C Specification

The XrSpatialBounded2DDataEXT structure is defined as:

// Provided by XR_EXT_spatial_entity
typedef struct XrSpatialBounded2DDataEXT {
    XrPosef        center;
    XrExtent2Df    extents;
} XrSpatialBounded2DDataEXT;

Members

Member Descriptions

  • center is an XrPosef defining the geometric center of the bounded 2D component.

  • extents is extents of the bounded 2D component along the x-axis (extents.width), y-axis (extents.height), centered on center.

Description

The extents of the XR_SPATIAL_COMPONENT_TYPE_BOUNDED_2D_EXT refer to the entity’s size in the x-y plane of the plane’s coordinate system. A plane with a position of {0, 0, 0}, rotation of {0, 0, 0, 1} (no rotation), and an extent of {1, 1} refers to a 1 meter x 1 meter plane centered at {0, 0, 0} with its front face normal vector pointing towards the +Z direction in the component’s space.

XXYYZZHeightHeightYYZZXXVertical planeVertical planeHorizontal PlaneHorizontal PlaneWidthWidthWidthWidthHeightHeight
Figure 1. Bounded2D Component Coordinate System
Note
Note

OpenXR uses an X-Y plane with +Z as the plane normal but other APIs may use an X-Z plane with +Y as the plane normal. The X-Y plane can be converted to an X-Z plane by rotating -π/2 radians around the +X axis.
Valid Usage (Implicit)

See Also

XR_EXT_spatial_entity, XrExtent2Df, XrPosef, XrSpatialComponentBounded2DListEXT, XrSpatialComponentDataQueryResultEXT, XrSpatialComponentTypeEXT, xrQuerySpatialComponentDataEXT

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.