[DOCS] Improve docs for is_action_just_pressed and is_action_just_released (#12081)

This commit is contained in:
Olli Markkanen 2017-10-14 12:30:41 +03:00 committed by Nathan Lovato
parent 688deaa1d0
commit 9876bad05c
1 changed files with 9 additions and 7 deletions

View File

@ -4,7 +4,7 @@
A Singleton that deals with inputs.
</brief_description>
<description>
A Singleton that deals with inputs. This includes key presses, mouse buttons and movement, joypads, and input actions.
A Singleton that deals with inputs. This includes key presses, mouse buttons and movement, joypads, and input actions. Actions and their events can be set in the Project Settings / Input Map tab. Or be set with [InputMap].
</description>
<tutorials>
</tutorials>
@ -75,7 +75,7 @@
<argument index="1" name="axis" type="int">
</argument>
<description>
Returns the current value of the joypad axis at given index (see JOY_* constants in [@Global Scope])
Returns the current value of the joypad axis at given index (see [code]JOY_*[/code] constants in [@Global Scope])
</description>
</method>
<method name="get_joy_axis_index_from_string">
@ -180,6 +180,7 @@
<argument index="0" name="action" type="String">
</argument>
<description>
Returns [code]true[/code] when you start pressing the action event.
</description>
</method>
<method name="is_action_just_released" qualifiers="const">
@ -188,6 +189,7 @@
<argument index="0" name="action" type="String">
</argument>
<description>
Returns [code]true[/code] when you stop pressing the action event.
</description>
</method>
<method name="is_action_pressed" qualifiers="const">
@ -196,7 +198,7 @@
<argument index="0" name="action" type="String">
</argument>
<description>
Returns true or false depending on whether the action event is pressed. Actions and their events can be set in the Project Settings / Input Map tab. Or be set with [InputMap].
Returns [code]true[/code] if you are pressing the action event.
</description>
</method>
<method name="is_joy_button_pressed" qualifiers="const">
@ -207,7 +209,7 @@
<argument index="1" name="button" type="int">
</argument>
<description>
Returns if the joypad button at the given index is currently pressed. (see JOY_* constants in [@Global Scope])
Returns [code]true[/code] if you are pressing the joypad button. (see [code]JOY_*[/code] constants in [@Global Scope])
</description>
</method>
<method name="is_joy_known">
@ -216,7 +218,7 @@
<argument index="0" name="device" type="int">
</argument>
<description>
Returns if the specified device is known by the system. This means that it sets all button and axis indices exactly as defined in the JOY_* constants (see [@Global Scope]). Unknown joypads are not expected to match these constants, but you can still retrieve events from them.
Returns [code]true[/code] if the system knows the specified device. This means that it sets all button and axis indices exactly as defined in the [code]JOY_*[/code] constants (see [@Global Scope]). Unknown joypads are not expected to match these constants, but you can still retrieve events from them.
</description>
</method>
<method name="is_key_pressed" qualifiers="const">
@ -225,7 +227,7 @@
<argument index="0" name="scancode" type="int">
</argument>
<description>
Returns true or false depending on whether the key is pressed or not. You can pass KEY_*, which are pre-defined constants listed in [@Global Scope].
Returns [code]true[/code] if you are pressing the key. You can pass [code]KEY_*[/code], which are pre-defined constants listed in [@Global Scope].
</description>
</method>
<method name="is_mouse_button_pressed" qualifiers="const">
@ -234,7 +236,7 @@
<argument index="0" name="button" type="int">
</argument>
<description>
Returns true or false depending on whether mouse button is pressed or not. You can pass BUTTON_*, which are pre-defined constants listed in [@Global Scope].
Returns [code]true[/code] if you are pressing the mouse button. You can pass [code]BUTTON_*[/code], which are pre-defined constants listed in [@Global Scope].
</description>
</method>
<method name="joy_connection_changed">