C Specification

The XrSpatialBoundsSpherefANDROID structure is defined as:

// Provided by XR_ANDROID_spatial_discovery_bounds
typedef struct XrSpatialBoundsSpherefANDROID {
    XrStructureType    type;
    const void*        next;
    XrSpace            space;
    XrTime             time;
    XrSpheref          sphere;
} XrSpatialBoundsSpherefANDROID;

Members

Member Descriptions

  • type is the XrStructureType of this structure.

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

  • space is the XrSpace that any poses for the bounds are defined in.

  • time is an XrTime at which the poses for the bounds are defined.

  • sphere is an XrSpheref which describes the spherical volume within which the runtime must constrain its discovery of spatial entities.

Description

Spatial capabilities that support XR_SPATIAL_CAPABILITY_FEATURE_SPHERE_BOUNDS_FILTER_ANDROID (as enumerated by xrEnumerateSpatialCapabilityFeaturesEXT) allow the application to restrict the discovery to spatial entities whose location or bounds are within or intersecting with sphere by chaining XrSpatialBoundsSpherefANDROID to XrSpatialDiscoverySnapshotCreateInfoEXT::next. For a discovery snapshot in which the applicable capability supports XR_SPATIAL_CAPABILITY_FEATURE_SPHERE_BOUNDS_FILTER_ANDROID, if this structure is present in the next chain, the runtime must not include any spatial entities whose location or bounds are entirely outside of sphere.

It is important to note that the inclusion of XrSpatialBoundsSpherefANDROID in the next chain of XrSpatialDiscoverySnapshotCreateInfoEXT acts as an 'AND' condition with the other filters provided. Entities coming from spatial capabilities that do not support XR_SPATIAL_CAPABILITY_FEATURE_SPHERE_BOUNDS_FILTER_ANDROID must not be included in the discovery snapshot. This behavior is different from the rest of the OpenXR specification where unrecognized or unsupported structures in the next pointer chain are ignored by the runtime. Also, as described in the https://registry.khronos.org/OpenXR/specs/1.1/html/xrspec.html#fundamentals-next-chain-structure-uniqueness section, the runtime will only process the first occurrence of the XrSpatialBoundsSpherefANDROID structure in the next chain.

Valid Usage (Implicit)

See Also

XR_ANDROID_spatial_discovery_bounds, XrSpace, XrSpatialDiscoverySnapshotCreateInfoEXT, XrSpheref, XrStructureType, XrTime

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.