godot-docs/classes/class_inputmap.rst

.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.

.. _class_InputMap:

InputMap
========

**Inherits:** :ref:`Object<class_object>`

**Category:** Core

Brief Description
-----------------

Singleton that manages actions.

Member Functions
----------------

+----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| void                       | :ref:`action_add_event<class_InputMap_action_add_event>`  **(** :ref:`String<class_string>` action, :ref:`Object<class_object>` event  **)**     |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| void                       | :ref:`action_erase_event<class_InputMap_action_erase_event>`  **(** :ref:`String<class_string>` action, :ref:`Object<class_object>` event  **)** |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>`    | :ref:`action_has_event<class_InputMap_action_has_event>`  **(** :ref:`String<class_string>` action, :ref:`Object<class_object>` event  **)**     |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| void                       | :ref:`add_action<class_InputMap_add_action>`  **(** :ref:`String<class_string>` action  **)**                                                    |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| void                       | :ref:`erase_action<class_InputMap_erase_action>`  **(** :ref:`String<class_string>` action  **)**                                                |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>`    | :ref:`event_is_action<class_InputMap_event_is_action>`  **(** :ref:`Object<class_object>` event, :ref:`String<class_string>` action  **)** const |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Array<class_array>`  | :ref:`get_action_list<class_InputMap_get_action_list>`  **(** :ref:`String<class_string>` action  **)**                                          |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Array<class_array>`  | :ref:`get_actions<class_InputMap_get_actions>`  **(** **)**                                                                                      |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>`    | :ref:`has_action<class_InputMap_has_action>`  **(** :ref:`String<class_string>` action  **)** const                                              |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
| void                       | :ref:`load_from_globals<class_InputMap_load_from_globals>`  **(** **)**                                                                          |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+

Member Function Description
---------------------------

.. _class_InputMap_action_add_event:

- void  **action_add_event**  **(** :ref:`String<class_string>` action, :ref:`Object<class_object>` event  **)**

Add an :ref:`InputEvent<class_inputevent>` to an action. This :ref:`InputEvent<class_inputevent>` will trigger the action.

.. _class_InputMap_action_erase_event:

- void  **action_erase_event**  **(** :ref:`String<class_string>` action, :ref:`Object<class_object>` event  **)**

Remove an :ref:`InputEvent<class_inputevent>` from an action.

.. _class_InputMap_action_has_event:

- :ref:`bool<class_bool>`  **action_has_event**  **(** :ref:`String<class_string>` action, :ref:`Object<class_object>` event  **)**

Whether an action has an :ref:`InputEvent<class_inputevent>` associated with it.

.. _class_InputMap_add_action:

- void  **add_action**  **(** :ref:`String<class_string>` action  **)**

Add an (empty) action to the :ref:`InputMap<class_inputmap>`. An :ref:`InputEvent<class_inputevent>` can then be added to this action with :ref:`action_add_event<class_InputMap_action_add_event>`.

.. _class_InputMap_erase_action:

- void  **erase_action**  **(** :ref:`String<class_string>` action  **)**

Remove an action from the :ref:`InputMap<class_inputmap>`.

.. _class_InputMap_event_is_action:

- :ref:`bool<class_bool>`  **event_is_action**  **(** :ref:`Object<class_object>` event, :ref:`String<class_string>` action  **)** const

Return whether the given event is part of an existing action. This method ignores keyboard modifiers if the given :ref:`InputEvent<class_inputevent>` is not pressed (for proper release detection). See :ref:`action_has_event<class_InputMap_action_has_event>` if you don't want this behavior.

.. _class_InputMap_get_action_list:

- :ref:`Array<class_array>`  **get_action_list**  **(** :ref:`String<class_string>` action  **)**

Return an array of InputEvents associated with a given action.

.. _class_InputMap_get_actions:

- :ref:`Array<class_array>`  **get_actions**  **(** **)**

Return an array of all actions in the :ref:`InputMap<class_inputmap>`.

.. _class_InputMap_has_action:

- :ref:`bool<class_bool>`  **has_action**  **(** :ref:`String<class_string>` action  **)** const

Whether this InputMap has a registered action with the given name.

.. _class_InputMap_load_from_globals:

- void  **load_from_globals**  **(** **)**

Clear the :ref:`InputMap<class_inputmap>` and load it anew from :ref:`Globals<class_globals>`.