summaryrefslogtreecommitdiff
path: root/doc/classes/XRController3D.xml
diff options
context:
space:
mode:
authorRémi Verschelde <rverschelde@gmail.com>2021-07-30 15:28:05 +0200
committerRémi Verschelde <rverschelde@gmail.com>2021-07-30 15:29:52 +0200
commit7adf4cc9b5de6701a41e27690a69b9892d5eed85 (patch)
tree0019e6d1b7cd993b81d5bba268074cfc4e10a213 /doc/classes/XRController3D.xml
parenta1c19b9a1e53f78c75c13cb418270db80057b21a (diff)
doc: Use self-closing tags for `return` and `argument`
For the time being we don't support writing a description for those, preferring having all details in the method's description. Using self-closing tags saves half the lines, and prevents contributors from thinking that they should write the argument or return documentation there.
Diffstat (limited to 'doc/classes/XRController3D.xml')
-rw-r--r--doc/classes/XRController3D.xml36
1 files changed, 12 insertions, 24 deletions
diff --git a/doc/classes/XRController3D.xml b/doc/classes/XRController3D.xml
index 5d8c23bd6f..47ddc22823 100644
--- a/doc/classes/XRController3D.xml
+++ b/doc/classes/XRController3D.xml
@@ -13,54 +13,45 @@
</tutorials>
<methods>
<method name="get_controller_name" qualifiers="const">
- <return type="String">
- </return>
+ <return type="String" />
<description>
If active, returns the name of the associated controller if provided by the AR/VR SDK used.
</description>
</method>
<method name="get_is_active" qualifiers="const">
- <return type="bool">
- </return>
+ <return type="bool" />
<description>
Returns [code]true[/code] if the bound controller is active. XR systems attempt to track active controllers.
</description>
</method>
<method name="get_joystick_axis" qualifiers="const">
- <return type="float">
- </return>
- <argument index="0" name="axis" type="int">
- </argument>
+ <return type="float" />
+ <argument index="0" name="axis" type="int" />
<description>
Returns the value of the given axis for things like triggers, touchpads, etc. that are embedded into the controller.
</description>
</method>
<method name="get_joystick_id" qualifiers="const">
- <return type="int">
- </return>
+ <return type="int" />
<description>
Returns the ID of the joystick object bound to this. Every controller tracked by the [XRServer] that has buttons and axis will also be registered as a joystick within Godot. This means that all the normal joystick tracking and input mapping will work for buttons and axis found on the AR/VR controllers. This ID is purely offered as information so you can link up the controller with its joystick entry.
</description>
</method>
<method name="get_mesh" qualifiers="const">
- <return type="Mesh">
- </return>
+ <return type="Mesh" />
<description>
If provided by the [XRInterface], this returns a mesh associated with the controller. This can be used to visualize the controller.
</description>
</method>
<method name="get_tracker_hand" qualifiers="const">
- <return type="int" enum="XRPositionalTracker.TrackerHand">
- </return>
+ <return type="int" enum="XRPositionalTracker.TrackerHand" />
<description>
Returns the hand holding this controller, if known. See [enum XRPositionalTracker.TrackerHand].
</description>
</method>
<method name="is_button_pressed" qualifiers="const">
- <return type="bool">
- </return>
- <argument index="0" name="button" type="int">
- </argument>
+ <return type="bool" />
+ <argument index="0" name="button" type="int" />
<description>
Returns [code]true[/code] if the button at index [code]button[/code] is pressed. See [enum JoyButton].
</description>
@@ -80,22 +71,19 @@
</members>
<signals>
<signal name="button_pressed">
- <argument index="0" name="button" type="int">
- </argument>
+ <argument index="0" name="button" type="int" />
<description>
Emitted when a button on this controller is pressed.
</description>
</signal>
<signal name="button_released">
- <argument index="0" name="button" type="int">
- </argument>
+ <argument index="0" name="button" type="int" />
<description>
Emitted when a button on this controller is released.
</description>
</signal>
<signal name="mesh_updated">
- <argument index="0" name="mesh" type="Mesh">
- </argument>
+ <argument index="0" name="mesh" type="Mesh" />
<description>
Emitted when the mesh associated with the controller changes or when one becomes available. Generally speaking this will be a static mesh after becoming available.
</description>