Debian Codegraph @

texmf-dist/doc/man/man1/autosp.1

raw
1 .\" This manpage is licensed under the GNU Public License
2 .TH AUTOSP 1 2025-10-26 "" ""
3
4 .SH NAME
5 autosp \- preprocessor to generate note-spacing commands for MusiXTeX scores
6
7 .SH SYNOPSIS
8 .B autosp
9 .RB [ \-v\ |\ \-\-version\ |\ \-h\ |\ \-\-help ]
10
11 .B autosp
12 .RB [ \-d\ |\ \-\-dotted ]
13 .RB [ \-l\ |\ \-\-log ]
14 .IR infile [\fR.aspc\fP]
15 .RI [ outfile [ \fR.tex\fP ]]
16
17 .SH DESCRIPTION
18 This program makes it easier to create MusiXTeX scores by converting (non-standard) commands of the
19 form \\anotes ... \\en (or \\an ... \\en) into one or more conventional
20 note-spacing commands (\\notes \\Notes \\NOtes ...),
21 determined by the actual note values, with \\sk spacing commands inserted as necessary.
22 The coding
23 for an entire measure can be entered one part at a time,
24 without
25 concern for note-spacing changes within the part or spacing requirements of other parts.
26
27 For example, if applied to
28 .nf
29
30 \\anotes\\qa J\\qa K&\\ca l\\qa m\\ca n\\en
31
32 .fi
33 .B autosp
34 generates
35 .nf
36
37 \\Notes\\qa J\\sk\\qa K\\sk&\\ca l\\qa m\\sk\\ca n\\en
38
39 .fi
40 Typically,
41 an
42 \\anotes command generates several conventional
43 note-spacing commands.
44
45 If the
46 .I infile
47 argument
48 does not have an .aspc extension, input is taken from
49 .IR infile .aspc
50 if that file exists.
51
52 If the
53 .I outfile
54 argument does not have a .tex extension, output is sent to
55 .IR outfile .tex.
56 If no
57 .I outfile
58 argument is provided, output will go to
59 .IR infile .tex
60 (or to
61 .IR infile .ltx
62 if a \\documentclass declaration is encountered).
63
64 For
65 \\anotes commands,
66 line breaks and spaces may precede note segments, allowing more flexible source formatting;
67 the line breaks and spaces will be elided from the output.
68
69 For example,
70 .nf
71
72 \\an
73 \\ibl0K0\\qb0K\\nbbl0\\qb0{.K}\\tbbbl0\\tbbl0\\tql0L&
74 \\ibbl1m{-2}\\qb1{.m}\\tbbbl1\\tbbl1\\qb1l\\tql1k\\en
75
76 .fi
77 is acceptable and generates
78 .nf
79
80 \\notesp\\ibl0K0\\qb0K&\\ibbl1m{-2}\\qb1{.m}\\en
81 \\nnotes\\sk&\\tbbbl1\\tbbl1\\qb1l\\en
82 \\notesp\\nbbl0\\qb0{.K}&\\tql1k\\en
83 \\nnotes\\tbbbl0\\tbbl0\\tql0L&\\sk\\en
84
85 .fi
86
87
88 If the
89 .B \-l
90 ( \fB\-\-log\fP ) option is used, a very detailed log
91 .IR infile .alog
92 is generated.
93
94 If the
95 .B \-d
96 ( \fB--dotted\fP )
97 option is used,
98 .I dotted
99 beam notes of the form \\qb{\fIn\fP}{\fB.\fP\fIp\fP} are
100 .I not
101 given extra space;
102 it is assumed that the subsequent note will be shifted
103 by
104 a \\roff-like command
105 or a spacing command such as \\qsk or \\hqsk.
106 Commands of the form \\qlp{\fIp\fP}, \\qlpp{\fIp\fP}, ..., \\qpb{\fIn\fP}{\fIp\fP} and
107 \\qppb{\fIn\fP}{\fIp\fP} are always spaced
108 as indicated.
109
110 If there is a single staff, consecutive whole-bar rest bars
111 are merged into a multi-bar rest. Bar-centered rests can be
112 coded using the standard \\def\\atnextbar notation but
113 the non-standard command \\Cpause (or \\Cp) in a note segment also generates a
114 bar-centered rest.
115
116 Spacing commands \\sk and \\bsk in the source are discarded,
117 but not "small" skips \\hsk, \\qsk, \\tqsk, \\hqsk or \\qqsk,
118 or the small "backward" skips \\hbsk, \\bqsk, \\btsk, or \\bhsk.
119 Moreover,
120 non-standard commands
121 \\QQsk, \\HQsk \\TQsk and \\Qsk in the source generate "global" skips; i.e., the effect of \\qqsk, \\hqsk, \\tqsk or \\qsk, respectively, in
122 .I every
123 staff. These ensure that staffs remain synchronized if additional spacing is needed in any staff(s).
124
125 Global skips may also be obtained within collective-coding sequences by using
126 up to four successive commas
127 to get the effects of \\QQsk, \\HQsk, \\TQsk or \\Qsk, respectively.
128 Global skips \\tqsk (or, for double-flats, \\qsk) are
129 automatically inserted before accidentals ('^', '_', '=', '<', '>') on collective-coding notes
130 (except when the preceding note is "virtual"; i.e., a skip).
131 If this automatic additional spacing is
132 .I not
133 wanted in some context, it may be avoided by
134 replacing
135 the accidental in the collective-coding sequence
136 by
137 any of the
138 .I explicit
139 accidental commands: \\sh, \\fl, \\na, \\smallsh, \\bigsh, etc.
140 If the automatic spacing is insufficient, the spacing may be increased by adding sufficient commas or
141 using a conventional notes command instead of \\an.
142
143
144 A note segment can be completely empty, but if a note segment should start
145 with or contain a "space," the note-value
146 of that space must be made explicit with a command of the
147 form \\ha{*}, \\qa{.*}, \\qa{*}, \\ca{*}, etc.
148
149 From version 2017-06-14, the effects of \\TransformNotes calls are implemented by the
150 .B autosp
151 pre-processor. This
152 enables use of
153 musixlyr in
154 .B autosp
155 scores; musixlyr.tex
156 is incompatible with the
157 musixtnt.tex
158 implementation of \\TransformNotes.
159
160 All other conventional MusiXTeX commands are output exactly as given in the input.
161
162
163 .SH OPERATION
164
165 .B autosp
166 determines the spacing for ordinary notes from the note
167 commands themselves; for example,
168 .TP 3
169 +
170 \\qa, \\qu, \\ql, \\qp result in
171 \\NOtes;
172 .TP 3
173 +
174 \\ca, \\cu, \\cl, \\ds result in \\Notes;
175 .PP
176 and so on.
177
178 The spacing for
179 .IR beamed
180 notes is determined by the beam
181 multiplicity, so that \\ib... results in \\Notes, \\ibb... results in
182 \\notes, etc.
183
184 Collective coding of note sequences (including accidentals and dots) is handled
185 by expanding the sequence
186 into a sequence of individual note commands.
187
188
189 .B autosp
190 scales notes by the relevant instrument-size value.
191
192 .SH LIMITATIONS
193
194 .B autosp
195 assumes that & and | (rather than \\nextinstrument and \\nextstaff) are used to separate instruments and staffs.
196
197
198 Appoggiaturas and grace notes are recognized by the use of \\tinynotesize; note-spacing
199 of 1.45\\elemskip is used. If this isn't suitable and can't be corrected with a small skip, a
200 \\vnotes command with any desired spacing can be used.
201
202 .B autosp
203 supports
204 .I x-tuplets
205 introduced using \\xtuplet{\fIx\fP}
206 or \\xxtuplet{\fIx:y\fP}
207 and
208 .I triplets
209 introduced
210 using any of the following commands (regardless of any re-definition of \\txt or \\tuplettxt):
211 .nf
212
213 \\triolet
214 \\uptrio
215 \\downtrio
216 \\uptuplet
217 \\downtuplet
218
219 .fi
220 .B autosp
221 assumes that an x-tuplet is to be played in
222 (\fIx\fP\-1)/\fIx\fP
223 of the apparent x-tuplet duration.
224 So, for example, a triplet in eighths is assumed to be played in the time of one quarter note.
225 If this assumption
226 isn't valid, the x-tuplet must
227 be coded explicitly using a suitable \\vnotes command; see the first
228 measure of barsant2.aspc for an example of a non-standard x-tuplet: a 5-tuple
229 of 64th notes with an intended duration
230 of
231 .I six
232 64ths.
233
234 In some polyrhythmic scores, the \\txt numeral may be displaced, even if the notes
235 themselves are correctly spaced. In these cases, it is possible to suppress
236 the normal output of \\txt by using the non-standard commands \\Triolet (no arguments)
237 or \\Xtuplet{k}\\
238 and placing a numeral at the correct location using \\zcn (i.e., \\zcharnote).
239
240 .B autosp
241 can deal with simultaneous x-tuplets in multiple staffs provided the x values and
242 total note durations are identical.
243
244 In some baroque scores, particularly by J.S. Bach, a beamed sixteenth note is vertically aligned
245 with
246 the third note of a triplet of eighth notes in another staff (implying that they should
247 be sounded simultaneously); e.g.,
248 .nf
249
250 \\ibl0L0\\qb0{.L}\\tqql0L
251
252 .fi
253 would be played as if notated
254 .nf
255
256 \\uptrio{b}10\\ql L\\hroff{\\cl L}
257
258 .fi
259 The following coding will align the beamed sixteenth note
260 with the third note of a triplet in another staff:
261 .nf
262
263 \\ibl0L0\\qb0{.L}\\hbsk\\tqql0L
264
265 .fi
266 and, similarly, for triplets of sixteenth notes:
267 .nf
268
269 \\ibbu0J0\\qb0{.J}\\hbsk\\nqqqu0J\\qb0{.J}\\hbsk\\tqqqu0J
270
271 .fi
272 Generally, user-defined macros are not processed or expanded; however, definitions of the form
273 .nf
274
275 \\def\\atnextbar{\\znotes ... \\en}
276
277 .fi
278 generate definitions that do take account of \\TransformNotes.
279
280 All staffs are assumed to have the same meter; see kinder2.aspc for
281 an example of how to work around this.
282
283 .B autosp
284 may not be effective for music with more than one voice in a single staff. It might be
285 advisable to use a separate staff for each voice, to avoid \\anotes when necessary,
286 or to omit certain voices
287 initially and add them into the resulting TeX file.
288
289 .SH EXAMPLES
290 See files quod2.aspc, kinder2.aspc, geminiani.aspc and barsant2.aspc for scores suitable for input to
291 .BR autosp .
292 The program
293 .B tex2aspc
294 can be used to convert "legacy" MusiXTeX scores to .aspc format.
295
296 .SH SEE ALSO
297 .BR msxlint (1)
298 .BR tex2aspc (1)
299 .PP
300 musixdoc.pdf
301
302 .SH AUTHOR
303 This program and manual page were written by Bob Tennent <[email protected]>.