cml/cmtools
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

xscore_gen.md : Updated documentation.

Browse Source
This commit is contained in:
kevin 2020-08-05 11:38:41 -04:00
parent 2f85922294
commit 5ebee85b7e
1 changed files with 21 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
doc/xscore_gen.md
View File

@ -95,6 +95,8 @@ Rectangles around a number indicate sections numbers.
Sections are used to aggregate measurements and to Sections are used to aggregate measurements and to
indicate where particular transforms will be applied in the electronic score. indicate where particular transforms will be applied in the electronic score.
TODO: Show screen shot
Preparing the Music XML File Preparing the Music XML File
---------------------------- ----------------------------
@ -105,7 +107,9 @@ the [Dolet 6 Sibelius plug-in]<https://www.musicxml.com/>
After generating the file it is necessary to do some After generating the file it is necessary to do some
minor pre-processing before submitting it to *xscore_gen* minor pre-processing before submitting it to *xscore_gen*
```
iconv -f UTF-16 -t UTF-8 -o score-utf16.xml score-utf8.xml iconv -f UTF-16 -t UTF-8 -o score-utf16.xml score-utf8.xml
```
On the first line of score-utf8.xml change: On the first line of score-utf8.xml change:
@ -199,6 +203,7 @@ Onset | * | note onset
Decoration Sytax: Decoration Sytax:
------------------ ------------------
```
!<dyn_mark> Assign dynamics !<dyn_mark> Assign dynamics
!(<dyn_mark>) - less uncertain dynamic mark !(<dyn_mark>) - less uncertain dynamic mark
!<upper-case-dyn-mark> - begin of dynamic fork (See note below regarding dynamic forks) !<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
g (grace note) g (grace note)
A (after first) A (after first)
N (soon after first) N (soon after first)
```
Note: The first non-grace note in a grace note sequence is marked with a %b. Note: The first non-grace note in a grace note sequence is marked with a %b.
The last non-grace note in a grace note sequence is marked with a %s or %a. 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. @####)
Insert/delete Event Marks: <mark> Insert/delete Event Marks: <mark>
----------------------------------- -----------------------------------
d (sostenuto down - just after note onset)
u ( " up - just before this event) Mark | Note
x ( " up just before this event and down just after it) -----|--------------------------------------------------------------------------
D (damper pedal down - after this event) d | sostenuto down just after note onset
U (damper pedal up - before this event) u | sostenuto up just before this event
_ (set tie end flag) x | sostenuto up just before this event and down just after it
& (skip this event) D | damper pedal down after this event
U | damper pedal up before this event
_ | set tie end flag
& | skip this event
Dynamic Marks: <dyn-mark> Dynamic Marks: <dyn-mark>
-------------------------- --------------------------
```
s (silent note) s (silent note)
pppp- pppp-
pppp pppp
@ -268,9 +280,11 @@ Dynamic Marks: <dyn-mark>
ff ff
ff+ ff+
fff fff
```
Note: Dynamic Forks: Note: Dynamic Forks:
-------------------- --------------------
Use upper case dynamic letters to indicate forks in the dynamics Use upper case dynamic letters to indicate forks in the dynamics
which should be filled automatically. Note that all notes which should be filled automatically. Note that all notes
in the voice assigned to the first note in the fork will be in the voice assigned to the first note in the fork will be