summaryrefslogtreecommitdiff
path: root/modules/openxr/doc_classes/OpenXRInterface.xml
blob: f089fd066e57396e330ceca6bf1743c902e73d50 (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
<?xml version="1.0" encoding="UTF-8" ?>
<class name="OpenXRInterface" inherits="XRInterface" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../doc/class.xsd">
	<brief_description>
		Our OpenXR interface.
	</brief_description>
	<description>
		The OpenXR interface allows Godot to interact with OpenXR runtimes and make it possible to create XR experiences and games.
		Due to the needs of OpenXR this interface works slightly different than other plugin based XR interfaces. It needs to be initialised when Godot starts. You need to enable OpenXR, settings for this can be found in your games project settings under the XR heading. You do need to mark a viewport for use with XR in order for Godot to know which render result should be output to the headset.
	</description>
	<tutorials>
		<link title="Setting up XR">$DOCS_URL/tutorials/xr/setting_up_xr.html</link>
	</tutorials>
	<methods>
		<method name="get_available_display_refresh_rates" qualifiers="const">
			<return type="Array" />
			<description>
				Returns display refresh rates supported by the current HMD. Only returned if this feature is supported by the OpenXR runtime and after the interface has been initialized.
			</description>
		</method>
	</methods>
	<members>
		<member name="display_refresh_rate" type="float" setter="set_display_refresh_rate" getter="get_display_refresh_rate" default="0.0">
			The display refresh rate for the current HMD. Only functional if this feature is supported by the OpenXR runtime and after the interface has been initialized.
		</member>
	</members>
	<signals>
		<signal name="pose_recentered">
			<description>
				Informs the user queued a recenter of the player position.
			</description>
		</signal>
		<signal name="session_begun">
			<description>
				Informs our OpenXR session has been started.
			</description>
		</signal>
		<signal name="session_focussed">
			<description>
				Informs our OpenXR session now has focus.
			</description>
		</signal>
		<signal name="session_stopping">
			<description>
				Informs our OpenXR session is stopping.
			</description>
		</signal>
		<signal name="session_visible">
			<description>
				Informs our OpenXR session is now visible (output is being sent to the HMD).
			</description>
		</signal>
	</signals>
</class>