OpenXRSpatialComponentMarkerList

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.

Copies row payload from the same live snapshot: String/PackedByteArray for matching buffer types, otherwise Nil. Requires a successful query and MarkerType; not always QR text and not MarkerId. Validate VariantType and map allowed application identifiers rather than arbitrary paths/code.

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 OpenXRSpatialComponentMarkerList();

public Variant GetMarkerData(Rid snapshot, long index);

public uint GetMarkerId(long index);

public OpenXRSpatialComponentMarkerList.MarkerType GetMarkerType(long index);