chiark / gitweb /
Import upstream version 5.3.
[mup] / mup / docs / uguide / tuplets.html
CommitLineData
69695f33
MW
1<HTML>
2<HEAD><TITLE>
3Tuplets
4</TITLE></HEAD>
5<BODY>
6<P>
7&nbsp;&nbsp;&nbsp;<A HREF="ichdattr.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="altinp.html">next page --&gt;</A>
10</P>
11
12<H3>
13Tuplets
14</H3>
15<P>
16Tuplets are specified by giving a list of chords within curly braces.
17The ending brace is optionally followed by a side (&quot;above&quot; or &quot;below&quot;).
18This is followed by a number or pair of numbers, and a semicolon.
19</P>
20<P>
21The &quot;side&quot; tells Mup whether to print the tuplet number and bracket above
22or below the chords. It only applies on voice 1 or 2
23when the other voice (1 or 2) is nonexistent or a space.
24If there are at least two voices, the number and bracket
25will always be put above on voice 1 and below on voice 2.
26You can always force the side on voice 3.
27If you don't specify a side for a tuplet,
28Mup will choose the side that seems best.
29</P>
30<P>
31The first number is the number that should be printed with the tuplet.
32If it is followed by an &quot;n&quot; the number (and bracket) will not actually be
33printed.
34If it is followed by a &quot;y&quot; the number and bracket will always be printed,
35unless there is only a single chord in the tuplet, in which case only
36the number will be printed.
37If it is followed by &quot;num&quot; the number will always be printed,
38but the bracket will never be printed.
39If none of those modifiers are are specified,
40the number will always be printed, but
41the bracket will be omitted in cases where all the notes in the tuplet
42are beamed together and the beam does not include any notes not in the tuplet.
43</P>
44<P>
45The second number, if any, is separated from the first by a comma,
46and tells the time unit that the tuplet is to
47take up. This number can be dotted if necessary.
48It can also be a time expression, like 2+8,
49although that is very rarely likely to be useful.
50If no second number is given, the default is to fit in the next shorter
51un-dotted note. For example, three eighth notes would be fitted into
52the time of a quarter note, or five eighth notes would be fitted into the
53time of a half note.
54</P>
55<P>
56Occasionally in music, as a shorthand,
57a single note or chord is printed with a tuplet number to
58indicate the note or chord is to be repeated several times as a tuplet.
59Mup will allow this; simply use a tuplet with only one chord, and add
60one or more
61<A HREF="chrdattr.html#slashes">slashes.</A>
62</P>
63<P>
64Here are some examples of tuplets:
65<BR><PRE>
66// This has a triplet, where 3 eighth
67// notes take as much time as a
68// normal quarter note.
691: { 8ce; df; eg;}3; 4fa;
70bar
71
72// This has a dublet, in which 2 quarter notes
73// take the time of a normal dotted quarter
741: { 4f; g; } 2, 4.;8a;
75bar
76
77// A quarter note and eighth note that
78// make up a triplet the length of a
79// normal quarter note,
80// with the 3 printed above the notes
811: { 4c+; 8b; } above 3; 4c+;
82bar
83
84// A septuplet in the time of a half note
85// with the &quot;7&quot; printed below the notes
861: { 8c; b-; c; e; d; f; a; } below 7;
87bar
88
89// single chord tuplet
901: { [slash 1] 4.ceg;}3; 4;
91bar
92</PRE><BR>
93<IMG SRC="mugex30.gif" ALT="Picture of Mup output"><BR>
94</P>
95<HR><P>
96&nbsp;&nbsp;&nbsp;<A HREF="ichdattr.html">&lt;-- previous page</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html">Table of Contents</A>&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="altinp.html">next page --&gt;</A>
97</P>
98</BODY></HTML>