C Specification

The xrCreateRenderModelSpaceEXT function is defined as:

// Provided by XR_EXT_render_model
XrResult xrCreateRenderModelSpaceEXT(
    XrSession                                   session,
    const XrRenderModelSpaceCreateInfoEXT*      createInfo,
    XrSpace*                                    space);

Parameters

Parameter Descriptions

Description

The application can create an XrSpace handle that tracks a render model using xrCreateRenderModelSpaceEXT.

The origin of the underlying render model space is defined to be the origin of the glTF model.

Applications can use xrLocateSpace to locate the space created this way in a desired base space, as with all other varieties of XrSpace handles. Unless otherwise specified by a related extension, the pose and locatability of a render model space have no fixed relationship with any other object or space, and should be used only to transform the associated model for rendering. If a render model space is not both position and orientation TRACKED when location is queried for a time equal to the intended display time, this indicates that the application is intended to not render that model in that frame, unless otherwise specified by a related extension. This is used in lieu of an explicit visibility state flag.

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_HANDLE_INVALID

  • XR_ERROR_INSTANCE_LOST

  • XR_ERROR_SESSION_LOST

  • XR_ERROR_OUT_OF_MEMORY

  • XR_ERROR_LIMIT_REACHED

See Also

XR_EXT_render_model, XrRenderModelEXT, XrRenderModelSpaceCreateInfoEXT, XrSession, XrSpace

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.