reckfellENGINE

OpenXRSpatialComponentBounded2DList

Spatial snapshot data: OpenXRSpatialComponentBounded2DList.

On this page
class OpenXRSpatialComponentBounded2DListReckfellSharpInherits OpenXRSpatialComponentData

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.

Center pose of a bounded region from a filled row. Raw tracking-space transform, not a game Entity GlobalTransform. Apply the chosen XR binding coordinate/scale conventions and validate state; Identity on error is no valid pose.

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.

Constructors1

OpenXRSpatialComponentBounded2DListConstructor
# OpenXRSpatialComponentBounded2DList
C#
public OpenXRSpatialComponentBounded2DList();

Creates a caller-owned RefCounted query-data container with empty buffers. Performs no QuerySnapshot and receives no device data. SetCapacity allocates without filling rows. Keep owned containers alive through native query use; do not dispose provider-owned resources.

Methods2

GetCenterPoseTransform3D
# GetCenterPose
C#
public Transform3D GetCenterPose(long index);

Center pose of a bounded region from a filled row. Raw tracking-space transform, not a game Entity GlobalTransform. Apply the chosen XR binding coordinate/scale conventions and validate state; Identity on error is no valid pose.

Parameters
NameTypeDefault
indexlong—
index

Zero-based filled-row index from the same successful snapshot query, not entity ID. Matches OpenXRSpatialQueryResultData; allocated capacity alone is insufficient.

Returns Transform3D

Center pose of a bounded region from a filled row. Raw tracking-space transform, not a game Entity GlobalTransform. Apply the chosen XR binding coordinate/scale conventions and validate state; Identity on error is no valid pose.

GetSizeVector2
# GetSize
C#
public Vector2 GetSize(long index);

Bounded2D width/height as Vector2 in runtime units, not UI pixel resolution. Requires a successful query and valid row; applies no WorldScale and creates no mesh/collider. Zero dimensions can be an error fallback rather than a detected surface.

Parameters
NameTypeDefault
indexlong—
index

Zero-based filled-row index from the same successful snapshot query, not entity ID. Matches OpenXRSpatialQueryResultData; allocated capacity alone is insufficient.

Returns Vector2

Bounded2D width/height as Vector2 in runtime units, not UI pixel resolution. Requires a successful query and valid row; applies no WorldScale and creates no mesh/collider. Zero dimensions can be an error fallback rather than a detected surface.

Reckfell Engine documentationBack to top ↑
QUICK LINKSGetting startedEntity hierarchyC# & .NET 10Scenes and prefabs
Reckfell guides and full API K
reckfellENGINE
RECKFELL ACCOUNT

Sign in

Sign in to your Reckfell account.

One account for the entire Reckfell platform.