1 | =============================== Score Input Language ===========================
|
---|
2 |
|
---|
3 | Score input commands consist of a sequence of control commands and notes,
|
---|
4 | or rests, in the form of ASCII strings.
|
---|
5 |
|
---|
6 | Control Commands:
|
---|
7 | -----------------
|
---|
8 |
|
---|
9 | !score = n make 'n' the current score and display it
|
---|
10 | !clear n clear score 'n'
|
---|
11 | !clear * clear all scores
|
---|
12 | !clear $ clear the current score
|
---|
13 |
|
---|
14 | !goto n @ m display score at beat 'n', frame 'm'
|
---|
15 |
|
---|
16 | !pos = n @ m position p_cur at beat 'n', relative frame 'm'
|
---|
17 | !beat = n position p_cur at beat 'n', relative frame 0
|
---|
18 | !frame = n position p_cur at absolute frame 'n'
|
---|
19 | !find l n position p_cur at the left of the chain at time 'n'
|
---|
20 | !find r n position p_cur at the right of the chain at time 'n'
|
---|
21 |
|
---|
22 | !weight = n set the note weight at 'n' percent
|
---|
23 |
|
---|
24 | , advance p_cur by current note value
|
---|
25 | . advance p_cur by 1 frame
|
---|
26 | ; advance p_cur to next beat
|
---|
27 | : advance p_cur by one beat interval (192 frames)
|
---|
28 |
|
---|
29 | !group = n make 'n' the current group
|
---|
30 | !status = on enable the current group
|
---|
31 | !status = off disable the current group
|
---|
32 | !inst = n select intstrument 'n' for the current group
|
---|
33 | !trans = {+|-} n transpose the current group + or - 'n' cents
|
---|
34 | !dyn = n set the current group dynamics value to 'n'
|
---|
35 | !loc = n set the current group location value to 'n'
|
---|
36 |
|
---|
37 | !tempo = n set the tempo to 'n' beats per minute (4..240)
|
---|
38 | !tuning = n select 'n' as the current tuning table
|
---|
39 | !stop stop the score clock
|
---|
40 |
|
---|
41 | !wait wait for a CR
|
---|
42 | !verbose enter verbose mode
|
---|
43 | !quiet leave verbose mode
|
---|
44 | !test enter testing mode
|
---|
45 | !normal leave testing mode
|
---|
46 |
|
---|
47 | !chase display the score chain from p_cur to the end
|
---|
48 | !show active display the active score list
|
---|
49 | !show names display the score names
|
---|
50 | !show sections display the sections
|
---|
51 | !snap display the score pointers and times
|
---|
52 |
|
---|
53 | !end end of commands
|
---|
54 | |
---|
55 |
|
---|
56 | Notes and Rests:
|
---|
57 | ----------------
|
---|
58 |
|
---|
59 | Notes are specified as follows:
|
---|
60 |
|
---|
61 | val [#] oct [+|-|/n]
|
---|
62 |
|
---|
63 | where:
|
---|
64 |
|
---|
65 | val note pitch a through g
|
---|
66 | oct note octave 0 through 9
|
---|
67 | # accidental flag
|
---|
68 | + note begin at current time
|
---|
69 | - note end at current time
|
---|
70 | /n note of length 1/n starting at current time
|
---|
71 |
|
---|
72 |
|
---|
73 | e.g.: a#0+ start a note of pitch a0
|
---|
74 |
|
---|
75 | a#0- end a note of pitch a0
|
---|
76 |
|
---|
77 | c3/4 enter a 1/4 note of pitch c3
|
---|
78 |
|
---|
79 | e7 enter a note of pitch e7 with the same value
|
---|
80 | as the previous note
|
---|
81 |
|
---|
82 |
|
---|
83 | Rests are specified as follows:
|
---|
84 |
|
---|
85 | r n / m
|
---|
86 |
|
---|
87 | where:
|
---|
88 |
|
---|
89 | n number of consecutive rests
|
---|
90 | m rest interval (1/m note)
|
---|
91 |
|
---|
92 |
|
---|
93 | e.g.: r2/1 2 whole note resets
|
---|
94 |
|
---|
95 |
|
---|
96 | Note on/off times are calculated as follows:
|
---|
97 |
|
---|
98 | noteval = 192L / QQnum;
|
---|
99 |
|
---|
100 | noteon = t_cur;
|
---|
101 |
|
---|
102 | noteoff = t_cur + ((noteper * noteval) / 100L);
|
---|
103 |
|
---|
104 | where:
|
---|
105 |
|
---|
106 | QQNum = note value default = 1/4 note (192/4)
|
---|
107 |
|
---|
108 | noteper = note weight default = 80 percent
|
---|