pbmtoepsi



Pbmtoepsi User Manual(0)                              Pbmtoepsi User Manual(0)




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

       -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 direc-
              tions.


       -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



netpbm documentation               June 2002          Pbmtoepsi User Manual(0)

Man(1) output converted with man2html