Browse Source

doc/xscore_gen.md : Updates

master
kevin 3 years ago
parent
commit
f291cecfe7
1 changed files with 19 additions and 3 deletions
  1. 19
    3
      doc/xscore_gen.md

+ 19
- 3
doc/xscore_gen.md View File

89
 Tempo + Even + Dyn  | #996633  | purple
89
 Tempo + Even + Dyn  | #996633  | purple
90
 
90
 
91
 Decrement color by one (i.e. 0xFE) to indicate the last note in a group
91
 Decrement color by one (i.e. 0xFE) to indicate the last note in a group
92
-of measured notes.  Note that a decremented color stops all active measures
93
-not just the measurement associated with the decremented color.  
92
+of measured notes.
93
+
94
+To be more precise:
95
+Decrementing a note indicates the end of a 'measurement group'.
96
+
97
+A measurement group is a set of notes marked for a measurement style
98
+(e.g. even,dynamics,tempo, even+dynamics, ... ).  A measurement
99
+section may contain multiple measurement groups - each of which is
100
+terminated by a decremented color.
101
+
102
+There is no concept of an 'end of section'.  The end of section is the
103
+same as the beginning of the next section.
104
+
105
+Note that if the terminating note of a given measurement group
106
+contains two styles then only one color needs to be decremented to end
107
+the group. For example if the terminating note is marked for both
108
+evenness and dynamics (red + blue) then decrementing either red or
109
+blue will terminate both the evenness and dynamics measurements.
94
 
110
 
95
 
111
 
96
 ### Section Numbering
112
 ### Section Numbering
112
 minor pre-processing before submitting it to *xscore_gen*
128
 minor pre-processing before submitting it to *xscore_gen*
113
 
129
 
114
 ```
130
 ```
115
-iconv -f UTF-16 -t UTF-8 -o score-utf16.xml score-utf8.xml
131
+iconv -f UTF-16 -t UTF-8 -o score-utf8.xml score-utf16.xml
116
 ```
132
 ```
117
 
133
 
118
 On the first line of score-utf8.xml change:
134
 On the first line of score-utf8.xml change:

Loading…
Cancel
Save