Transport
The transport statements drive the session’s play head. They are statements, not function calls, and
end with ;. In VSCode, F5, Shift+F5 and Ctrl+Shift+F5 send them
(key bindings).
| Statement | Play head | Sound | Session |
|---|---|---|---|
PLAY; | Runs on from where it is | Plays | Kept |
PAUSE; | Stays where it is | Notes are released; tails ring out | Kept |
STOP; | Returns to the start | Notes are released; tails ring out | Kept |
STOP; three times | At the start | Cut: see below | Kept |
RECORD; | Runs on from where it is | Plays, and records armed tracks | Kept |
SEEK n; | Moves to cycle n | Unchanged | Kept |
RESET; | — | Everything stops | Discarded |
In a file run the statements do the same, and the run ends after the file’s last statement, with playback.
PLAY;PAUSE;PLAY;SEEK 16;STOP;Starts playback from the play head. Cycle callbacks are run for the current cycle first, so the first cycle is not empty.
Stops playback and keeps the play head where it is. Every sounding note gets a note-off. The next
PLAY runs on from the same place.
Stops playback and returns the play head to the start. It stops the transport, not the sound: reverb and delay tails ring out, and faders stay where they are.
STOP while already stopped escalates. The third one in a row is a panic: every output fades to
silence over a few milliseconds, every instrument and effect is flushed — reverb, delay lines,
sounding voices — and every MIDI note resonon started that is still sounding gets its note-off, with
pitch bend reset to centre. Tracks, instruments and patterns are kept. The messages sent are in
MIDI Messages.
RECORD
Section titled “RECORD”Starts playback like PLAY, and records every armed track. With nothing armed it only plays. STOP
ends the take; PAUSE does not. See Record a Take.
SEEK n; moves the play head to cycle n; n is any number expression, and below 0 means 0.
While playing, playback jumps there, and cycle callbacks run for that cycle first. Notes still
sounding are released, as on PAUSE; reverb and delay tails ring on. While paused or stopped, the
next PLAY starts from there. See
Arrange a Song from Sections.
Discards the whole session — every variable, track, instrument and effect — and starts a new, empty
one. It is not a way to silence the music; three STOPs are.