Next: Lyrics Up: Reference Manual Previous: Riffs
Compared to patterns, sequences, grooves and the various directives used in MMA , the actual bar by bar chord notations are surprisingly simple.
Any line in your input file which is not a directive or comment is assumed to be a bar of chord data.
A line for chord data consists of the following parts:
Formally, this becomes:
| [num] Chord [Chord ...] [lyric] [solo] [* Factor] |
As you can see, all that is really needed is a single chord. So, the line:
| Cm |
is completely valid. As is:
| 10 Cm Dm Em Fm * 4 |
The optional solo or melody data is enclosed in “{ }”s. The complete format and use is detailed in the Solo and Melody Tracks.
Lyrics are enclosed in ”[ ]” brackets. See the Lyrics section.
The optional leading bar number is silently discarded by MMA . It is really just a specialized comment which helps you debug your music. Note that only a numeric item is permitted here.
Get in the habit of using bar numbers. You'll thank yourself when a song seems to be missing a bar, or appears to have an extra one. Without the leading bar numbers it can be quite frustrating to match your input file to a piece of sheet music.8.1
One important use of the leading bar number is for the -b command line option detailed here.
You should note that it is perfectly acceptable to have only a bar number on a line. This is common when you are using bar repeat, for example:
|
1 Cm * 4
2 3 4 5 A |
In the above example bars 2, 3 and 4 are comment bars.
Quite often music has several sequential identical bars. Instead of typing these bars over and over again, MMA has an optional multiplier which can be placed at the end of a line of music data. The multiplier or factor can is specified as “* NN” This will cause the current bar to repeated the specified number of times. For example:
| Cm / Dm / * 4 |
produces 4 bars of output with each the first 2 beats of each bar a Cm chord and the last 2 a Dm. (The “/” is explained below.)
The most important part of a musical data line is, of course, the chords. You can specify a different chord for each beat in your music. For example:
| Cm Dm Em Fm |
specifies four different chords in a bar. It should be obvious by now that in a piece in 4/4 you'll end up with a “Cm” chord on beat 1, “Dm” on 2, etc.
If you have fewer chord names than beats, the bar will be filled automatically with the last chord name on the line. In other words:
| Cm |
and
| Cm Cm Cm Cm |
are equivalent (assuming 4 beats per bar). There must be one (or more) spaces between each chord.
One further shorthand is the “/”. This simply means to repeat the last chord. So:
| Cm / Dm / |
is the same as
| Cm Cm Dm Dm |
It is perfectly okay to start a line with a “/”. In this case the last chord from the previous line is used. If the first line of music data begins with a “/” you'll get an error-- MMA tries to be smart, but it doesn't read minds. Having “/” at the end of the bar is a tad silly since MMA just ends up throwing these away, but it does no harm.
MMA recognizes a wide variety of chords in standard and Roman numeral notation. In addition, you can specify slash chords, inversions, barre offsets, and shift the octave up or down. Refer to the complete table in the appendix for details.
To disable a voice for a beat you can use a “z” for a chord name. If used by itself a “z” will disable all but the drum tracks for the given beat. However, you can disable “Chord”, “Arpeggio”, “Scale”, “Walk”, “Aria”, or “Bass” tracks as well by appending a track specifier to the “z”. Track specifiers are the single letters “C”, “A”, “S”, “W”, “B”, “R” or `D” and “!”. Track specifiers are only valid if you also specify a chord. The track specifiers are:
Assuming the “C” is the chord and “AB” are the track specifiers:
Assuming that you have a drum, chord and bass pattern defined:
| Fm z G7zC CmzD |
would generate the following beats:
In addition, there is a super-z notation. “z!” forces all instruments to be silent for the given beats. “z!” is the same as “zABCDWR”, except that the latter is not valid since it needs a prefixed chord.
The “z” notation is used when you have a “tacet” beat or beats. The alternate notations can be used to silence specific tracks for a beat or two, but this is used less frequently.
In earlier versions of MMA all chords (and rests) were positioned on the beat, and one could only specify a limited number of chord changes per bar. Using the enhanced positioning syntax an unlimited number of chord changes per bar can be specified. But, please note the changes you hear in your song depend on the specific pattern you are using! You might specify a chord at, for example, beat 2.25, but if the pattern doesn't sound a chord at that position it's a bit silly.
As discussed above, a normal set of chord changes is entered like:
| Cm / Dm |
which sets a “Cm” for beats 1 and 2, and “Dm” for beats 3 to the bar end.
To modify this, you can use the “@” symbol along with an offset to indicate other changes. So, the above example could also be written as:
| Cm Dm@3 |
Changing on the “off beat” is simple as well. Consider,
| C D@3.5 F |
In this case the “C” chord is in effect from the first beat until beat 3.5, a “D” chord is set for 3.5 until 4, and an “F” from 4 to the end of bar.
In parsing, when MMA finds a chord name without the “@” it assumes that the position is the next full beat after the previous chord ... which means that in the above example “F” and “F@4” are equivalent.
| Cm Dm E@1.5 |
would generate an error.
In direct conflict with the rest of the rules for input files, all chord names (and modifiers) are case sensitive. This means that you can not use notations like “cm”--use “Cm” instead.
The “z” and the associated track specifiers are also case sensitive. For example, the form “Zc” will not work!