OpenXRSpatialComponentPlaneAlignmentList

Native component-data container for QuerySnapshot, not a tracker, game Entity or ready geometry. OpenXRSpatialQueryResultData must be first in a query array; other components use the same row indices. Validate component support, successful query and row state before reading.

SetCapacity allocates memory rather than device data. Query-result GetCapacity reports allocated array length and can be nonzero without any query. Never consume stale storage after a failed/incomplete query. Final output counts are not separately public between the two passes; changing runtime result counts was not tested.

Buffer getters need the same live snapshot. Copy needed arrays/strings before FreeSpatialSnapshot or the end of a borrowed capability callback. Never double-free that snapshot; keep owned containers alive through use. Raw poses are not ready GlobalTransform values and do not automatically apply WorldOrigin/reference frame/WorldScale.

Filled-row alignment metadata: HorizontalUpward, HorizontalDownward or Vertical. Rotates no geometry and replaces no center pose; component support depends on the runtime. Errors return a MAX_ENUM sentinel, not reliable floor/wall data.

Integration guide. Eleven Windows XR-off checks covered metadata/capacity/virtual dispatch without reading unfilled memory. Real snapshots, buffer values, pose/UUID/marker decoding, headsets and export remain untested. Engine unchanged.

Declarations checked against C# SDK 1.0.0. Expand a name to see declarations and documentation.

public OpenXRSpatialComponentPlaneAlignmentList();

public OpenXRSpatialComponentPlaneAlignmentList.PlaneAlignment GetPlaneAlignment(long index);