C Specification

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

// Provided by XR_VERSION_1_1
typedef struct XrFrustumf {
    XrPosef    pose;
    XrFovf     fov;
    float      nearZ;
    float      farZ;
} XrFrustumf;

Members

Member Descriptions

  • pose is an XrPosef defining the position and orientation of the tip of the frustum within the reference frame of the corresponding XrSpace.

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

  • nearZ is the positive distance of the near plane of the frustum bound along the -Z direction of the frustum space.

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

Description

The runtime must return XR_ERROR_VALIDATION_FAILURE if farZ is less than or equal to zero.

The runtime must return XR_ERROR_VALIDATION_FAILURE if nearZ is less than zero.

See XrFovf for validity requirements on fov.

See Also

XR_VERSION_1_1, XrFovf, XrPosef

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.