options.txt


		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, except the
last one (ex: "-lnGI20").

The options may be disabled when starting with '+' or ending with '-'
(ex: "+MT1" is the same as "-MT1-"

List of the options
-------------------

 
GO TO INDEX GO TO TOP

-

-
	Read the abc file from stdin.

 
GO TO INDEX GO TO TOP

--

--<format> <value>
	Set the format parameter to <value>. See format.txt.

 
GO TO INDEX GO TO TOP

-a

-a<float>
	See: format.txt - maxshrink <float>

 
GO TO INDEX GO TO TOP

-B

-B<int>, +B
	See: format.txt - barsperstaff <int>

 
GO TO INDEX GO TO TOP

-b

-b<int>
	See: format.txt - measurefirst <int>

 
GO TO INDEX GO TO TOP

-c

-c, +c
	See: format.txt - continueall <bool>

 
GO TO INDEX GO TO TOP

-D

-D<dir>
	Search the format files in the directory <dir>.

 
GO TO INDEX GO TO TOP

-d

-d<unit>
	See: format.txt - staffsep <unit>

 
GO TO INDEX GO TO TOP

-E

-E, +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).
	EPS files are normally embedded into Postscript documents,
	but they may be a way to generate graphical images. For
	example, using GhostScript:
		abcm2ps voices -E -e7
		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)

 
GO TO INDEX GO TO TOP

-e

-e<list>
	Select the tunes inside an ABC file.
	<list> is a comma separated list of items (tune numbers).
	Each selector applies to the previous associated ABC file.
	An item may be a single index value (as indicated in the 'X:'
	field), or a range of such values. A range is indicated as
	<first_index>-<last_index>. The last index may be omitted
	meaning 'last tune of file'.
	Example:
		abcm2ps voices -e 5,2-4 newfeatures -e5-
	Note: Filtering may raise problems, mainly on global definitions.

 
GO TO INDEX GO TO TOP

-F

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

 
GO TO INDEX GO TO TOP

-f

-f
	See: format.txt - flatbeams <bool>

 
GO TO INDEX GO TO TOP

-G

-G, +G
	See: format.txt - graceslurs <bool>

 
GO TO INDEX GO TO TOP

-H

-H
	Display the current format values.

 
GO TO INDEX GO TO TOP

-h

-h
	Quick help, equivalent to "abcm2ps" without any arguments.
	This also shows the default settings for some parameters.

 
GO TO INDEX GO TO TOP

-I

-I<unit>
	See: format.txt - indent <unit>

 
GO TO INDEX GO TO TOP

-i

-i, +i
	Insert a red cercle around the errors in the PostScript output.

 
GO TO INDEX GO TO TOP

-j

-j<int>[b], +j
	See: format.txt - measurenb <int>

 
GO TO INDEX GO TO TOP

-k

-k<int>[b], +k
	See: format.txt - measurenb <int>

 
GO TO INDEX GO TO TOP

-L

-L<int>
	See: format.txt - encoding <int>

 
GO TO INDEX GO TO TOP

-l

-l, +l
	See: format.txt - landscape <bool>

 
GO TO INDEX GO TO TOP

-M

-M, +M
	See: format.txt - musiconly <bool>

 
GO TO INDEX GO TO TOP

-m

-m<unit>
	See: format.txt - leftmargin <unit>

 
GO TO INDEX GO TO TOP

-N

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

 
GO TO INDEX GO TO TOP

-n

-n, +n
	See: format.txt - writehistory <bool>

 
GO TO INDEX GO TO TOP

-O

-O[<directory>][<name>], +O
	Define the output file directory and/or name.
	By default, the output file goes to the current directory
	with a name 'Out.ps' for PS, and 'Outnnn.eps' for EPS (see
	option '-E').
	With this option, the file name may be <name> or <name>nnn.eps.
	If <name> is '=', the output file is the name of the ABC
	source file with the extension '.ps' for PS, or the title
	of the tune for EPS.
	If <name> is '-', the result is output on stdout (PS only).
	'+O' resets the output file directory and name to their defaults.

 
GO TO INDEX GO TO TOP

-s

-s<float>
	See: format.txt - scale <float>

 
GO TO INDEX GO TO TOP

-T

-T<int>[<voice>], +T[<int>[<voice>]]
	Activate or deactivate tablature drawing.
	<int> is the tablature number as defined in %%tablature.
	<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

 
GO TO INDEX GO TO TOP

-u

-u
	See: format.txt - abc2pscompat <bool>

 
GO TO INDEX GO TO TOP

-V

-V
	Show the version number.

 
GO TO INDEX GO TO TOP

-w

-w<unit>
	See: format.txt - staffwidth <unit>

 
GO TO INDEX GO TO TOP

-x

-x, +x
	See: format.txt - withxrefs <bool>

 
GO TO INDEX GO TO TOP

-0

-0, +0
	See: format.txt - splittune <bool>

 
GO TO INDEX GO TO TOP

-1

-1, +1
	See: format.txt - oneperpage <bool>
GO TO INDEX GO TO TOP

Index

- | -- | -0 | -1 | -a | -B | -b | -c | -D | -d | -E | -e | -F | -f | -G | -H | -h | -I | -i | -j | -k | -L | -l | -M | -m | -N | -n | -O | -s | -T | -u | -V | -w | -x

(34 topics)

GO TO INDEX GO TO TOP