The compilation execute a set of instructions to create Translator or Score.
List of instructions are in Translator or Score tab, in the section Compilation
Menu Edit/Compile executes the compilation of the list of instructions.
Syntaxe is quite simple :
- one instruction per line
- A line starts with a keyword, and continues with parameters
- A line starting with # or - is ignored
List of key-words :
newGrid: quick method to create a new Score from chord list for the Translator. First line Grid nameScore tone signature creates a new Score. Next lines name_System chord|chord...creates new Systems whith chords ( cf. syntax setchord ). Last line gives the order of Systems order name_system,... , or loop name_system,... to make an infinte loop ( cf. syntax order ).
Example :
newgrid my_grid F 4/4
A F|C/Bb
B F|Bb
loop A,A,B
setGrid: same as newGrid, but does not delete existing Score
SetNote chord/event list-notes: Set the notes of the chord or the eventof the Score. Notes are seprated with comma. If the octave is not specified, the next pitch is selected ( default octave is 4 ).. Example : SetNote cell(1)/chord(1) C3,Eb,G set chord Cm with octave 3 ( C3, Eb3, G3 ) in the first chord of the first cell.
SetNote chord/event list-notes: Set the notes of the chord or the eventof the Score. Notes are seprated with comma. If the ocatve is not specified, the next pitch is selected ( default octave is 4 ).. Example : SetNote cell(1)/chord(1) C3,Eb,G set chord Cm with octave 3 ( C3, Eb3, G3 ) in the first chord of the first cell.
addNote : same as setNote, but existing notes of the Chord/event are not destroyed before.
changeNote object note newNote : replace all notes of the object with the new note, without octave criteria. Example to diminish the 5th in a celll C changeNote cell(1) G Gb
setchord system grid-chord: set a grid of chords in a system, on track 16. The grid of chords is a list of cell name (between brackets [] ) , or chord names ( e.g. G Bb ...) , with / between each beat, or | between each bar.
The syntax of cell can include a tone, a style, a program using the syntax tone*style:cell,prog:channel ( e.g. Bb*IV makes a modulation in Bb, so Mib chord. IV,5 selects program 5, to select a scale or any other option
Using =x, you can start at bar x (e.g. setchord system(1) =4|G : sets G in bar#4 )
Example :
setchord system(1)C|F//G|Dm|C set chord C on the beat#1 bar#1 and bar#4, chord F on beat#1bar#2, chord G on beat#2 bar#2, and chord Dm on beat#1 bar#3.
It is possible to modify the chord with alterations ( DM, D7sus4, ... )
reverse chord/sequence number : reverse the chord or the chords of the Sequence. Chord is sorted before to be reversed. Positive number increases the pitch of the chord. Negative number decrases the pitch. Without value, the chord is reversed "automatically". Example : reverse chord(1) 1 reverse chord C3 E3 G3 to E3 G3 C4. reverse chord(1) -1 reverse chord C3 E3 G3 to G2 C3 E3.
rotate object number : rotate object. Example : rotate note(1) 1 rotates chord C3 E3 G3 to E3 G3 C3. rotate note(1) -1 rotates chord C3 E3 G3 to G3 C3 E3.
trigger event chord mapper-element : Specify a mapper-element trigerred in a score-event. The mapper-element can contain these items, seperated with spaces : style(x),program(x), channel(x). Example : trigger 1.1 D modify or create a quarter beat#1 bar#1 which triggers the chord D of the current Style.
new object name : create new object with the name. For a System, it is possible to add signature, and key. For a Score, it is possible to add signature. Example : new cell(1) I create cell#1 with name I. new system(1) A 3+2/4 D create system#1, nammed A, with 5 beats/bar ( main beat 1 and 3 ), on D major.
rename object name : rename object
delete object : delete object
signature object x+y+z/t : set signature in a Score, System or Event. Example signature system(1) 3/4 for a waltz . signature system(1) 3+2+2/4 for 7beats/bar, and main beat on 1 3 and 5
tone object tone : set tone of a System. Example : tone system(1) Eb.
transpose object number-half-tone : transpose object
shift object number-of--degrees : transpose object with degree. Example : shift chord(1) 1 transposes chord C3 E3 G3 in D3 F3 A3 ( according degrees set in Translator )
copy object source object destination : copy object to the destination. Object destination is created or replaced. Example : copy sequence(1) sequence(2)
set Selector k1 k2 column row : Set the computer shortcuts keys k1 and k2 for the Selector, and te row/column in the window of theTranslator grid. Shortucts key k1 and k2 have same syntax as displayed in the editor, plus the value null to specify no shortcut. Example : set cell(1)/selector Shift-F1 null 3 2 puts this cell in column 3, row 2, which can be trigerred with Shift-F1.
generalize object : generalize parameters of the object to the similar objetcs with same name. Example : generalize sequence(1) to copy parameters of Sequence#1 ( except notes ) in all Sequences with same name.
propagate score|system(x) : propagate Cell chords to the Score, according to Cell triggers contained in the Events of the Score.
order list-System : set the order of systems in the Score. The list contains numbers, separated with comma. Transposition can be added to systeme number afetr a : . Same for Style number. Example : order 1,2,2,1,3 makes the order system#1 once, twice system#2, da-capo on system#1, and coda on system#3. order 1:0:1,2,2:12,1:0:2,3 does the same, but with Style#1 triggers on the beginnnig, second time of System#2 is one octave up, and da-capo uses Style#2.
loop on/off : loop of Systems on or off, to make infine da-capo at the end of the Score. Example : loop on
with object : specify object to use in the next instructions, to avoid repeating naming. Next objects concerned must not start with /. Example : with /style(1)/cell(1) specifies that all next objetcs not starting with a / will be part of cell#1 of style#1.
skip : skip instructions up to instruction resume
resume : restart execution of instruction
end : end compilation
List of objects :
score : the Score. Exemple : /score
system(x) : a System in the Score. Example : /system(1)
translator : the Translator. Example : /translator
style(x) : a Style in Translator. Example : /style(1)
cell(x) : a Cell in a Style. Example : /style(1)/cell(1), equivalent to with /style(1) and cell(1),
sequence(x) : a Sequence in a Style or a Cell
mapping(x) : an Mapper in a Style or a Cell
chord(x) : a Chord in a Cell, or a Sequence, or a Mapper, or a Selector.
note(x) : a Note in a Chord.
selector : a Selector in a System, a Style, a Cell, a Sequence, or a Mapper.
event : to specify an event in an instruction trigger. The minimum is : bar#.beat#. .Tick# (0..960 ) cab be aded. For the duration not equal to 1 beat, add :nbBeat ( add .nbTick if necessary). Example : 2.3 for a quarteron bar#2 beat#3. 2.3.480 same, but half-beat later 2.3:2 same, but for a duration of two beats.