chiark / gitweb /
Import upstream version 5.3.
[mup] / mup / docs / uguide / roll.html
CommitLineData
fac14bbe
MW
1<HTML>
2<HEAD><TITLE>
3Rolls
4</TITLE></HEAD>
5<BODY>
6<P>
7&nbsp;&nbsp;&nbsp;<A HREF="pedal.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="tags.html">next page --&gt;</A>
10</P>
11
12<H2>
13Rolls
14</H2>
15<P>
16Rolls can be specified with the &quot;roll&quot; statement, which has a format:
17<BR><PRE>
18<B>roll</B> <I>staff voice</I> <B>:</B> <I>timeval</I><B>;</B>
19</PRE><BR>
20</P>
21<P>
22A simple example would be:
23<BR><PRE>
24roll 2 1: 3;
25</PRE><BR>
26which indicates that a roll is to be placed on the chord at count 3 of
27staff 2 voice 1.
28As usual, if the <I>voice</I> is omitted, voice 1 is assumed.
29</P>
30<P>
31Multiple rolls in a measure can be listed on a single statement if they are
32associated with the same voice. For example:
33<BR><PRE>
341: ceg;dfa;egb;fac+;
35// rolls on 3 chords: on the first,
36// second, and third beats of the measure
37roll 1: 1;2;3;
38bar
39</PRE><BR>
40<IMG SRC="mugex78.gif" ALT="Picture of Mup output"><BR>
41would produce rolls on the chords on counts 1, 2, and 3.
42</P>
43<P>
44A roll can extend over several chords on different voices, or even
45different staffs. This is specified
46by giving the top and bottom staffs and voices, with the keyword &quot;to&quot;
47between them. For example:
48<BR><PRE>
491: 4.r;8g+b+d++ tie;2;
502-3: 4.ceg;8gbd+ tie;2;
51roll 1 1 to 3 1: 2.5;
52bar
53</PRE><BR>
54<IMG SRC="mugex79.gif" ALT="Picture of Mup output"><BR>
55The roll would extend from voice 1 of staff 1 to voice 1 of staff 3.
56</P>
57<P>
58If you wish the roll to be downward, the keyword &quot;down&quot; can be placed
59after &quot;roll.&quot; This will result in a downward arrow being drawn on the
60bottom end of the roll.
61<BR><PRE>
62score
63 vscheme=2o
64music
651 1: c+e+g+;;;;
661 2: ceg;;;;
67// downward roll on staff 1
68// on beats 2 and 4
69roll down 1 1 to 1 2: 2; 4;
70bar
71</PRE><BR>
72<IMG SRC="mugex80.gif" ALT="Picture of Mup output"><BR>
73</P>
74<P>
75You can also explicitly say &quot;up&quot; which will cause an upward arrow to be
76drawn at the top of the roll. If no direction is specified, no arrow is drawn.
77</P>
78<HR><P>
79&nbsp;&nbsp;&nbsp;<A HREF="pedal.html">&lt;-- previous page</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html">Table of Contents</A>&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="tags.html">next page --&gt;</A>
80</P>
81</BODY></HTML>