Advanced Input (Actions)

Action-based input lets you bind one or more keys to a named gameplay action.

Creating Actions

Use app.input.create_action(name, trigger, *keys):

import grafyte
from grafyte import InputTrigger, Key

app = grafyte.Application("Actions Example", (640, 360))

app.input.create_action("move_up", InputTrigger.Hold, Key.W, Key.Up)
app.input.create_action("move_down", InputTrigger.Hold, Key.S, Key.Down)
app.input.create_action("reset", InputTrigger.Press, Key.R)

Checking Actions

Use app.input["action_name"] to test whether the action is active:

player_y = 0.0
speed = 40.0

while not app.should_close():
    if app.input["move_up"]:
        player_y += speed * app.dt
    if app.input["move_down"]:
        player_y -= speed * app.dt
    if app.input["reset"]:
        player_y = 0.0

    app.render()

app.quit()

Available Triggers

InputTrigger.Press: active for one frame when the key is pressed
InputTrigger.Hold: active while the key remains down
InputTrigger.Release: active for one frame when the key is released

This pattern keeps gameplay code independent from the exact key layout.