C Specification

The XrRenderModelPropertiesEXT structure is defined as:

// Provided by XR_EXT_render_model
typedef struct XrRenderModelPropertiesEXT {
    XrStructureType    type;
    void*              next;
    XrUuidEXT          cacheId;
    uint32_t           animatableNodeCount;
} XrRenderModelPropertiesEXT;

Members

Member Descriptions

  • type is the XrStructureType of this structure.

  • next is NULL or a pointer to the next structure in a structure chain.

  • cacheId is an XrUuidEXT to uniquely identify a render model asset using only extensions listed by the application at XrRenderModelEXT creation.

  • animatableNodeCount is the number of uniquely-named nodes that are animated using state tracked by the XrRenderModelEXT.

Description

The XrRenderModelPropertiesEXT structure is an output structure for xrGetRenderModelPropertiesEXT.

Applications may use cacheId to avoid loading the exact same render model asset twice when two or more XrRenderModelEXT handles use the same glTF asset. Applications may also use cacheId to cache preprocessed render model asset data (and the associated animatableNodeCount node names) between sessions: it is a persistent UUID, unlike the associated XrRenderModelEXT handle or XrRenderModelIdEXT atom. Note that runtimes may return a different UUID for a given logical entity (e.g. hardware) in another session.

Within the corresponding XrSession, the association between an XrRenderModelIdEXT value, the glTF extensions required by the underlying model based on the contents of the XrRenderModelCreateInfoEXT::gltfExtensions array, and the cacheId, is constant. A UUID cacheId corresponds to a unique binary asset, with a constant animatableNodeCount, and is a function of the render model ID and the required glTF extensions selected based on the supported glTF extension contents reported by the application. The runtime must set cacheId to a valid UUID value and subsequent valid calls to xrGetRenderModelPropertiesEXT with the same XrRenderModelEXT and XrRenderModelPropertiesGetInfoEXT values must return the same values for cacheId while that ID remains valid to use.

Valid Usage (Implicit)

See Also

XR_EXT_render_model, XrStructureType, XrUuidEXT, xrGetRenderModelPropertiesEXT

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.