|
The file format being demonstrated
here is a "blueprint", and thus subject to change!
Nydana, Sweden. All rights reserved
until further notice.
|
Nydana Notation's File Format
Nydana Notation's file format allows sheet music written
in Nydana Notation to be translated into characters which
can be stored in a textfile (traditional notation is not
supported). It's not just intended to be understood by
computers, but is also adapted to humans. Anyone who
understands how it works will be able to translate sheet
music, by hand, into this new format, or vice versa. The
format could also be useful when to feed in musical symbols
in notation software applications. The file format would
also allow various notation software applications to
exchange sheet music files between them. Further editing
could be done in one of these applications before saving the
file in the application's native format. Nydana Notation's
file format is case sensitive. No default values are
assumed. Computer programs can nevertheless have default
settings which may be altered by the user.
Nydana Notation's file format simply consists of a number
of commands yielded one after another. Commands begin with a
letter or a number. Commands are generally separated by
blanks, but sometimes the blank is replaced with an
underline sign ( _ ). When commands are tied together with
an underline, they happen at the same time; that is, they
will be vertically aligned on the staff. The order in which
such associated commands are written will not have any
effect on how they should be interpreted. So, for instance,
p_q would be the same as q_p. It is, however, recommended to
always put a note/chord command first in a line of
associated commands. If a command is not associated, then
it's usually valid until the end of the measure (or until
the command is stated again, with % added directly after
it).
There are some commands that control graphical objects
that extend horizontally. The slur command is one of these.
Such commands have a colon added to show that they begin,
and a semicolon to show when they end.
Global commands begin with a capital letter and are not
specifically related to any one particular staff.
Let's begin with an example of what this format may look
like and then walk through it step by step. The example
being used is an excerpt from the musical piece which can be
downloaded from the Nydana website.
The First Three Measures of Summer Song:
Nydana/1 Title(Summer Song) Ra(W. Peterson-Berger)
Staff2(1-2) Brace(1-2) Bar(1-2)
0.1 g kb b time2h_tx(<t><>Andante con
moto</t><n><it>dolce cantando) /q 4c_p
0.2 f b time2h /q r
1.1 /q 3acf_cr: 4cfa 4fac 4acf
1.2 /h 2ff_s: 2ee
2.1 /q 5cfa_cr; /E 4acg 4acf /q 4fac 4cfa
2.2 /h 2dd 2cc
3.1 /q 4dfd /E 4dfc 4dfB /q 4df 3Bd
3.2 /h 1BB 1aa_s;
The Summer Song example step by step:
Nydana/1 Title(Summer Song) Ra(W.
Peterson-Berger)
The first command tells us that it's a Nydana file -
version 1. The second command yields the title; and the
third writes out the name of the composer. The text is
passed like an argument inside parentheses.
Staff2(1-2) Brace(1-2) Bar(1-2)
The command Staff2 means that staves with double
staffbands will be used. (1-2) tells us that staves 1-2 will
be of this kind. The next command assigns curly braces; and
the third command tells us that staves 1-2 have joined
barlines.
0.1 g kb b time2h_tx(<t><>Andante
con moto</t><n><it>dolce cantando) /q 4c_p
The 0 indicates which measure is about to be described
(here set to 0 since the measure is not a complete measure).
The number that follows after the dot is the staff number.
The treble clef is represented by g. The key signature
symbol is represented by kb. The flat staff signature is
represented by b. The time command yields the time
signature. A text command follows after that. The text is
written inside parentheses. Tags can be added in a text. The
<t> indicates a tempo text. The empty tag, <>,
is an alignment pointer. The text will thus start above the
time signature. </t> switches off the tempo text mode;
<n> is a line break; and <it> means: switch to
italic. Command /q tells us to use quarter notes. Then comes
the first note. Note and chord commands always begin with a
number. The number represents the octave in which it is
placed. The c represents the note C (the natural notes, A B
C D E F G, have small letters). Finally, p is the piano
dynamics sign. The underline sign between command 4c and p
puts the piano dynamics sign below note C4.
0.2 f b time2h /q r
Staff number 2 begins. A bass clef (f) and a flat staff
signature (b) follows, and then comes the time signature.
The note value for staff 2 is set to quarter notes. The
letter r represents a rest, and it will consequently be a
quarter rest.
And so measure number 1 begins:
1.1 /q 3acf_cr: 4cfa 4fac 4acf
The first staff begins, and after a note value
indication, a chord is written. Chords begin with a number
which tells us what octave the lowest note in the chord
belongs to. In this case it's the third octave. Then the
actual notes in the chord follow, and they are consequently
A, C and F. When they are written with lower case letters,
they represent white noteheads. The underline sign
associates the chord command with command cr, which tells us
that at the same time as the chord is written, a crescendo
wedge begins (the colon means begin). Finally, three other
chords follow.
1.2 /h 2ff_s: 2ee
Staff number two begins a new measure. The first chord
starts in octave number 2 and uses half notes. At the same
time a slur (s) begins from this chord. Yet another chord
finishes this measure.
And so the second measure begins:
2.1 /q 5cfa_cr; /E 4acg 4acf /q 4fac 4cfa
At the first chord, the crescendo wedge, which was
started in the first measure, is ended (the semicolon means
end). The note value is then set to beamed eight notes (/E)
for the two chords to follow. After two additional quarter
note chords, staff 2 is yielded:
2.2 /h 2dd 2cc
And so the third measure begins:
3.1 /q 4dfd /E 4dfc 4dfB /q 4df 3Bd
In the third and fifth chord, the note B is written with
a capital letter, yielding black noteheads for these notes.
Staff 2 shouldn't need any further explanation:
3.2 /h 1BB 1aa_s;
Nydana Notation's File Format Commands
Version
Write Nydana/1 to show that the file is compatible with
version number 1 of the format.
Measure/Staff/Part Indication
Step 1: Write the measure number. Begin with 0 if it's
the first measure and it's not a complete measure. Measures
are always yielded in numerical ascending order; either from
0 and upwards, or from 1 and upwards, without omitting any
number inbetween.
Step 2: Add a dot follwed by the staff number. Staves are
always yielded in numerical ascending order; always from 1
and upwards, without omitting any number inbetween.
Step 3: If needed, add a dot followed by a part number.
Example: 1.2.3 means measure 1, staff 2, part 3. Barlines
will be drawn automatically.
Staff Definition
Step 1: Write Staffline for a single-line staff. Write
Staff1 for a single-band staff. Write Staff2 for a
double-band staff; and so on.
Step 2: Add <s> for a small staff.
Step 3: Add the staff number(s) in parentheses. Example:
Staff1(2-3,5-6) means that staves 2 to 3, and 5 to 6, will
be single-band staves.
Brackets
Step 1: Write Bracket followed by the affected staff
numbers in parentheses. Example: Bracket(1-2,4-8) means that
staves 1 to 2 share a vertical bracket ( [ ), and staves 4
to 8 share another vertical bracket. Brackets can also
overlap. Example: Bracket(1-4,1-2,3-4)
Braces
Step 1: Write Brace followed by the affected staff
numbers in parentheses. Example: Brace(1-2,4-8) means that
staves 1 to 2 share a vertical brace ( { ), and staves 4 to
8 share another vertical brace. Braces can also overlap.
Example: Brace(1-4,1-2,3-4)
Staff Labels
Step 1: Write L followed by the staff number.
Step 2: Add the instrument name in parentheses. Example:
L1(Flute) means that Flute is written to the left of staff
1. L1-4(Strings) means that Strings is written to the left
of staves 1 to 4 (centered between staves 2 and 3).
Route
Step 1: Write Route when making changes to how staves are
arranged.
Step 2: Add, in parentheses, how staves/parts should be
routed to other staves/parts. This can, for instance, be
used for assigning which staff/part should take over a tie
when moving on to the next measure. Example: Route(1>2)
means that staff 1 is continued as staff 2.
Route(1>2,2>3) means that staff 1 continues as staff
2, and staff 2 is continued as staff 3. Route(2>2.2)
means that staff 2 becomes staff 2/part 2 in the next
measure. Write x after a staff/part that is discontinued.
Route(2>1,2x) means that staff 2 becomes staff 1, and
that staff 2 is discontinued.
Joined Barlines
Write Bar followed by the affected staff numbers in
parentheses. Example: Bar(1-2,4-8) means that staves 1 to 2,
and 4 to 8 have joined barlines.
Specific Barlines
Step 1: Write Bp to adress the latest barline of the
previous measure. Write Bn to address the beginning barline
of the next measure.
Step 2: Add d for a double barline. Add e for a double,
ending barline. Add r for a repeat bar (dots on left side
for the previous measure, and dots on the right side for the
next measure). Add i for an invisible barline. Example: Bpd
turns the latest barline of the previous measure into a
double barline.
Step 3: If needed, add the affected staves in
parentheses. Example: Bnd(1-4,6-8) means that the next
barline should be a double line for staves 1 to 4, and 6 to
8.
New Line
Write Line if the music is intended to begin on a new
line.
New Page
Write Page if the music is intended to continue on a new
page.
Staff Indentation
Step 1: Write Indent, before the next measure is about to
begin, for an arbitrary staff indentation. Write Indent0 if
there should be no indentation.
Step 2: If needed, add the desired staff indentation in
staff units (specifies how much the first line of music will
be indented in comparison to the following lines of music;
measured between points at which staff lines begin). This
command is only necessary when to override the interpreting
computer program's preset indentation. Example: Indent45
Staff Space
Write Staffdistance followed by the distance between the
previously yielded staff and the next staff, expressed in
staff units (the height of a notehead equals two staff
units) and measured between the closest staff lines of two
neighbouring staves. Example: Staffdistance35 creates a
space of 35 staff units between the staves.
Rehearsal Measure Numbers
Step 1: Write I to put the rehearsal number, according to
the file format's measure number, above the barline. Write
Ib for a rehearsal number in a box. Write Io for a rehearsal
number in an oval. Write these commands just before the
affected measure is about to be described.
Step 2: Add a number if the rehearsal number is different
from the file format's measure number. Alternatively, add a
letter or a combination of two letters, in parentheses.
Example: I10 puts rehearsal number 10 above the barline.
Ib(AB) puts AB in a box above the barline.
Volta Brackets
Step 1: Write Vb for a single volta bracket that will
embrace all staves yielded after the command, during the
next measure.
Step 2: If necessary, add a number (from 2 and up) that
describes the number of measures that the bracket should
embrace.
Step 3: Add text in parentheses.
Font Definition
Step 1: Write Font followed by a font number. This
defines a font that can be set by adding an appropriate tag
in a text. If font 0 is defined, it will be used as the
default font.
Step 2: Add the font name in parentheses. Example:
Font2(Times) means that the times font can later be set with
tag <f2>.
Font Size
Step 1: Write Fontsize followed by a font number.
Step 2: Add vertical text size in staff units (including
decimals if needed) in parentheses. Example: Fontsize2(2.3)
Dedicated Text Areas
|
Ltop
|
Mtop
|
Rtop
|
|
|
Title
|
|
|
La
|
Ma
|
Ra
|
|
Lb
|
Mb
|
Rb
|
|
Lc
|
Mc
|
Rc
|
|
|
(room for music)
|
|
|
Lx
|
Mx
|
Rx
|
|
Ly
|
My
|
Ry
|
|
Lz
|
Mz
|
Rz
|
|
Lbot
|
Mbot
|
Rbot
|
Step 1: Choose the desired text area from the table
above. The table represents the page layout.
Step 2: Add text in parentheses. Example: Title(Summer
Song) Ra(W. Peterson-Berger) Lbot(Copyright<co>Nydana)
The following example writes out a complete verse (with
its verse number to be printed to the left of the verse, and
in an upper position): Mx(<vh>2</vh>It was a
sunny morning<n>It was in early May)
A text can continue to the right, over into the next
area, if that area is not being used. Likewise, a table row
is allowed to expand downwards.
Comments
Comments are written between ___and ___ (three underline
signs in a row). Example: ___This is a comment!___
It's also possible to have more than one comment line:
___
This is
a comment!
___
Any signs can be written within a comment, except for the
combination of two or more underline signs written together.
Clefs
Step 1: Write g for a treble clef. Write f for a bass
clef.
Step 2: If needed, add a plus sign or a minus sign
followed by an octave number if it's an octave transposing
clef. Example: g+1
Step 3: Add <s> for a clef that is smaller than the
usual.
Key Signature Symbols
Step 1: Write k# for a sharp key signature symbol. Write
kb for a flat key signature symbol. Write kn for a natural
key signature symbol.
Step: If needed, add a number in the range from 2 to 7.
Example: k#3 yields a sharp sign followed by the Roman
numeral III in superscript.
Staff Signatures
Write # for a sharp staff signature. Write b for a flat
staff signature.
Time Signatures
Write time4q for a 4:4 time signature. Write time2h for a
2:2 time signature. Write time3q for a 3:4 time signature,
and so on (q = quarter note, h = half note, e = eight note,
etc). It's also possible to construct more complicated time
signatures by introducing plus signs. Example: time2+3+3q
yields 2+3+3:4. It's also possible to write double time
signatures: time3h time2h writes the two time signatures in
succession.
Note Value
The note value is valid for notes, chords and rests that
follow on the particular staff (or for an individual part on
a staff). The note value is no longer valid when a measure
has ended.
Step 1: Use one of the follwing: /g Grace note; /d Double
whole note; /w Whole note; /h Half note; /q Quarter note; /e
Eight note; /s Sixteenth note; /t 1/32; /i 1/64; /x 1/128;
/y 1/256; /z 1/512; /k 1/1024. For beamed notes, use one of
the following: /E /S /T /I /X /Y /Z /K. If beams are to be
continued from any preceding beamed notes, use one of the
following: /Ec /Sc /Tc /Ic /Xc /Yc /Zc /Kc. The vertical
positions of the beams' ends could be controlled by stem
length commands.
Example: /E 4a 4a /S 4a 4a means that the first two notes
are beamed together with one beam; and the next two notes
are beamed together with two beams; but there is no beam
between the second and third note. /S 4a 4a /S 4a 4a means
that the first two notes are beamed together with two beams;
and the next two notes are beamed together with two beams;
but there is no beam between the second and third note. /E
4a 4a /Sc 4a 4a means that the first two notes are beamed
together with one beam; and the next two notes are beamed
together with two beams; but there is also one beam
connecting the second and third note. /S 4a 4a /Sc 4a 4a
means that the first two notes are beamed together with two
beams; and the next two notes are beamed together with two
beams; but there is also one beam connecting the second and
third note.
Step 2: Add a dot for a dotted note. Add two dots for a
double dotted note, etc. Example: /E..
Notes/chords
Noteheads in a chord are analysed from bottom to top;
that is, according to how the noteheads are positioned on
the staff, regardless of pitch. The noteheads that belong to
a specific octave, range from positions C up to B.
Step 1: Begin with the octave number for a notehead (in a
chord it refers to the lowest notehead). Middle C belongs to
octave 4. The octave number always reflects the actual
sounding octave, even when all'ottava is used.
Step 2: Add a note (a b c d e f g A B C D E F G). Small
letters represent naturals. Capital letters represent
altered notes. The current staff signature, or any
accidental, will decide how it's altered.
Step 3: If needed, add a dot for a sharp accidental sign.
Add a comma for a flat accidental sign. Add x for a double
sharp sign. Add w for a double flat sign. Example: 2A.
yields A#2; 2A, yields Ab2; 2Ax yields Ax2; 2Aw yields Aw2.
Step 4: Add ' if the gap to the next notehead is more
than seven staff-steps above the previous notehead. Add ''
(write two single quotes in a row) if the gap to the next
notehead is more than 14 staff-steps above the previous
notehead, and so on. This generally means that ' will be
used when the interval between two neighbouring notes in a
chord exceeds one octave. Example: 2c'd means C2 D3, not C2
D2.
Step 5: Repeat steps 2-4 for chords.
Join Notes/Chords with Horizontal Brackets
If two noteheads in a chord occupy the same vertical
position on the staff, a second note/chord, that is to be
played on the same beat, can be added to a preceding
note/chord. The two notes/chords will be joined by a
horizontal bracket.
Write j in association with the second note/chord. The
second note/chord will thus be played at the same time as
the first note/chord. Example: 4a j_4A
Rests
Step 1: Write r for a rest sign that corresponds to the
note value being set. Write r<i> for an invisible
rest.
Step 2: Optionally, add a number for a multi-rest that
will last for as many measures as specified by the number.
Example: r3 is a multi-rest that lasts three measures.
Slurs
Step 1: Write s for a slur.
Step 2: Add tags if needed. Example: s<4a> means
that the position of the slur at this moment is the same as
that of a notehead A4 on the staff. Another example:
s<u> indicates a slur that arches upwards.
Step 3: Add : if the slur begins. Add ; if the slur ends.
Don't add anything if the command is only being used for
showing the vertical position of the slur between endpoints.
Example: 4a_s<u>: 4g_s<5b> 4c_s; is an upwards
arching slur with a vertical position B5 over note G4.
Ties
All notes (or as many as possible) in a chord will be
tied.
Step 1: Write t for a tie.
Step 2: Add tags if needed. Example: td<4a> means
that the position of the tie at this moment is the same as
that of a notehead A4 on the staff (used only with single
ties). t<d> indicates a tie that arches downwards
(used only with single ties).
Step 3: Add : if the tie begins. Add ; if the tie ends
(ties will continue to be applied to consequtive
notes/chords until the ending command is yielded). Don't add
anything if the command is only being used for showing the
vertical position of the tie between endpoints. The tie can
also be ended directly after a note/chord, without reaching
all the way to its destination. Example: 4a_t: t; 4a instead
of 4a_t: 4a_t;
Dynamics Marks
Step 1: Write p for piano. Write pp for pianissimo, and
so on. Write f for forte. Write ff for fortissimo, and so
on. Write mf for mezzoforte. Write sf for sforzando. Wite
sfp for sforzandopiano. Write sfz for sforzato. Write fz for
forzando/forzato. Write rf for rinforzando. Write rfz for
rinforzato. Write fzp for forzatopiano. Other options: ffz,
fffz, ffffz, sff, sfff, sffff.
Step 2: If needed, add a vertical position tag. Example:
4a_p<2a>
It is also possible to write the dynamics mark in a text
message (cf. tag <cd>). Example:
4a_tx(<!>f</!> subito) writes f subito, with f
displayed in its appropriate font.
Crescendo and Diminuendo
Step 1: Write cr for a crecendo wedge. Write di for a
diminuendo (decrescendo) wedge.
Step 2: If needed, add tags. Example: cr<4a> means
that the position of the wedge at the moment is the same as
that of a notehead A4 on the staff. The vertical position
should normally only be yielded for the beginning command
unless the wedge is actually tilted. The vertical ending
position for a crescendo wedge, or the vertical starting
position for a diminuendo wedge, refers to a point centered
between wedge lines.
Step 3: Add : if the wedge begins with the associated
note/chord. Add ; if the wedge ends with (and includes) the
associated note/chord. Example: 4a_cr: 4b_cr;
General Purpose Text
Step 1: Write tx for a general purpose text.
Step 2: Add the text in parentheses.
Step 3: If needed, add tags. Example:
4a_tx(molto)<a>_tx(forte)<b> places molto above
note A4 and forte below the same note.
Stretched Text
Step 1: Write ts for a stretched text. Dashes will be
added automatically between the segments of a phrase.
Step 2: If needed, add an id number (2 or higher) after
ts if more than one stretched text is to appear
simultaneously.
Step 3: If needed, add tags.
Step 4: Add : if it is the beginning of the stretched
text. Add ; if it is the end of the stretched text.
Example: 4a_ts(es): 4b_ts(press) 5c_ts(ivo); means that
the text is stretched out between notes A4, B4 and C5; like
this: es - press - ivo. Another example:
4a_ts(espress):_ts2(rall): 4b_ts(ivo);_ts2(entando); means
that espress - ivo and rall - entando begin and end
simultaneously.
Chord Symbol
Write c followed by the chord symbol text in parentheses.
Example: c(F#<mj>) yields F#maj7, where maj7, however,
is replaced with a triangle.
Tag <v> is used for compound chords written on two
rows with a horizontal divider line. Example:
c(C<v>Dm) puts C over Dm.
Lyrics
Step 1: Write w for words. Dashes will be inserted
automatically when necessary.
Step 2: If needed, add a verse number (from 2 and up).
Step 3: Add the text in parentheses. Example: 4a_w(hello)
writes hello below note A4.
Step 4: Add : if it is the beginning of a word. Add ; if
it is the end of a word. Example: 4a_w(so): 4b_w(lo)
5c_w(ist); writes so - lo - ist below the notes. Another
example: 4a_w2(so): 4b_w2; writes so---- (in a second verse)
below the notes.
More than one verse number can share the same text.
Example: w2-3(evening) means that the word evening is shared
by verses 2 to 3, and is thus only written once, and
inbetween line 2 and 3.
Wavy Line Arpeggio
Write ar for a vertical wavy arpeggio line. Write au for
a vertical wavy arpeggio line that is specifically marked to
be upwards directed. Write ad for a vertical wavy arpeggio
line that is specifically marked to be downwards directed.
Write aa for a vertical wavy arpeggio line that is to be
joined with the arpeggio on the staff above. Write ab for a
vertical wavy arpeggio line that is marked to be downwards
directed, and that is to be joined with the arpeggio on the
staff above. Example: 4abc_ar
Straight Line Arpeggio
Write ru for a straight vertical arpeggio line with an
upwards pointing arrow. Write rd for a straight vertical
arpeggio line with a downwards pointing arrow. Write ra for
a straight vertical arpeggio line that is to be joined with
the arpeggio line on the staff above. Write rb for a
vertical arpeggio line with a downwards pointing arrow, and
that is to be joined with the arpeggio on the staff above.
Example: 4abc_ru
Tremolo Bars On a Stem
Write tm followed by a number to put as many tremolo bars
on the stem of a note as the number indicates. Example:
4a_tm3 puts three tremolo bars on the stem of note A4.
The associated command is only valid once. If not
associated, the command is valid until the end of the
measure, or until a % is added after the command.
Tremolo Bars Between Stems
Step 1: Write tm followed by a number to assign as many
tremolo bars as the number indicates.
Step 2: Add : if the tremolo bars begin from the
associated note/chord. Add ; if the tremolo bars end at the
associated note/chord. Example: 4a_tm2: 4b_tm2; puts two
tremolo bars between notes A4 and B4.
When needed, tx(trem.) or tx(non trem.) could be added in
a separate text command.
Flageolets
Step 1: Write fo for a flageolet circle.
Step 2: If needed, add tags. Example: 4a_sq<b>
indicates a flageolet sign below note A4.
The associated command is only valid once. If not
associated, the command is valid until the end of the
measure, or until a % is added after the command.
Accents
Step 1: Write ma for marcato (>). Write as for a
strong accent (^). Write mt for martelato (v). Example:
4a_ma adds a marcato sign to note A4.
Step 2: If needed, add tags. Example: 4a_ma<5c>
adds a marcato sign to note A4, placed at vertical position
C5.
The associated command is only valid once. If not
associated, the command is valid until the end of the
measure, or until a % is added after the command.
All'ottava
Step 1: Write ao for All'ottava. Write ob for ottava
bassa.
Step 2: If needed, add the number of octaves (from 2 and
up).
Step 3: If needed, add tags. Example: oa<4a> means
that the position of the dashed all'ottava line at this
moment is the same as that of a notehead A4 on the staff.
The position should only be yielded for the beginning
command.
Step 4: Add : if the all'ottava or ottava bassa begins.
Add ; if the all'ottava or ottava bassa ends. Example:
4a_ao2<5c>: 4b_ao2;
Trills
Step 1: Write tr for a trill. The command should be
associated with a trill note. Example: 4a_tr
Step 2: If needed, add tags. Example: tr<4a> means
that the position of the trill sign at this moment is the
same as that of a notehead A4 on the staff. The vertical
position should not be yielded for an ending command. The
vertical position indication refers to the center of the
trill sign.
Step 3: Add : if a wavy line should begin after the trill
sign. Add ; if the wavy line ends.
The Trill's Alternating Note
Step 1: Write tf for the alternating note of a trill (the
alternating note will be written as a stemless notehead
inside parentheses). The trill note command and the trill's
alternating note command should not be associated with an
underline. A complete example: 4e_tr 4f_tf
Glissando Lines
Step 1: Write gi for glissando line(s). All notes (or as
many as possible) in a chord will have glissando lines.
Step 2: If needed, add an associated text in parentheses
(only needed for the beginning command).
Step 3: Add : if the line(s) begin. Add ; if the line(s)
end. Example: 4a_gi(gliss.): 4b_gi;
Dotted Line
Step 1: Write dt for a dotted line.
Step 2: If needed, add an associated text in parentheses
(only needed for the beginning command).
Step 3: Add : if the dotted line begins. Add ; if the
dotted line ends. Example: 4a_dt: 4b_dt;
Wavy Line
Step 1: Write wa for a wavy line.
Step 2: If needed, add an associated text in parentheses
(only needed for the beginning command).
Step 3: Add : if the wavy line begins. Add ; if the wavy
line ends. Example: 4a_wa(shake): 4b_wa;
Tuplets
Step 1: Write n for tuplets (nested tuplets are also
possible).
Step 2: Add a tuplet number. Do not add a number if the
tuplet number should be invisible (the latest yielded tuplet
number will be automatically assumed).
Step 3: If needed, add tags. Example: n3<4a> means
that the position of the tuplet bracket at this moment is
the same as that of a notehead A4 on the staff.
Step 4: Add : if the tuplet begins. Add ; if the tuplet
ends. Example: 4a_n3: 4a 4a_n3;
Various Signs
Step 1: Write co for Coda. Write fi for Firmata. Write se
for Segno. Write cs for Caesura (&). Write gp for a
grand pause (//). Write sm for single simile mark (. /.).
Write sm2 for a double simile mark (. //.). Write mo for a
mordent. Write mi for an inverted mordent. Write tu for a
turn. Write tv for a turn with a vertical line in the
middle.
Step 2: If needed, add tags. For example, add a vertical
position tag: co<4a>
It is also possible to write the above signs as tags in
text messages (cf. tag <!>). Example: 4a_tx(D.C. al
<!>co</!> e poi la Coda) writes da capo al,
follwed by the actual Coda sign, followed by e poi la Coda.
The associated command is only valid once. If not
associated, the command is valid until the end of the
measure, or until a % is added after the command.
Instrument Specific Signs
Step 1: Write pz for a left hand pizzicato (+). Write ps
for a snap pizzicato. Write bo for Bouché (+). Write
ou for Ouvert (o). Write ub for Sull'arco = up bow (V).
Write db for Giù arco = down bow. Example: 4a_db
gives note A4 a down bow sign.
Step 2: If needed, add tags. For example, add a vertical
position tag: pz<4a>
The associated command is only valid once. If not
associated, the command is valid until the end of the
measure, or until a % is added after the command.
Staccato
Write st for a staccato dot. Example: 4a_st. Write si for
a staccatissimo wedge. Example: 4a_si.
The associated command is only valid once. If not
associated, the command is valid until the end of the
measure, or until a % is added after the commmand.
Tenuto/Portamento
Write te for a tenuto dash. Example: 4a_te.
The associated command is only valid once. If not
associated, the command is valid until the end of the
measure, or until a % is added after the command.
Piano Pedal Marks
Step 1: Write pd for a piano pedal mark.
Step 2: Add : if the sostenuto pedal is depressed (a line
will follow after the pedal mark). Add ; if the sostenuto
pedal is released. Write rd between a pd: and a pd; for a
release/depress. Example: 4a_pd: rd 4b_pd;
Dashed Barline
Write bd for a dashed barline.
Microtonal Signs
Step 1: Write u for a microtonal up sign (>). Write d
for a microtonal down sign (<). All notes in a chord are
affected if step 3 is not followed through.
Step 2: If needed, add a number representing the number
of signs (not necessary if just one sign is desired). The
number can also have decimal 5 added (after a dot) if the
half-comma sign is desired. Example: u_4a raises note A4 one
comma (=23 cents). d0.5_4a lowers note A4 by half a comma.
d3_4a lowers note A4 three commas. u2.5_4a raises note A4 by
two and a half comma.
Step 3: If needed, add index numbers in parentheses if
individual noteheads in a chord are targeted. Example:
4abcde_u(1-3,5) means that notes A4, B4, C5 and E5 are
raised one comma.
The associated command is only valid once. If not
associated, the command is valid until the end of the
measure, or until a % is added after the command.
Asterisks
Step 1: Write a for an asterisk. All notes in a chord are
affected if step 2 is not followed through. Example: 4a_a
means that note A4 gets an asterisk.
Step 2: If needed, add index numbers in parentheses if
individual noteheads in a chord are targeted. Example:
4abcde_a(1-3,5) means that notes A4, B4, C5 and E5 get
asterisks. Define what the asterisk means in a separate text
command, like so: tx(*1<dm>)
The associated command is only valid once. If not
associated, the command is valid until the end of the
measure, or until a % is added after the command.
Fingering Numbers
For single notes: Write v followed by the finger number
that the note will get. Associate with a note. Example:
4a_v3 means that finger number 3 will be applied to note A4.
Use two finger numbers separated by a plus sign for finger
switches. Example: 4a_v2+3 means that note A4 gets finger
numbers 2 and 3, with a small tie between the numbers.
For chords: Write v followed by the finger numbers one
after another (0 = circle with small wedge). Example:
4abc_v234 means that A4 gets finger number 2, B4 gets finger
number 3, and C5 gets finger number 4. Write * instead of a
finger number if no finger number is to be yielded for a
particular note in a chord. Example: 4abc_v2*4 will not give
a finger number to note B4. Use two finger numbers separated
by a plus sign for finger switches. The two numbers will be
assigned to a single note in the chord. Example: 4ab_v23+4
means that note A4 gets finger number 2, and note B4 gets
finger numbers 3 and 4, with a small tie between the
numbers.
Parenthesized Noteheads
For single notes: Write pa in association with a note
command. Example: 4a_pa means that note A4 will be written
inside parentheses.
For chords: Write pa followed by numbers representing the
affected notes, in parentheses, separated by commas.
Example: 4abc_pa(1,2) means that notes A4 and B4 will be
parenthesized.
Horizontal Brackets
Step1: Write sq for a (square) horizontal bracket.
Step2: If needed, add an id number (2 or higher) when
more than one bracket is used simultaneously.
Step 3: If needed, add an associated text in parentheses
(only necessary for the beginning command).
Step 4: If needed, add tags. Example: 4a_sq<b>
indicates a bracket below note A4.
Step 5: Add : if the bracket begins. Add ; if the bracket
ends. Example:
4a_sq(dolce)<b>:_sq2(cantando)<a>: 4b_sq;_sq2;
puts a horizontal bracket above notes A4 and B4 with text
dolce, and also a horizontal bracket below the same notes
with text cantando.
Flex Notes
Step 1: Write fx for a flex note. Example: 4ceg fx
Step 2: If needed, add a number that tells how many flex
notes are desired. Example: 4ceg fx3 is the same as 4ceg fx
fx fx
Repeat the Latest Command
Step 1: Write x to repeat the latest command.
Step 2: If needed, add a number that describes how many
times the command should be repeated. Example: 4ceg x3 is
the same as 4ceg 4ceg 4ceg 4ceg
Transfer Up Function
Step 1: Write up to transfer a note (or all notes in a
chord) to the next staff above. Example: 4a_up puts note A4
on the next staff above (in a system of staves).
Step 2: If needed, add a number if a maximum number of
notes should be transferred up. Example: 4abc_up2 puts notes
B4 and C5 on the next staff above.
The associated command is only valid once. If not
associated, the command is valid until the end of the
measure, or until a % is added after the command.
Transfer Down Function
Step 1: Write dn to transfer a note (or all notes in a
chord) to the next staff below. Example: 2a_dn puts note A2
on the next staff below (in a system of staves).
Step 2: If needed, add a number if a maximum number of
notes should be transferred down. Example: 2abc_dn2 puts
notes A2 and B2 on the next staff below.
The associated command is only valid once. If not
associated, the command is valid until the end of the
measure, or until a % is added after the command.
Ledger Band Control
Step 1: Write b followed by an octave number (the octave
number is always the actual sounding octave).
Step 2: Add : if the ledger band should begin. Add ; if
the ledger band should end. Example: 4a_b2: means that a
ledger band begins with the associated note. 4a_b2 lets the
note have a short ledger band of its own.
Stem Control
Step 1: Write hu for an upwards directed stem. Write hd
for a downwards directed stem. Example: 4a_hu means that the
stem of note A4 is upwards directed.
Step 2: If needed, add a number that represents the
desired staff length in staff units. Example: 4a_hu12 means
that note A4 will have an upwards directed stem with a staff
length that equals 12 staff units.
The associated command is only valid once. If not
associated, the command is valid until the end of the
measure, or until a % is added after the command.
The stem length will be applied to the first and last
note/chord in a group of beamed notes/chords. For beams, the
stem is said to end at the midth of the beam. If there is
more than one beam, then it's the beam that is the most
distant from the associated notehead(s) that counts. For
whole notes, half notes and double whole notes, the stem is
said to end at a level where also the curved parts of the
stem are included.
Tags
Tags are written inside angular parentheses (cf. html)
and can be part of a command. Tags are also sometimes
inserted in a text. For example, <*4> will yield a
quarter note (notes inserted in a text like this will be
written with solid black noteheads). A font, being defined
with command Font, can be invoked like this: <f2>.
Tags inserted in a text are no longer valid when the text
(or stretched text) has been completed. The empty tag,
<>, points to where an associated note/chord/rest etc
will be situated in relation to the text (if not used, then
the text will be centered around an associated
note/chord/rest). Write a slash to reset a tag that has been
inserted in a text. For example, to reset italic, write
</i>.
Describing vertical positions of signs etc is not
necessary in this file format, but is often possible by
using tags. For example, if <4a> is added to a
command, it indicates the same vertical position as that of
a notehead being written as 4a in this file format. For
signs, the vertical position indication refers to the center
of the smallest rectangle which encloses a sign. If a dot
follows a vertical position number, it means that the object
is moved upwards by half a staff unit (a staff unit equals
half the height of a notehead). For example, to place a sign
exactly in the middle of a double band staff equipped with a
treble clef, write <4b.>. Conversely, a comma sign
will lower an object by half a staff unit. Thus, <5c,>
is equal to <4b.>. Capital letters are not used in
tags. For octave positions lower than 0, a minus sign can be
used. A position for the note A, one octave below octave 0,
could thus be written <-1a>. Please note that clefs
and all'ottava will alter how vertical positions relate to
the staff.
The total length tag indicates (in staff units) the
aquired length at the point where the tag is inserted. Total
length tags can thus be yielded several times in a text to
show the total length being reached at various points.
In order to leave, for example, 15 staff units of space
horizontally to the next occurence of a graphical object
(like a note, for instance), write for exampe: 4a<15>
4b which leaves 15 staff units of space between the two
notes.
It is sometimes meaningful to have a command inside a
text. It makes it possible to integrate various signs or
dynamics marks in texts. For example: tx(D.C. al
<!>co</!> e poi la Coda) inserts the actual Coda
sign that the command co yields, in the text.
|
<>
|
center is here
|
<!>
|
use command
|
|
<20>
|
20 staff units of space
|
<4a> or <3g.> etc
|
vertical position
|
|
<=30>
|
total length in staff units
|
<n>
|
line break
|
|
<i>
|
make invisible
|
<ce>
|
text centered
|
|
<co>
|
copyright sign
|
<ga>
|
text adjusted left
|
|
<at>
|
at sign
|
<dr>
|
text adjusted right
|
|
<+>
|
right
|
<sm>
|
straight margins
|
|
<->
|
left
|
<sp>
|
superscript
|
|
<+2>
|
two staff units right etc
|
<sb>
|
subscript
|
|
<-2>
|
two staff units left etc
|
<bo>
|
bold
|
|
<as>
|
above staff
|
<it>
|
italic
|
|
<bs>
|
below staff
|
<un>
|
underline
|
|
<a>
|
above
|
<)>
|
)
|
|
<b>
|
below
|
<(>
|
(
|
|
<u>
|
up
|
<si>
|
<
|
|
<d>
|
down
|
<de>
|
>
|
|
<s>
|
small
|
<mj>
|
maj7 triangle
|
|
<t>
|
tempo text
|
<dm>
|
dim7 circle
|
|
<v>
|
compound chord divider
|
<ne>
|
not equal sign
|
|
<f2> or <f14> etc
|
set a font
|
<vy>
|
write vertically
|
|
<vh>
|
verse-number header
|
<sc25>
|
scale to 25%
|
|
<*d>
|
double whole note
|
<*i>
|
1/64 note
|
|
<*w>
|
whole note
|
<*x>
|
1/128 note
|
|
<*h>
|
half note
|
<*y>
|
1/256 note
|
|
<*q>
|
quarter note
|
<*z>
|
1/512 note
|
|
<*e>
|
eight note
|
<*k>
|
1/1024 note
|
|
<*s>
|
sixteenth note
|
<.>
|
note value dot
|
|
<*t>
|
1/32 note
|
<ti>
|
tie
|
|