C Specification

The XrBodySkeletonHTC structure is defined as:

// Provided by XR_HTC_body_tracking
typedef struct XrBodySkeletonHTC {
    XrStructureType            type;
    void*                      next;
    uint32_t                   jointCount;
    XrBodySkeletonJointHTC*    joints;
} XrBodySkeletonHTC;

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.

  • jointCount is an uint32_t describing the count of elements in joints array.

  • joints is an application-allocated array of XrBodySkeletonJointHTC that will be filled with skeleton joint elements.

Description

The XrBodySkeletonHTC structure is a container to represent the body skeleton in T-pose including each joint pose. The runtime must return XR_ERROR_VALIDATION_FAILURE if jointCount does not equal the number of joints associated with the XrBodyJointSetHTC value used to create the XrBodyTrackerHTC.

The application must allocate an array of at least jointCount elements for joints, to be populated by the runtime. If joints is NULL, the runtime must return XR_ERROR_VALIDATION_FAILURE.

The runtime must return joints representing the default pose of the current estimation regarding the user’s skeleton.

The runtime must update the joints array ordered so that it is indexed using the corresponding body joint enumeration (e.g. XrBodyJointHTC for the joint set XR_BODY_JOINT_SET_FULL_HTC) as associated with the XrBodyJointSetHTC value used when creating the XrBodyTrackerHTC. For example, when the XrBodyTrackerHTC is created with XR_BODY_JOINT_SET_FULL_HTC, the runtime must fill the joints array indexed by the XrBodyJointHTC enumeration.

Valid Usage (Implicit)

See Also

XR_HTC_body_tracking, XrBodySkeletonJointHTC, XrStructureType, xrGetBodySkeletonHTC

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-2025 The Khronos Group Inc.

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