chiark / gitweb /
Merge branch 'arkkra' into shiny
[mup] / mup / docs / uguide / lyrics.html
CommitLineData
69695f33
MW
1<HTML>
2<HEAD><TITLE>
3Lyrics
4</TITLE></HEAD>
5<BODY>
6<P>
7&nbsp;&nbsp;&nbsp;<A HREF="multirst.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="tabstaff.html">next page --&gt;</A>
10</P>
11
12<H2>
13Lyrics
14</H2>
15<P>
16Lyrics are specified in a somewhat similar manner to
17<A HREF="chordinp.html">note groups.</A>
18Lyrics for each staff are specified with the word &quot;lyrics&quot;
19optionally followed by a <I>place</I>,
20followed by the <I>staff number</I>, followed by a colon, then the timing and
21syllable information.
22</P>
23<P>
24The <I>place</I>, if specified, can be &quot;above&quot; or &quot;below,&quot; to
25indicate whether the lyrics are to be printed above or below the given
26staff. The default is below.
27</P>
28<P>
29The <I>staff number</I> can be a single number or list of ranges of numbers.
30It can also be given as the keyword &quot;all,&quot; which will place the lyrics
31above the top visible staff or below the bottom visible staff.
32</P>
33<P>
34The place can also be specified as &quot;between <I>M</I><B>&amp;</B><I>N</I>&quot;
35where <I>M</I> and <I>N</I> are numbers.
36This will cause the lyrics to printed approximately halfway between staff
37<I>M</I> and staff <I>N</I>. <I>N</I> must be exactly one greater than <I>M</I>.
38<BR><PRE>
39lyrics 1:
40lyrics above 2,3:
41lyrics between 1&amp;2, 3&amp;4:
42</PRE><BR>
43</P>
44<P>
45If you want the same lyrics above some staffs but below others,
46you can specify several places and list of staffs, separated by semicolons.
47For example:
48<BR><PRE>
49lyrics above 1,3 ; below 2,4 ; between 5&amp;6 :
50</PRE><BR>
51</P>
52<P>
53After the colon comes a list of
54time values.
55Time values are separated by semicolons and are specified as they are
56for notes: &quot;2&quot; for half notes, &quot;8.&quot; for dotted eight, etc.
57</P>
58<P>
59If the time values for lyrics are the same as the time values for the notes
60on the staff, the time values need not be specified. If you don't
61specify them, Mup will derive the appropriate values from the music input.
62If you list more than one staff, the time values will be derived from the
63first staff you list. Usually, the time values will be derived from voice 1,
64but if voice 1 music data doesn't exist or is invisible,
65or if the lyrics are explicitly specified as &quot;below&quot;
66and there is a visible voice 2, then voice 2 will be used.
67Voice 3, if any, is never used for automatically
68deriving time values for lyrics.
69Some examples:
70<BR><PRE>
71
721: c;d;e;f;
73lyrics 1: &quot;The sun will shine&quot;;
74// The time values will be all quarter notes,
75// as derived from the music on staff 1
76bar
77
781: 8g;4.f;4g;a;
79lyrics 1: &quot;up-on the earth.&quot;;
80// The derived time values will be 8;4.;4;;
81bar
82
83// In these examples, time values will be taken
84// from staff 4, since it is the first one listed.
85// In the last case, because &quot;below&quot; is specified explicitly,
86// the times will be taken from voice 2
87// if there is a visible voice 2; in all the other cases
88// it will be taken from voice 1 if voice 1 music
89// has been entered and is visible.
90lyrics 4,7,9: &quot;for-ev-er&quot;;
91lyrics above 4-6: &quot;nev-er-more&quot;;
92lyrics between 4&amp;5,6&amp;7: &quot;this is it&quot;;
93lyrics below 4,2: &quot;and so forth&quot;;
94</PRE><BR>
95The line describing the music from which to derive the times
96must appear in the input prior to the lyrics line that is deriving the times.
97If chords in the music are tied or slurred together, Mup will
98treat those chords as being for a single syllable.
99However, there may be some
100circumstances in which the rules Mup uses to derive time values may not
101yield what you want, in which case you will have to explicitly specify the times
102for that measure.
103</P>
104<P>
105Following the time values is a list of one or more
106verse numbers and lyric strings containing the words of the lyrics.
107The verse number(s) are given within square brackets. If no verse is
108specified on the first set of lyrics for a staff and
109place, verse 1 is assumed.
110On subsequent lyrics strings for that staff and place,
111the verse number is assumed to be one more than the previous verse number.
112Thus you only need to explicitly specify a verse
113number if you want to skip over a verse or supply them out of order.
114</P>
115<P>
116Verse numbers need not be consecutive.
117The staff number and verse number can be given as lists or ranges.
118Another example:
119<BR><PRE>
1201-2: 4.c+;8c;{4e;f;g;}3;
121lyrics below 1-2: 4.;8;{4;;;}3; \
122 &quot;This is some-thing else.&quot;; \
123 [4,5] &quot;How do you like this?&quot;; \
124 [2-3,6] &quot;Now try this out too.&quot;;
125bar
126</PRE><BR>
127<IMG SRC="mugex41.gif" ALT="Picture of Mup output"><BR>
128</P>
129<P>
130In this example, the lyrics will go below staffs 1 and 2. There are
1315 syllables. The first is a dotted quarter in length, the second is
132an eighth, and the last three make up a quarter note triplet. The first
133string is for verse 1, since no verse number was specified. The second
134string will be used for verses 4 and 5, and the last string for verses
1352, 3, and 6.
136</P>
137<P>
138<A NAME="centered">You can also specify a verse number of "c" which means the verse is</A>
139to be centered vertically. This is useful if you have a refrain that
140is identical for several verses, and you don't want to have it printed
141multiple times.
142<BR><PRE>
1431: c;;e;;
144lyrics 1: ;;2s; [1] &quot;verse one&quot;; [2] &quot;verse two&quot;;
145lyrics 1: 2s;4;; [c] &quot;The refrain&quot;; // centered lyrics
146bar
147</PRE><BR>
148<IMG SRC="mugex42.gif" ALT="Picture of Mup output"><BR>
149</P>
150<P>
151The lyrics string is followed by a semicolon.
152There must normally be one syllable in the lyrics string for each time value.
153<A HREF="lyrics.html#except">(There is one exception,</A>
154discussed later.)
155Syllables are separated in the lyrics string by white space,
156a dash, or an underscore.
157</P>
158<P>
159Sometimes a syllable is to be held out for several counts
160or over several notes. This can be indicated by dashes or underscores.
161If the syllable in the lyric string ends with a dash, on output the dash
162will be placed halfway between the given syllable and the next syllable.
163If the distance between the two syllables is long, several evenly-spaced
164dashes will be printed.
165If a syllable in the lyric string ends with an underscore,
166an underscore line will be printed from the end of the
167current syllable to the edge of the last note associated with the syllable.
168</P>
169<P>
170Here are some examples:
171<BR><PRE>
172// Verse 1. The first two words have the
173// duration of a quarter note each.
174// The last word lasts a half note.
1751: e;d;2c;
176lyrics 1: 4;;2; [1] &quot;Three blind mice&quot;;
177bar
178</PRE><BR>
179<IMG SRC="mugex43.gif" ALT="Picture of Mup output"><BR>
180<BR><PRE>
181// examples of above lyrics with dash and underscore
1821: 4d&lt;&gt;;e;8g;b;4a;
183lyrics above 1: &quot;now_ or nev-er&quot;;
184bar
185</PRE><BR>
186<IMG SRC="mugex44.gif" ALT="Picture of Mup output"><BR>
187</P>
188<P>
189Mup does its best to figure out where to end dashes or underscores. However,
190if there isn't a following syllable after a dash or underscore, Mup would
191extend the dash or underscore to the end of the piece, which may not be
192what you want. There are a few other cases where Mup may be unable to
193properly deduce where you had intended an underscore to end.
194You can manually halt the dash or underscore by adding in
195an &quot;empty syllable,&quot; consisting of &quot;&lt;&gt;&quot;. Normally, the angle brackets are
196used inside lyrics to enclose special non-lyrics items, as will be
197<A HREF="lyrics.html#lyrext">described a bit later.</A>
198However, if they are used by themselves with nothing between them,
199they essentially mean a syllable with no text.
200<BR><PRE>
2011: 2c;4d&lt;&gt;;e;
202lyrics 1: &quot;last word._&quot;;
203bar
204
2051: 4d;e;f;g;
206// add empty syllable to end the underscore
207lyrics 1: 1; &quot;&lt;&gt;&quot;;
208bar
209</PRE><BR>
210<IMG SRC="mugex45.gif" ALT="Picture of Mup output"><BR>
211</P>
212<P>
213Occasionally, a single chord is used for more than one syllable.
214If the syllables are within the same word, it is sufficient to omit the
215dashes between syllables, so that Mup will treat them as a single syllable.
216However, if the syllables are in separate words,
217a &quot;~&quot; can be used in place of a space between the syllables.
218On output, Mup will replace the &quot;~&quot;
219with a space and a small, curved line below the space, indicating that the
220syllables on either side are to be joined. For example:
221<BR><PRE>
2221: b;a;2g;
223lyrics 1: ;;2; &quot;man-y~a day&quot;;
224bar
225</PRE><BR>
226<IMG SRC="mugex46.gif" ALT="Picture of Mup output"><BR>
227If you don't want the curved line,
228you can use the special character name &quot;\(space)&quot; instead of a
229literal space.
230<A HREF="textstr.html#space">That special space character</A>
231is printed like a normal space on output,
232but is not considered a space for the purposes of determining syllable
233boundaries. Alternately,
234<A HREF="lyrics.html#lyrext">a technique using angle brackets,</A>
235described later, can be used.
236</P>
237<P>
238If several verses use the same time values, you can specify them all on
239one input line.
240For example:
241<BR><PRE>
2421: d;f;a;g;
243lyrics 1: [1] &quot;this is verse one&quot;; \
244 [2] &quot;this is verse two&quot;;
245bar
246</PRE><BR>
247<IMG SRC="mugex47.gif" ALT="Picture of Mup output"><BR>
248</P>
249<P>
250In this example,
251because of the \ at the end of the first line, both verses are effectively
252on the same input line.
253</P>
254<P>
255<A NAME="except">Occasionally, lyrics may occur during only part of a measure.</A>
256This case can be handled by specifying &quot;space&quot;
257by using an &quot;s&quot; after time values that have no
258lyric syllable associated with them. For example:
259<BR><PRE>
2601: 2r;g;
261lyrics 1: 2s;; [1] &quot;Now&quot;;
262bar
263</PRE><BR>
264<IMG SRC="mugex48.gif" ALT="Picture of Mup output"><BR>
265</P>
266<P>
267In this example, the first half note of the measure is a space, so there will
268be no lyric there. The second half note of the measure will have the word &quot;Now&quot;
269as its lyric. Note that the &quot;s&quot; does not work quite the same way with lyrics
270as it does with notes. With notes, &quot;2s;;&quot; would mean two half-note spaces,
271because the space would be used as default for the following chord where no
272notes were specified. With lyrics, &quot;2s;;&quot; means a half note space, followed
273by a half note lyric; the space is not carried forward as a default.
274</P>
275<P>
276If you don't specify any time values, relying on Mup to derive the time values
277from the corresponding music time values, any rests and spaces in the music
278will be translated to lyric spaces. If the first note entered in a chord
279is tied to or slurred to the following chord, that following chord
280will also be translated to a lyric space, since you most likely want
281a single syllable to span both chords in that case.
282</P>
283<P>
284<A NAME="lyrext">Occasionally, you may want to print something within a lyric string</A>
285which isn't really a lyric syllable.
286The most common example of this would be
287that you may want to print verse numbers. Other possibilities may include
288associating a dynamic mark (e.g., &quot;mf&quot;) with a particular verse, or
289marking a section for a subset of the singers (e.g., &quot;Men:&quot; or &quot;Solo:&quot;).
290These extra things are specified within angle brackets. They can be placed
291immediately before or after any syllable.
292Mup will not consider them when lining up the syllable with notes.
293Normally, it will assume there is enough
294space to print them rather than reserving space for them. If you want Mup
295to ensure there is enough space to print them, put a &quot;^&quot; immediately
296after the &quot;&lt;&quot;.
297</P>
298<P>
299Some examples:
300<BR><PRE>
3011: f;e;d;c;
302lyrics 1: &quot;&lt;1. &gt;This is verse one.&quot;;
303bar
3041: 2g;4;;
305lyrics 1: 2s;4;; &quot;&lt;^\f(TX)ff\f(PV) &gt;Loud-er&quot;;
306bar
307</PRE><BR>
308<IMG SRC="mugex49.gif" ALT="Picture of Mup output"><BR>
309</P>
310<P>
311The &lt; &gt; construct can also be used to fine-tune the placement of syllables.
312The placement of syllables is governed in general by the
313<A HREF="param.html#lyralign">lyricsalign parameter.</A>
314Sometimes, however, you may want to adjust the placement of specific syllables.
315Suppose you have a long syllable, like &quot;strength&quot; and would like
316to shift it leftward somewhat. Entering it as &quot;&lt;str&gt;ength&quot; would
317cause Mup to move the syllable farther to the left than it normally would.
318<BR><PRE>
3191: c;d;e;f;
320lyrics 1: &quot;This strength not moved.&quot;; \
321 &quot;This &lt;str&gt;ength was moved.&quot;;
322bar
323</PRE><BR>
324<IMG SRC="mugex50.gif" ALT="Picture of Mup output"><BR>
325</P>
326<P>
327Angle brackets may also be useful for entering
328chant, where many words
329are to be associated with a single note. For example:
330<BR><PRE>
331lyrics 1: &quot;All&lt;^ these words will be treated like one syllable.&gt;&quot;;
332</PRE><BR>
333</P>
334<P>
335The font and size to use for lyrics is initially determined
336from the
337<A HREF="param.html#lyrfam">"lyricsfontfamily,"</A>
338<A HREF="param.html#lyrfont">"lyricsfont"</A>
339and
340<A HREF="param.html#lyrsize">"lyricssize"</A>
341parameters for the appropriate staff.
342If &quot;all&quot; is used for the staff number, the score parameters are used.
343In the case of &quot;between,&quot; the parameters for the staff above are used for
344determining the font and size.
345The usual \f and \s forms can be used to
346<A HREF="textstr.html">change these values</A>
347for a given verse. Lyrics fontfamily, font and size values
348are maintained separately for each
349combination of staff number, verse number, and place, and are carried forward
350from one measure to the next. Thus, for example, if you want one verse to
351be printed in roman and another in italics (perhaps one is in English and the
352other in another language), you need only put a &quot;\f(TI)&quot; at the beginning of
353the syllable string for the first measure of the second verse, and all
354subsequent syllables for that verse will be in italics.
355Setting the
356<A HREF="param.html#lyrfam">"lyricsfontfamily,"</A>
357<A HREF="param.html#lyrfont">"lyricsfont"</A>
358or
359<A HREF="param.html#lyrsize">"lyricssize"</A>
360parameters will reset the values for
361all verses of the staff (if set in
362<A HREF="contexts.html">staff context),</A>
363or the entire score (if set in
364<A HREF="contexts.html">score context).</A>
365</P>
366<P>
367Another way to align a syllable in a particular way is to precede the
368syllable with a |. If the | is preceded by a number (optionally signed),
369the left edge of the syllable will be placed that many points from the
370horizontal &quot;middle&quot; of the chord.
371If there isn't a number before it, the value is obtained from the
372<A HREF="param.html#sylpos">sylposition parameter.</A>
373Negative values are to the left, and will usually be what you want.
374This alignment method is particularly useful for lining up multiple verses,
375either to get verse numbers to line up or to align words at the beginning
376of a poetic line. The | goes after anything in angle brackets.
377<BR><PRE>
3781: 8c;d;4e;8e;g;4c+;
379lyrics 1: &quot;&lt;1. &gt;|\&quot;How are you?\&quot; -7|He asked her.&quot;; \
380 &quot;&lt;2. &gt;|\&quot;I am fine,\&quot; -7|She re-plied.&quot;;
381bar
382</PRE><BR>
383<IMG SRC="mugex51.gif" ALT="Picture of Mup output"><BR>
384</P>
385<P>
386A few more examples of lyrics:
387<BR><PRE>
3881,3-4: c;8e;;4d;r;
3892: c+;8g;;4b;;
390lyrics between 1&amp;2,3&amp;4: 4;8;;4;s; &quot;This is a test.&quot;;
391lyrics above 2: 2s;4;; &quot;The end.&quot;;
392bar
393</PRE><BR>
394<IMG SRC="mugex52.gif" ALT="Picture of Mup output"><BR>
395</P>
396<HR><P>
397&nbsp;&nbsp;&nbsp;<A HREF="multirst.html">&lt;-- previous page</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html">Table of Contents</A>&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="tabstaff.html">next page --&gt;</A>
398</P>
399</BODY></HTML>