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
|
abcm2ps command line options
============================
The list of the command line options may be known running:
'abcm2ps -h'
The options may be grouped when they have no argument, but the
last one (ex: "-lnGI20").
The options may be disabled when starting with '+' or ending with '-'
(ex: "+MT1" is the same as "-MT1-").
The general output format is the last found in the command line.
It may be:
"-E" for Encapsulated PostScript, one file per tune
"-g" for SVG, one file per tune
"-v" for SVG, one file per page
"-X" for XHTML+SVG
(none) for PostScript
(see below for more information)
List of the options
-------------------
-
Read the abc file from stdin.
--<format> <value>
Set the format parameter to <value>. See format.txt.
-a <float>
See: format.txt - maxshrink <float>
-A
Annotate.
This option inserts reference elements in the PostScript
or SVG output.
-B <int>, +B
See: format.txt - barsperstaff <int>
-b <int>
See: format.txt - measurefirst <int>
-c, +c
See: format.txt - continueall <bool>
-D <dir>
Search the format files in the directory <dir>.
-d <unit>
See: format.txt - staffsep <unit>
-E
Produce EPS output instead of simple PS.
In this mode, each tune goes to a different file which
name is '<name>nnn.eps' or <title>.eps (see option '-O'
- 'nnn' is a sequence number incremented at each tune
- output to stdout is forbidden).
EPS files are normally embedded into Postscript documents,
but they may be a way to generate graphical images. For
example, using GhostScript:
abcm2ps voices -Ee7
gs -sDEVICE=pngmono -r80 -g590x174 \
-dBATCH -dNOPAUSE \
-sOutputFile=quitolis.png Out001.eps
(the values for -g are the values of the bounding box in
the .eps, multiplied by (80 / 72), where 80 is the value
for -r, and 72 is the default resolution)
-e [ <tune index list> ] [ <regular expression> ]
See: format.txt - select [ <tune index list> ] [ <regular expression> ]
-F <file>, +F
Read the format (or PostScript) file <file>.
When omitted, the default type of a format file is '.fmt'.
In the form '+F', the default format file ('default.fmt') is not
read.
-f
See: format.txt - flatbeams <bool>
-G, +G
See: format.txt - graceslurs <bool>
-g
Produce SVG output instead of EPS.
In this mode each tune goes to a different file which name
is 'Outnnn.svg' (see option '-O').
If the output is stdout (option '-O-'), all the SVG images
are output without XML header.
-H
Display the current format values.
-h
Quick help, equivalent to "abcm2ps" without any arguments.
This also shows the default settings for some parameters.
-I <unit>
See: format.txt - indent <unit>
-i, +i
Insert a red cercle around the errors in the PostScript output.
-j <int>[b], +j
See: format.txt - measurenb <int>
-k <int>
Set the size of the PostScript output buffer in Kibytes.
Setting this value to a higher value permits the
generation of big tunes with -E or -g.
The default value is 64.
-l, +l
See: format.txt - landscape <bool>
-M, +M
See: format.txt - writefields w <bool>
-m <unit>
See: format.txt - leftmargin <unit>
-N <int>, +N
Number the pages.
<int> indicates the mode:
0 no page numbers
1 at top left
2 at top right
3 at top left on even pages, top right on odd pages
4 at top right on even pages, top left on odd pages
For compatibility with previous versions, '+N' is the same as
'-N0', and '-N' is the same as '-N2'.
If a header is defined ('%%header'), this option is ignored.
-n, +n
See: format.txt - writehistory <bool>
-O [ <directory> ] [ <name> ], +O
Define the output file directory and/or name.
The directory must end with the directory separator
('/' for unix/windows, '\' for mac).
By default, the output file goes to the current directory
with the name:
'Out.ps' for PS,
'Outnnn.eps' for EPS (see option '-E'),
'Outnnn.svg' for SVG (see options '-g' and '-v') or
'Out.xhtml' for XHTML+SVG (see option '-X').
'nnn' being a sequence number.
When <name> is present, it is the name of the file, or it
replaces 'Out' in the file name.
If <name> is '=', it is replaced by the name of the ABC
source file.
If <name> is '-', the result is output to stdout (not for EPS).
'+O' resets the output file directory and name to their defaults.
-q
Quiet mode.
When present, only the errors are shown.
-s <float>
See: format.txt - scale <float>
-S
Secure mode.
When present, file inclusion (%%format and %%EPS) and PostScript
injection (%%beginps and %%postscript) are disabled.
-T <int> [ <voice> ], +T [ <int> [<voice> ] ]
Activate or deactivate tablature drawing.
<int> is the tablature number as defined in %%tablature.
There may be only 8 different tablatures.
<voice> is the voice name, full name or subname as found in V:.
When absent, apply to all voices.
Up to 4 such commands may be defined.
Ex: '-T1flute +T2'
See: format.txt - tablature
-V
Show the version number.
-v
Produce SVG output instead of simple PS.
In this mode each page goes to a different file which name
is 'Outnnn.svg' (see option '-O').
-w <unit>
See: format.txt - staffwidth <unit>
-X
Produce XML + SVG output instead of simple PS.
The default file name is 'Out.xhtml' (see option '-O').
-x, +x
See: format.txt - writefields X <bool>
-0, +0
See: format.txt - splittune <bool>
-1, +1
See: format.txt - oneperpage <bool>
|
