Manual: pbmtoepsi

Pbmtoepsi User Manual(1)			   General Commands Manual			    Pbmtoepsi User Manual(1)

NAME
       pbmtoepsi - convert a PBM image to an encapsulated PostScript style preview bitmap

SYNOPSIS
       pbmtoepsi [-dpi=N[xN]] [-bbonly] [pbmfile]

       All  options  can  be  abbreviated to their shortest unique prefix.  You may use two hyphens instead of one.  You may
       separate an option name and its value with white space instead of an equals sign.

DESCRIPTION
       This program is part of Netpbm(1).

       Reads a PBM image as input.  Produces an encapsulated Postscript style bitmap as output.	 The output is not  a  stand
       alone postscript file, it is only a preview bitmap, which can be included in an encapsulated PostScript file.

       pbmtoepsi  assumes  the	PBM input describes a whole output page, with one pixel on the page corresponding to one PBM
       pixel.  It detects white borders in the image and generates Postscript output that contains a Bounding Box  statement
       to describe the location of the principal image (the image excluding the white borders) on the page and thus does not
       include the borders in the raster part of the Postscript output.

       There is no epsitopbm tool - this transformation is one way.

OPTIONS
       In  addition  to	 the  options common to all programs based on libnetpbm (most notably -quiet, see  Common Options ),
       pbmtoepsi recognizes the following command line options:

       -dpi=N[xN]

	      This option specifies the resolution in dots per inch of the
		   ultimate output device.  You must specify this because the
		   Bounding Box statement defines the bounding box in absolute
		   distances, not in pixels.  pbmtoepsi assumes in
		   calculating the bounding box that each PBM pixel will become one
		   dot on the output device, and applies your dpi
		   specification to calculate the size and location on the page of
		   the bounding box.

	      If you specify NxN, the first number is the
		   horizontal resolution and the second number is the vertical
		   resolution.	If you specify just a single number N, that is the
		   resolution in both directions.

	      The default is 72 dots per inch in both directions.

	      This option was new In Netpbm 10.3 (June 2002).  Before that,
		   pbmtoepsi always assumed 72 dots per inch in both directions.

       -bbonly
	      Only create a boundary box, don't fill it with the image.

SEE ALSO
       pbm(1), pnmtops(1), pstopnm(1), psidtopgm(1), pbmtolps(1),

       Postscript language documentation

AUTHOR
       Copyright (C) 1988 Jef Poskanzer, modified by Doug Crabill 1992

DOCUMENT SOURCE
       This manual page was generated by the Netpbm tool 'makeman' from HTML source.  The master documentation is at

	      http://netpbm.sourceforge.net/doc/pbmtoepsi.html

netpbm documentation					  June 2002				    Pbmtoepsi User Manual(1)