InputMapImpl

Implementation class for the InputMap system.

This class provides the actual functionality for mapping physical inputs (keyboard, mouse, gamepad) to logical game actions. It supports complex input scenarios including:

• Multiple inputs bound to a single action
• Digital-to-analog conversion (e.g., WASD to movement axis)
• Analog-to-digital conversion (e.g., trigger press threshold)
• Input state tracking (pressed, just pressed, just released)
• Gamepad-specific targeting
• UI focus integration

The implementation uses an efficient index-based system to track bindings and input states, minimizing overhead during runtime input processing.

Instance Members #

Target events of a specific gamepad by setting its gamepad id. If kept to default (-1), events from any gamepad will be handled. Useful for multiplayer games where each player has their own controller.

If set to true, when binding a new input, the system will check if the input was just pressed this frame and set the initial state accordingly. This prevents immediate triggering of "just pressed" events when binding an input that's already being held down.

Set to false to disable this input map entirely. When disabled, all input queries will return false/0.0 and no events will be triggered. Useful for pausing input handling or switching between different input schemes.

Binds a keyboard key code to an action. Multiple key codes can be bound to the same action.

Gets all key codes currently bound to an action.

Removes a key code binding from an action.

Binds a keyboard key to an analog axis action. When the key is pressed, it will set the axis to the specified value. Useful for digital-to-analog conversion (e.g., WASD to movement).

Gets all key codes bound to an axis action.

Gets the axis value associated with a key code binding.

Removes a key code to axis binding.

Binds a keyboard scan code to an action. Scan codes represent physical key positions and are layout-independent.

Gets all scan codes currently bound to an action.

Removes a scan code binding from an action.

Binds a mouse button to an action.

Gets all mouse buttons currently bound to an action.

Removes a mouse button binding from an action.

Binds a gamepad button to an action.

Gets all gamepad buttons currently bound to an action.

Removes a gamepad button binding from an action.

Binds a gamepad analog axis to an axis action. The axis value will be passed through directly.

Gets all gamepad axes currently bound to an axis action.

Removes a gamepad axis binding from an axis action.

Binds a gamepad axis to a button action with a threshold. The button will be "pressed" when the axis value crosses the threshold.

Binds a button action to trigger an axis action when pressed. This allows button presses to set axis values.

Checks if an action is currently pressed (held down). Returns true for every frame while the input is held.

Checks if an action was just pressed this frame. Returns true only on the frame the input was initially pressed.

Checks if an action was just released this frame. Returns true only on the frame the input was released.

Gets the current value of an axis action. Returns 0.0 if the input map is disabled or no axis is active.

Private Members #

A way to know from which the pressed key comes from

Triggered when a mapped action is pressed (key down, button pressed, etc.). @event keyDown

Triggered when a mapped action is released (key up, button released, etc.). @event keyUp

Triggered when an analog axis value changes for a mapped action. @event axis

Metadata #