[mup] / mup / docs / uguide / contexts.html

<HTML>
<HEAD><TITLE>
Mup Contexts
</TITLE></HEAD>
<BODY>
<P>
&nbsp;&nbsp;&nbsp;<A HREF="gensyn.html">&lt;-- previous page</A>

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html">Table of Contents</A>&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="music.html">next page --&gt;</A>
</P>
            
<H2>
Contexts
</H2>
<P>
There is always a current Mup &quot;context&quot; that is in effect.
When Mup begins reading input, it is operating in &quot;music&quot; context, which
is where music, lyrics, barlines, and other related things
are described. You can change to another
context by entering its name. A context remains in effect until
another context is named.
The contexts are:
<DL>
<DT>
<A HREF="headfoot.html">header</A>
<DD>
to define what goes at the top of the first page, typically
the title, composer, etc.
<DT>
<A HREF="headfoot.html">footer</A>
<DD>
to define what goes at the bottom of the first page,
typically a copyright notice, performance notes, etc.
<DT>
<A HREF="headfoot.html">header2</A>
<DD>
to define what is to be printed on the top of pages after the first page.
<DT>
<A HREF="headfoot.html">footer2</A>
<DD>
to define what is to be printed on the bottom of pages after the first page.
<DT>
<A HREF="headfoot.html">top</A>
<DD>
to define what is to be printed on the top of page.
This gets printed below the header (or header2), if any.
If the output is not already at the beginning of a new page,
a new page is started.
Unlike header, which can only be used once, and is used only on the very
first page, top can be used multiple times. In a song with multiple movements,
you might use top to put a title at the beginning of each movement.
<DT>
<A HREF="headfoot.html">bottom</A>
<DD>
to define what is to be printed on the bottom of page.
This gets printed above the footer (or footer2), if any.
If the output is not already at the beginning of a new page,
a new page is started.
Unlike footer, which can only be used once, and is used only on the very
first page, bottom can be used multiple times.
<DT>
<A HREF="headfoot.html">top2</A>
<DD>
to define what is to be printed on the top of pages
after the page that uses &quot;top.&quot;
If the output is not already at the beginning of a new page,
a new page is started.
<DT>
<A HREF="headfoot.html">bottom2</A>
<DD>
to define what is to be printed on the bottom of pages
after the page that uses &quot;bottom.&quot;
If the output is not already at the beginning of a new page,
a new page is started.
<DT>
<A HREF="prnttext.html#block">block</A>
<DD>
to define a block that contains text rather than music.
<DT>
score
<DD>
to define
<A HREF="param.html">parameters</A>
that apply to the entire score.
<DT>
staff <I>S</I>
<DD>
to define
<A HREF="param.html">parameters</A>
to be used for staff <I>S</I>,
where <I>S</I> is a number from 1 to 40.
<DT>
voice <I>S V</I>
<DD>
to define
<A HREF="param.html">parameters</A>
for a particular voice <I>V</I> on staff <I>S</I>.
The voice <I>V</I> can be either 1, 2, or 3.
<I>S</I> is a staff number from 1 to 40.
<DT>
<A HREF="textmark.html#grids">grids</A>
<DD>
to define grids (typically for guitar)
<DT>
<A HREF="shaped.html">headshapes</A>
<DD>
to define what note head shapes to use for notes of various durations.
This context is rarely used, and is described in the chapter on
<A HREF="shaped.html">shaped notes.</A>
<DT>
<A HREF="music.html">music</A>
<DD>
to define everything else. This includes
<A HREF="chordinp.html">notes,</A>
<A HREF="lyrics.html">lyrics,</A>
<A HREF="bars.html">bar lines,</A>
<A HREF="phrase.html">phrase marks,</A>
<A HREF="textmark.html">tempo and dynamic marks, etc.</A>
</DL>
</P>
<P>
Most contexts are optional. An input file
just needs to contain either at least one measure of music
or at least one
<A HREF="prnttext.html#block">block.</A>
<A HREF="headfoot.html">The \fBheader, footer, header2,\fP and \fBfooter2\fP</A>
contexts may be placed anywhere in the file, but each can be used only once.
The other contexts may appear any number of times
in any order, and the order in which they occur is significant in
determining the output produced.
</P>
<HR><P>
&nbsp;&nbsp;&nbsp;<A HREF="gensyn.html">&lt;-- previous page</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html">Table of Contents</A>&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="music.html">next page --&gt;</A>
</P>
</BODY></HTML>
Commit	Line	Data
fac14bbe MW	1	<HTML>
	2	<HEAD><TITLE>
	3	Mup Contexts
	4	</TITLE></HEAD>
	5	<BODY>
	6	<P>
	7	<A HREF="gensyn.html"><-- previous page</A>
	8
	9	<A HREF="index.html">Table of Contents</A>    <A HREF="music.html">next page --></A>
	10	</P>
	11
	12	<H2>
	13	Contexts
	14	</H2>
	15	<P>
	16	There is always a current Mup "context" that is in effect.
	17	When Mup begins reading input, it is operating in "music" context, which
	18	is where music, lyrics, barlines, and other related things
	19	are described. You can change to another
	20	context by entering its name. A context remains in effect until
	21	another context is named.
	22	The contexts are:
	23	<DL>
	24	<DT>
	25	<A HREF="headfoot.html">header</A>
	26	<DD>
	27	to define what goes at the top of the first page, typically
	28	the title, composer, etc.
	29	<DT>
	30	<A HREF="headfoot.html">footer</A>
	31	<DD>
	32	to define what goes at the bottom of the first page,
	33	typically a copyright notice, performance notes, etc.
	34	<DT>
	35	<A HREF="headfoot.html">header2</A>
	36	<DD>
	37	to define what is to be printed on the top of pages after the first page.
	38	<DT>
	39	<A HREF="headfoot.html">footer2</A>
	40	<DD>
	41	to define what is to be printed on the bottom of pages after the first page.
	42	<DT>
	43	<A HREF="headfoot.html">top</A>
	44	<DD>
	45	to define what is to be printed on the top of page.
	46	This gets printed below the header (or header2), if any.
	47	If the output is not already at the beginning of a new page,
	48	a new page is started.
	49	Unlike header, which can only be used once, and is used only on the very
	50	first page, top can be used multiple times. In a song with multiple movements,
	51	you might use top to put a title at the beginning of each movement.
	52	<DT>
	53	<A HREF="headfoot.html">bottom</A>
	54	<DD>
	55	to define what is to be printed on the bottom of page.
	56	This gets printed above the footer (or footer2), if any.
	57	If the output is not already at the beginning of a new page,
	58	a new page is started.
	59	Unlike footer, which can only be used once, and is used only on the very
	60	first page, bottom can be used multiple times.
	61	<DT>
	62	<A HREF="headfoot.html">top2</A>
	63	<DD>
	64	to define what is to be printed on the top of pages
65	after the page that uses "top."
66	If the output is not already at the beginning of a new page,
67	a new page is started.
68	<DT>
69	<A HREF="headfoot.html">bottom2</A>
70	<DD>
71	to define what is to be printed on the bottom of pages
72	after the page that uses "bottom."
73	If the output is not already at the beginning of a new page,
74	a new page is started.
75	<DT>
76	<A HREF="prnttext.html#block">block</A>
77	<DD>
78	to define a block that contains text rather than music.
79	<DT>
80	score
81	<DD>
82	to define
83	<A HREF="param.html">parameters</A>
84	that apply to the entire score.
85	<DT>
86	staff <I>S</I>
87	<DD>
88	to define
89	<A HREF="param.html">parameters</A>
90	to be used for staff <I>S</I>,
91	where <I>S</I> is a number from 1 to 40.
92	<DT>
93	voice <I>S V</I>
94	<DD>
95	to define
96	<A HREF="param.html">parameters</A>
97	for a particular voice <I>V</I> on staff <I>S</I>.
98	The voice <I>V</I> can be either 1, 2, or 3.
99	<I>S</I> is a staff number from 1 to 40.
100	<DT>
101	<A HREF="textmark.html#grids">grids</A>
102	<DD>
103	to define grids (typically for guitar)
104	<DT>
105	<A HREF="shaped.html">headshapes</A>
106	<DD>
107	to define what note head shapes to use for notes of various durations.
108	This context is rarely used, and is described in the chapter on
109	<A HREF="shaped.html">shaped notes.</A>
110	<DT>
111	<A HREF="music.html">music</A>
112	<DD>
113	to define everything else. This includes
114	<A HREF="chordinp.html">notes,</A>
115	<A HREF="lyrics.html">lyrics,</A>
116	<A HREF="bars.html">bar lines,</A>
117	<A HREF="phrase.html">phrase marks,</A>
118	<A HREF="textmark.html">tempo and dynamic marks, etc.</A>
119	</DL>
120	</P>
121	<P>
122	Most contexts are optional. An input file
123	just needs to contain either at least one measure of music
124	or at least one
125	<A HREF="prnttext.html#block">block.</A>
126	<A HREF="headfoot.html">The \fBheader, footer, header2,\fP and \fBfooter2\fP</A>
127	contexts may be placed anywhere in the file, but each can be used only once.
128	The other contexts may appear any number of times
129	in any order, and the order in which they occur is significant in
130	determining the output produced.
131	</P>
132	<HR><P>
133	<A HREF="gensyn.html"><-- previous page</A>     <A HREF="index.html">Table of Contents</A>    <A HREF="music.html">next page --></A>
134	</P>
135	</BODY></HTML>