C Specification

The XrSystemGeospatialAnchorPropertiesANDROID structure is defined as:

// Provided by XR_ANDROID_geospatial_anchor
typedef struct XrSystemGeospatialAnchorPropertiesANDROID {
    XrStructureType    type;
    void*              next;
    uint32_t           maxSurfaceAnchorCount;
} XrSystemGeospatialAnchorPropertiesANDROID;

Members

Member Descriptions

  • type is the XrStructureType of this structure.

  • next is NULL or a pointer to the next structure in a structure chain. No such structures are defined in core OpenXR or this extension.

  • maxSurfaceAnchorCount is a uint32_t indicating the maximum number of surface anchors that can be created.

Description

An application can inspect geospatial anchor capabilities of the system by chaining an XrSystemGeospatialAnchorPropertiesANDROID structure to the XrSystemProperties when calling xrGetSystemProperties.

If XrSystemGeospatialPropertiesANDROID::supportsGeospatial is XR_TRUE, then maxSurfaceAnchorCount indicates the maximum number of surface anchors the runtime supports. The limit must be greater than 0 in this case.

If XrSystemGeospatialPropertiesANDROID::supportsGeospatial is not XR_TRUE, then maxSurfaceAnchorCount must be 0.

Valid Usage (Implicit)

See Also

XR_ANDROID_geospatial_anchor, XrStructureType, XrSystemProperties, xrGetSystemProperties

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-2026 The Khronos Group Inc.

This work is licensed under a Creative Commons Attribution 4.0 International License.