C Specification

A XrHandMeshUpdateInfoMSFT describes the information to update a hand mesh.

// Provided by XR_MSFT_hand_tracking_mesh
typedef struct XrHandMeshUpdateInfoMSFT {
    XrStructureType       type;
    const void*           next;
    XrTime                time;
    XrHandPoseTypeMSFT    handPoseType;
} XrHandMeshUpdateInfoMSFT;

Members

Member Descriptions

  • type is the XrStructureType of this structure.

  • next is NULL or a pointer to the next structure in a structure chain. No such structures are defined in core OpenXR or this extension.

  • time is the XrTime that describes the time for which the application wishes to query the hand mesh state.

  • handPoseType is an XrHandPoseTypeMSFT which describes the type of hand pose of the hand mesh to update.

Description

A runtime may not maintain a full history of hand mesh data, therefore the returned XrHandMeshMSFT might return data that’s not exactly corresponding to the time input. If the runtime cannot return any tracking data for the given time at all, it must set XrHandMeshMSFT::isActive to XR_FALSE for the call to xrUpdateHandMeshMSFT. Otherwise, if the runtime returns XrHandMeshMSFT::isActive as XR_TRUE, the data in XrHandMeshMSFT must be valid to use.

An application can choose different handPoseType values to query the hand mesh data. The returned hand mesh must be consistent to the hand joint space location on the same XrHandTrackerEXT when using the same XrHandPoseTypeMSFT.

Valid Usage (Implicit)

See Also

XR_MSFT_hand_tracking_mesh, XrHandPoseTypeMSFT, XrStructureType, XrTime, xrUpdateHandMeshMSFT

Document Notes

For more information, see the OpenXR Specification

This page is extracted from the OpenXR Specification. Fixes and changes should be made to the Specification, not directly.

Copyright

Copyright 2014-2024, The Khronos Group Inc.

This work is licensed under a Creative Commons Attribution 4.0 International License.