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> |