Browse Source

xscore_gen.md : Updated documentation.

master
kevin 3 years ago
parent
commit
5ebee85b7e
1 changed files with 21 additions and 7 deletions
  1. 21
    7
      doc/xscore_gen.md

+ 21
- 7
doc/xscore_gen.md View File

@@ -95,6 +95,8 @@ Rectangles around a number indicate sections numbers.
95 95
 Sections are used to aggregate measurements and to 
96 96
 indicate where particular transforms will be applied in the electronic score.
97 97
 
98
+TODO: Show screen shot
99
+
98 100
 
99 101
 Preparing the Music XML File
100 102
 ----------------------------
@@ -105,7 +107,9 @@ the [Dolet 6 Sibelius plug-in]<https://www.musicxml.com/>
105 107
 After generating the file it is necessary to do some
106 108
 minor pre-processing before submitting it to *xscore_gen*
107 109
 
110
+```
108 111
 iconv -f UTF-16 -t UTF-8 -o score-utf16.xml score-utf8.xml
112
+```
109 113
 
110 114
 On the first line of score-utf8.xml change:
111 115
 
@@ -199,6 +203,7 @@ Onset     |  *   | note onset
199 203
 Decoration Sytax:
200 204
 ------------------
201 205
 
206
+```
202 207
 !<dyn_mark>             Assign dynamics
203 208
 !(<dyn_mark>)             - less uncertain dynamic mark
204 209
 !<upper-case-dyn-mark>    - begin of dynamic fork (See note below regarding dynamic forks)
@@ -216,6 +221,7 @@ $<sci_pitch>            Assign a note a new pitch
216 221
   g (grace note) 
217 222
   A (after first)
218 223
   N (soon after first)
224
+```
219 225
 
220 226
 Note: The first non-grace note in a grace note sequence is marked with a %b.
221 227
 The last non-grace note in a grace note sequence is marked with a %s or %a.
@@ -233,16 +239,22 @@ not require an explict tick mark notation (i.e. @####)
233 239
 
234 240
 Insert/delete  Event Marks: <mark>
235 241
 -----------------------------------
236
- d (sostenuto down - just after note onset)
237
- u (    "      up  - just before this event)
238
- x (    "      up    just before this event and down just after it)
239
- D (damper pedal down - after this event)
240
- U (damper pedal up - before this event)
241
- _ (set tie end flag)
242
- & (skip this event)
242
+
243
+Mark | Note
244
+-----|--------------------------------------------------------------------------
245
+ d   | sostenuto down just after note onset
246
+ u   | sostenuto up just before this event
247
+ x   | sostenuto up just before this event and down just after it
248
+ D   | damper pedal down after this event
249
+ U   | damper pedal up before this event
250
+ _   | set tie end flag
251
+ &   | skip this event
252
+
243 253
 
244 254
 Dynamic Marks: <dyn-mark>
245 255
 --------------------------
256
+
257
+```
246 258
   s       (silent note)
247 259
   pppp-
248 260
   pppp
@@ -268,9 +280,11 @@ Dynamic Marks: <dyn-mark>
268 280
   ff
269 281
   ff+
270 282
   fff
283
+```
271 284
 
272 285
 Note: Dynamic Forks:
273 286
 --------------------
287
+
274 288
 Use upper case dynamic letters to indicate forks in the dynamics
275 289
 which should be filled automatically.  Note that all notes
276 290
 in the voice assigned to the first note in the fork will be

Loading…
Cancel
Save