This page has been translated automatically.
视频教程
界面
要领
高级
实用建议
专业(SIM)
UnigineEditor
界面概述
资源工作流程
版本控制
设置和首选项
项目开发
调整节点参数
Setting Up Materials
设置属性
照明
Sandworm
使用编辑器工具执行特定任务
如何擴展編輯器功能
嵌入式节点类型
Nodes
Objects
Effects
Decals
光源
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
编程
基本原理
搭建开发环境
使用范例
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
材质和着色器
Rebuilding the Engine Tools
GUI
双精度坐标
应用程序接口
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
创建内容
内容优化
材质
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials
注意! 这个版本的文档是过时的,因为它描述了一个较老的SDK版本!请切换到最新SDK版本的文档。
注意! 这个版本的文档描述了一个不再受支持的旧SDK版本!请升级到最新的SDK版本。

Unigine::Plugins::UltraleapDevice Class

Header: #include <plugins/Unigine/Ultraleap/UnigineUltraleap.h>

UltraleapDevice Class

Enums

HARDWARE_TYPE#

Name说明/描 述
HARDWARE_TYPE_UNKNOWN = 0x0000An unknown device that is compatible with the tracking software.
HARDWARE_TYPE_PERIPHERAL = 0x0003The Leap Motion Controller (the first consumer peripheral).
HARDWARE_TYPE_DRAGONFLY = 0x1102Internal research product codename “Dragonfly”.
HARDWARE_TYPE_NIGHTCRAWLER = 0x1201Internal research product codename “Nightcrawler”.
HARDWARE_TYPE_RIGEL = 0x1202Research product codename “Rigel”.
HARDWARE_TYPE_SIR170 = 0x1203he Ultraleap Stereo IR 170 (SIR170) hand tracking module.
HARDWARE_TYPE__3DI = 0x1204The Ultraleap 3Di hand tracking camera.
HARDWARE_TYPE_INVALID = -1An invalid device type.

TRANSFORM_MODE#

Name说明/描 述
TRANSFORM_MODE_HMD_VARJO = 0HMD Pose from AppVarjo and the IModelView from Game::getPlayer() are used for transform.
TRANSFORM_MODE_MANUAL = 1The user manually sets the transform matrix as described for the Ultraleap Coordinate System.

Members


bool isStatusConnected ( ) const#

Returns a value indicating if the Ultraleap Controller device is connected.

Return value

true if the device is connected; otherwise, false.

bool isStatusStreaming ( ) const#

Returns a value indicating if the Ultraleap Controller device is sending out frames.

Return value

true if the device is sending out frames; otherwise, false.

bool isStatusPaused ( ) const#

Returns a value indicating if the Ultraleap Controller device streaming has been paused.

Return value

true if the device streaming has been paused; otherwise, false.

bool isStatusRobust ( ) const#

Returns a value indicating if the Ultraleap Controller device has transitioned to robust mode in order to compensate for known sources of infrared interference.

Return value

true if the device has transitioned to robust mode in order to compensate; otherwise, false.

bool isStatusSmudged ( ) const#

Returns a value indicating if the Ultraleap Controller device’s window is smudged. If the device’s window is smudged, tracking may be degraded.

Return value

true if the device’s window is smudged; otherwise, false.

bool isStatusLowResource ( ) const#

Returns a value indicating if the Ultraleap Controller device has entered low-resource mode.

Return value

true if the device has entered low-resource mode; otherwise, false.

bool isStatusUnknownFailure ( ) const#

Returns a value indicating if the Ultraleap Controller device has failed, but the failure reason is not known.

Return value

true if the device has failed, but the failure reason is not known; otherwise, false.

bool isStatusBadCalibration ( ) const#

Returns a value indicating if the Ultraleap Controller device has a bad calibration record and cannot send frames.

Return value

true if the device has a bad calibration record and cannot send frames; otherwise, false.

bool isStatusBadFirmware ( ) const#

Returns a value indicating if the Ultraleap Controller device reports corrupt firmware or cannot install a required firmware update.

Return value

true if the device reports corrupt firmware or cannot install a required firmware update; otherwise, false.

bool isStatusBadTransport ( ) const#

Returns a value indicating if the Ultraleap Controller device USB connection is faulty.

Return value

true if the device USB connection is faulty; otherwise, false.

bool isStatusBadControl ( ) const#

Returns a value indicating if the Ultraleap Controller device USB control interfaces failed to initialize.

Return value

true if the device USB control interfaces failed to initialize; otherwise, false.

String getSerial ( ) const#

Returns the device serial number.

Return value

The device serial number.

float getHFov ( ) const#

Returns the horizontal field of view of this device in radians.

Return value

The horizontal field of view of this device in radians.

float getVFov ( ) const#

Returns the vertical field of view of this device in radians.

Return value

The vertical field of view of this device in radians.

double getRange ( ) const#

Returns the maximum range for this device, in meters.

Return value

The maximum range for this device, in meters.

double getDistanceBetweenCameras ( ) const#

Returns the distance between the Ultraleap cameras, in meters.

Return value

The distance between the Ultraleap cameras, in meters.

UltraleapDevice::HARDWARE_TYPE getHardwareType ( ) const#

Returns the recognized type of hardware.

Return value

The hardware type. One of the HARDWARE_TYPE_* values.

unsigned int getLeapID ( ) const#

Returns the ID of the current device.

Return value

The device ID.

bool isSupportedColorImages ( ) const#

Returns the value indicating if color images are supported for this device.

Return value

true if color images are supported for this device; otherwise, false.

bool isSupportedAccelerometer ( ) const#

Returns the value indicating if the accelerometer is supported for this device.

Return value

true if the accelerometer is supported for this device; otherwise, false.

bool isSupportedGyroscope ( ) const#

Returns the value indicating if the gyroscope is supported for this device.

Return value

true if the gyroscope is supported for this device; otherwise, false.

bool isSupportedTemperature ( ) const#

Returns the value indicating if temperature measuring is supported for this device.

Return value

true if temperature measuring is supported for this device; otherwise, false.

Math::vec3 getAccelerometer ( ) const#

Returns the accelerometer measurements, in in m/s^2.

Return value

The accelerometer measurements, in m/s^2.

Math::vec3 getGyroscope ( ) const#

Returns the gyroscope measurements, in rad/s.

Return value

The gyroscope measurements, in rad/s.

float getTemperature ( ) const#

Returns the measured temperature, in deg C.

Return value

The measured temperature, in deg C.

void setTrackingOffset ( const Math::Vec3& offset ) #

Sets the default offset for the newly connected device. The Y value specifies the offset from the eyes to the frontal camera plane, in meters, and the Z value — the offset from the eye level up to the camera level, in meters. The X value should be set to 0. These settings can be used to match the physical position and orientation of the Tracking Hardware on a tracked device it is mounted on (such as a VR headset).

Arguments

  • const Math::Vec3& offset - The default offset for the newly connected device. The Y value specifies the offset from the eyes to the frontal camera plane, in meters, and the Z value — the offset from the eye level up to the camera level, in meters. The X value should be set to 0.

Math::Vec3 getTrackingOffset ( ) const#

Returns the current virtual offset of the tracking device. The Y value specifies the offset from the eyes to the frontal camera plane, in meters, and the Z value — the offset from the eye level up to the camera level, in meters.

Return value

The default offset for the newly connected device. The Y value specifies the offset from the eyes to the frontal camera plane, in meters, and the Z value — the offset from the eye level up to the camera level, in meters. The X value should be set to 0.

float getTrackingFPS ( ) const#

Returns the number of the tracking frames per second for this device.

Return value

The tracking FPS value.

void setTransform ( const Math::Mat4& transform ) #

Sets the transformation matrix for this device.

Arguments

  • const Math::Mat4& transform - The transformation matrix.

Math::Mat4 getTransform ( ) const#

Returns the current transformation matrix for this device.

Return value

The transformation matrix.

void setTransformMode ( UltraleapDevice::TRANSFORM_MODE mode ) #

Sets the transform mode for this device.
Notice
If the HMD VARJO transform mode has been set, but AppVarjo hasn't been found, the transform mode is switched to MANUAL.

Arguments

UltraleapDevice::TRANSFORM_MODE getTransformMode ( ) const#

Returns the current transform mode for this device.

Return value

The transform mode. One of the TRANSFORM_MODE* values.

UltraleapHand * getLeftHand ( ) const#

Returns the object for the left hand.

Return value

The object for the left hand.

UltraleapHand * getRightHand ( ) const#

Returns the object for the right hand.

Return value

The object for the right hand.

bool isLeftDistortionReceived ( ) const#

Returns a value indicating if the distortion calibration map for the left-eye image has been received.

Return value

true if the distortion calibration map for the left-eye image has been received; otherwise, false.

Ptr<Image> getLeftDistortionImage ( ) const#

Returns the distortion calibration map for the left-eye image.

Return value

The distortion calibration map for the left-eye image.

bool isLeftColorReceived ( ) const#

Returns a value indicating if the color image for the left eye image has been received.

Return value

true if the color image for the left eye image has been received; otherwise, false.

Ptr<Image> getLeftColorImage ( ) const#

Returns the color image for the left eye.

Return value

The color image for the left eye.

bool isRightDistortionReceived ( ) const#

Returns a value indicating if the distortion calibration map for the right-eye image has been received.

Return value

true if the distortion calibration map for the right-eye image has been received; otherwise, false.

Ptr<Image> getRightDistortionImage ( ) const#

Returns the distortion calibration map for the right-eye image.

Return value

The distortion calibration map for the right-eye image.

bool isRightColorReceived ( ) const#

Returns a value indicating if the color image for the right eye image has been received.

Return value

true if the color image for the right eye image has been received; otherwise, false.

Ptr<Image> getRightColorImage ( ) const#

Returns the color image for the right eye.

Return value

The color image for the right eye.
Last update: 2023-06-23
Build: ()