Skip to content

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).

StatementPlay headSoundSession
PLAY;Runs on from where it isPlaysKept
PAUSE;Stays where it isNotes are released; tails ring outKept
STOP;Returns to the startNotes are released; tails ring outKept
STOP; three timesAt the startCut: see belowKept
RECORD;Runs on from where it isPlays, and records armed tracksKept
SEEK n;Moves to cycle nUnchangedKept
RESET;—Everything stopsDiscarded

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.

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.