chiark / gitweb /
Import upstream version 5.3.
[mup] / mup / docs / uguide / noteattr.html
1 <HTML>
2 <HEAD><TITLE>
3 Note attributes
4 </TITLE></HEAD>
5 <BODY>
6 <P>
7 &nbsp;&nbsp;&nbsp;<A HREF="chordinp.html">&lt;-- previous page</A>
8
9 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html">Table of Contents</A>&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="chrdattr.html">next page --&gt;</A>
10 </P>
11          
12 <H3>
13 Note attributes
14 </H3>
15 <P>
16 There are several optional attributes that can be specified for each note.
17 Any or all of these may appear on any note in any order
18 after the
19 <A HREF="chordinp.html#letter">letter,</A>
20 <A HREF="chordinp.html#acc">accidental,</A>
21 and
22 <A HREF="chordinp.html#oct">octave specifications.</A>
23 They include:
24 <UL>
25 <LI>
26 <A HREF="noteattr.html#small">small note head</A>
27 <LI>
28 <A HREF="noteattr.html#ntie">tie</A>
29 <LI>
30 <A HREF="noteattr.html#nslur">slurs</A>
31 <LI>
32 <A HREF="noteattr.html#shaped">headshape</A>
33 <LI>
34 <A HREF="noteattr.html#ntag">location tag</A>
35 </UL>
36 </P>
37 <H4>
38 Small note head
39 </H4>
40 <P>
41 <A NAME="small">A note specification can be followed by a "?"</A>
42 to indicate the note is to be printed with a small note head,
43 rather than the normal
44 size. (Note: if you have several notes in a chord and want all of them to
45 be small,
46 <A HREF="chrdattr.html#cue">the "cue" construct, described later,</A>
47 may be preferable.)
48 </P>
49 <P>
50 Examples:
51 <BR><PRE>
52 // print the &quot;e&quot; as a small note
53 1: 1c e? g;
54 bar
55
56 // make the second note small
57 1: f; ?; g; ;
58 bar
59 </PRE><BR>
60 <IMG SRC="mugex12.gif" ALT="Picture of Mup output"><BR>
61 </P>
62 <H4>
63 Note tie
64 </H4>
65 <P>
66 <A NAME="ntie">A "~" can be used to indicate the note is to be tied</A>
67 to the note of the same
68 pitch in the following chord. That following chord need not be in the same
69 measure, but it must contain a matching note.
70 (Note: if a chord with several notes is to have all the notes tied
71 to the following chord,
72 <A HREF="ichdattr.html#tie">the "tie" construct</A>
73 described later may be preferable.)
74 The ~ may be preceded by the word 'dotted' or 'dashed' if you want
75 a dotted or dashed tie; otherwise a normal, solid tie is drawn.
76 The ~ may be followed by the word 'up' or 'down' to specify the
77 direction for the curve's bulge. If neither is specified, Mup will
78 determine an appropriate direction, so you only need to give a direction
79 if you wish to override Mup's choice.
80 </P>
81 <P>
82 Examples
83 <BR><PRE>
84 1: d~; 8; e~; ; f;
85 bar
86
87 // tie the g (which also happens
88 // to be a &quot;small&quot; note)
89 1: 2g+g?~; 4eg?;
90 bar
91 </PRE><BR>
92 <IMG SRC="mugex13.gif" ALT="Picture of Mup output"><BR>
93 </P>
94 <H4>
95 Slurs
96 </H4>
97 <P>
98 <A NAME="nslur">A note can also be followed by a list of notes to be slurred to,</A>
99 enclosed in angle brackets.
100 A slur will be drawn from the note to each of the notes
101 listed in the angle brackets. The notes inside the brackets
102 are specified by a pitch and optional octave. No
103 <A HREF="chordinp.html#acc">accidentals</A>
104 are specified, even if the note to be slurred
105 to has an accidental. Examples:
106 <BR><PRE>
107 // slur from c of first chord to e of second chord
108 1: c&lt;e&gt;; e; f; g;
109 bar
110
111 // slur from c+ of first chord to a&amp; of second chord
112 // and from c+ of first chord to d&amp;+ of second chord
113 1: 2cc+&lt;ad+&gt;; a&amp;d&amp;+;
114 bar
115 </PRE><BR>
116 <IMG SRC="mugex14.gif" ALT="Picture of Mup output"><BR>
117 </P>
118 <P>
119 If there is only one note in the following chord, it isn't necessary to
120 explicitly state it within the angle brackets; &quot;&lt;&gt;&quot; will suffice.
121 <BR><PRE>
122 // slur from c to d, and f to g
123 1: c&lt;&gt;; d; f&lt;&gt;; g;
124 bar
125 </PRE><BR>
126 <IMG SRC="mugex15.gif" ALT="Picture of Mup output"><BR>
127 </P>
128 <P>
129 The &lt; may be preceded by the word 'dotted' or 'dashed' if you want
130 a dotted or dashed slur, otherwise a normal, solid slur is drawn.
131 The &gt; may be followed by the word 'up' or 'down' to specify the
132 direction for the curve's bulge. If neither is specified, Mup will
133 determine an appropriate direction, so you only need to give a direction
134 if you wish to override Mup's choice.
135 </P>
136 <P>
137 There are four special &quot;slurs&quot; which are really slides to/from an
138 indefinite note. They are most commonly used on
139 <A HREF="tabstaff.html">tablature staffs,</A>
140 but are allowed on ordinary staffs too. 
141 They are: &lt;/n&gt; &lt;\n&gt; &lt;n/&gt; and &lt;n\&gt; for sliding upward into the note,
142 downward into the note, upward out from the note, and downward out from
143 the note respectively. These have to be in angle brackets by themselves,
144 so if you want to have both one of these slides and another slur on the
145 same note, multiple sets of angle brackets must be used, as in
146 <BR><PRE>
147 1: 2c&lt;/n&gt;&lt;d&gt;;d;
148 </PRE><BR>
149 </P>
150 <H4>
151 Head shape
152 </H4>
153 <P>
154 <A NAME="shaped">Sometimes you may want to mix head shapes on a single stem.</A>
155 For example, you might want to use a diamond to designate a harmonic,
156 with other notes in the same chord being normal shape.
157 There is an entire
158 <A HREF="shaped.html">section on head shapes,</A>
159 so only a simple example is given here.
160 To make a single note have a different head shape,
161 use hs followed by the name of the shape in quotes.
162 <BR><PRE>
163 1: 2e e+ hs &quot;diam&quot;;g;
164 </PRE><BR>
165 </P>
166 <H4>
167 Note location tag
168 </H4>
169 <P>
170 Finally, a
171 <A HREF="tags.html">"location tag"</A>
172 can be associated with a note. This would
173 enable you to draw things relative to the note.
174 <A NAME="ntag">A note location tag</A>
175 is set by using an &quot;=&quot; followed by a name. The name can be either:
176 <UL>
177 <LI>
178 a single lower case letter
179 <LI>
180 an underscore followed by one or more
181 letters, numbers, and underscores in any combination.
182 </UL>
183 The name is arbitrary, and is used as
184 a tag that can be referred to later. Examples:
185 <BR><PRE>
186 // associate tag p with note e&amp;
187 3: 2c; e&amp; =p g;
188
189 // associate tag _end with note f
190 2: 1f =_end;
191 </PRE><BR>
192 </P>
193 <HR><P>
194 &nbsp;&nbsp;&nbsp;<A HREF="chordinp.html">&lt;-- previous page</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html">Table of Contents</A>&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="chrdattr.html">next page --&gt;</A>
195 </P>
196 </BODY></HTML>