Input

Input handles keys, mouse, named actions, and axes. It is snapshot-based, which means gameplay code reads the state captured for the current frame instead of polling the operating system directly.

Basic API

Method	Use
SetWindow(GLFWwindow *window)	connects the input backend to the window
Update()	captures the current frame snapshot
IsKeyDown()	key currently held
IsKeyJustPressed()	up-to-down transition
IsKeyJustReleased()	down-to-up transition
IsMouseButtonDown()	mouse button currently held
IsMouseButtonJustPressed()	mouse button pressed this frame
IsMouseButtonJustReleased()	mouse button released this frame
GetMousePosition()	cursor position in logical space
GetMouseWorldPosition(camera)	cursor position transformed into world space
GetMouseDelta()	cursor movement between frames

important

SetWindow() is called for you by Application. In a normal game you should not touch it unless you are building your own GLFW layer.

Keys and Mouse

Key exposes a compact selection that is enough for the engine's default bindings:

• Space
• A to Z
• Escape
• F3
• arrows: Left, Right, Up, Down

MouseButton exposes:

• Left
• Right
• Middle

Actions

Actions are logical names that group multiple keys.

Method	What it does
ClearAction(name)	removes the entire binding
AddActionBinding(name, key)	adds a key
RemoveActionBinding(name, key)	removes a key
IsActionDown(name)	checks whether any bound key is held
IsActionJustPressed(name)	checks the press transition
IsActionJustReleased(name)	checks the release transition

Default Bindings

On first use, the engine registers this automatically:

Action	Keys
accept	Space
cancel	Escape
jump	Space
interact	E
pause	Escape
debug_colliders	F3

tip

IsAction...() checks any key associated with the name. If you want rebinding, clear the action and recreate it with your own keys.

1D Axes

Method	Use
ClearAxis(name)	removes the axis
AddAxisBinding(name, negativeKey, positiveKey)	adds a negative/positive pair
RemoveAxisBinding(name, negativeKey, positiveKey)	removes a pair
GetAxis(name)	returns a value in [-1, 1]

GetAxis() sums every registered pair and then clamps the result.

2D Axes

Method	Use
ClearAxis2D(name)	removes the 2D axis
AddAxis2DBinding(name, left, right, up, down)	adds a 2D configuration
RemoveAxis2DBinding(...)	removes the configuration
GetAxis2D(name)	returns a normalized Vec2

Default Axes

Axis	Keys
move	arrows and WASD
arrows_move	arrows
wasd_move	WASD

Direction Note

GetAxis2D() uses screen-space coordinates:

• x > 0 goes right
• y > 0 goes down

That matches the engine's logical resolution and the way the demo moves entities on screen.

Mouse

GetMousePosition() returns the cursor position remapped to logical resolution. GetMouseWorldPosition(camera) converts that logical position into world space using the camera's view-projection matrix. GetMouseDelta() returns movement in window coordinates.

warning

Mouse delta and logical position do not use exactly the same space. If you mix both in your own system, it is worth checking the context carefully.

Example

const Vec2 mouseWorld = Input::GetMouseWorldPosition(GetApplication().GetCamera());
const Vec2 direction = mouseWorld - gun.Transform().GetPosition();
gun.Transform().SetRotation(Degrees(Atan2(direction.y, direction.x)));

Practical Example

const Vec2 move = Input::GetAxis2D("move");

if (Input::IsActionJustPressed("jump"))
{
    Log::Debug("jump");
}

Common Pattern

If you want to build your own control scheme, the usual flow is:

1. clear the default binding you want to replace
2. register your own keys
3. read the action or axis from gameplay code

That keeps the gameplay layer independent from any particular keyboard layout.