Package org.lwjgl.openxr
Class EXTHandTracking
- java.lang.Object
-
- org.lwjgl.openxr.EXTHandTracking
-
public class EXTHandTracking extends java.lang.ObjectThe EXT_hand_tracking extension.
-
-
Field Summary
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static intnxrCreateHandTrackerEXT(XrSession session, long createInfo, long handTracker)Unsafe version of:CreateHandTrackerEXTstatic intnxrLocateHandJointsEXT(XrHandTrackerEXT handTracker, long locateInfo, long locations)Unsafe version of:LocateHandJointsEXTstatic intxrCreateHandTrackerEXT(XrSession session, XrHandTrackerCreateInfoEXT createInfo, org.lwjgl.PointerBuffer handTracker)Create a hand joints handle.static intxrDestroyHandTrackerEXT(XrHandTrackerEXT handTracker)Destroy a hand joints handle.static intxrLocateHandJointsEXT(XrHandTrackerEXT handTracker, XrHandJointsLocateInfoEXT locateInfo, XrHandJointLocationsEXT locations)Locate hand joint locations.
-
-
-
Field Detail
-
XR_EXT_hand_tracking_SPEC_VERSION
The extension specification version.
-
XR_EXT_HAND_TRACKING_EXTENSION_NAME
The extension name.
-
XR_OBJECT_TYPE_HAND_TRACKER_EXT
ExtendsXrObjectType.
-
XR_TYPE_SYSTEM_HAND_TRACKING_PROPERTIES_EXT, XR_TYPE_HAND_TRACKER_CREATE_INFO_EXT, XR_TYPE_HAND_JOINTS_LOCATE_INFO_EXT, XR_TYPE_HAND_JOINT_LOCATIONS_EXT, XR_TYPE_HAND_JOINT_VELOCITIES_EXT
ExtendsXrStructureType.Enum values:
-
XR_HAND_LEFT_EXT, XR_HAND_RIGHT_EXT
XrHandEXT - Describes which hand the tracker is tracking.Enumerant Descriptions
HAND_LEFT_EXTspecifies the hand tracker will be tracking the user’s left hand.HAND_RIGHT_EXTspecifies the hand tracker will be tracking the user’s right hand.
See Also
-
XR_HAND_JOINT_PALM_EXT, XR_HAND_JOINT_WRIST_EXT, XR_HAND_JOINT_THUMB_METACARPAL_EXT, XR_HAND_JOINT_THUMB_PROXIMAL_EXT, XR_HAND_JOINT_THUMB_DISTAL_EXT, XR_HAND_JOINT_THUMB_TIP_EXT, XR_HAND_JOINT_INDEX_METACARPAL_EXT, XR_HAND_JOINT_INDEX_PROXIMAL_EXT, XR_HAND_JOINT_INDEX_INTERMEDIATE_EXT, XR_HAND_JOINT_INDEX_DISTAL_EXT, XR_HAND_JOINT_INDEX_TIP_EXT, XR_HAND_JOINT_MIDDLE_METACARPAL_EXT, XR_HAND_JOINT_MIDDLE_PROXIMAL_EXT, XR_HAND_JOINT_MIDDLE_INTERMEDIATE_EXT, XR_HAND_JOINT_MIDDLE_DISTAL_EXT, XR_HAND_JOINT_MIDDLE_TIP_EXT, XR_HAND_JOINT_RING_METACARPAL_EXT, XR_HAND_JOINT_RING_PROXIMAL_EXT, XR_HAND_JOINT_RING_INTERMEDIATE_EXT, XR_HAND_JOINT_RING_DISTAL_EXT, XR_HAND_JOINT_RING_TIP_EXT, XR_HAND_JOINT_LITTLE_METACARPAL_EXT, XR_HAND_JOINT_LITTLE_PROXIMAL_EXT, XR_HAND_JOINT_LITTLE_INTERMEDIATE_EXT, XR_HAND_JOINT_LITTLE_DISTAL_EXT, XR_HAND_JOINT_LITTLE_TIP_EXT
XrHandJointEXT - The name of hand joints that can be trackedSee Also
XrHandCapsuleFB,XrHandTrackingMeshFBEnum values:
HAND_JOINT_PALM_EXTHAND_JOINT_WRIST_EXTHAND_JOINT_THUMB_METACARPAL_EXTHAND_JOINT_THUMB_PROXIMAL_EXTHAND_JOINT_THUMB_DISTAL_EXTHAND_JOINT_THUMB_TIP_EXTHAND_JOINT_INDEX_METACARPAL_EXTHAND_JOINT_INDEX_PROXIMAL_EXTHAND_JOINT_INDEX_INTERMEDIATE_EXTHAND_JOINT_INDEX_DISTAL_EXTHAND_JOINT_INDEX_TIP_EXTHAND_JOINT_MIDDLE_METACARPAL_EXTHAND_JOINT_MIDDLE_PROXIMAL_EXTHAND_JOINT_MIDDLE_INTERMEDIATE_EXTHAND_JOINT_MIDDLE_DISTAL_EXTHAND_JOINT_MIDDLE_TIP_EXTHAND_JOINT_RING_METACARPAL_EXTHAND_JOINT_RING_PROXIMAL_EXTHAND_JOINT_RING_INTERMEDIATE_EXTHAND_JOINT_RING_DISTAL_EXTHAND_JOINT_RING_TIP_EXTHAND_JOINT_LITTLE_METACARPAL_EXTHAND_JOINT_LITTLE_PROXIMAL_EXTHAND_JOINT_LITTLE_INTERMEDIATE_EXTHAND_JOINT_LITTLE_DISTAL_EXTHAND_JOINT_LITTLE_TIP_EXT
-
XR_HAND_JOINT_SET_DEFAULT_EXT
XrHandJointSetEXT - The set of hand joints to track.Enumerant Descriptions
HAND_JOINT_SET_DEFAULT_EXTindicates that the createdXrHandTrackerEXTtracks the set of hand joints described byXrHandJointEXTenum, i.e. theLocateHandJointsEXTfunction returns an array of joint locations with the count ofHAND_JOINT_COUNT_EXTand can be indexed usingXrHandJointEXT.
See Also
-
XR_HAND_JOINT_COUNT_EXT
API Constants
-
-
Method Detail
-
nxrCreateHandTrackerEXT
public static int nxrCreateHandTrackerEXT(XrSession session, long createInfo, long handTracker)
Unsafe version of:CreateHandTrackerEXT
-
xrCreateHandTrackerEXT
public static int xrCreateHandTrackerEXT(XrSession session, XrHandTrackerCreateInfoEXT createInfo, org.lwjgl.PointerBuffer handTracker)
Create a hand joints handle.C Specification
An application can create an
XrHandTrackerEXThandle usingCreateHandTrackerEXTfunction.XrResult xrCreateHandTrackerEXT( XrSession session, const XrHandTrackerCreateInfoEXT* createInfo, XrHandTrackerEXT* handTracker);Valid Usage (Implicit)
- The
XR_EXT_hand_trackingextension must be enabled prior to callingCreateHandTrackerEXT sessionmust be a validXrSessionhandlecreateInfomust be a pointer to a validXrHandTrackerCreateInfoEXTstructurehandTrackermust be a pointer to anXrHandTrackerEXThandle
Return Codes
- On success, this command returns
- On failure, this command returns
If the system does not support hand tracking, runtime must return
ERROR_FEATURE_UNSUPPORTEDfromCreateHandTrackerEXT. In this case, the runtime must returnFALSEforsupportsHandTrackinginXrSystemHandTrackingPropertiesEXTwhen the functionGetSystemPropertiesis called, so that the application can avoid creating a hand tracker.See Also
- Parameters:
session- anXrSessionin which the hand tracker will be active.createInfo- theXrHandTrackerCreateInfoEXTused to specify the hand tracker.handTracker- the returnedXrHandTrackerEXThandle.
- The
-
xrDestroyHandTrackerEXT
public static int xrDestroyHandTrackerEXT(XrHandTrackerEXT handTracker)
Destroy a hand joints handle.C Specification
DestroyHandTrackerEXTfunction releases thehandTrackerand the underlying resources when finished with hand tracking experiences.XrResult xrDestroyHandTrackerEXT( XrHandTrackerEXT handTracker);Valid Usage (Implicit)
- The
XR_EXT_hand_trackingextension must be enabled prior to callingDestroyHandTrackerEXT handTrackermust be a validXrHandTrackerEXThandle
Thread Safety
- Access to
handTracker, and any child handles, must be externally synchronized
Return Codes
- On success, this command returns
- On failure, this command returns
- Parameters:
handTracker- anXrHandTrackerEXTpreviously created byCreateHandTrackerEXT.
- The
-
nxrLocateHandJointsEXT
public static int nxrLocateHandJointsEXT(XrHandTrackerEXT handTracker, long locateInfo, long locations)
Unsafe version of:LocateHandJointsEXT
-
xrLocateHandJointsEXT
public static int xrLocateHandJointsEXT(XrHandTrackerEXT handTracker, XrHandJointsLocateInfoEXT locateInfo, XrHandJointLocationsEXT locations)
Locate hand joint locations.C Specification
The
LocateHandJointsEXTfunction locates an array of hand joints to a base space at given time.XrResult xrLocateHandJointsEXT( XrHandTrackerEXT handTracker, const XrHandJointsLocateInfoEXT* locateInfo, XrHandJointLocationsEXT* locations);Valid Usage (Implicit)
- The
XR_EXT_hand_trackingextension must be enabled prior to callingLocateHandJointsEXT handTrackermust be a validXrHandTrackerEXThandlelocateInfomust be a pointer to a validXrHandJointsLocateInfoEXTstructurelocationsmust be a pointer to anXrHandJointLocationsEXTstructure
Return Codes
- On success, this command returns
- On failure, this command returns
See Also
- Parameters:
handTracker- anXrHandTrackerEXTpreviously created byCreateHandTrackerEXT.locateInfo- a pointer toXrHandJointsLocateInfoEXTdescribing information to locate hand joints.locations- a pointer toXrHandJointLocationsEXTreceiving the returned hand joint locations.
- The
-
-