VocalEasel/mma/docs/html/ref/node6.html

895 lines
24 KiB
HTML
Raw Normal View History

2009-05-17 22:34:44 +00:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2006-11-10 08:07:56 +00:00
2011-07-26 22:49:39 +00:00
<!--Converted with LaTeX2HTML 2008 (1.71)
2006-11-10 08:07:56 +00:00
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>Grooves</TITLE>
<META NAME="description" CONTENT="Grooves">
<META NAME="keywords" CONTENT="mma">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
2011-07-26 22:49:39 +00:00
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8">
<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
2006-11-10 08:07:56 +00:00
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="mma.css">
<LINK REL="next" HREF="node7.html">
<LINK REL="previous" HREF="node5.html">
<LINK REL="up" HREF="mma.html">
<LINK REL="next" HREF="node7.html">
</HEAD>
<BODY bgcolor="#ffffff">
2009-05-17 22:34:44 +00:00
<DIV CLASS="navigation"><!--Navigation Panel-->
2011-07-26 22:49:39 +00:00
<A NAME="tex2html487"
2006-11-10 08:07:56 +00:00
HREF="node7.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
2011-07-26 22:49:39 +00:00
<A NAME="tex2html485"
2006-11-10 08:07:56 +00:00
HREF="mma.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
2011-07-26 22:49:39 +00:00
<A NAME="tex2html479"
2006-11-10 08:07:56 +00:00
HREF="node5.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<BR>
2011-07-26 22:49:39 +00:00
<B> Next:</B> <A NAME="tex2html488"
2006-11-10 08:07:56 +00:00
HREF="node7.html">Riffs</A>
2011-07-26 22:49:39 +00:00
<B> Up:</B> <A NAME="tex2html486"
2006-11-10 08:07:56 +00:00
HREF="mma.html">Reference Manual</A>
2011-07-26 22:49:39 +00:00
<B> Previous:</B> <A NAME="tex2html480"
2006-11-10 08:07:56 +00:00
HREF="node5.html">Sequences</A>
<BR>
2009-05-17 22:34:44 +00:00
<BR></DIV>
2006-11-10 08:07:56 +00:00
<!--End of Navigation Panel-->
<!--Table of Child-Links-->
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
2009-05-17 22:34:44 +00:00
<UL CLASS="ChildLinks">
2011-07-26 22:49:39 +00:00
<LI><A NAME="tex2html489"
2006-11-10 08:07:56 +00:00
HREF="node6.html#SECTION00610000000000000000">Creating A Groove</A>
2011-07-26 22:49:39 +00:00
<LI><A NAME="tex2html490"
2006-11-10 08:07:56 +00:00
HREF="node6.html#SECTION00620000000000000000">Using A Groove</A>
<UL>
2011-07-26 22:49:39 +00:00
<LI><A NAME="tex2html491"
2006-11-10 08:07:56 +00:00
HREF="node6.html#SECTION00621000000000000000">Overlay Grooves</A>
2007-04-29 06:47:40 +00:00
</UL>
<BR>
2011-07-26 22:49:39 +00:00
<LI><A NAME="tex2html492"
2009-05-17 22:34:44 +00:00
HREF="node6.html#SECTION00630000000000000000">Groove Aliases</A>
2011-07-26 22:49:39 +00:00
<LI><A NAME="tex2html493"
2009-05-17 22:34:44 +00:00
HREF="node6.html#SECTION00640000000000000000">AllGrooves</A>
2011-07-26 22:49:39 +00:00
<LI><A NAME="tex2html494"
2009-05-17 22:34:44 +00:00
HREF="node6.html#SECTION00650000000000000000">Deleting Grooves</A>
2011-07-26 22:49:39 +00:00
<LI><A NAME="tex2html495"
2009-05-17 22:34:44 +00:00
HREF="node6.html#SECTION00660000000000000000">Library Issues</A>
2007-04-29 06:47:40 +00:00
</UL>
2006-11-10 08:07:56 +00:00
<!--End of Table of Child-Links-->
<HR>
<H1><A NAME="SECTION00600000000000000000"></A>
<A NAME="sec-grooves"></A>
<BR>
Grooves
</H1>
<P>
Grooves, in some ways, are
2011-07-26 22:49:39 +00:00
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> 's answer to macros ... but
2006-11-10 08:07:56 +00:00
they are cooler, easier to use, and have a more musical name.
<P>
Really, though, a groove is just a simple mechanism for saving and
restoring a set of patterns and sequences. Using grooves it is easy to
create sequence libraries which can be incorporated into your songs
with a single command.
<P>
<H1><A NAME="SECTION00610000000000000000">
Creating A Groove</A>
</H1>
<P>
A groove can be created at anytime in an input file with the command:
<P>
2007-04-29 06:47:40 +00:00
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>DefGroove SlowRhumba </B>
2006-11-10 08:07:56 +00:00
2007-04-29 06:47:40 +00:00
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
<P>
Optionally, you can include a documentation string to the end of this
command:
<P>
2007-04-29 06:47:40 +00:00
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>DefGroove SlowRumba A descriptive comment! </B>
2006-11-10 08:07:56 +00:00
2007-04-29 06:47:40 +00:00
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
<P>
A groove name can include any character, including digits and
punctuation. However, it cannot include a space character (used as a
2011-07-26 22:49:39 +00:00
delimiter) or a '/'<A NAME="tex2html33"
HREF="#foot2803"><SUP><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">1</SPAN></SUP></A>, nor can consist solely of digits<A NAME="tex2html34"
HREF="#foot2927"><SUP><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">2</SPAN></SUP></A>
2006-11-10 08:07:56 +00:00
<P>
In normal operation the documentation strings are ignored. However,
when
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> is run with the -Dx command line option these strings are
2009-05-17 22:34:44 +00:00
printed to the terminal screen in <SPAN CLASS="logo,LaTeX">L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X</SPAN> format. The standard library
document is generated from this data. The comments <SPAN CLASS="textit">must</SPAN> be
2011-07-26 22:49:39 +00:00
suitable for <SPAN CLASS="logo,LaTeX">L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X</SPAN>: this means that special symbols like &#8220;#&#8221;,
&#8220;&amp;&#8221;, etc. must be &#8220;quoted&#8221; with a preceding &#8220; &#92;&#8221;.
2006-11-10 08:07:56 +00:00
<P>
At this point the following information is saved:
<P>
<UL>
<LI>Current Sequence size,
</LI>
<LI>The current sequence for each track,
</LI>
<LI>Time setting (quarter notes per bar),
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Accent&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Articulation&#8221; settings for each track,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Compress&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Direction&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;DupRoot&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Harmony&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;HarmonyOnly&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;HarmonyVolume&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Invert&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Limit&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Mallet&#8221; (rate and decay),
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;MidiSeq&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;MidiVoice&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;MidiClear&#8221;
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;NoteSpan&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Octave&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Range&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;RSkip&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Rtime&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Rvolume&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Scale&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;SeqRnd&#8221;, globally and for each track,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;SeqRndWeight&#8221;, globally and for each track,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Strum&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;SwingMode&#8221; Status and Skew,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Time Signature&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Tone&#8221; for drum tracks,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Unify&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Voice&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;VoicingCenter&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;VoicingMode&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;VoicingMove&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;VoicingRange&#8221;,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;Volume&#8221; for tracks and master,
2006-11-10 08:07:56 +00:00
</LI>
2011-07-26 22:49:39 +00:00
<LI>&#8220;VolumeRatio&#8221;.
2006-11-10 08:07:56 +00:00
<P>
</LI>
</UL>
<P>
<H1><A NAME="SECTION00620000000000000000">
Using A Groove</A>
</H1>
<P>
You can restore a previously defined groove at anytime in your song
with:
<P>
2007-04-29 06:47:40 +00:00
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Groove Name </B>
2006-11-10 08:07:56 +00:00
2007-04-29 06:47:40 +00:00
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
<P>
At this point all of the previously saved information is restored.
<P>
A few cautions:
<P>
<UL>
2009-05-17 22:34:44 +00:00
<LI>Pattern definitions are <SPAN CLASS="textit">not</SPAN> saved in grooves. Redefining
2006-11-10 08:07:56 +00:00
a pattern results in a new pattern definition. Sequences use the
pattern definition in effect when the sequence is declared.
<P>
</LI>
2011-07-26 22:49:39 +00:00
<LI>The &#8220;SeqSize&#8221; setting is restored with a groove. The sequence
2006-11-10 08:07:56 +00:00
point is also reset to bar 1. If you have multi-bar sequences,
restoring a groove may upset your idea of the sequence pattern.
<P>
</LI>
</UL>
<P>
To make life (infinitely) more interesting, you can specify more than
one previously defined groove. In this case the next groove is
selected after each bar. For example:
<P>
2007-04-29 06:47:40 +00:00
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Groove Tango LightTango LightTangoSus LightTango </B>
2006-11-10 08:07:56 +00:00
2007-04-29 06:47:40 +00:00
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
<P>
would create the following bars:
<P>
<OL>
<LI>Tango
</LI>
<LI>LightTango
</LI>
<LI>LightTangoSus
</LI>
<LI>LightTango
</LI>
<LI>Tango
</LI>
</OL>
<P>
Note how the groove pattern wraps around to the first one when the
list is exhausted. There is no way to select an item from the list,
except by going though it.
<P>
You might find this handy if you have a piece with an alternating time
2009-05-17 22:34:44 +00:00
signature. For example, you might have a <SPAN CLASS="textbf">3/4</SPAN> <SPAN CLASS="textbf">4/4</SPAN>
2006-11-10 08:07:56 +00:00
song. Rather than creating a 2 bar groove, you could do something
like:
<P>
2007-04-29 06:47:40 +00:00
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Groove Groove34 Groove44 </B>
2006-11-10 08:07:56 +00:00
2007-04-29 06:47:40 +00:00
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
<P>
2011-07-26 22:49:39 +00:00
For long lists you can use the &#8220;/&#8221; to repeat the last groove in the
2006-11-10 08:07:56 +00:00
list. The example above could be written:
<P>
2007-04-29 06:47:40 +00:00
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Groove Tango LightTango LightTangoSus / </B>
2006-11-10 08:07:56 +00:00
2007-04-29 06:47:40 +00:00
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
<P>
2011-07-26 22:49:39 +00:00
When you use the &#8220;list&#8221; feature of G<SMALL>ROOVE</SMALL>s you should be
2006-11-10 08:07:56 +00:00
aware of what happens with the bar sequence number. Normally the
sequence number is incremented after each bar is processed; and, when
a new groove is selected the sequence number is reset (see S<SMALL>EQ</SMALL>,
2011-07-26 22:49:39 +00:00
<A HREF="node24.html#seqnumber">discussed here)</A>. When
2006-11-10 08:07:56 +00:00
you use a list which changes the G<SMALL>ROOVE</SMALL> after each bar the
2011-07-26 22:49:39 +00:00
sequence number is reset after each bar ... with one exception: if
2006-11-10 08:07:56 +00:00
the same G<SMALL>ROOVE</SMALL> is being used for two or more bars the sequence
2011-07-26 22:49:39 +00:00
will not be reset.<A NAME="tex2html35"
HREF="#foot2928"><SUP><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">3</SPAN></SUP></A>
2006-11-10 08:07:56 +00:00
<P>
2011-07-26 22:49:39 +00:00
Another way to select G<SMALL>ROOVE</SMALL>s is to use a list of grooves with a leading value. This lets you select the G<SMALL>ROOVE</SMALL> to use based on the value of a variable ... handy if you want different sounds for repeated sections. Again, an example:
2006-11-10 08:07:56 +00:00
<P>
2007-04-29 06:47:40 +00:00
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Set loop 1 // create counter with value of 1
2006-11-10 08:07:56 +00:00
<BR>
Repeat
<BR>&nbsp;&nbsp;Groove $loop BossaNovaSus BossaNova1Sus BossaNovaFill
2009-05-17 22:34:44 +00:00
<BR>&nbsp;&nbsp;print This is loop $Loop ...Groove is $_Groove
2006-11-10 08:07:56 +00:00
<BR>&nbsp;&nbsp;1 A / Am
<BR>&nbsp;&nbsp;Inc Loop // Bump the counter value
<BR>
RepeatEnd 4
2007-04-29 06:47:40 +00:00
</B>
2006-11-10 08:07:56 +00:00
2007-04-29 06:47:40 +00:00
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
<P>
2011-07-26 22:49:39 +00:00
If you use this option, make sure the value of the counter is greater than 0. Also, note that the values larger than the list count are &#8220;looped&#8221; to be valid. The use of &#8220;/&#8221;s for repeated names is also permitted. For an example have a look at the file <TT><SPAN CLASS="textbf">grooves.mma</SPAN></TT>, included in this distribution. You could get the same results with various &#8220;if&#8221; statements, but this is easier.
2006-11-10 08:07:56 +00:00
<P>
<H2><A NAME="SECTION00621000000000000000">
Overlay Grooves</A>
</H2>
<P>
To make the creation of variations easier, you can use G<SMALL>ROOVE</SMALL>
in a track setting:
<P>
2007-04-29 06:47:40 +00:00
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Scale Groove Funny </B>
2006-11-10 08:07:56 +00:00
2007-04-29 06:47:40 +00:00
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
<P>
In this case only the information saved in the corresponding
D<SMALL>EF</SMALL>G<SMALL>ROOVE </SMALL>F<SMALL>UNNY</SMALL> for the S<SMALL>CALE</SMALL> track will be restored.
2011-07-26 22:49:39 +00:00
You might think of this as a &#8220;groove overlay&#8221;. Have a look at the
sample song &#8220;Yellow Bird&#8221; for an example.
2006-11-10 08:07:56 +00:00
<P>
When restoring track grooves, as in the above example, the
S<SMALL>EQ</SMALL>S<SMALL>IZE</SMALL> is not reset. The sequence size of the restored track
is adjusted to fit the current sequence size setting.
<P>
2011-07-26 22:49:39 +00:00
One caution with these &#8220;overlays&#8221; is that no check is done to see if
2006-11-10 08:07:56 +00:00
the track you're using exists. Yes, the G<SMALL>ROOVE</SMALL> must have been
defined, but not the track. Huh? Well, you need to know a bit about
how
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> parses files and how it handles new tracks. When
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> reads
a line in a file it first checks to see if the first word on the line
is a simple command like P<SMALL>RINT</SMALL>, MIDI or any other
command which doesn't require a leading trackname. If it is, the
appropriate function is called and file parsing continues. If it is
not a simple command
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> tests to see if it is a track specific
command. But to do that, it first has to test the first word to see if
2009-05-17 22:34:44 +00:00
it is a valid track name like <SPAN CLASS="textit">Bass</SPAN> or <SPAN CLASS="textit">Chord-Major</SPAN>. And,
2006-11-10 08:07:56 +00:00
if it is a valid track name and that track doesn't exist, the track is
2011-07-26 22:49:39 +00:00
created ... this is done <SPAN CLASS="textit">before</SPAN> the rest of the command is
2006-11-10 08:07:56 +00:00
processed. So, if you have a command like:
<P>
2007-04-29 06:47:40 +00:00
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Bass-Foo Groove Something </B>
2006-11-10 08:07:56 +00:00
2007-04-29 06:47:40 +00:00
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
<P>
and you really meant to type:
<P>
2007-04-29 06:47:40 +00:00
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Bass-Foe Groove Something </B>
2006-11-10 08:07:56 +00:00
2007-04-29 06:47:40 +00:00
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
<P>
you'll have a number of things happening:
<P>
<OL>
2009-05-17 22:34:44 +00:00
<LI>The track <SPAN CLASS="textit">Bass-Foo</SPAN> will be created. This is not an issue
2006-11-10 08:07:56 +00:00
to be concerned over since no data will be created for this new
track unless you set a S<SMALL>EQUENCE</SMALL> for it.
<P>
</LI>
<LI>As part of the creation, all the existing G<SMALL>ROOVE</SMALL>s will
2009-05-17 22:34:44 +00:00
have the <SPAN CLASS="textit">Bass-Foo</SPAN> track (with its default/empty settings)
2006-11-10 08:07:56 +00:00
added to them.
<P>
</LI>
<LI>And the current setting you think you're modifying with the
2009-05-17 22:34:44 +00:00
<SPAN CLASS="textit">Bass-Foe</SPAN> settings will be created with the <SPAN CLASS="textit">Bass-Foo</SPAN>
2006-11-10 08:07:56 +00:00
settings (which are nothing).
<P>
</LI>
<LI>Eventually you'll wonder why
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> isn't working.
<P>
</LI>
</OL>
<P>
So, be very careful using this command option. Check your spelling.
And use the P<SMALL>RINT</SMALL>A<SMALL>CTIVE</SMALL> command to verify your G<SMALL>ROOVE</SMALL>
creations. A basic test is done by
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> when you use a G<SMALL>ROOVE</SMALL>
in this manner and if the sequence for the named track is not defined
you will get a warning.
<P>
2007-04-29 06:47:40 +00:00
<H1><A NAME="SECTION00630000000000000000">
2009-05-17 22:34:44 +00:00
Groove Aliases</A>
</H1>
<P>
In an attempt to make the entire groove naming issue simpler, an
additional command has been added. More complication to make life
simpler.
<P>
You can create an alias for any defined G<SMALL>ROOVE</SMALL> name with:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>DefAlias NewAlias SomeGroove </B>
</td></tr>
</Table>
<P>
2011-07-26 22:49:39 +00:00
Now you can refer to the groove &#8220;SomeGroove&#8221; with the name
&#8220;NewAlias&#8221;.
2009-05-17 22:34:44 +00:00
<P>
A few rules:
<P>
<UL>
<LI>the alias name must not be the name of a currently defined
groove,
</LI>
<LI>when defining a new groove you cannot use the name of an alias.
</LI>
</UL>
<P>
Groove aliases are a tool designed to make it possible to have a
standard set of groove names in
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> usable at the same time as the
standard library.
<P>
There is a major difference between a groove alias and the simple act
of assigning two names to the same groove. Consider this snippet:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>...define some things ...
<BR>
Defgroove Good
<BR>
Defgroove Good2 </B>
</td></tr>
</Table>
<P>
2011-07-26 22:49:39 +00:00
You now have both &#8220;good&#8221; and &#8220;good2&#8221; assigned to the same set of
2009-05-17 22:34:44 +00:00
sequences, etc. Now, lets change something:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Groove Good
<BR>
Chord Voice Accordion
<BR> ...
<BR> </B>
</td></tr>
</Table>
<P>
2011-07-26 22:49:39 +00:00
Now, the groove &#8220;good&#8221; has an accordion voicing; &#8220;good2&#8221; still has
whatever the old &#8220;good&#8221; had. Compare this with:
2009-05-17 22:34:44 +00:00
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>...define some things ...
<BR>
DefGroove Good
<BR>
DefAlias Good2 Good </B>
</td></tr>
</Table>
<P>
Now, make the same change:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Groove Good
<BR>
Chord Voice Accordion </B>
</td></tr>
</Table>
<P>
2011-07-26 22:49:39 +00:00
By using an alias &#8220;good2&#8221; now points to the changed &#8220;good&#8221;.
2009-05-17 22:34:44 +00:00
<P>
<H1><A NAME="SECTION00640000000000000000">
AllGrooves</A>
</H1>
<P>
There are times when you wish to change a setting in a set of library
files. For example, you like the <SPAN CLASS="textit">Rhumba</SPAN> library sounds, but,
for a particular song you'd like a punchier bass sound. Now, it is
fairly easy to create a new library file for this; or you can set the
new bass settings each time you select a different G<SMALL>ROOVE</SMALL>.
<P>
Much easier is to apply your changes to all the G<SMALL>ROOVE</SMALL>s in the
file. For example:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Use Rhumba
<BR>
Begin AllGrooves
<BR>
Bass Articulate 50
<BR>
Bass Volume +20
<BR>
Walk Articulate 50
<BR>
Walk Volume +10
<BR>
End
<BR> ...</B>
</td></tr>
</Table>
<P>
The A<SMALL>LL</SMALL>G<SMALL>ROOVES</SMALL> command operates by applying its arguments to each
G<SMALL>ROOVE</SMALL> currently defined. This includes the environment you are
currently in, even if this is not a defined G<SMALL>ROOVE</SMALL>.
<P>
You can use the command with or without a track modifier:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>AllGrooves Volume p </B>
</td></tr>
</Table>
<P>
or
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>AllGrooves Chord Octave 5 </B>
</td></tr>
</Table>
<P>
Everything after the directive is interpreted as a legitimate
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> command. A warning message will be displayed if the command had no
2011-07-26 22:49:39 +00:00
effect. The warning &#8220;No tracks affected with ...&#8221; will be
2009-05-17 22:34:44 +00:00
displayed if nothing was done. This could be due to a misspelt command
or track name, or the fact that the specified track does not exist.
<P>
2011-07-26 22:49:39 +00:00
If you want to &#8220;undo&#8221; the effect of the A<SMALL>LL</SMALL>G<SMALL>ROOVES</SMALL> just import
2009-05-17 22:34:44 +00:00
the library file again with:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Use stdlib/rhumba
<BR>
Groove Rhumba </B>
</td></tr>
</Table>
<P>
or remove all the current G<SMALL>ROOVE</SMALL>s from memory with:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>GrooveClear
<BR>
Groove Rhumba </B>
</td></tr>
</Table>
<P>
In both cases you'll end up with the original G<SMALL>ROOVE</SMALL> settings.
<P>
A few notes:
<P>
<UL>
<LI>This command only effects G<SMALL>ROOVE</SMALL>s which have
been loaded into memory either by loading a library file or otherwise
creating a G<SMALL>ROOVE</SMALL>.
<P>
</LI>
<LI>Be careful what commands you use since they are applied rather
blindly. For example, the command:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>AllTracks BeatAdjust 2 </B>
</td></tr>
</Table>
<P>
will insert 2 additional beats for each G<SMALL>ROOVE</SMALL> you have. So, if
you have 10 G<SMALL>ROOVE</SMALL>s you would insert 20 beats. Not what you
intended. T<SMALL>EMPO</SMALL> and other commands will cause similar problems.
<P>
</LI>
</UL>
<P>
<H1><A NAME="SECTION00650000000000000000">
2007-04-29 06:47:40 +00:00
Deleting Grooves</A>
</H1>
<P>
There are times when you might want
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> to forget about all the
G<SMALL>ROOVE</SMALL>s in its memory. Just do a:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>GrooveClear </B>
</td></tr>
</Table>
<P>
at any point in your input file and that is exactly what happens. But,
2011-07-26 22:49:39 +00:00
&#8220;why&#8221;, you may ask, &#8220;would one want to do this?&#8221; One case would be
2007-04-29 06:47:40 +00:00
to force the re-reading of a library file. For example, a library file
might have a user setting like:
<P>
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>If Ndef ChordVoice
<BR>
Set ChordVoice Piano1
<BR>
Endif </B>
</td></tr>
</Table>
<P>
2011-07-26 22:49:39 +00:00
In this case you could set the variable &#8220;ChordVoice&#8221; before loading
2007-04-29 06:47:40 +00:00
any of the G<SMALL>ROOVE</SMALL>s in the file. All works! Now, assume that you
have a repeated section and want to change the voice. Simply changing
2009-05-17 22:34:44 +00:00
the variable <SPAN CLASS="textit">does not work</SPAN>. The library file isn't re-read
since the existing G<SMALL>ROOVE</SMALL> data is already in memory. Using
2007-04-29 06:47:40 +00:00
G<SMALL>ROOVE</SMALL>C<SMALL>LEAR</SMALL> erases the existing data and forces a re-reading of
the library file.
<P>
Please note that low-level setting like MIDI track assignments are
2009-05-17 22:34:44 +00:00
<SPAN CLASS="textit">not</SPAN> changed by this command.
2007-04-29 06:47:40 +00:00
<P>
2009-05-17 22:34:44 +00:00
Groove aliases are also deleted with this command.
2007-04-29 06:47:40 +00:00
2009-05-17 22:34:44 +00:00
<P>
<H1><A NAME="SECTION00660000000000000000">
2006-11-10 08:07:56 +00:00
Library Issues</A>
2007-04-29 06:47:40 +00:00
</H1>
2006-11-10 08:07:56 +00:00
<P>
If you are using a groove from a library file, you just need to do
something like:
<P>
2007-04-29 06:47:40 +00:00
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Groove Rhumba2 </B>
2006-11-10 08:07:56 +00:00
2007-04-29 06:47:40 +00:00
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
<P>
at the appropriate position in your input file.
<P>
2009-05-17 22:34:44 +00:00
One minor problem which <SPAN CLASS="textit">may</SPAN> arise is that more than one library
2006-11-10 08:07:56 +00:00
file has defined the same groove name. This might happen if you have a
third-party library file. For the proposes of this example, lets
2011-07-26 22:49:39 +00:00
assume that the standard library file &#8220;rhumba.mma&#8221; and a second file
&#8220;xyz-rhumba.mma&#8221; both define the groove &#8220;Rhumba2&#8221;. The
<A HREF="node27.html#lib-use">auto-load</A> routines
which search the library database will load the first &#8220;Rhumba2&#8221; it
2006-11-10 08:07:56 +00:00
finds, and the search order cannot be determined. To overcome this
possible problem, do a explicit loading of the correct file. In this
case, simply do:
<P>
2007-04-29 06:47:40 +00:00
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Use xyz-rhumba </B>
2006-11-10 08:07:56 +00:00
2007-04-29 06:47:40 +00:00
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
<P>
near the top of your file. And if you wish to switch to the groove
defined in the standard file, you can always do:
<P>
2007-04-29 06:47:40 +00:00
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Use rhumba </B>
2006-11-10 08:07:56 +00:00
2007-04-29 06:47:40 +00:00
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
<P>
just before the groove call. The U<SMALL>SE</SMALL> will read the specified
2011-07-26 22:49:39 +00:00
file and overwrite the old definition of &#8220;Rhumba2&#8221; with its own.
2006-11-10 08:07:56 +00:00
<P>
2011-07-26 22:49:39 +00:00
This issue in covered in more detail <A HREF="node27.html#library-maint">here in</A> this manual.
2009-05-17 22:34:44 +00:00
<P>
2006-11-10 08:07:56 +00:00
<BR><HR><H4>Footnotes</H4>
<DL>
2011-07-26 22:49:39 +00:00
<DT><A NAME="foot2803">... '/'</A><A
HREF="node6.html#tex2html33"><SUP><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">1</SPAN></SUP></A></DT>
2006-11-10 08:07:56 +00:00
<DD>The '/' is reserved for future
enhancements.
</DD>
2011-07-26 22:49:39 +00:00
<DT><A NAME="foot2927">... digits</A><A
HREF="node6.html#tex2html34"><SUP><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">2</SPAN></SUP></A></DT>
2009-05-17 22:34:44 +00:00
<DD><SPAN CLASS="textbf">12345</SPAN> and <SPAN CLASS="textbf">2</SPAN> are invalid; <SPAN CLASS="textbf">11foo11</SPAN> and <SPAN CLASS="textbf">a2-2</SPAN> are permitted.
2006-11-10 08:07:56 +00:00
</DD>
2011-07-26 22:49:39 +00:00
<DT><A NAME="foot2928">... reset.</A><A
HREF="node6.html#tex2html35"><SUP><SPAN CLASS="arabic">6</SPAN>.<SPAN CLASS="arabic">3</SPAN></SUP></A></DT>
2006-11-10 08:07:56 +00:00
<DD>Actually,
<FONT Face="Serif" Color="Navy"><I>MMA</I></FONT> checks to see the next
G<SMALL>ROOVE</SMALL> in the list is the same as the current one, and if it
is then no change is done.
</DD>
2009-05-17 22:34:44 +00:00
</DL>
<DIV CLASS="navigation"><HR>
2006-11-10 08:07:56 +00:00
<!--Navigation Panel-->
2011-07-26 22:49:39 +00:00
<A NAME="tex2html487"
2006-11-10 08:07:56 +00:00
HREF="node7.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
2011-07-26 22:49:39 +00:00
<A NAME="tex2html485"
2006-11-10 08:07:56 +00:00
HREF="mma.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
2011-07-26 22:49:39 +00:00
<A NAME="tex2html479"
2006-11-10 08:07:56 +00:00
HREF="node5.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<BR>
2011-07-26 22:49:39 +00:00
<B> Next:</B> <A NAME="tex2html488"
2006-11-10 08:07:56 +00:00
HREF="node7.html">Riffs</A>
2011-07-26 22:49:39 +00:00
<B> Up:</B> <A NAME="tex2html486"
2006-11-10 08:07:56 +00:00
HREF="mma.html">Reference Manual</A>
2011-07-26 22:49:39 +00:00
<B> Previous:</B> <A NAME="tex2html480"
2009-05-17 22:34:44 +00:00
HREF="node5.html">Sequences</A></DIV>
2006-11-10 08:07:56 +00:00
<!--End of Navigation Panel-->
<ADDRESS>
2007-04-29 06:47:40 +00:00
bob
2011-07-26 22:49:39 +00:00
2010-11-07
2006-11-10 08:07:56 +00:00
</ADDRESS>
</BODY>
</HTML>