evaluateGenerated

Category: Creation protocol · Session

Brief

Runs one frame.

Description

Runs one frame.

Example request

{"id": 1, "op": "evaluate"}

Properties

Name	Type	Required	Description
`nodes`	`[string]`	no	evaluate only these nodes, the state and never-produced outputs
`settle`	`bool`	no	first wait for every `async` run to land
`measure`	`bool`	no	wait for the device after each node, so `timings` are the work and not its submission
`clock`	`bool`	no	time the frames on the device as they run, waiting for nothing, from this evaluation on (false stops); `device` is the latest one done, node by node
`time`	`number`	no	session time in seconds; 0 when not given
`rate`	`number`	no	the sound clock, frames a second, which Kernels read as rate()
`queued`	`number`	no	the samples (per channel) the sound device holds and has not played, which Kernels read as queued(); 0 when not given
`pointer`	`[x, y]`	no	the pointer in the output’s pixels from its top left, as a Kernel’s `pointer()` reads it
`down`	`bool`	no	whether the pointer is pressed, what `pointer_down()` reads
`buttons`	`[integer]`	no	buttons held: 0 left, 1 right, 2 middle, then a pad’s
`wheel`	`[x, y]`	no	the scroll for this frame
`sticks`	`[[x, y]]`	no	a pad’s left stick, right stick and triggers, up to three pairs
`pads`	`integer`	no	how many pads are connected, what `pads()` reads
`keys`	`[integer]`	no	keys held, by the browser’s codes
`text`	`string`	no	the characters typed since the last evaluation, what `typed()` reads; 32 at most
`window`	`[w, h]`	no	the window in pixels; else the session’s
`scale`	`number`	no	the window’s scale factor, with `window`; 1 when not given

Answer

executed, reused, committed, outputs, timings, measured, device, let_go (nodes let go to make room in the Host); in the Player, ignored (the context fields it gave, which the window’s own input stands in for) and a note