summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/autosp.1
blob: 3d51ccd59477c629ef2367553a79ad10d0111353 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
.\" This manpage is licensed under the GNU Public License
.TH AUTOSP 1 2018-02-14  "" ""

.SH NAME
autosp \- preprocessor to generate note-spacing commands for MusiXTeX scores

.SH SYNOPSIS
.B autosp 
.RB  [ \-v\ |\ \-\-version\ |\ \-h\ |\ \-\-help ]

.B autosp
.RB [ \-d\ |\ \-\-dotted ]
.RB [ \-l\ |\ \-\-log ]
.IR infile [\fR.aspc\fP]
.RI [ outfile [ \fR.tex\fP ]]


This program makes it easier to create MusiXTeX scores by converting (non-standard) commands of the 
form \\anotes ... \\en into one or more conventional
note-spacing commands (\\notes \\Notes \\NOtes ...), 
determined by the actual note values, with \\sk spacing commands inserted as necessary.
The coding
for an entire measure can be entered one part at a time, 
without
concern for note-spacing changes within the part or spacing requirements of other parts.

For example, if applied to
.nf

    \\anotes\\qa J\\qa K&\\ca l\\qa m\\ca n\\en 

.fi
.B autosp
generates
.nf

    \\Notes\\qa J\\sk\\qa K\\sk&\\ca l\\qa m\\sk\\ca n\\en

.fi
Typically,
an
\\anotes command generates several conventional
note-spacing commands.

If the 
.I infile
argument 
does not have an .aspc extension, input is taken from 
.IR infile .aspc 
if that file exists.

If the
.I outfile
argument does not have a .tex extension, output is sent to
.IR outfile .tex.
If no 
.I outfile 
argument is provided, output will go to
.IR infile .tex
(or to
.IR infile .ltx
if a \\documentclass declaration is encountered).

For
\\anotes commands,
line breaks and spaces may precede note segments, allowing more flexible source formatting; 
the line breaks and spaces will be elided from the output. 

For example, 
.nf

  \\anotes
    \\ibl0K0\\qb0K\\nbbl0\\qb0{.K}\\tbbbl0\\tbbl0\\tql0L&
    \\ibbl1m{-2}\\qb1{.m}\\tbbbl1\\tbbl1\\qb1l\\tql1k\\en

.fi
is acceptable and generates
.nf

  \\notesp\\ibl0K0\\qb0K&\\ibbl1m{-2}\\qb1{.m}\\en
  \\nnotes\\sk&\\tbbbl1\\tbbl1\\qb1l\\en
  \\notesp\\nbbl0\\qb0{.K}&\\tql1k\\en
  \\nnotes\\tbbbl0\\tbbl0\\tql0L&\\sk\\en

.fi


If the 
.B \-l 
( \fB\-\-log\fP ) option is used, a very detailed log 
.IR infile .alog
is generated.

If the 
.B \-d  
( \fB--dotted\fP )
option is used, 
.I dotted 
beam notes of the form \\qb{\fIn\fP}{\fB.\fP\fIp\fP} are 
.I not 
given extra space;
it is assumed that the subsequent note will be shifted
by 
a \\roff-like command 
or a spacing command such as \\qsk or \\hqsk.
Commands of the form \\qlp{\fIp\fP}, \\qlpp{\fIp\fP}, ..., \\qpb{\fIn\fP}{\fIp\fP} and 
\\qppb{\fIn\fP}{\fIp\fP} are always spaced
as indicated. 

If there is a single staff, consecutive whole-bar rest bars
are merged into a multi-bar rest. Bar-centered rests can be
coded using the standard \\def\\atnextbar notation but 
the non-standard command \\Cpause in a note segment also generates a
bar-centered rest.

Spacing commands \\sk and \\bsk in the source are discarded,
but not "small" skips \\hsk, \\qsk, \\tqsk, \\hqsk or \\qqsk,
or the small "backward" skips \\hbsk, \\bqsk, \\btsk, or \\bhsk.
Moreover,
non-standard commands
\\QQsk, \\HQsk \\TQsk and \\Qsk in the source generate "global" skips; i.e., the effect of \\qqsk, \\hqsk, \\tqsk or \\qsk, respectively,  in 
.I every 
staff. These ensure that staffs remain synchronized if additional spacing is needed in any staff(s). 

Global skips may also be obtained within collective-coding sequences by using
up to four successive commas 
to get the effects of \\QQsk, \\HQsk, \\TQsk or \\Qsk, respectively.
Global skips \\tqsk (or, for double-flats, \\qsk) are 
automatically inserted before accidentals ('^', '_', '=', '<', '>') on collective-coding notes
(except when the preceding note is "virtual"; i.e., a skip).
If this automatic additional spacing is 
.I not 
wanted in some context, it may be avoided by
replacing 
the accidental in the collective-coding sequence
by 
any of the 
.I explicit 
accidental commands: \\sh, \\fl, \\na, \\smallsh, \\bigsh, etc.
If the automatic spacing is insufficient, the spacing may be increased by adding sufficient commas or 
using a conventional notes command instead of \\anotes.  


A note segment can be completely empty, but if a note segment should start
with or contain a "space," the note-value
of that space must be made explicit with a command of the
form \\ha{*}, \\qa{.*}, \\qa{*}, \\ca{*}, etc. 

From version 2017-06-14, the effects of \\TransformNotes calls are implemented by the 
.B autosp
pre-processor. This
enables use of 
musixlyr in
.B autosp 
scores; musixlyr.tex 
is incompatible with the
musixtnt.tex 
implementation of \\TransformNotes.

All other conventional MusiXTeX commands are output exactly as given in the input.


.SH OPERATION

.B autosp
determines the spacing for ordinary notes from the note
commands themselves; for example, 
.TP 3
+
\\qa, \\qu, \\ql, \\qp result in
\\NOtes; 
.TP 3
+
\\ca, \\cu, \\cl, \\ds result in \\Notes; 
.PP
and so on. 
 
The spacing for 
.IR beamed 
notes is determined by the beam
multiplicity, so that \\ib... results in \\Notes, \\ibb... results in
\\notes, etc. 

Collective coding of note sequences (including accidentals and dots) is handled 
by expanding the sequence
into a sequence of individual note commands.

 
.SH LIMITATIONS

.B autosp
assumes that & and | (rather than \\nextinstrument and \\nextstaff) are used to separate instruments and staffs.


Appoggiaturas and grace notes are recognized by the use of \\tinynotesize; note-spacing
of 1.45\\elemskip is used. If this isn't suitable and can't be corrected with a small skip, a
\\vnotes command with any desired spacing can be used.

.B autosp 
supports 
.I x-tuplets 
introduced using \\xtuplet{\fIx\fP}
or \\xxtuplet{\fIx:y\fP}
and 
.I triplets 
introduced
using any of the following commands (regardless of any re-definition of \\txt or \\tuplettxt):
.nf

  \\triolet
  \\uptrio
  \\downtrio
  \\uptuplet
  \\downtuplet

.fi
.B autosp 
assumes that an x-tuplet is to be played in 
(\fIx\fP\-1)/\fIx\fP 
of the apparent x-tuplet duration.
So, for example, a triplet in eighths is assumed to be played in the time of one quarter note.
If this assumption
isn't valid, the x-tuplet must
be coded explicitly using a suitable \\vnotes command; see the first
measure of barsant2.aspc for an example of a non-standard x-tuplet: a 5-tuple 
of 64th notes with an intended duration
of 
.I six 
64ths.

In some polyrhythmic scores, the \\txt numeral may be displaced, even if the notes
themselves are correctly spaced. In these cases, it is possible to suppress 
the normal output of \\txt by using the non-standard commands \\Triolet (no arguments)
or \\Xtuplet{k}\\
and placing a numeral at the correct location using \\zcn (i.e., \\zcharnote).

.B autosp
can deal with simultaneous x-tuplets in multiple staffs provided the x values and
total note durations are identical.  

In some baroque scores, particularly by J.S. Bach, a beamed sixteenth note is vertically aligned
with
the third note of a triplet of eighth notes in another staff (implying that they should
be sounded simultaneously); e.g.,
.nf

    \\ibl0L0\\qb0{.L}\\tqql0L

.fi
would be played as if notated 
.nf

    \\uptrio{b}10\\ql L\\hroff{\\cl L}

.fi
The following coding will align the beamed sixteenth note 
with the third note of a triplet in another staff:
.nf

    \\ibl0L0\\qb0{.L}\\hbsk\\tqql0L

.fi
and, similarly, for triplets of sixteenth notes:
.nf

    \\ibbu0J0\\qb0{.J}\\hbsk\\nqqqu0J\\qb0{.J}\\hbsk\\tqqqu0J

.fi
Generally, user-defined macros are not processed or expanded; however, definitions of the form
.nf

    \\def\\atnextbar{\\znotes ... \\en}

.fi
generate definitions that do take account of \\TransformNotes.

All staffs are assumed to have the same meter; see kinder2.aspc for
an example of how to work around this.

.B autosp
may not be effective for music with more than one voice in a single staff. It might be
advisable to use a separate staff for each voice, to avoid \\anotes when necessary, 
or to omit certain voices
initially and add them into the resulting TeX file.

.SH EXAMPLES
See files quod2.aspc, kinder2.aspc, geminiani.aspc and barsant2.aspc for scores suitable for input to  
.BR autosp .
The program
.B tex2aspc
can be used to convert "legacy" MusiXTeX scores to .aspc format.

.SH SEE ALSO
.BR msxlint (1)
.BR tex2aspc (1)
.PP 
musixdoc.pdf

.SH AUTHOR 
This program and manual page were written by Bob Tennent <rdt@cs.queensu.ca>.