[mup] / mup / docs / uguide / manual.html

<HTML>
<HEAD><TITLE>
Manual placement of notes
</TITLE></HEAD>
<BODY>
<P>
&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>
</P>
         
<H2>
Manual placement of notes
</H2>
<P>
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
<A HREF="midi.html">MIDI output.</A>
</P>
<P>
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
<A HREF="chrdattr.html#pad">padding to the chord.</A>
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
<A HREF="tags.html">location tag</A>
<A HREF="noteattr.html#ntag">on one of the notes</A>
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
<A HREF="prnttext.html">print statement</A>
using one of the special
<A HREF="textstr.html#symlist">music characters,</A>
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:
<BR><PRE>
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) &quot;\(up2n)&quot;
bar
</PRE><BR>
<IMG SRC="mugex90.gif" ALT="Picture of Mup output"><BR>
In this example, 4 stepsizes of padding
was added to the quarter note g of voice 1
on staff 1. A location tag &quot;h&quot; 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).
</P>
<P>
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:
<BR><PRE>
print (h.w - 5, h.y + 3) &quot;\(flat)&quot;
</PRE><BR>
<IMG SRC="mugex91.gif" ALT="Picture of Mup output"><BR>
to place a flat sign in front of the c.
</P>
<P>
Ledger lines needed by the notes also have to be
placed manually, using the &quot;line&quot;
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.
</P>
<HR><P>
&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>
</P>
</BODY></HTML>
Commit	Line	Data
69695f33 MW	1	<HTML>
	2	<HEAD><TITLE>
	3	Manual placement of notes
	4	</TITLE></HEAD>
	5	<BODY>
	6	<P>
	7	<A HREF="mantup.html"><-- previous page</A>
	8
	9	<A HREF="index.html">Table of Contents</A>    <A HREF="brackmac.html">next page --></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) "\(up2n)"
	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 "h" 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) "\(flat)"
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 "line"
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	<A HREF="mantup.html"><-- previous page</A>     <A HREF="index.html">Table of Contents</A>    <A HREF="brackmac.html">next page --></A>
91	</P>
92	</BODY></HTML>