chiark - git - mdw - mup/blob - mup/docs/uguide/tuplets.html

   1 <HTML>
   2 <HEAD><TITLE>
   3 Tuplets
   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>
  13 Tuplets
  14 </H3>
  15 <P>
  16 Tuplets are specified by giving a list of chords within curly braces.
  17 The ending brace is optionally followed by a side (&quot;above&quot; or &quot;below&quot;).
  18 This is followed by a number or pair of numbers, and a semicolon.
  19 </P>
  20 <P>
  21 The &quot;side&quot; tells Mup whether to print the tuplet number and bracket above
  22 or below the chords. It only applies on voice 1 or 2
  23 when the other voice (1 or 2) is nonexistent or a space.
  24 If there are at least two voices, the number and bracket
  25 will always be put above on voice 1 and below on voice 2.
  26 You can always force the side on voice 3.
  27 If you don't specify a side for a tuplet,
  28 Mup will choose the side that seems best.
  29 </P>
  30 <P>
  31 The first number is the number that should be printed with the tuplet.
  32 If it is followed by an &quot;n&quot; the number (and bracket) will not actually be
  33 printed.
  34 If it is followed by a &quot;y&quot; the number and bracket will always be printed,
  35 unless there is only a single chord in the tuplet, in which case only
  36 the number will be printed.
  37 If it is followed by &quot;num&quot; the number will always be printed,
  38 but the bracket will never be printed.
  39 If none of those modifiers are are specified,
  40 the number will always be printed, but
  41 the bracket will be omitted in cases where all the notes in the tuplet
  42 are beamed together and the beam does not include any notes not in the tuplet.
  43 </P>
  44 <P>
  45 The second number, if any, is separated from the first by a comma,
  46 and tells the time unit that the tuplet is to
  47 take up. This number can be dotted if necessary.
  48 It can also be a time expression, like 2+8,
  49 although that is very rarely likely to be useful.
  50 If no second number is given, the default is to fit in the next shorter
  51 un-dotted note. For example, three eighth notes would be fitted into
  52 the time of a quarter note, or five eighth notes would be fitted into the
  53 time of a half note.
  54 </P>
  55 <P>
  56 Occasionally in music, as a shorthand,
  57 a single note or chord is printed with a tuplet number to
  58 indicate the note or chord is to be repeated several times as a tuplet.
  59 Mup will allow this; simply use a tuplet with only one chord, and add
  60 one or more
  61 <A HREF="chrdattr.html#slashes">slashes.</A>
  62 </P>
  63 <P>
  64 Here 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.
  69 1: { 8ce; df; eg;}3; 4fa;
  70 bar
  71
  72 // This has a dublet, in which 2 quarter notes
  73 // take the time of a normal dotted quarter
  74 1: { 4f; g; } 2, 4.;8a;
  75 bar
  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
  81 1: { 4c+; 8b; } above 3; 4c+;
  82 bar
  83
  84 // A septuplet in the time of a half note
  85 // with the &quot;7&quot; printed below the notes
  86 1: { 8c; b-; c; e; d; f; a; } below 7;
  87 bar
  88
  89 // single chord tuplet
  90 1:  { [slash 1] 4.ceg;}3; 4;
  91 bar
  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>