From 5d1ea92daf3eb2b9d7688b43568e8f2d0b7c0ab8 Mon Sep 17 00:00:00 2001
From: Bastiaan Olij <mux213@gmail.com>
Date: Sun, 29 Aug 2021 16:05:11 +1000
Subject: Rework XR positional trackers

---
 doc/classes/XRServer.xml | 31 ++++++++++++++++++++-----------
 1 file changed, 20 insertions(+), 11 deletions(-)

(limited to 'doc/classes/XRServer.xml')

diff --git a/doc/classes/XRServer.xml b/doc/classes/XRServer.xml
index 0929094fd1..87164ebb52 100644
--- a/doc/classes/XRServer.xml
+++ b/doc/classes/XRServer.xml
@@ -90,20 +90,21 @@
 		<method name="get_reference_frame" qualifiers="const">
 			<return type="Transform3D" />
 			<description>
-				Returns the reference frame transform. Mostly used internally and exposed for GDNative build interfaces.
+				Returns the reference frame transform. Mostly used internally and exposed for GDExtension build interfaces.
 			</description>
 		</method>
 		<method name="get_tracker" qualifiers="const">
 			<return type="XRPositionalTracker" />
-			<argument index="0" name="idx" type="int" />
+			<argument index="0" name="tracker_name" type="StringName" />
 			<description>
-				Returns the positional tracker at the given ID.
+				Returns the positional tracker with this name.
 			</description>
 		</method>
-		<method name="get_tracker_count" qualifiers="const">
-			<return type="int" />
+		<method name="get_trackers">
+			<return type="Dictionary" />
+			<argument index="0" name="tracker_types" type="int" />
 			<description>
-				Returns the number of trackers currently registered.
+				Returns a dictionary of trackers for this type.
 			</description>
 		</method>
 		<method name="remove_interface">
@@ -145,7 +146,6 @@
 		<signal name="tracker_added">
 			<argument index="0" name="tracker_name" type="StringName" />
 			<argument index="1" name="type" type="int" />
-			<argument index="2" name="id" type="int" />
 			<description>
 				Emitted when a new tracker has been added. If you don't use a fixed number of controllers or if you're using [XRAnchor3D]s for an AR solution, it is important to react to this signal to add the appropriate [XRController3D] or [XRAnchor3D] nodes related to this new tracker.
 			</description>
@@ -153,20 +153,29 @@
 		<signal name="tracker_removed">
 			<argument index="0" name="tracker_name" type="StringName" />
 			<argument index="1" name="type" type="int" />
-			<argument index="2" name="id" type="int" />
 			<description>
 				Emitted when a tracker is removed. You should remove any [XRController3D] or [XRAnchor3D] points if applicable. This is not mandatory, the nodes simply become inactive and will be made active again when a new tracker becomes available (i.e. a new controller is switched on that takes the place of the previous one).
 			</description>
 		</signal>
+		<signal name="tracker_updated">
+			<argument index="0" name="tracker_name" type="StringName" />
+			<argument index="1" name="type" type="int" />
+			<description>
+				Emitted when an existing tracker has been updated. This can happen if the user switches controllers.
+			</description>
+		</signal>
 	</signals>
 	<constants>
-		<constant name="TRACKER_CONTROLLER" value="1" enum="TrackerType">
+		<constant name="TRACKER_HEAD" value="1" enum="TrackerType">
+			The tracker tracks the location of the players head. This is usually a location centered between the players eyes. Note that for handheld AR devices this can be the current location of the device.
+		</constant>
+		<constant name="TRACKER_CONTROLLER" value="2" enum="TrackerType">
 			The tracker tracks the location of a controller.
 		</constant>
-		<constant name="TRACKER_BASESTATION" value="2" enum="TrackerType">
+		<constant name="TRACKER_BASESTATION" value="4" enum="TrackerType">
 			The tracker tracks the location of a base station.
 		</constant>
-		<constant name="TRACKER_ANCHOR" value="4" enum="TrackerType">
+		<constant name="TRACKER_ANCHOR" value="8" enum="TrackerType">
 			The tracker tracks the location and size of an AR anchor.
 		</constant>
 		<constant name="TRACKER_ANY_KNOWN" value="127" enum="TrackerType">
-- 
cgit v1.2.3