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