class_inputeventaction.rst 3.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  3. .. DO NOT EDIT THIS FILE, but the InputEventAction.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_InputEventAction:
  6. InputEventAction
  7. ================
  8. **Inherits:** :ref:`InputEvent<class_InputEvent>` **<** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
  9. Input event type for actions.
  10. Description
  11. -----------
  12. Contains a generic action which can be targeted from several types of inputs. Actions can be created from the **Input Map** tab in the **Project > Project Settings** menu. See :ref:`Node._input<class_Node_method__input>`.
  13. Tutorials
  14. ---------
  15. - `#actions <../tutorials/inputs/inputevent.html#actions>`_ in :doc:`../tutorials/inputs/inputevent`
  16. - `2D Dodge The Creeps Demo <https://godotengine.org/asset-library/asset/515>`_
  17. - `3D Voxel Demo <https://godotengine.org/asset-library/asset/676>`_
  18. Properties
  19. ----------
  20. +-----------------------------+-----------------------------------------------------------+-----------+
  21. | :ref:`String<class_String>` | :ref:`action<class_InputEventAction_property_action>` | ``""`` |
  22. +-----------------------------+-----------------------------------------------------------+-----------+
  23. | :ref:`bool<class_bool>` | :ref:`pressed<class_InputEventAction_property_pressed>` | ``false`` |
  24. +-----------------------------+-----------------------------------------------------------+-----------+
  25. | :ref:`float<class_float>` | :ref:`strength<class_InputEventAction_property_strength>` | ``1.0`` |
  26. +-----------------------------+-----------------------------------------------------------+-----------+
  27. Property Descriptions
  28. ---------------------
  29. .. _class_InputEventAction_property_action:
  30. - :ref:`String<class_String>` **action**
  31. +-----------+-------------------+
  32. | *Default* | ``""`` |
  33. +-----------+-------------------+
  34. | *Setter* | set_action(value) |
  35. +-----------+-------------------+
  36. | *Getter* | get_action() |
  37. +-----------+-------------------+
  38. The action's name. Actions are accessed via this :ref:`String<class_String>`.
  39. ----
  40. .. _class_InputEventAction_property_pressed:
  41. - :ref:`bool<class_bool>` **pressed**
  42. +-----------+--------------------+
  43. | *Default* | ``false`` |
  44. +-----------+--------------------+
  45. | *Setter* | set_pressed(value) |
  46. +-----------+--------------------+
  47. | *Getter* | is_pressed() |
  48. +-----------+--------------------+
  49. If ``true``, the action's state is pressed. If ``false``, the action's state is released.
  50. ----
  51. .. _class_InputEventAction_property_strength:
  52. - :ref:`float<class_float>` **strength**
  53. +-----------+---------------------+
  54. | *Default* | ``1.0`` |
  55. +-----------+---------------------+
  56. | *Setter* | set_strength(value) |
  57. +-----------+---------------------+
  58. | *Getter* | get_strength() |
  59. +-----------+---------------------+
  60. The action's strength between 0 and 1. This value is considered as equal to 0 if pressed is ``false``. The event strength allows faking analog joypad motion events, by specifying how strongly the joypad axis is bent or pressed.
  61. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  62. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  63. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`