NAME

epstoimg - create bitmap images from PostScript

SYNOPSIS

epstoimg [options]... <filename>

DESCRIPTION

This program uses the Ghostscript interpreter (http://www.ghostscript.com/) to produce bitmap images from PostScript language files. The image shows the area within the bounding box, if the input file contains one, otherwise it shows the entire page. Multipage documents are supported.

OPTIONS

-?, --help: Causes the program to show an option summary and usage information, then exit.

--version: Causes the program to show version and license information, then exit.

-w, --width=#

-h, --height=#: Sets the size of the output image, in pixels. This will be the total size of the image including any padding. If only one is given, the other is calculated using the EPS bounding box, or the page size if no bounding box is specified. If neither is specified, the output image is sized to have one pixel per PostScript point in the input, plus any padding.

-m, --margin=<dim>: If a bounding box is specified in the input file, it is padded by this length on all sides before the file is rendered. This value may be negative, so long as the resulting box is nondegenerate.
The length is 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).

-p, --padding=#: After rendering, the output image can be padded on all sides by a border of white pixels. The default is zero pixels (no padding).

-b, --black: This causes the -p option to pad with black rather than white.

-r, --rotation=#: This rotates the output image by the given (integral) number of counter-clockwise quarter turns. The value may be negative. epstoimg searches the input file for the first valid %%Orientation: or %%PageOrientation: comment to set the orientation of the page; the value of this option is applied relative to that default.
The width and height of the output, if specified, are applied after rotation (so -w 600 produces a 600-pixel wide image regardless of the page's orientation).

-s, --resolution=<res>: This option controls the resolution (in DPI) of the Ghostscript interpreter. Normally epstoimg sets this automatically based on the desired output size and input bounding box, if any, but this option can be used to override the default value. The resolution may be a single number, or two numbers joined by a letter 'x' to specify different resolutions in X and Y. Low values will produce fast, lower-quality output; higher values may result in nicer output at the expense of processing time.

-g, --grayscale: Converts the image to grayscale before saving.

-o, --output=<filename>: Sets the output filename. The default is to write to stdout. At least one of -o or -f must be given. If only -o is given, the output format is determined from the file extension.
If the input contains multiple pages, then a four-digit page number is inserted before the extension. Thus, "-o foo.png" will actually produce output files "foo.0001.png", "foo.0002.png", etc. If the input is just a single page, the output filename is used unchanged.

-f, --format=FMT: Sets the output image format. Valid values are: "BMP", "GIF", "JPEG", "PCX", "PNG", "PPM", "TIFF". This overrides the format inferred from the filename extension given with -o, if any.

-i, --interpreter=<gs>: This specifies the location of the Ghostscript interpreter. If the first character is a '+', then the directories in the PATH environment variable are searched for the remainder of the string and the first match is used. The default value is set at install time.

-q, --quiet: Normally epstoimg prints a message to stderr as each page of the input file is processed. -q suppresses all output to stderr, except for actual error messages.

-v, --verbose: The opposite of -q, this causes additional information to be printed to stderr as the program runs.

COPYRIGHT

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.