API Reference › Phases › Input
phase

Input

phase Input

Input is the first phase of every frame. The runtime polls the keyboard just before it runs, so a handler … phase Input reads the current key with Input.key() and turns it into intent — a chosen direction, a menu selection, a pause toggle — usually by writing a program var that later phases act on. Keep it to reading input and recording decisions: do the actual movement and simulation in FixedUpdate/Update, and the drawing in Render. Because it runs before FixedUpdate, Update, LateUpdate, and Render, the intent it records is visible to every phase in the same frame.

Example

program InputExample {
  const DIRECTION_LEFT: int = 0
  const DIRECTION_RIGHT: int = 1
  var facing: int = DIRECTION_RIGHT

  handler ReadControls phase Input {
    let pressed_key = Input.key()
    if pressed_key == 'a' { facing = DIRECTION_LEFT }
    if pressed_key == 'd' { facing = DIRECTION_RIGHT }
  }

  handler DrawWorld phase Render {
    Screen.clear(Color.MidnightBlue)
    var marker_x = 40
    if facing == DIRECTION_RIGHT { marker_x = 200 }
    Screen.fill_rectangle(x: marker_x, y: 100, width: 16, height: 16, color: Color.LimeGreen)
    Screen.show()
  }
}
← All symbols