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
       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 ⟨index.html#commonoptions⟩ ), 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  be-
              come 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.15 on Sat Jun 29 01:55:48 CEST 2024.