viscosity/engine/modules/openxr/doc_classes/OpenXRSpatialMarkerTrackingCapability.xml

66 lines
4.1 KiB
XML

<?xml version="1.0" encoding="UTF-8" ?>
<class name="OpenXRSpatialMarkerTrackingCapability" inherits="OpenXRExtensionWrapper" api_type="core" experimental="" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../doc/class.xsd">
<brief_description>
Implementation for handling spatial entity marker tracking logic.
</brief_description>
<description>
This class handles the OpenXR marker tracking spatial entity extension.
</description>
<tutorials>
</tutorials>
<methods>
<method name="do_entity_update">
<return type="void" />
<param index="0" name="spatial_context" type="RID" />
<param index="1" name="component_data" type="OpenXRSpatialComponentData[]" />
<param index="2" name="next_snapshot_create" type="OpenXRStructureBase" default="null" />
<param index="3" name="next_snapshot_query" type="OpenXRStructureBase" default="null" />
<description>
Calls [method OpenXRSpatialEntityExtension.update_spatial_entities] and [method OpenXRSpatialEntityExtension.query_snapshot] with the marker entities associated with [param spatial_context].
[param component_data] are the [OpenXRSpatialComponentData]s to update for this marker capability.
If [param next_snapshot_create] is non-null, then pass this to the [code]next[/code] parameter in [method OpenXRSpatialEntityExtension.update_spatial_entities].
If [param next_snapshot_query] is non-null, then pass this to the [code]next[/code] parameter in [method OpenXRSpatialEntityExtension.query_snapshot].
</description>
</method>
<method name="is_april_tag_supported">
<return type="bool" />
<description>
Returns [code]true[/code] if April tag marker tracking is supported by the current device.
</description>
</method>
<method name="is_aruco_supported">
<return type="bool" />
<description>
Returns [code]true[/code] if Aruco marker tracking is supported by the current device.
</description>
</method>
<method name="is_micro_qrcode_supported">
<return type="bool" />
<description>
Returns [code]true[/code] if micro QR code marker tracking is supported by the current device.
</description>
</method>
<method name="is_qrcode_supported">
<return type="bool" />
<description>
Returns [code]true[/code] if QR code marker tracking is supported by the current device.
</description>
</method>
<method name="start_entity_discovery">
<return type="OpenXRFutureResult" />
<param index="0" name="spatial_context" type="RID" />
<param index="1" name="component_data" type="OpenXRSpatialComponentData[]" />
<param index="2" name="next_snapshot_create" type="OpenXRStructureBase" default="null" />
<param index="3" name="next_snapshot_query" type="OpenXRStructureBase" default="null" />
<param index="4" name="user_callback" type="Callable" default="Callable()" />
<description>
Calls [method OpenXRSpatialEntityExtension.discover_spatial_entities] and [method OpenXRSpatialEntityExtension.query_snapshot] with the marker entities associated with [param spatial_context].
[param component_data] are the [OpenXRSpatialComponentData]s to discover for this marker capability.
If [param next_snapshot_create] is non-null, then pass this to the [code]next[/code] parameter in [method OpenXRSpatialEntityExtension.discover_spatial_entities].
If [param next_snapshot_query] is non-null, then pass this to the [code]next[/code] parameter in [method OpenXRSpatialEntityExtension.query_snapshot].
[param user_callback], when non-null, is called with two parameters usually twice. The first parameter is the [RID] of the discovery snapshot and the second parameter is a boolean where [code]false[/code] indicates the discovery snapshot is about to be processed, and [code]true[/code] indicates the discovery snapshot has been processed and [param component_data] has valid data. The second call is skipped if an error was encountered.
The returned [OpenXRFutureResult] is identical to the return from [method OpenXRSpatialEntityExtension.discover_spatial_entities].
</description>
</method>
</methods>
</class>