summaryrefslogtreecommitdiff
path: root/doc/classes/ARVRPositionalTracker.xml
blob: 686ac1db7750543d7f9513a0c02b20839426ce69 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
<?xml version="1.0" encoding="UTF-8" ?>
<class name="ARVRPositionalTracker" inherits="Object" category="Core" version="3.0.alpha.custom_build">
	<brief_description>
		A tracked object
	</brief_description>
	<description>
		An instance of this object represents a device that is tracked such as a controller or anchor point. HMDs aren't represented here as they are fully handled internally.
		As controllers are turned on and the AR/VR interface detects them instances of this object are automatically added to this list of active tracking objects accessible through the ARVRServer
		The ARVRController and ARVRAnchor both consume objects of this type and should be the objects you use in game. The positional trackers are just the under the hood objects that make this all work and are mostly exposed so GDNative based interfaces can interact with them.
	</description>
	<tutorials>
	</tutorials>
	<demos>
	</demos>
	<methods>
		<method name="get_hand" qualifiers="const">
			<return type="int" enum="ARVRPositionalTracker.TrackerHand">
			</return>
			<description>
				Returns the hand holding this tracker, if known. See TRACKER_* constants.
			</description>
		</method>
		<method name="get_joy_id" qualifiers="const">
			<return type="int">
			</return>
			<description>
				If this is a controller that is being tracked the controller will also be represented by a joystick entry with this id.
			</description>
		</method>
		<method name="get_name" qualifiers="const">
			<return type="String">
			</return>
			<description>
				If available this returns the name of the controller or anchor point.
			</description>
		</method>
		<method name="get_orientation" qualifiers="const">
			<return type="Basis">
			</return>
			<description>
				Returns the orientation matrix of the controller.
			</description>
		</method>
		<method name="get_position" qualifiers="const">
			<return type="Vector3">
			</return>
			<description>
				Returns the position of the controller adjusted by world scale.
			</description>
		</method>
		<method name="get_tracks_orientation" qualifiers="const">
			<return type="bool">
			</return>
			<description>
				Returns true if the orientation of this device is being tracked.
			</description>
		</method>
		<method name="get_tracks_position" qualifiers="const">
			<return type="bool">
			</return>
			<description>
				Returns true if the position of this device is being tracked.
			</description>
		</method>
		<method name="get_transform" qualifiers="const">
			<return type="Transform">
			</return>
			<argument index="0" name="adjust_by_reference_frame" type="bool">
			</argument>
			<description>
				Returns the transform combining the orientation and position of this device.
			</description>
		</method>
		<method name="get_type" qualifiers="const">
			<return type="int" enum="ARVRServer.TrackerType">
			</return>
			<description>
				Type of tracker.
			</description>
		</method>
	</methods>
	<constants>
		<constant name="TRACKER_HAND_UNKNOWN" value="0">
			The hand this tracker is held in is unknown or not applicable.
		</constant>
		<constant name="TRACKER_LEFT_HAND" value="1">
			This tracker is the left hand controller.
		</constant>
		<constant name="TRACKER_RIGHT_HAND" value="2">
			This tracker is the right hand controller.
		</constant>
	</constants>
</class>