The Main Loop

Grafyte applications run inside a frame loop:

import grafyte

app = grafyte.Application("My Game", (640, 360))
scene = app.make_new_scene()
ui = app.make_new_ui()

while not app.should_close():
    app.render()

app.quit()

app.should_close() returns True when the user requests to close the window. app.render() processes window events and draws the current frame, so it must be called every iteration.

If your game uses more than one scene, keep the currently active scene in sync with your game state before rendering. The UI manager is rendered separately as screen-space overlay content, so it is a good fit for HUDs, menus, and score text.

Frame Timing

Grafyte exposes frame timing as properties:

app.dt: elapsed time since the previous frame, in seconds
app.now: current engine time, in seconds

Example:

while not app.should_close():
    elapsed = app.now
    delta = app.dt
    app.render()

Shutdown

Call app.quit() once the loop ends so native resources are released cleanly.