API Reference › Screen — drawing › Screen.status
method

Screen.status

Screen.status(text)

Sets a single persistent line of status text that the runtime displays outside your normal drawing — a lightweight HUD line for debugging or a title-bar style message. Unlike Screen.draw_text, it is not part of the framebuffer you clear and present each frame: you set it once (or whenever it changes) and it persists until you set it again. Use it for coarse status such as the current level, connection state, or a frame-rate readout while iterating. It takes a single string argument.

Parameters

textthe status line to display

Example

program StatusLine {
  var elapsed_frames: int = 0

  handler UpdateStatus phase Update {
    elapsed_frames = elapsed_frames + 1
    Screen.status(text: `frame {elapsed_frames}`)
  }

  handler DrawWorld phase Render {
    Screen.clear(Color.MidnightBlue)
    Screen.show()
  }
}
← All symbols