epstoimg man page on DragonFly
[printable version]
EPSTOIMG(1) User Commands EPSTOIMG(1)
NAME
epstoimg - create bitmap images from PostScript
SYNOPSIS
epstoimg [options]... <filename>
DESCRIPTION
This program uses the Ghostscript interpreter (http://www.ghost‐
script.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 informa‐
tion, 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 Post‐
Script 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 nondegen‐
erate.
The length is given as a number followed by "in", "cm", "mm",
"pt", "ft", or "m" to indicate the units. A number given with‐
out 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 pad‐
ding).
-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 %%Orienta‐
tion: 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 resolu‐
tion 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
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.
epstoimg 1.0 September 2003 EPSTOIMG(1)
[top]
List of man pages available for DragonFly
Copyright (c) for man pages and the logo by the respective OS vendor.
For those who want to learn more, the polarhome community provides shell access and support.
[legal]
[privacy]
[GNU]
[policy]
[cookies]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
|
|
Vote for polarhome
|
