chiark / gitweb /
Import upstream version 5.3.
[mup] / mup / mupmate / template.C
1 /* Copyright (c) 2006 by Arkkra Enterprises */
2 /* All rights reserved */
3
4 /* We build the template into Mupmate so we do not have to depend on the
5  * template file existing at run time. */
6 extern const char * const template_text =
7 "//!Mup-Arkkra\n\
8 // This is a Mup input file template.\n\
9 // Lines starting with // are \"comments\" that are here for your benefit.\n\
10 // You can remove them without affecting the output.\n\
11 \n\
12 /////////////////////////////////////////////////////////////////////////\n\
13 //              things to go on the top of the first page\n\
14 top\n\
15 \n\
16         //               centered title.\n\
17         // The number in parentheses is the text point size.\n\
18         // Make it bigger if you want a bigger title or smaller if you\n\
19         // want a smaller title\n\
20         title (18) \"Replace this with the title of your song\"\n\
21 \n\
22         //              subtitle\n\
23         // If you want a subtitle, remove the // from the beginning\n\
24         // of the next line and fill in the appropriate subtitle text\n\
25         // title (14) \"Replace this with the subtitle\"\n\
26 \n\
27         //              composer info\n\
28         // The first pair of double quotes enclose what to left justify,\n\
29         // the second encloses what to right justify.\n\
30         // If you want more than one line, add similar lines of input\n\
31         title   \"\"   \"Replace this with composer info\"\n\
32 \n\
33 \n\
34 /////////////////////////////////////////////////////////////////////////\n\
35 //              things to go on the bottom on the first page\n\
36 bottom\n\
37         // If you want a copyright notice, remove the //\n\
38         // from the next line and edit in the appropriate information\n\
39         // title \"\\(copyright) Copyright  Replace this with year and name\"\n\
40 \n\
41 \n\
42 /////////////////////////////////////////////////////////////////////////\n\
43 //              things to go on the top of pages other than the first\n\
44 top2\n\
45         // This example will give a centered page number between dashes.\n\
46         // You can customize as you wish.\n\
47         title \"- \\% -\"\n\
48 \n\
49 \n\
50 /////////////////////////////////////////////////////////////////////////\n\
51 //              things to go at the bottom of pages other than the first\n\
52 bottom2\n\
53         // if you want things printed at the bottom of pages of than\n\
54         // the first page, place them here\n\
55 \n\
56 \n\
57 /////////////////////////////////////////////////////////////////////////\n\
58 //              score-wide parameters\n\
59 //\n\
60 // You may or may not need to change some items in this section\n\
61 //\n\
62 // The values given as examples are the default values that Mup uses\n\
63 // if you don't specify anything for them\n\
64 score\n\
65         //      time signature. Can be cut, com,\n\
66         //      or two numbers with a / between them\n\
67         time = 4/4\n\
68 \n\
69         //      key signature. Value is a number from 0 to 7\n\
70         //      followed by # or & for number of sharps or flats.\n\
71         key = 0#\n\
72 \n\
73         //      how many staffs. Can be a number from 1 to 40\n\
74         staffs = 1\n\
75 \n\
76         //      clef. Can be treble, treble8, 8treble, frenchviolin,\n\
77         //      soprano, mezzosoprano, alto, tenor, baritone, or bass\n\
78         clef = treble\n\
79 \n\
80         // Note: there are many more parameters that can be set,\n\
81         // but they are not included in this simple template.\n\
82         // There are parameters to set margins, control how things\n\
83         // are laid out on the page, transpositions value, font and size\n\
84         // for text and lyrics, etc\n\
85 \n\
86 \n\
87 /////////////////////////////////////////////////////////////////////////\n\
88 //      You can set some parameters for specific staffs,\n\
89 //      to override the score-wide parameters. For example,\n\
90 //      if you specify staffs = 2 in the score-wide parameters above,\n\
91 //      and want to use bass clef on staff 2, even though the score-wide\n\
92 //      clef parameter is set to treble, you can do\n\
93 //              staff 2\n\
94 //                      clef = bass\n\
95 \n\
96 \n\
97 /////////////////////////////////////////////////////////////////////////\n\
98 //              music input starts here\n\
99 music\n\
100 \n\
101 \n\
102 // For each measure, you enter one line of input for each staff,\n\
103 // then indicate what kind of barline to print.\n\
104 // The following specifies that staff 1 contains a measure of rest\n\
105 // and that an ordinary bar line is to be used at the end of the measure.\n\
106 \n\
107 1: mr;\n\
108 bar\n\
109 \n\
110 // Usually, a measure of input for one staff consists of one or more chords\n\
111 // Each chord is specified by\n\
112 //      time_value notes ;\n\
113 // where time_value is something like\n\
114 //      4       for a quarter note\n\
115 //      8       for an eighth note\n\
116 //      4.      for a dotted-quarter note\n\
117 // etc and notes is a list of one or more notes, specified as a pitch from\n\
118 // a to g, optionally followed by an accidental (#, &, x, &&, or n for sharp,\n\
119 // flat, double sharp, double flat, or natural respectively).\n\
120 // Examples:\n\
121 //      4c;\n\
122 //      2. ceg;\n\
123 //      16 f#;\n\
124 //      1 d b&;\n\
125 // (Spaces are optional, you can put them in if you want, but don't have to)\n\
126 //\n\
127 // So a complete measure might look something like:\n\
128 //      1: 4e; 4d; 2c;\n\
129 //      bar\n\
130 //\n\
131 // If you want a note in a different octave than the default octave\n\
132 // (the octave from middle-C up for treble clef,\n\
133 // or the octave below middle-C for bass clef),\n\
134 // you can add a + for each octave to go up or - for each octave to go down.\n\
135 // For example:\n\
136 //      1: c+; gc+e+; a&-; f#---;\n\
137 //\n\
138 // There are many other things you can specify, such as ties, slurs, grace\n\
139 // notes, etc, and there are also many shortcuts you can use to save typing.\n\
140 // Consult the Mup documentation for more details.\n\
141 \n\
142 // Other bar types you may want to use are\n\
143 //      repeatstart\n\
144 //      repeatend\n\
145 //      repeatboth\n\
146 //      dblbar\n\
147 //      endbar\n\
148 //      invisbar";