X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~mdw/git/mup/blobdiff_plain/cdb3c0882392596f814cf939cbfbd38adc6f2bfe..ddf6330b56bcfb657e0186b24b9b1422c51d3424:/mup/docs/uguide/manual.html diff --git a/mup/docs/uguide/manual.html b/mup/docs/uguide/manual.html new file mode 100644 index 0000000..190c9e4 --- /dev/null +++ b/mup/docs/uguide/manual.html @@ -0,0 +1,92 @@ + + +Manual placement of notes + + +

+   <-- previous page + +     Table of Contents    next page --> +

+ +

+Manual placement of notes +

+

+Mup supports up to three voices per staff. If you need more than that, such as +when 4 notes of different lengths occur on the same beat, it is possible +to position extra notes manually. +Manually positioned notes will not be included in +MIDI output. +

+

+First of all, unless the fourth voice is vertically far away from the other two, +you'll probably need to reserve some +extra space to the left or right of the other chords. This can be done +by adding a bit of +padding to the chord. +If you want the extra note on the left of the regular +voices, add padding to whichever regular voice is leftmost. If you want it +on the right, the padding will have to go on the following note, or on +the bar line if you are on the last chord of a measure. The amount of +padding to add may have to be determined by trial and error; 5 stepsizes +is a good first guess. Next, set a +location tag +on one of the notes +in one of the regular groups. +The manually-positioned note will be placed relative to +that location tag. The x will be slightly left or right of the +west or east of the existing group; something like 3 stepsizes might be +a good first guess. The y can be specified in terms of +stepsizes up from the note you used for the location tag. You can use a +print statement +using one of the special +music characters, +such as: +dblwhole, 1n, up2n, dn2n, up4n, up32n, etc. If the note needs ledger lines, +dots, or accidentals, these too have to be manually positioned, +which can be a bit tricky. Here is a simple example: +

+score
+vscheme=3o
+beamstyle=4,4,4,4
+
+music
+1 1: [pad 4] 4g =h; a; b; a;
+1 2: 4.c;8;2;
+1 3: [down] 8e;; [ho 0] 2.f;
+print (h.w - 2.3, h.y + 3) "\(up2n)"
+bar
+

+Picture of Mup output
+In this example, 4 stepsizes of padding +was added to the quarter note g of voice 1 +on staff 1. A location tag "h" was set to this note. After the information +about the second voice on staff 1, a half note was manually placed +2.3 stepsizes left of the first voice and at pitch c+ (3 steps up from the g). +

+

+If you also need to place an accidental and/or dots, more padding should be +requested, and additional print statements used for each item. For example, +you could specify perhaps 5 stepsizes of padding, then add: +

+print (h.w - 5, h.y + 3) "\(flat)"
+

+Picture of Mup output
+to place a flat sign in front of the c. +

+

+Ledger lines needed by the notes also have to be +placed manually, using the "line" +command. If the note is more than three steps above or below the staff, more +than one ledger line would be needed, and each would need to be specified +separately. The y coordinate of the each ledger line would be the same +as the y coordinate of the note, +plus or minus some number of step sizes. The length of +the line depends on the note head. About 4.5 stepsizes is a good estimate for +most notes, but a double whole needs more like 6 stepsizes. +

+

+   <-- previous page     Table of Contents    next page --> +

+