Package org.lwjgl.openxr

Class EXTHandTrackingDataSource

java.lang.Object

org.lwjgl.openxr.EXTHandTrackingDataSource

public final class EXTHandTrackingDataSource
extends Object

The XR_EXT_hand_tracking_data_source extension.

This extension augments the XR_EXT_hand_tracking extension.

Runtimes may support a variety of data sources for hand joint data for XR_EXT_hand_tracking, and some runtimes and devices may use joint data from multiple sources. This extension allows an application and the runtime to communicate about and make use of those data sources in a cooperative manner.

This extension allows the application to specify the data sources that it wants data from when creating a hand tracking handle, and allows the runtime to specify the currently active data source.

The application must enable the XR_EXT_hand_tracking extension in order to use this extension.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	XR_EXT_HAND_TRACKING_DATA_SOURCE_EXTENSION_NAME	The extension name.
static final int	XR_EXT_hand_tracking_data_source_SPEC_VERSION	The extension specification version.
static final int	XR_HAND_TRACKING_DATA_SOURCE_CONTROLLER_EXT	XrHandTrackingDataSourceEXT - Describes the hand tracking data source.
static final int	XR_HAND_TRACKING_DATA_SOURCE_UNOBSTRUCTED_EXT	XrHandTrackingDataSourceEXT - Describes the hand tracking data source.
static final int	XR_TYPE_HAND_TRACKING_DATA_SOURCE_INFO_EXT	Extends XrStructureType.
static final int	XR_TYPE_HAND_TRACKING_DATA_SOURCE_STATE_EXT	Extends XrStructureType.

Method Summary

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

XR_EXT_hand_tracking_data_source_SPEC_VERSION

public static final int XR_EXT_hand_tracking_data_source_SPEC_VERSION

The extension specification version.

See Also:

• Constant Field Values

XR_EXT_HAND_TRACKING_DATA_SOURCE_EXTENSION_NAME

public static final String XR_EXT_HAND_TRACKING_DATA_SOURCE_EXTENSION_NAME

The extension name.

See Also:

• Constant Field Values

XR_TYPE_HAND_TRACKING_DATA_SOURCE_INFO_EXT

public static final int XR_TYPE_HAND_TRACKING_DATA_SOURCE_INFO_EXT

Extends XrStructureType.

Enum values:

• TYPE_HAND_TRACKING_DATA_SOURCE_INFO_EXT
• TYPE_HAND_TRACKING_DATA_SOURCE_STATE_EXT

See Also:

• Constant Field Values

XR_TYPE_HAND_TRACKING_DATA_SOURCE_STATE_EXT

public static final int XR_TYPE_HAND_TRACKING_DATA_SOURCE_STATE_EXT

Extends XrStructureType.

Enum values:

• TYPE_HAND_TRACKING_DATA_SOURCE_INFO_EXT
• TYPE_HAND_TRACKING_DATA_SOURCE_STATE_EXT

See Also:

• Constant Field Values

XR_HAND_TRACKING_DATA_SOURCE_UNOBSTRUCTED_EXT

public static final int XR_HAND_TRACKING_DATA_SOURCE_UNOBSTRUCTED_EXT

XrHandTrackingDataSourceEXT - Describes the hand tracking data source.

Description

The application can use XrHandTrackingDataSourceEXT with XrHandTrackingDataSourceInfoEXT when calling CreateHandTrackerEXT to tell the runtime all supported data sources for the application for the hand tracking inputs.

The application can use it with XrHandTrackingDataSourceStateEXT when calling LocateHandJointsEXT to inspect what data source the runtime used for the returned hand joint locations.

If the XR_EXT_hand_joints_motion_range extension is supported by the runtime and the data source is HAND_TRACKING_DATA_SOURCE_CONTROLLER_EXT, then it is expected that application will use that extension when retrieving hand joint poses.

Enumerant Descriptions

• HAND_TRACKING_DATA_SOURCE_UNOBSTRUCTED_EXT - This data source value indicates that the hand tracking data source supports using individual fingers and joints separately. Examples of such sources include optical hand tracking, data gloves, or motion capture devices.
• HAND_TRACKING_DATA_SOURCE_CONTROLLER_EXT - This data source value indicates that the hand tracking data source is a motion controller. The runtime must not supply this data source if the controller providing the data is not actively held in the user’s hand, but may still provide data if the runtime is unable to detect if the controller is not in the user’s hand, or a user selected policy changes this behavior. Unless specified otherwise by another extension, data returned from HAND_TRACKING_DATA_SOURCE_CONTROLLER_EXT must behave as HAND_JOINTS_MOTION_RANGE_UNOBSTRUCTED_EXT.

See Also

XrHandTrackingDataSourceInfoEXT, XrHandTrackingDataSourceStateEXT, CreateHandTrackerEXT, LocateHandJointsEXT

See Also:

• Constant Field Values

XR_HAND_TRACKING_DATA_SOURCE_CONTROLLER_EXT

public static final int XR_HAND_TRACKING_DATA_SOURCE_CONTROLLER_EXT

XrHandTrackingDataSourceEXT - Describes the hand tracking data source.

Description

The application can use XrHandTrackingDataSourceEXT with XrHandTrackingDataSourceInfoEXT when calling CreateHandTrackerEXT to tell the runtime all supported data sources for the application for the hand tracking inputs.

The application can use it with XrHandTrackingDataSourceStateEXT when calling LocateHandJointsEXT to inspect what data source the runtime used for the returned hand joint locations.

If the XR_EXT_hand_joints_motion_range extension is supported by the runtime and the data source is HAND_TRACKING_DATA_SOURCE_CONTROLLER_EXT, then it is expected that application will use that extension when retrieving hand joint poses.

Enumerant Descriptions

• HAND_TRACKING_DATA_SOURCE_UNOBSTRUCTED_EXT - This data source value indicates that the hand tracking data source supports using individual fingers and joints separately. Examples of such sources include optical hand tracking, data gloves, or motion capture devices.
• HAND_TRACKING_DATA_SOURCE_CONTROLLER_EXT - This data source value indicates that the hand tracking data source is a motion controller. The runtime must not supply this data source if the controller providing the data is not actively held in the user’s hand, but may still provide data if the runtime is unable to detect if the controller is not in the user’s hand, or a user selected policy changes this behavior. Unless specified otherwise by another extension, data returned from HAND_TRACKING_DATA_SOURCE_CONTROLLER_EXT must behave as HAND_JOINTS_MOTION_RANGE_UNOBSTRUCTED_EXT.

See Also

XrHandTrackingDataSourceInfoEXT, XrHandTrackingDataSourceStateEXT, CreateHandTrackerEXT, LocateHandJointsEXT

See Also:

• Constant Field Values