DragonFly On-Line Manual Pages

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.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
       Copyright (C) 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)