Lessons · Usage guide

Highlighting & playback

Colors, the composite, follow modes

% Every token class has a color: notes teal, drums amber, chords violet,
% and each RULE its own stable rainbow hue, kept everywhere it appears.
% Fills and sustains take the color of the symbol they extend: the '_'
% after '5' is teal, the one after '.1Min' violet. A three-bar G minor
% air, its harmony, and a light kit: all four classes sounding at once.
 
bpm 72
instrument plain
meter 4
unit 1/4
key g min
 
Air    ::= | 5 _4 '1 _2 7 _2 6 _4 5 _4 |
           | 6 _4 '1 _2 7 _2 5 _8      |
           | 4 _4 5 _2 6 _2 7# _4 5 _4 |
Chords ::= | .1Min _8 .5Maj _8 |
           | .6Maj _8 .3Maj _8 |
           | .4Min _8 .5Maj _8 |
Kit    ::= | kick - - tamb - tamb - - kick - - tamb - tamb - - |
 
{Air, Chords, Kit*3}
 
 
% Nothing prints between the lines: a project is one continuous document,
% and what a run produced is reported in the DEBUGGER TRAY along the
% bottom: the rules each block defined, the length of every production.
% Errors land there too, each naming the line to jump to, and a failed
% 'assert' is one of them. This one holds: the answer is the subject four
% SCALE steps up, so it stays in G minor instead of leaving it.
 
Theme  ::= | 1 _2 5 _2 6 _2 5 _2 3 _4 1 _4 |
Answer ::= Theme @~4
Close  ::= | 4 _2 3 _2 2 _2 .7# _2 1 _8 |
 
assert Answer == 5 _2 '2 _2 '3 _2 '2 _2 7 _4 5 _4
 
Theme Answer Close
 
 
% Press ▶ and the document is WALKED, the way a debugger walks a program:
% the block that is sounding is framed, the lines that make this instant
% light up, and the view steps along to keep them in sight. Sounding
% symbols take a gray lift with a black underline. Under a brace both
% voices light together: the ground steps every four units while the air
% above it holds one note across two of those steps.
 
Ground<bass> ::= | ..1 _4 ..5 _4 ..6 _4 ..5 _4 |
 
{Air, Ground*3}
 
 
% The tray reads the state AT THE PLAYHEAD (or at your cursor when
% nothing is playing), never at the end of the file. Its pitch strip is
% all twelve classes, spelled the way the key writes them, and a class
% lights by PITCH: 4# climbs into the dominant here and 5b falls away
% from it, and one chip lights both times: they are one black key.
 
assert 4# == 5b
 
Rise ::= | 2 _2 3 _2 4 _2 4# _2 5 _8 |
Fall ::= | 5 _2 5b _2 4 _2 3 _2 2 _4 1 _4 |
Walk<bass> ::= | ..2 _8 ..5 _8 | ..1 _8 ..6 _8 | ..5 _8 ..1 _8 |
 
{Rise Fall Close, Walk}
 
 
% Rules out of reach of the passage at the playhead dim in the gutter;
% click one and it sounds alone, as its own production with its own ▶.
% Three readings of the subject, each a separate line and so a separate
% segment: as written, reversed with its durations, then reflected around
% the key axis, its five intervals turned upside down, g held as the axis.
 
Theme
Theme~
Theme^
 
 
% The air once more with every voice it has collected, then the subject,
% its answer and the close over that same ground and pulse: two
% productions, one playhead, walking six blocks of color.
 
{Air, Chords, Ground*3, Kit*3}
{Theme Answer Close, Ground*3, Kit*3}

% Every token class has a color: notes teal, drums amber, chords violet,
% and each RULE its own stable rainbow hue, kept everywhere it appears.
% Fills and sustains take the color of the symbol they extend: the '_'
% after '5' is teal, the one after '.1Min' violet. A three-bar G minor
% air, its harmony, and a light kit: all four classes sounding at once.

bpm 72
instrument plain
meter 4
unit 1/4
key g min

Air    ::= | 5 _4 '1 _2 7 _2 6 _4 5 _4 |
           | 6 _4 '1 _2 7 _2 5 _8      |
           | 4 _4 5 _2 6 _2 7# _4 5 _4 |
Chords ::= | .1Min _8 .5Maj _8 |
           | .6Maj _8 .3Maj _8 |
           | .4Min _8 .5Maj _8 |
Kit    ::= | kick - - tamb - tamb - - kick - - tamb - tamb - - |

{Air, Chords, Kit*3}

% Nothing prints between the lines: a project is one continuous document,
% and what a run produced is reported in the DEBUGGER TRAY along the
% bottom: the rules each block defined, the length of every production.
% Errors land there too, each naming the line to jump to, and a failed
% 'assert' is one of them. This one holds: the answer is the subject four
% SCALE steps up, so it stays in G minor instead of leaving it.

Theme  ::= | 1 _2 5 _2 6 _2 5 _2 3 _4 1 _4 |
Answer ::= Theme @~4
Close  ::= | 4 _2 3 _2 2 _2 .7# _2 1 _8 |

assert Answer == 5 _2 '2 _2 '3 _2 '2 _2 7 _4 5 _4

Theme Answer Close

% Press ▶ and the document is WALKED, the way a debugger walks a program:
% the block that is sounding is framed, the lines that make this instant
% light up, and the view steps along to keep them in sight. Sounding
% symbols take a gray lift with a black underline. Under a brace both
% voices light together: the ground steps every four units while the air
% above it holds one note across two of those steps.

Ground<bass> ::= | ..1 _4 ..5 _4 ..6 _4 ..5 _4 |

{Air, Ground*3}

% The tray reads the state AT THE PLAYHEAD (or at your cursor when
% nothing is playing), never at the end of the file. Its pitch strip is
% all twelve classes, spelled the way the key writes them, and a class
% lights by PITCH: 4# climbs into the dominant here and 5b falls away
% from it, and one chip lights both times: they are one black key.

assert 4# == 5b

Rise ::= | 2 _2 3 _2 4 _2 4# _2 5 _8 |
Fall ::= | 5 _2 5b _2 4 _2 3 _2 2 _4 1 _4 |
Walk<bass> ::= | ..2 _8 ..5 _8 | ..1 _8 ..6 _8 | ..5 _8 ..1 _8 |

{Rise Fall Close, Walk}

% Rules out of reach of the passage at the playhead dim in the gutter;
% click one and it sounds alone, as its own production with its own ▶.
% Three readings of the subject, each a separate line and so a separate
% segment: as written, reversed with its durations, then reflected around
% the key axis, its five intervals turned upside down, g held as the axis.

Theme
Theme~
Theme^

% The air once more with every voice it has collected, then the subject,
% its answer and the close over that same ground and pulse: two
% productions, one playhead, walking six blocks of color.

{Air, Chords, Ground*3, Kit*3}
{Theme Answer Close, Ground*3, Kit*3}

running…edit it and it re-runs as you type

Highlighting & playback · Usage guide