X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~mdw/git/mup/blobdiff_plain/cdb3c0882392596f814cf939cbfbd38adc6f2bfe..ddf6330b56bcfb657e0186b24b9b1422c51d3424:/mup/docs/uguide/noteattr.html diff --git a/mup/docs/uguide/noteattr.html b/mup/docs/uguide/noteattr.html new file mode 100644 index 0000000..d88e8d1 --- /dev/null +++ b/mup/docs/uguide/noteattr.html @@ -0,0 +1,196 @@ + + +Note attributes + + +

+   <-- previous page + +     Table of Contents    next page --> +

+ +

+Note attributes +

+

+There are several optional attributes that can be specified for each note. +Any or all of these may appear on any note in any order +after the +letter, +accidental, +and +octave specifications. +They include: +

+

+

+Small note head +

+

+A note specification can be followed by a "?" +to indicate the note is to be printed with a small note head, +rather than the normal +size. (Note: if you have several notes in a chord and want all of them to +be small, +the "cue" construct, described later, +may be preferable.) +

+

+Examples: +

+// print the "e" as a small note
+1: 1c e? g;
+bar
+
+// make the second note small
+1: f; ?; g; ;
+bar
+

+Picture of Mup output
+

+

+Note tie +

+

+A "~" can be used to indicate the note is to be tied +to the note of the same +pitch in the following chord. That following chord need not be in the same +measure, but it must contain a matching note. +(Note: if a chord with several notes is to have all the notes tied +to the following chord, +the "tie" construct +described later may be preferable.) +The ~ may be preceded by the word 'dotted' or 'dashed' if you want +a dotted or dashed tie; otherwise a normal, solid tie is drawn. +The ~ may be followed by the word 'up' or 'down' to specify the +direction for the curve's bulge. If neither is specified, Mup will +determine an appropriate direction, so you only need to give a direction +if you wish to override Mup's choice. +

+

+Examples +

+1: d~; 8; e~; ; f;
+bar
+
+// tie the g (which also happens
+// to be a "small" note)
+1: 2g+g?~; 4eg?;
+bar
+

+Picture of Mup output
+

+

+Slurs +

+

+A note can also be followed by a list of notes to be slurred to, +enclosed in angle brackets. +A slur will be drawn from the note to each of the notes +listed in the angle brackets. The notes inside the brackets +are specified by a pitch and optional octave. No +accidentals +are specified, even if the note to be slurred +to has an accidental. Examples: +

+// slur from c of first chord to e of second chord
+1: c<e>; e; f; g;
+bar
+
+// slur from c+ of first chord to a& of second chord
+// and from c+ of first chord to d&+ of second chord
+1: 2cc+<ad+>; a&d&+;
+bar
+

+Picture of Mup output
+

+

+If there is only one note in the following chord, it isn't necessary to +explicitly state it within the angle brackets; "<>" will suffice. +

+// slur from c to d, and f to g
+1: c<>; d; f<>; g;
+bar
+

+Picture of Mup output
+

+

+The < may be preceded by the word 'dotted' or 'dashed' if you want +a dotted or dashed slur, otherwise a normal, solid slur is drawn. +The > may be followed by the word 'up' or 'down' to specify the +direction for the curve's bulge. If neither is specified, Mup will +determine an appropriate direction, so you only need to give a direction +if you wish to override Mup's choice. +

+

+There are four special "slurs" which are really slides to/from an +indefinite note. They are most commonly used on +tablature staffs, +but are allowed on ordinary staffs too. +They are: </n> <\n> <n/> and <n\> for sliding upward into the note, +downward into the note, upward out from the note, and downward out from +the note respectively. These have to be in angle brackets by themselves, +so if you want to have both one of these slides and another slur on the +same note, multiple sets of angle brackets must be used, as in +

+1: 2c</n><d>;d;
+

+

+

+Head shape +

+

+Sometimes you may want to mix head shapes on a single stem. +For example, you might want to use a diamond to designate a harmonic, +with other notes in the same chord being normal shape. +There is an entire +section on head shapes, +so only a simple example is given here. +To make a single note have a different head shape, +use hs followed by the name of the shape in quotes. +

+1: 2e e+ hs "diam";g;
+

+

+

+Note location tag +

+

+Finally, a +"location tag" +can be associated with a note. This would +enable you to draw things relative to the note. +A note location tag +is set by using an "=" followed by a name. The name can be either: +

+The name is arbitrary, and is used as +a tag that can be referred to later. Examples: +
+// associate tag p with note e&
+3: 2c; e& =p g;
+
+// associate tag _end with note f
+2: 1f =_end;
+

+

+

+   <-- previous page     Table of Contents    next page --> +

+