Next: Solo and Melody Tracks Up: Reference Manual Previous: Musical Data Format
MIDI files can include song lyrics. And some MIDI players or sequencers can display them as a file is played. Some, but not all.
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 Kmid which displays and highlights lyrics almost in a Karaoke manner, xplaymidi and timidity which display the lyrics in a secondary panel.
With this qualifier out of the way, there really is no reason for lyrics NOT to be useful in a program like MMA . Singers do not want a melody playing while they are vocalizing (really, they are no different in this than any other instrumentalist). And some platforms9.1 other than Linux support lyric display in a more useful format.
The ``Standard MIDI File'' document describes a Lyric Meta-event:
FF 05 len text Lyric. A lyric to be sung. Generally, each syllable will be a separate lyric event which begins at the event's time.9.2
Unfortunately, not all players and creators follow the specification--the most notable exception are ``.kar'' files. These files eschew the Lyric event and place their lyrics as a Text Event. There are programs strewn on the net which convert between the two formats (but I really don't know if conversion is needed).
If you want to read the word from the source, refer to the official MIDI lyrics documentation at http://www.midi.org/about-midi/smf/rp017.shtml.
MMA has a number of options in setting lyrics. They are all called via the LYRIC command. Most options are set as option/setting pairs with the option name and the setting joined with an ``=''.
MMA supports both format for lyrics (discussed above). The EVENT option is used to select the desired mode.
| Lyric EVENT=LYRIC |
selects the default LYRIC EVENT mode.
| Lyric EVENT=TEXT |
selects the TEXT EVENT mode. Use of this option also prints a warning message.
Another option controlled by the LYRIC 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. MMA 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:
| Lyric SPLIT=BAR |
You can return to normal (syllable/word) mode at anytime with:
| Lyric SPLIT=NORMAL |
It is possible to have MMA duplicate the current chord names and insert them as a lyrics. The option:
| Lyric CHORDS=On |
will enable this. In this mode the chord line is parsed and inserted as verse one into each bar.
The mode is enabled with ``On'' or ``1'' and disabled with ``Off'' or ``0''.
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.
If you are transposing a piece or if you with to display the chords for a guitar with a cappo you can tell MMA to transpose the chord names inserted with CHORDS=ON. Just add a transpose directive in the LYRIC command:
| Lyric CHORDS=On Transpose=2 |
Please note that the Lyrics code does not look at the global TRANSPOSE setting.9.3
MMA 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 CNAMES option to either ``Sharp'' or ``Flat''. Another example:
| Lyric CHORDS=On Transpose=2 CNames=Flat |
By default, the ``flat'' setting is used. In addition to ``Flat'' and ``Sharp'' you can use the abbreviations ``#'', ``b'' and ``SPMamp;''.
You can (and may well need to) change the CNAMES setting anywhere in the song.
Adding a lyric to your song is a simple matter ...and like so many things, there is more than one way to do it.
Lyrics can be set for a bar in-between a pair of []s somewhere in a data bar.9.4 For example:
|
z [ Pardon ]
C [ me, If I'm ] E7 [ sentimental, \r] C [when we say good ] |
The alternate method is to use the LYRIC SET directive:
| Lyric Set Hello Young Lovers |
Unlike the other LYRIC options, the SET 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 []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 LYRIC SET is that you can specify multiple bars of lyrics at one point in your file. See the sample file egs/lyrics.mma for an example.
The lyrics for each bar are separated into individual events, one for each word ...unless the option SPLIT=BAR has been used, in which case the entire lyric is placed at the offset corresponding to the start of the bar.
MMA recognizes two special characters in a LYRIC:
When a multi-verse section is created using a REPEAT or GOTO, different lyrics can be specified for different passes. In this case you simply specify two more sets of lyrics:
| A / Am / [First verse] [Second Verse] |
However, for this work properly you must set the internal counter LYRICVERSE for any verse other than 1. This counter is set with the command:
| Lyric Verse=Value | INC | DEC |
This means that you can directly set the value (the default value is 1) with a command like:
| Lyric Verse=2 |
And you can increment or decrement the value with the INC and DEC options. This is handy at to use in repeat sections:
| Lyric Verse=Inc |
You cannot set the value to a value less than 1.
There are a couple of special cases:
At times you may wish to override
MMA '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 ``
''
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:
|
z z z C [ <4>Hello ]
F [ Young lovers ] |
Assuming 4/4 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.
Note: there must not be a space inside the ``'', nor can there be
a space between the bracket and the syllable it applies to.
Only the first ``'' is checked. So, if you really want to have
the characters ``
'' or ``
'' in a lyric just include a dummy to
keep
MMA happy:
| C [ <><Verse_1.>This is a Demo ] |
This example9.5 shows a complete song with lyrics. You should also examine the file egs/lyrics.mma for an alternate example.
A few combinations are not permitted: