Top Description Fields Constructors Methods
org.lwjgl.openxr

public final Class EXTHandTrackingDataSource

extends Object
Class Inheritance

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

Modifier and TypeField and Description
public static final String
public static final int
XR_EXT_hand_tracking_data_source_SPEC_VERSION

The extension specification version.

public static final int
XR_HAND_TRACKING_DATA_SOURCE_CONTROLLER_EXT

XrHandTrackingDataSourceEXT - Describes the hand tracking data source.

public static final int
XR_HAND_TRACKING_DATA_SOURCE_UNOBSTRUCTED_EXT

XrHandTrackingDataSourceEXT - Describes the hand tracking data source.

public static final int
public static final int

Constructor Summary

AccessConstructor and Description
private

Method Summary

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

XR_EXT_HAND_TRACKING_DATA_SOURCE_EXTENSION_NAMEback to summary
public static final String XR_EXT_HAND_TRACKING_DATA_SOURCE_EXTENSION_NAME

The extension name.

XR_EXT_hand_tracking_data_source_SPEC_VERSIONback to summary
public static final int XR_EXT_hand_tracking_data_source_SPEC_VERSION

The extension specification version.

XR_HAND_TRACKING_DATA_SOURCE_CONTROLLER_EXTback to summary
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

XR_HAND_TRACKING_DATA_SOURCE_UNOBSTRUCTED_EXTback to summary
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

XR_TYPE_HAND_TRACKING_DATA_SOURCE_INFO_EXTback to summary
public static final int XR_TYPE_HAND_TRACKING_DATA_SOURCE_INFO_EXT

Extends XrStructureType.

Enum values:
XR_TYPE_HAND_TRACKING_DATA_SOURCE_STATE_EXTback to summary
public static final int XR_TYPE_HAND_TRACKING_DATA_SOURCE_STATE_EXT

Extends XrStructureType.

Enum values:

Constructor Detail

EXTHandTrackingDataSourceback to summary
private EXTHandTrackingDataSource()