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,8 +89,24 @@ Dyn   + Tempo       | #FF7F00  | red   + green (brown)
89 89
 Tempo + Even + Dyn  | #996633  | purple
90 90
 
91 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 112
 ### Section Numbering
@@ -112,7 +128,7 @@ After generating the file it is necessary to do some
112 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 134
 On the first line of score-utf8.xml change:

Loading…
Cancel
Save