C Specification

The xrLocateBodyJointsHTC function is defined as:

// Provided by XR_HTC_body_tracking
XrResult xrLocateBodyJointsHTC(
    XrBodyTrackerHTC                            bodyTracker,
    const XrBodyJointsLocateInfoHTC*            locateInfo,
    XrBodyJointLocationsHTC*                    locations);

Parameters

Parameter Descriptions

Description

The xrLocateBodyJointsHTC function locates an array of body joints relative to a base space at a given time.

If XrBodyJointLocationsHTC::jointLocationCount does not match the value associated with the supplied XrBodyJointSetHTC value, the runtime must return XR_ERROR_VALIDATION_FAILURE.

Valid Usage (Implicit)
Return Codes
On success, this command returns

  • XR_SUCCESS

  • XR_SESSION_LOSS_PENDING

On failure, this command returns

  • XR_ERROR_FUNCTION_UNSUPPORTED

  • XR_ERROR_VALIDATION_FAILURE

  • XR_ERROR_RUNTIME_FAILURE

  • XR_ERROR_HANDLE_INVALID

  • XR_ERROR_INSTANCE_LOST

  • XR_ERROR_SESSION_LOST

  • XR_ERROR_TIME_INVALID

See Also

XR_HTC_body_tracking, XrBodyJointLocationsHTC, XrBodyJointsLocateInfoHTC, XrBodyTrackerHTC

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.