Documentation · Naming

instrument <voice> · Name<voice> ::= … · Name<voice> Instruments

Say what the document is played on with instrument bell, or what one rule is with Bass<bass> ::= …. A use site overrides both: Bass<bell>. The tag takes no space before it, because a lone < is the descending mark.

• The voices are plain, pluck, bell, reed, bass, swell, hollow, chiptune and wobble. They are synth voices, not recordings of instruments, and they are named for the sound they make.
• chiptune is a bright square struck in a millisecond, with the vibrato a game machine puts on a held note; wobble is a saw under a low-pass swung open and shut five times a second. Those two MOVE while the note is held, and the Voices panel gives each a speed and a sweep.
• instrument <voice> is the DOCUMENT's voice from that line down, like bpm or key: it fills in every note that names nothing, and changes nothing that does. instrument none puts it back to the ordinary voice.
• A tag covers the whole expansion, like every other mark after a reference: the rules inside it play on it too, unless one of them names its own.
• A tag at a use site beats the one on the definition; the innermost tag wins.
• Write it with NO space: Tune<bell>. Tune <bell> is a descending mark, the symbol bell, and an ascending mark, which is what it has always been.
• A name the synth does not have plays on the plain voice. The Voices panel lists it as unknown, which is how a typo is found.
• It changes how a document SOUNDS and nothing else: the score, the roll and a MIDI export are unmoved.
• The panel behind the rail’s Voices button sets each voice’s attack, decay, release, level and tone. Those settings are the reader’s, kept per browser, and are not written into the document.