VocalEasel/mma/docs/html/ref/node25.html

216 lines
5.6 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>
2011-07-26 22:49:39 +00:00
<TITLE>Begin/End Blocks</TITLE>
<META NAME="description" CONTENT="Begin/End Blocks">
2006-11-10 08:07:56 +00:00
<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="node26.html">
<LINK REL="previous" HREF="node24.html">
<LINK REL="up" HREF="mma.html">
<LINK REL="next" HREF="node26.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="tex2html827"
2006-11-10 08:07:56 +00:00
HREF="node26.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="tex2html825"
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="tex2html819"
2006-11-10 08:07:56 +00:00
HREF="node24.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="tex2html828"
HREF="node26.html">Documentation Strings</A>
<B> Up:</B> <A NAME="tex2html826"
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="tex2html820"
HREF="node24.html">Other Commands and Directives</A>
2006-11-10 08:07:56 +00:00
<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="tex2html829"
HREF="node25.html#SECTION002510000000000000000">Begin</A>
<LI><A NAME="tex2html830"
HREF="node25.html#SECTION002520000000000000000">End</A>
2006-11-10 08:07:56 +00:00
</UL>
<!--End of Table of Child-Links-->
<HR>
2011-07-26 22:49:39 +00:00
<H1><A NAME="SECTION002500000000000000000"></A>
<A NAME="sec-blocks"></A>
<BR>
Begin/End Blocks
2006-11-10 08:07:56 +00:00
</H1>
<P>
2011-07-26 22:49:39 +00:00
Entering a series of directives for a specific track can get quite
tedious. To make the creation of library files a bit easier, you can
create a block. For example, the following:
2009-05-17 22:34:44 +00:00
<P>
2011-07-26 22:49:39 +00:00
<Table Hspace="40%" CellSpacing=0 CellPadding=10 BGColor="OldLace" Border=3>
<tr><td>
<B>Drum Define X 0 2 100; 50 2 90
2009-05-17 22:34:44 +00:00
<BR>
2011-07-26 22:49:39 +00:00
Drum Define Y 0 2 100
<BR>
Drum Sequence X Y </B>
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
<P>
2011-07-26 22:49:39 +00:00
Can be replaced with:
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>
2011-07-26 22:49:39 +00:00
<B>Drum Begin
<BR>&nbsp;&nbsp;&nbsp;&nbsp;Define X 0 2 100; 50 2 90
<BR>&nbsp;&nbsp;&nbsp;&nbsp;Define Y 0 2 100
End
<BR>
Drum Sequence X Y </B>
2007-04-29 06:47:40 +00:00
</td></tr>
</Table>
2006-11-10 08:07:56 +00:00
2007-04-29 06:47:40 +00:00
<P>
2011-07-26 22:49:39 +00:00
Or, even more simply, with:
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>
2011-07-26 22:49:39 +00:00
<B>Drum Begin Define
<BR>&nbsp;&nbsp;&nbsp;&nbsp;X 0 2 100; 50 2 90
<BR>&nbsp;&nbsp;&nbsp;&nbsp;Y 0 2 100
<BR>
End </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 examine some of the library files you will see that this
shortcut is used a lot.
2009-05-17 22:34:44 +00:00
<P>
2011-07-26 22:49:39 +00:00
<H1><A NAME="SECTION002510000000000000000">
Begin</A>
2009-05-17 22:34:44 +00:00
</H1>
<P>
2011-07-26 22:49:39 +00:00
The B<SMALL>EGIN</SMALL> command requires any number of arguments. Valid
examples include:
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>
2011-07-26 22:49:39 +00:00
<B>Begin Drum
<BR>
Begin Chord2
<BR>
Begin Walk Define </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
Once a B<SMALL>EGIN</SMALL> block has been entered, all subsequent lines have
the words from the B<SMALL>EGIN</SMALL> command prepended to each line of
data. There is not much magic here--B<SMALL>EGIN</SMALL>/E<SMALL>ND</SMALL> is really
just some syntactic sugar.
2006-11-10 08:07:56 +00:00
<P>
2011-07-26 22:49:39 +00:00
<H1><A NAME="SECTION002520000000000000000">
End</A>
2006-11-10 08:07:56 +00:00
</H1>
<P>
2011-07-26 22:49:39 +00:00
To finish off a B<SMALL>EGIN</SMALL> block, use a single E<SMALL>ND</SMALL> on a line
by itself.
2009-05-17 22:34:44 +00:00
<P>
2011-07-26 22:49:39 +00:00
Defining musical data, repeats, or other B<SMALL>EGIN</SMALL>s inside a block
(other than COMMENT blocks) will not work.
<P>
Nesting is permitted, e.g.:
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>
2011-07-26 22:49:39 +00:00
<B>Scale Begin
<BR>&nbsp;&nbsp;&nbsp;&nbsp;Begin Define
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</B><SPAN CLASS="textit">stuff</SPAN><B>
<BR>&nbsp;&nbsp;&nbsp;&nbsp;End
<BR>&nbsp;&nbsp;&nbsp;&nbsp;Sequence </B><SPAN CLASS="textit">stuff</SPAN><B>
2009-05-17 22:34:44 +00:00
<BR>
2011-07-26 22:49:39 +00:00
End </B>
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
A B<SMALL>EGIN</SMALL> must be competed with a E<SMALL>ND</SMALL> before the end of a
file, otherwise an error will be generated. The U<SMALL>SE</SMALL> and
I<SMALL>NCLUDE</SMALL> commands are not permitted inside a block.
2006-11-10 08:07:56 +00:00
<P>
2009-05-17 22:34:44 +00:00
<DIV CLASS="navigation"><HR>
2006-11-10 08:07:56 +00:00
<!--Navigation Panel-->
2011-07-26 22:49:39 +00:00
<A NAME="tex2html827"
2006-11-10 08:07:56 +00:00
HREF="node26.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="tex2html825"
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="tex2html819"
2006-11-10 08:07:56 +00:00
HREF="node24.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="tex2html828"
HREF="node26.html">Documentation Strings</A>
<B> Up:</B> <A NAME="tex2html826"
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="tex2html820"
HREF="node24.html">Other Commands and Directives</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>