|-?, --help||Causes the program to show an option summary and usage information, then exit.|
|Causes the program to show version and license information, then exit.|
The normal output of imgtops is a page with a centered image. The
exact size and position depends on the various page size, image size,
and margin parameters listed below. The document always contains a tight
EPS bounding box around the image, but since bounding boxes must have
integral coordinates, there may be small slivers of empty page
contained in the bounding box as well. The -e option makes the
bounding box fit the image exactly, at the expense of centering
it on the page. These files are suitable only for EPS inclusion in
other documents; parts of the image will likely be cut off if they are
printed directly. -e causes the image size, page size, and page
margin options to be ignered.
The summary is: use -e if youre only using the output file by including it in another document. Dont use -e if you want to print the output file by itself.
|Set the desired image width and height. See the DIMENSIONS section below for legal dimension values. If both of these options are given, the image may be scaled nonuniformly. If the result does not fit on the page minus the margins, the image is scaled down to fit while maintaining its aspect ratio. The default if neither is given is to make the image as large as possible.|
|Set the output page size. The size value may be "letter", "legal", or "a4" to select one of the builtin sizes, or it may be two dimensions (width and height) separated by a comma.|
|Sets the size of the page margin. The default is one inch.|
|Rotates the image 90 degrees on the page. This may be used in conjunction with -e.|
|Forces all output to be Level 2 PostScript. This is the default. If both -3 and -2 are given, the one that appears last takes effect.|
|Allows the use of Level 3 PostScript features, which may result in smaller output files.|
|By default the output file is 7-bit clean, containing only printable ASCII characters and whitespace. This option allows arbitrary binary data to appear in the output, which reduces the size of the output file by about 20%. However, some PostScript document managers (such as gv, as of this writing) choke on binary data. For maximum portability of the resulting PostScript, do not use this option.|
|Uses a hexadecimal encoding of binary data instead of the default ASCII85 encoding. This option is primarily for debugging -- it results in an output file that is 60% larger, with no corresponding benefit. This option has no effect if -8 is specified (since then the binary data is not encoded at all, but appears in the output file directly).|
|By default, ASCII-encoded data is broken into lines of 75 characters or less. The -n option changes that limit. Setting it to zero or a negative value disables line breaking; the output will be one very long line. This option effects only the image data portion of the output file. The header of a typical output file contains lines of around 75 characters; -n has no effect on these lines. This option has no effect when -8 is specified.|
In batch mode, imgtops accepts multiple input images and
processes them all. It outputs one file per image; the output
filenames are constructed by replacing the input files extension with
".eps" (if -e is used) or ".ps" (if it is not). The -o
option can be used to specify the directory where the output files
should be placed.
At least one input image filename must be given; batch input images can not come from stdin.
-o, --output <filename>
-o, --output <dirname>
Normally imgtops processes a single input image, and -o
is used to specify the output filename. The default is stdout.
In batch mode (selected with -b), this option specifies a directory for the output files to go into; the filenames are constructed automatically from the input filenames.
|Normally imgtops prints a message to stderr as each input file is processed. -q suppresses all output to stderr, except for actual error messages.|
|The opposite of -q, this causes additional information to be printed to stderr as the program runs.|
Any option requiring a dimension may be given as a number followed by "in", "cm", "mm", "pt", "ft", or "m" to indicate the units. A number given without units is assumed to be a distance in PostScript points (1/72-inch).
Copyright © 2003 Doug Zongker
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
PostScript is a registered trademark of Adobe Systems Incorporated.
|imgtops 1.0||IMGTOPS (1)||September 2003|