C Specification

An XrSceneFrustumBoundMSFT structure describes the pose, field of view, and far distance of a frustum bounds.

// Provided by XR_MSFT_scene_understanding
typedef struct XrSceneFrustumBoundMSFT {
    XrPosef    pose;
    XrFovf     fov;
    float      farDistance;
} XrSceneFrustumBoundMSFT;

Members

Member Descriptions

  • pose is an XrPosef defining the position and orientation of the tip of the frustum bound within the reference frame of the corresponding XrSceneBoundsMSFT::space.

  • fov is an XrFovf for the four sides of the frustum bound where XrFovf::angleLeft and XrFovf::angleRight are along the X axis and XrFovf::angleUp and XrFovf::angleDown are along the Y axis of the frustum bound space.

  • farDistance is the positive distance of the far plane of the frustum bound along the -Z direction of the frustum bound space.

Description

The runtime must return XR_ERROR_VALIDATION_FAILURE if farDistance is less than or equal to zero. The runtime must return XR_ERROR_VALIDATION_FAILURE if the fov angles are not between between -π/2 and π/2 exclusively.

Valid Usage (Implicit)

See Also

XR_MSFT_scene_understanding, XrFovf, XrPosef, XrSceneBoundsMSFT

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.