dwww Home | Manual pages | Find package

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

NAME
       pbmtoepsi - convert a PBM image to an encapsulated PostScript style pre-
       view 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 Post-
       Script 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 bor-
       ders in the image and generates Postscript output that contains a Bound-
       ing 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 ]8;;index.html#commonoptions\ Common Options]8;;\ ),  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  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

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)

Generated by dwww version 1.16 on Tue Dec 16 04:50:10 CET 2025.