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