OpenXRSpatialCapabilityConfigurationAruco
ArUco configuration with a selected dictionary.
Configuration for CreateSpatialContext, not a detected Entity, tracker or OS permission. Requires the capability in a running OpenXR session. Constructor success and a selected dictionary do not mean the device detects that type. HasValidConfiguration checks current usability; context creation is separately asynchronous.
GetConfiguration returns a borrowed native pointer: neither substitute it for a RID nor retain it beyond resource lifetime. GetEnabledComponents reads selected components and can be empty before configuration building. Reading retrieves no room/marker data.
Source observation: repeated supported GetConfiguration appends Marker/Bounded2D without clearing and can duplicate entries. Use a fresh configuration for a new context instead of repeatedly probing the native getter. Not reproduced with a supported session.
Spatial-entity setup. Twelve Windows XR-off checks covered inactive configurations/dictionary metadata. Real headers/context/discovery, session changes and headsets remain untested. Engine unchanged.
Declarations checked against C# SDK 1.0.0. Expand a name to see declarations and documentation.
Constructors1
OpenXRSpatialCapabilityConfigurationArucoConstructor
public OpenXRSpatialCapabilityConfigurationAruco();Creates a caller-owned RefCounted configuration, not a capability singleton/context. Starts no OpenXR, detector or requests. The component list is empty before supported GetConfiguration; keep the resource alive during native use. Dispose owned instances after use/releasing references, not engine-owned configurations.
Properties1
ArucoDictProperty
public OpenXRSpatialCapabilityConfigurationAruco.ArucoDictEnum ArucoDict { get; set; }Selected ArUco dictionary as ArucoDictEnum. Constructor reads project setting marker_tracking/aruco_dict; current default 15 selects 7×7/1000 IDs. Setter changes configuration only; it enables no camera/capability and reconfigures no existing spatial context. Must match the printed marker and actual runtime support.
Methods3
GetArucoDictOpenXRSpatialCapabilityConfigurationAruco.ArucoDictEnum
public OpenXRSpatialCapabilityConfigurationAruco.ArucoDictEnum GetArucoDict();Selected ArUco dictionary as ArucoDictEnum. Constructor reads project setting marker_tracking/aruco_dict; current default 15 selects 7×7/1000 IDs. Setter changes configuration only; it enables no camera/capability and reconfigures no existing spatial context. Must match the printed marker and actual runtime support.
OpenXRSpatialCapabilityConfigurationAruco.ArucoDictEnumSelected ArUco dictionary as ArucoDictEnum. Constructor reads project setting marker_tracking/aruco_dict; current default 15 selects 7×7/1000 IDs. Setter changes configuration only; it enables no camera/capability and reconfigures no existing spatial context. Must match the printed marker and actual runtime support.
GetEnabledComponentslong[]
public long[] GetEnabledComponents();Copy of stored component types as long[], not marker payload. Supported GetConfiguration appends Marker and Bounded2D; empty beforehand. Current marker implementations append without clearing on repeated calls, potentially duplicating entries. Active behavior was not reproduced; create a fresh configuration for a new context instead of repeatedly probing GetConfiguration.
long[]Copy of stored component types as long[], not marker payload. Supported GetConfiguration appends Marker and Bounded2D; empty beforehand. Current marker implementations append without clearing on repeated calls, potentially duplicating entries. Active behavior was not reproduced; create a fresh configuration for a new context instead of repeatedly probing GetConfiguration.
SetArucoDictvoid
public void SetArucoDict(OpenXRSpatialCapabilityConfigurationAruco.ArucoDictEnum arucoDict);Selected ArUco dictionary as ArucoDictEnum. Constructor reads project setting marker_tracking/aruco_dict; current default 15 selects 7×7/1000 IDs. Setter changes configuration only; it enables no camera/capability and reconfigures no existing spatial context. Must match the printed marker and actual runtime support.
| Name | Type | Default |
|---|---|---|
arucoDict | OpenXRSpatialCapabilityConfigurationAruco.ArucoDictEnum | — |
arucoDictSelected ArUco dictionary as ArucoDictEnum. Constructor reads project setting marker_tracking/aruco_dict; current default 15 selects 7×7/1000 IDs. Setter changes configuration only; it enables no camera/capability and reconfigures no existing spatial context. Must match the printed marker and actual runtime support.
OpenXRSpatialCapabilityConfigurationAruco.ArucoDictEnum
| Value | Description |
|---|---|
Dict4X4100 = 2 | 4 by 4 pixel ArUco marker dictionary with 100 IDs. |
Dict4X41000 = 4 | 4 by 4 pixel ArUco marker dictionary with 1000 IDs. |
Dict4X4250 = 3 | 4 by 4 pixel ArUco marker dictionary with 250 IDs. |
Dict4X450 = 1 | 4 by 4 pixel ArUco marker dictionary with 50 IDs. |
Dict5X5100 = 6 | 5 by 5 pixel ArUco marker dictionary with 100 IDs. |
Dict5X51000 = 8 | 5 by 5 pixel ArUco marker dictionary with 1000 IDs. |
Dict5X5250 = 7 | 5 by 5 pixel ArUco marker dictionary with 250 IDs. |
Dict5X550 = 5 | 5 by 5 pixel ArUco marker dictionary with 50 IDs. |
Dict6X6100 = 10 | 6 by 6 pixel ArUco marker dictionary with 100 IDs. |
Dict6X61000 = 12 | 6 by 6 pixel ArUco marker dictionary with 1000 IDs. |
Dict6X6250 = 11 | 6 by 6 pixel ArUco marker dictionary with 250 IDs. |
Dict6X650 = 9 | 6 by 6 pixel ArUco marker dictionary with 50 IDs. |
Dict7X7100 = 14 | 7 by 7 pixel ArUco marker dictionary with 100 IDs. |
Dict7X71000 = 16 | 7 by 7 pixel ArUco marker dictionary with 1000 IDs. |
Dict7X7250 = 15 | 7 by 7 pixel ArUco marker dictionary with 250 IDs. |
Dict7X750 = 13 | 7 by 7 pixel ArUco marker dictionary with 50 IDs. |