--- /dev/null
+<HTML>
+<HEAD><TITLE>
+Tuplets
+</TITLE></HEAD>
+<BODY>
+<P>
+ <A HREF="ichdattr.html"><-- previous page</A>
+
+ <A HREF="index.html">Table of Contents</A> <A HREF="altinp.html">next page --></A>
+</P>
+
+<H3>
+Tuplets
+</H3>
+<P>
+Tuplets are specified by giving a list of chords within curly braces.
+The ending brace is optionally followed by a side ("above" or "below").
+This is followed by a number or pair of numbers, and a semicolon.
+</P>
+<P>
+The "side" tells Mup whether to print the tuplet number and bracket above
+or below the chords. It only applies on voice 1 or 2
+when the other voice (1 or 2) is nonexistent or a space.
+If there are at least two voices, the number and bracket
+will always be put above on voice 1 and below on voice 2.
+You can always force the side on voice 3.
+If you don't specify a side for a tuplet,
+Mup will choose the side that seems best.
+</P>
+<P>
+The first number is the number that should be printed with the tuplet.
+If it is followed by an "n" the number (and bracket) will not actually be
+printed.
+If it is followed by a "y" the number and bracket will always be printed,
+unless there is only a single chord in the tuplet, in which case only
+the number will be printed.
+If it is followed by "num" the number will always be printed,
+but the bracket will never be printed.
+If none of those modifiers are are specified,
+the number will always be printed, but
+the bracket will be omitted in cases where all the notes in the tuplet
+are beamed together and the beam does not include any notes not in the tuplet.
+</P>
+<P>
+The second number, if any, is separated from the first by a comma,
+and tells the time unit that the tuplet is to
+take up. This number can be dotted if necessary.
+It can also be a time expression, like 2+8,
+although that is very rarely likely to be useful.
+If no second number is given, the default is to fit in the next shorter
+un-dotted note. For example, three eighth notes would be fitted into
+the time of a quarter note, or five eighth notes would be fitted into the
+time of a half note.
+</P>
+<P>
+Occasionally in music, as a shorthand,
+a single note or chord is printed with a tuplet number to
+indicate the note or chord is to be repeated several times as a tuplet.
+Mup will allow this; simply use a tuplet with only one chord, and add
+one or more
+<A HREF="chrdattr.html#slashes">slashes.</A>
+</P>
+<P>
+Here are some examples of tuplets:
+<BR><PRE>
+// This has a triplet, where 3 eighth
+// notes take as much time as a
+// normal quarter note.
+1: { 8ce; df; eg;}3; 4fa;
+bar
+
+// This has a dublet, in which 2 quarter notes
+// take the time of a normal dotted quarter
+1: { 4f; g; } 2, 4.;8a;
+bar
+
+// A quarter note and eighth note that
+// make up a triplet the length of a
+// normal quarter note,
+// with the 3 printed above the notes
+1: { 4c+; 8b; } above 3; 4c+;
+bar
+
+// A septuplet in the time of a half note
+// with the "7" printed below the notes
+1: { 8c; b-; c; e; d; f; a; } below 7;
+bar
+
+// single chord tuplet
+1: { [slash 1] 4.ceg;}3; 4;
+bar
+</PRE><BR>
+<IMG SRC="mugex30.gif" ALT="Picture of Mup output"><BR>
+</P>
+<HR><P>
+ <A HREF="ichdattr.html"><-- previous page</A> <A HREF="index.html">Table of Contents</A> <A HREF="altinp.html">next page --></A>
+</P>
+</BODY></HTML>
~mdw / mup / blobdiff