VocalEasel/mma/docs/html/ref/node9.html
Matthias Neeracher fb48baaf09 Updated to MMA 1.4
2009-05-17 22:34:44 +00:00

659 lines
19 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!--Converted with LaTeX2HTML 2002-2-1 (1.71)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Lyrics</TITLE>
<META NAME="description" CONTENT="Lyrics">
<META NAME="keywords" CONTENT="mma">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="LaTeX2HTML v2002-2-1">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="mma.css">
<LINK REL="next" HREF="node10.html">
<LINK REL="previous" HREF="node8.html">
<LINK REL="up" HREF="mma.html">
<LINK REL="next" HREF="node10.html">
</HEAD>
<BODY bgcolor="#ffffff">
<DIV CLASS="navigation"><!--Navigation Panel-->
<A NAME="tex2html473"
HREF="node10.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html471"
HREF="mma.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html465"
HREF="node8.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html474"
HREF="node10.html">Solo and Melody Tracks</A>
<B> Up:</B> <A NAME="tex2html472"
HREF="mma.html">Reference Manual</A>
<B> Previous:</B> <A NAME="tex2html466"
HREF="node8.html">Musical Data Format</A>
<BR>
<BR></DIV>
<!--End of Navigation Panel-->
<!--Table of Child-Links-->
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL CLASS="ChildLinks">
<LI><A NAME="tex2html475"
HREF="node9.html#SECTION00910000000000000000">Lyric Options</A>
<UL>
<LI><A NAME="tex2html476"
HREF="node9.html#SECTION00911000000000000000">Event Type</A>
<LI><A NAME="tex2html477"
HREF="node9.html#SECTION00912000000000000000">Word Splitting</A>
</UL>
<BR>
<LI><A NAME="tex2html478"
HREF="node9.html#SECTION00920000000000000000">Chord Name Insertion</A>
<UL>
<LI><A NAME="tex2html479"
HREF="node9.html#SECTION00921000000000000000">Chord Transposition</A>
</UL>
<BR>
<LI><A NAME="tex2html480"
HREF="node9.html#SECTION00930000000000000000">Setting Lyrics</A>
<UL>
<LI><A NAME="tex2html481"
HREF="node9.html#SECTION00931000000000000000">Limitations</A>
</UL></UL>
<!--End of Table of Child-Links-->
<HR>
<H1><A NAME="SECTION00900000000000000000"></A>
<A NAME="sec-lyrics"></A>
<BR>
Lyrics
</H1>
<P>
MIDI files can include song lyrics. And some MIDI players or
sequencers can display them as a file is played. Some, but not all.
<P>
I'm not aware of any keyboards which display lyrics; and most Linux
based players do not display them. Exceptions to the rule are the
programs <SPAN CLASS="textit">Kmid</SPAN> which displays and highlights lyrics almost in a
Karaoke manner, <SPAN CLASS="textit">xplaymidi</SPAN> and <SPAN CLASS="textit">timidity</SPAN> which display the
lyrics in a secondary panel.
<P>
With this qualifier out of the way, there really is no reason for
lyrics NOT to be useful in a program like
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> . Singers do not want
a melody playing while they are vocalizing (really, they are no
different in this than any other instrumentalist). And some
platforms<A NAME="tex2html36"
HREF="#foot3690"><SUP><SPAN CLASS="arabic">9</SPAN>.<SPAN CLASS="arabic">1</SPAN></SUP></A> other than Linux support lyric display in a more
useful format.
<P>
The ``Standard MIDI File'' document describes a <SPAN CLASS="textit">Lyric</SPAN> Meta-event:
<P>
<P>
<BLOCKQUOTE><SPAN CLASS="textbf">FF 05 len text <SPAN CLASS="textit">Lyric</SPAN>.</SPAN> A lyric to be sung.
Generally, each syllable will be a separate lyric event which begins
at the event's time.<A NAME="tex2html37"
HREF="#foot3694"><SUP><SPAN CLASS="arabic">9</SPAN>.<SPAN CLASS="arabic">2</SPAN></SUP></A></BLOCKQUOTE>
<P>
<P>
Unfortunately, not all players and creators follow the
specification--the most notable exception are ``.kar'' files. These
files eschew the <SPAN CLASS="textit">Lyric</SPAN> event and place their lyrics as a
<SPAN CLASS="textit">Text Event</SPAN>. There are programs strewn on the net which convert
between the two formats (but I really don't know if
conversion is needed).
<P>
If you want to read the word from the source, refer to the official
MIDI lyrics documentation at
<TT><A NAME="tex2html38"
HREF="http://www.midi.org/about-midi/smf/rp017.shtml">http://www.midi.org/about-midi/smf/rp017.shtml</A></TT>.
<P>
<H1><A NAME="SECTION00910000000000000000">
Lyric Options</A>
</H1>
<P>
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> has a number of options in setting lyrics. They are all called
via the L<SMALL>YRIC</SMALL> command. Most options are set as option/setting
pairs with the option name and the setting joined with an ``=''.
<P>
<H2><A NAME="SECTION00911000000000000000">
Event Type</A>
</H2>
<P>
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> supports both format for lyrics (discussed above). The
EVENT option is used to select the desired mode.
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Lyric EVENT=LYRIC </B>
</td></tr>
</Table>
<P>
selects the default L<SMALL>YRIC </SMALL>E<SMALL>VENT</SMALL> mode.
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Lyric EVENT=TEXT </B>
</td></tr>
</Table>
<P>
selects the T<SMALL>EXT </SMALL>E<SMALL>VENT</SMALL> mode. Use of this option also prints a
warning message.
<P>
<H2><A NAME="SECTION00912000000000000000">
Word Splitting</A>
</H2>
<P>
Another option controlled by the L<SMALL>YRIC</SMALL> command is to determine
the method used to split words. As mentioned earlier (and in various
MIDI documents), the lyrics should be split into syllables.
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> does
this by taking each word (anything with white space surrounding it)
and setting a MIDI event for that. However, depending on your player,
you might want only one event per bar. You might even want to put the
lyrics for several bars into one event. In this case simply set the
``bar at a time'' flag:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Lyric SPLIT=BAR </B>
</td></tr>
</Table>
<P>
You can return to normal (syllable/word) mode at anytime with:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Lyric SPLIT=NORMAL </B>
</td></tr>
</Table>
<P>
<H1><A NAME="SECTION00920000000000000000">
Chord Name Insertion</A>
</H1>
<P>
It is possible to have
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> duplicate the current chord names and
insert them as a lyrics. The option:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Lyric CHORDS=On </B>
</td></tr>
</Table>
<P>
will enable this. In this mode the chord line is parsed and inserted
as verse one into each bar.
<P>
The mode is enabled with ``On'' or ``1'' and disabled with ``Off'' or
``0''.
<P>
After the chords are extracted they are treated exactly like a verse
you have entered as to word splitting, etc. Note that the special
chord ``z'' is converted to ``N.C.'' and directives after the ``z'' in
constructs like ``C7zCS'' will appear with only the chord name.
<P>
<H2><A NAME="SECTION00921000000000000000">
Chord Transposition</A>
</H2>
<P>
If you are transposing a piece or if you with to display the chords
for a guitar with a cappo you can tell
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> to transpose the chord
names inserted with C<SMALL>HORDS=</SMALL>O<SMALL>N</SMALL>. Just add a transpose directive
in the L<SMALL>YRIC</SMALL> command:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Lyric CHORDS=On Transpose=2 </B>
</td></tr>
</Table>
<P>
Please note that the Lyrics code does <SPAN CLASS="textit">not</SPAN> look at the global
T<SMALL>RANSPOSE</SMALL> setting.<A NAME="tex2html39"
HREF="#foot3720"><SUP><SPAN CLASS="arabic">9</SPAN>.<SPAN CLASS="arabic">3</SPAN></SUP></A>
<P>
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> isn't too smart in it's transposition and will often display the
``wrong'' chord names in relation to ``sharp'' and ``flat'' names. If
you find that you are getting too many ``wrong'' names, try setting
the CN<SMALL>AMES</SMALL> option to either ``Sharp'' or ``Flat''. Another
example:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Lyric CHORDS=On Transpose=2 CNames=Flat </B>
</td></tr>
</Table>
<P>
By default, the ``flat'' setting is used. In addition to ``Flat'' and
``Sharp'' you can use the abbreviations ``#'', ``b'' and ``SPMamp;''.
<P>
You can (and may well need to) change the CN<SMALL>AMES</SMALL> setting
anywhere in the song.
<P>
<H1><A NAME="SECTION00930000000000000000">
Setting Lyrics</A>
</H1>
<P>
Adding a lyric to your song is a simple matter ...and like so many
things, there is more than one way to do it.
<P>
Lyrics can be set for a bar in-between a pair of <SPAN CLASS="textbf">[]</SPAN>s
somewhere in a data bar.<A NAME="tex2html40"
HREF="#foot3726"><SUP><SPAN CLASS="arabic">9</SPAN>.<SPAN CLASS="arabic">4</SPAN></SUP></A> For
example:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>z [ Pardon ]
<BR>
C [ me, If I'm ]
<BR>
E7 [ sentimental, &#92;r]
<BR>
C [when we say good ] </B>
</td></tr>
</Table>
<P>
The alternate method is to use the L<SMALL>YRIC </SMALL>S<SMALL>ET</SMALL> directive:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Lyric Set Hello Young Lovers </B>
</td></tr>
</Table>
<P>
Unlike the other L<SMALL>YRIC</SMALL> options, the S<SMALL>ET</SMALL> option must be
the last one on a line, and it does not use the ``='' sign. If you are
setting the lyric for a single verse the <SPAN CLASS="textbf">[]</SPAN>s are optional;
however, for multiple verses they are used (just like they are when
you include the lyric in a data/chord line). The advantage to using
L<SMALL>YRIC </SMALL>S<SMALL>ET</SMALL> is that you can specify multiple bars of lyrics at
one point in your file. See the sample file <TT><SPAN CLASS="textbf">egs/lyrics.mma</SPAN></TT> for
an example.
<P>
The lyrics for each bar are separated into individual events, one for
each word ...unless the option S<SMALL>PLIT=</SMALL>B<SMALL>AR</SMALL> has been used, in
which case the entire lyric is placed at the offset corresponding to
the start of the bar.
<P>
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> recognizes two special characters in a L<SMALL>YRIC</SMALL>:
<P>
<UL>
<LI>A <SPAN CLASS="textbf"> &#92;r</SPAN> is converted into an EOL character (hex
value 0x0D). A <SPAN CLASS="textbf"> &#92;r</SPAN> should appear at the end of each
lyrical line.
<P>
</LI>
<LI>A <SPAN CLASS="textbf"> &#92;n</SPAN> is converted into a LF character (hex
value 0x0A). A <SPAN CLASS="textbf"> &#92;n</SPAN> should appear at the end of each
verse or paragraph.
<P>
</LI>
</UL>
<P>
When a multi-verse section is created using a R<SMALL>EPEAT</SMALL> or
G<SMALL>OTO</SMALL>, different lyrics can be specified for different passes.
In this case you simply specify two more sets of lyrics:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>A / Am / [First verse] [Second Verse] </B>
</td></tr>
</Table>
<P>
However, for this work properly you must set the internal counter
L<SMALL>YRIC</SMALL>V<SMALL>ERSE</SMALL> for any verse other than 1. This counter is set with
the command:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Lyric Verse=Value | INC | DEC </B>
</td></tr>
</Table>
<P>
This means that you can directly set the value (the default value is
1) with a command like:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Lyric Verse=2 </B>
</td></tr>
</Table>
<P>
And you can increment or decrement the value with the INC and
DEC options. This is handy at to use in repeat sections:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Lyric Verse=Inc </B>
</td></tr>
</Table>
<P>
You cannot set the value to a value less than 1.
<P>
There are a couple of special cases:
<P>
<UL>
<LI>If there is only one set of lyrics in a line, it will be treated
as text for verse 1, regardless of the value of L<SMALL>YRIC</SMALL>V<SMALL>ERSE</SMALL>.
<P>
</LI>
<LI>If the value of L<SMALL>YRIC</SMALL>V<SMALL>ERSE</SMALL> is greater than the number of
verses found after splitting the line, then no lyrics are produced.
In most cases this is probably not what you want.
<P>
</LI>
</UL>
<P>
At times you may wish to override
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> 's method of determining the
beat offsets for a lyric or a single syllable in a lyric. You can
specify the beat in the bar by enclosing the value in ``<SPAN CLASS="MATH"><IMG
WIDTH="33" HEIGHT="33" ALIGN="MIDDLE" BORDER="0"
SRC="img2.png"
ALT="$&lt; &gt;$"></SPAN>''
brackets. For example, suppose that your song starts with a pickup bar
and you'd like the lyrics for the first bar to start on beat 4:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>z z z C [ &lt;4&gt;Hello ]
<BR>
F [ Young lovers ] </B>
</td></tr>
</Table>
<P>
Assuming <SPAN CLASS="textbf">4/4</SPAN> the above would put the word ``Hello'' at beat
4 of the first bar; ``Young'' on the first beat of bar 2; and
``lovers'' on beat 3 of bar 2.
<P>
Note: there must not be a space inside the ``<SPAN CLASS="MATH"><IMG
WIDTH="33" HEIGHT="33" ALIGN="MIDDLE" BORDER="0"
SRC="img2.png"
ALT="$&lt; &gt;$"></SPAN>'', nor can there be
a space between the bracket and the syllable it applies to.
<P>
Only the first ``<SPAN CLASS="MATH"><IMG
WIDTH="33" HEIGHT="33" ALIGN="MIDDLE" BORDER="0"
SRC="img2.png"
ALT="$&lt; &gt;$"></SPAN>'' is checked. So, if you really want to have
the characters ``<SPAN CLASS="MATH"><IMG
WIDTH="19" HEIGHT="33" ALIGN="MIDDLE" BORDER="0"
SRC="img3.png"
ALT="$&lt;$"></SPAN>'' or ``<SPAN CLASS="MATH"><IMG
WIDTH="19" HEIGHT="33" ALIGN="MIDDLE" BORDER="0"
SRC="img4.png"
ALT="$&gt;$"></SPAN>'' in a lyric just include a dummy to
keep
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> happy:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>C [ &lt;&gt;&lt;Verse_1.&gt;This is a Demo ] </B>
</td></tr>
</Table>
<P>
<A HREF="#eg:twk">This example</A><A NAME="tex2html41"
HREF="#foot3791"><SUP><SPAN CLASS="arabic">9</SPAN>.<SPAN CLASS="arabic">5</SPAN></SUP></A> shows a complete
song with lyrics. You should also examine the file
<TT><SPAN CLASS="textbf">egs/lyrics.mma</SPAN></TT> for an alternate example.
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="#efefef" Border=3>
<tr><td Align="CENTER" BGColor="White">
<SPAN CLASS="textbf"><BIG CLASS="XLARGE">Twinkle, Twinkle, Little Star</BIG></SPAN> <A NAME="eg:twk"></A>
</tr> </td>
<tr> <td >
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Tempo 200
<BR>
Groove Folk
<BR>
Repeat
<BR>&nbsp;&nbsp;1 G [Twinkle,] [When the]
<BR>&nbsp;&nbsp;2 G [Twinkle] [blazing ]
<BR>&nbsp;&nbsp;3 C [little] [sun is]
<BR>&nbsp;&nbsp;4 G [star; &#92;r] [gone, &#92;r]
<BR>&nbsp;&nbsp;5 Am [How I] [When he ]
<BR>&nbsp;&nbsp;6 G [wonder] [nothing]
<BR>&nbsp;&nbsp;7 D7 [what you] [shines u-]
<BR>&nbsp;&nbsp;8 G [are. &#92;r] [pon. &#92;r]
<BR>&nbsp;&nbsp;9 G [Up a-] [then you]
<BR>&nbsp;&nbsp;10 D7 [bove the] [show your]
<BR>&nbsp;&nbsp;11 G [world so] [little]
<BR>&nbsp;&nbsp;12 D [high, &#92;r] [light, &#92;r]
<BR>&nbsp;&nbsp;13 G [Like a] [Twinkle, ]
<BR>&nbsp;&nbsp;14 D7 [diamond] [twinkle,]
<BR>&nbsp;&nbsp;15 G [in the] [all the]
<BR>&nbsp;&nbsp;16 D7 [sky! &#92;r] [night. &#92;r]
<BR>&nbsp;&nbsp;17 G [Twinkle,]
<BR>&nbsp;&nbsp;18 G [twinkle]
<BR>&nbsp;&nbsp;19 C [Little]
<BR>&nbsp;&nbsp;20 G [star, &#92;r]
<BR>&nbsp;&nbsp;21 Am [How I]
<BR>&nbsp;&nbsp;22 G [wonder]
<BR>&nbsp;&nbsp;23 D7 [what you]
<BR>&nbsp;&nbsp;24 G [are. &#92;r &#92;n]
<BR>&nbsp;
<BR>&nbsp;&nbsp;Lyric Verse=Inc
<BR>
RepeatEnd </B>
</td></tr>
</Table>
</td> </tr>
</Table>
<P>
<P>
<H2><A NAME="SECTION00931000000000000000">
Limitations</A>
</H2>
<P>
A few combinations are not permitted:
<P>
<UL>
<LI>You cannot specify lyrics in bars that are being repeated with
the ``*'' option.
<P>
</LI>
<LI>You cannot insert lyrics with L<SMALL>YRIC </SMALL>S<SMALL>ET</SMALL> and [<SMALL>STUFF]</SMALL>.
<P>
</LI>
</UL>
<BR><HR><H4>Footnotes</H4>
<DL>
<DT><A NAME="foot3690">...
platforms</A><A
HREF="node9.html#tex2html36"><SUP><SPAN CLASS="arabic">9</SPAN>.<SPAN CLASS="arabic">1</SPAN></SUP></A></DT>
<DD>Pointers and reviews to other players would be
would appreciated.
</DD>
<DT><A NAME="foot3694">... time.</A><A
HREF="node9.html#tex2html37"><SUP><SPAN CLASS="arabic">9</SPAN>.<SPAN CLASS="arabic">2</SPAN></SUP></A></DT>
<DD>I am quoting from ``MIDI
Documentation'' distributed with the TSE Library. Pete Goodliffe,
Oct. 21, 1999. Page 41.
</DD>
<DT><A NAME="foot3720">... setting.</A><A
HREF="node9.html#tex2html39"><SUP><SPAN CLASS="arabic">9</SPAN>.<SPAN CLASS="arabic">3</SPAN></SUP></A></DT>
<DD>This is a feature! It permits you
to have separate control over music generation and chord symbol
display.
</DD>
<DT><A NAME="foot3726">... bar.</A><A
HREF="node9.html#tex2html40"><SUP><SPAN CLASS="arabic">9</SPAN>.<SPAN CLASS="arabic">4</SPAN></SUP></A></DT>
<DD>Although the lyric can be placed
anywhere in the bar, it is recommended that you only place the lyric at
the end of the bar. All the examples follow this style.
</DD>
<DT><A NAME="foot3791">...eg:twk</A><A
HREF="node9.html#tex2html41"><SUP><SPAN CLASS="arabic">9</SPAN>.<SPAN CLASS="arabic">5</SPAN></SUP></A></DT>
<DD>Included in
this distribution as <TT><SPAN CLASS="textbf">songs/twinkle.mma</SPAN></TT>.
</DD>
</DL>
<DIV CLASS="navigation"><HR>
<!--Navigation Panel-->
<A NAME="tex2html473"
HREF="node10.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html471"
HREF="mma.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html465"
HREF="node8.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html474"
HREF="node10.html">Solo and Melody Tracks</A>
<B> Up:</B> <A NAME="tex2html472"
HREF="mma.html">Reference Manual</A>
<B> Previous:</B> <A NAME="tex2html466"
HREF="node8.html">Musical Data Format</A></DIV>
<!--End of Navigation Panel-->
<ADDRESS>
bob
2008-09-28
</ADDRESS>
</BODY>
</HTML>