summaryrefslogtreecommitdiff
path: root/doc/classes/ARVRScriptInterface.xml
blob: 182147a015c5222b21b3538bc9dd8213274d2ecf (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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
<?xml version="1.0" encoding="UTF-8" ?>
<class name="ARVRScriptInterface" inherits="ARVRInterface" category="Core" version="3.0.alpha.custom_build">
	<brief_description>
		Base class for GDNative based ARVR interfaces.
	</brief_description>
	<description>
		This class is used as a base class/interface class for implementing GDNative based ARVR interfaces and as a result exposes more of the internals of the ARVR server.
	</description>
	<tutorials>
	</tutorials>
	<demos>
	</demos>
	<methods>
		<method name="_get_projection_for_eye" qualifiers="virtual">
			<return type="void">
			</return>
			<description>
				Should return the projection 4x4 matrix for the requested eye.
			</description>
		</method>
		<method name="commit_for_eye" qualifiers="virtual">
			<return type="void">
			</return>
			<argument index="0" name="eye" type="int">
			</argument>
			<argument index="1" name="render_target" type="RID">
			</argument>
			<description>
				Outputs a finished render buffer to the AR/VR device for the given eye.
			</description>
		</method>
		<method name="get_anchor_detection_is_enabled" qualifiers="virtual">
			<return type="bool">
			</return>
			<description>
				Returns true if achor detection is enabled (AR only).
			</description>
		</method>
		<method name="get_capabilities" qualifiers="virtual">
			<return type="int">
			</return>
			<description>
				Returns a combination of flags providing information about the capabilities of this interface.
			</description>
		</method>
		<method name="get_recommended_render_targetsize" qualifiers="virtual">
			<return type="Vector2">
			</return>
			<description>
				Returns the size at which we should render our scene to get optimal quality on the output device.
			</description>
		</method>
		<method name="get_tracking_status" qualifiers="virtual">
			<return type="int">
			</return>
			<description>
				If supported, returns the status of our tracking. This will allow you to provide feedback to the user whether there are issues with positional tracking.
			</description>
		</method>
		<method name="get_transform_for_eye" qualifiers="virtual">
			<return type="Transform">
			</return>
			<argument index="0" name="eye" type="int">
			</argument>
			<argument index="1" name="cam_transform" type="Transform">
			</argument>
			<description>
				Get the location and orientation transform used when rendering a specific eye.
			</description>
		</method>
		<method name="initialize" qualifiers="virtual">
			<return type="bool">
			</return>
			<description>
				Initialize this interface.
			</description>
		</method>
		<method name="is_initialized" qualifiers="virtual">
			<return type="bool">
			</return>
			<description>
				Returns true if this interface has been initialized and is active.
			</description>
		</method>
		<method name="is_stereo" qualifiers="virtual">
			<return type="bool">
			</return>
			<description>
				Returns true if we require stereoscopic rendering for this interface.
			</description>
		</method>
		<method name="process" qualifiers="virtual">
			<return type="void">
			</return>
			<description>
				Gets called before rendering each frame so tracking data gets updated in time.
			</description>
		</method>
		<method name="set_anchor_detection_is_enabled" qualifiers="virtual">
			<return type="void">
			</return>
			<argument index="0" name="enabled" type="bool">
			</argument>
			<description>
				Enables anchor detection, this is used on AR interfaces and enables the extra logic that will detect planes, features, objects, etc. and adds/modifies anchor points.
			</description>
		</method>
		<method name="uninitialize" qualifiers="virtual">
			<return type="void">
			</return>
			<description>
				Turn this interface off.
			</description>
		</method>
	</methods>
	<constants>
	</constants>
</class>