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