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

   1 <HTML>
   2 <HEAD><TITLE>
   3 Manual placement of notes
   4 </TITLE></HEAD>
   5 <BODY>
   6 <P>
   7 &nbsp;&nbsp;&nbsp;<A HREF="mantup.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="brackmac.html">next page --&gt;</A>
  10 </P>
  11
  12 <H2>
  13 Manual placement of notes
  14 </H2>
  15 <P>
  16 Mup supports up to three voices per staff. If you need more than that, such as
  17 when 4 notes of different lengths occur on the same beat, it is possible
  18 to position extra notes manually.
  19 Manually positioned notes will not be included in
  20 <A HREF="midi.html">MIDI output.</A>
  21 </P>
  22 <P>
  23 First of all, unless the fourth voice is vertically far away from the other two,
  24 you'll probably need to reserve some
  25 extra space to the left or right of the other chords. This can be done
  26 by adding a bit of
  27 <A HREF="chrdattr.html#pad">padding to the chord.</A>
  28 If you want the extra note on the left of the regular
  29 voices, add padding to whichever regular voice is leftmost. If you want it
  30 on the right, the padding will have to go on the following note, or on
  31 the bar line if you are on the last chord of a measure. The amount of
  32 padding to add may have to be determined by trial and error; 5 stepsizes
  33 is a good first guess. Next, set a
  34 <A HREF="tags.html">location tag</A>
  35 <A HREF="noteattr.html#ntag">on one of the notes</A>
  36 in one of the regular groups.
  37 The manually-positioned note will be placed relative to
  38 that location tag. The x will be slightly left or right of the
  39 west or east of the existing group; something like 3 stepsizes might be
  40 a good first guess. The y can be specified in terms of
  41 stepsizes up from the note you used for the location tag. You can use a
  42 <A HREF="prnttext.html">print statement</A>
  43 using one of the special
  44 <A HREF="textstr.html#symlist">music characters,</A>
  45 such as:
  46 dblwhole, 1n, up2n, dn2n, up4n, up32n, etc. If the note needs ledger lines,
  47 dots, or accidentals, these too have to be manually positioned,
  48 which can be a bit tricky. Here is a simple example:
  49 <BR><PRE>
  50 score
  51 vscheme=3o
  52 beamstyle=4,4,4,4
  53
  54 music
  55 1 1: [pad 4] 4g =h; a; b; a;
  56 1 2: 4.c;8;2;
  57 1 3: [down] 8e;; [ho 0] 2.f;
  58 print (h.w - 2.3, h.y + 3) &quot;\(up2n)&quot;
  59 bar
  60 </PRE><BR>
  61 <IMG SRC="mugex90.gif" ALT="Picture of Mup output"><BR>
  62 In this example, 4 stepsizes of padding
  63 was added to the quarter note g of voice 1
  64 on staff 1. A location tag &quot;h&quot; was set to this note. After the information
  65 about the second voice on staff 1, a half note was manually placed
  66 2.3 stepsizes left of the first voice and at pitch c+ (3 steps up from the g).
  67 </P>
  68 <P>
  69 If you also need to place an accidental and/or dots, more padding should be
  70 requested, and additional print statements used for each item. For example,
  71 you could specify perhaps 5 stepsizes of padding, then add:
  72 <BR><PRE>
  73 print (h.w - 5, h.y + 3) &quot;\(flat)&quot;
  74 </PRE><BR>
  75 <IMG SRC="mugex91.gif" ALT="Picture of Mup output"><BR>
  76 to place a flat sign in front of the c.
  77 </P>
  78 <P>
  79 Ledger lines needed by the notes also have to be
  80 placed manually, using the &quot;line&quot;
  81 command. If the note is more than three steps above or below the staff, more
  82 than one ledger line would be needed, and each would need to be specified
  83 separately. The y coordinate of the each ledger line would be the same
  84 as the y coordinate of the note,
  85 plus or minus some number of step sizes. The length of
  86 the line depends on the note head. About 4.5 stepsizes is a good estimate for
  87 most notes, but a double whole needs more like 6 stepsizes.
  88 </P>
  89 <HR><P>
  90 &nbsp;&nbsp;&nbsp;<A HREF="mantup.html">&lt;-- previous page</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html">Table of Contents</A>&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="brackmac.html">next page --&gt;</A>
  91 </P>
  92 </BODY></HTML>