Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
EPSTOIMG(1)			 User Commands			   EPSTOIMG(1)

       epstoimg	- create bitmap	images from PostScript

       epstoimg	[options]... <filename>

       This   program  uses  the  Ghostscript  interpreter  (http://www.ghost- 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.

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

	      Causes the program to show version and license information, then

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

	      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

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

       -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

	      The  width  and  height of the output, if	specified, are applied
	      after rotation (so -w 600	produces a 600-pixel  wide  image  re-
	      gardless 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 re-
	      sult 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 (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

       PostScript is a registered trademark of Adobe Systems Incorporated.

epstoimg 1.0			September 2003			   EPSTOIMG(1)


Want to link to this manual page? Use this URL:

home | help