summary refs log tree commit diff
path: root/pbmtoepsi.html
diff options
context:
space:
mode:
authorgiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2006-12-25 03:06:05 +0000
committergiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2006-12-25 03:06:05 +0000
commit1017cbebe5d5edd859e0fddad0a8600f509f4821 (patch)
tree78bdf336648566f7a7d55f42837357dea3dd674c /pbmtoepsi.html
parent16f2ac126651015a376eba864a3a35f738b0b25a (diff)
downloadnetpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.tar.gz
netpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.tar.xz
netpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.zip
Place user guide into Subversion repository
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@181 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Diffstat (limited to 'pbmtoepsi.html')
-rw-r--r--pbmtoepsi.html112
1 files changed, 112 insertions, 0 deletions
diff --git a/pbmtoepsi.html b/pbmtoepsi.html
new file mode 100644
index 00000000..d6732425
--- /dev/null
+++ b/pbmtoepsi.html
@@ -0,0 +1,112 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML>
+<HEAD><title>Pbmtoepsi User Manual</title></HEAD>
+
+<BODY>
+<H1>pbmtoepsi</H1>
+Updated: June 2002
+<BR>
+<A HREF="#index">Table Of Contents</A>
+
+<A NAME="lbAB">&nbsp;</A>
+<H2>NAME</H2>
+pbmtoepsi - convert a PBM image to an encapsulated PostScript
+style preview bitmap
+
+<A NAME="lbAC">&nbsp;</A>
+<H2>SYNOPSIS</H2>
+
+<B>pbmtoepsi</B>
+[<B>-dpi=</B><I>N</I>[<B>x</B><I>N</I>]]
+[<B>-bbonly</B>]
+[<I>pbmfile</I>]
+
+<P>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.
+
+<A NAME="lbAD">&nbsp;</A>
+<H2>DESCRIPTION</H2>
+
+<p>This program is part of <a href="index.html">Netpbm</a>.
+
+<P>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.
+
+<P><b>pbmtoepsi</b> 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.
+
+<P>There is no <b>epsitopbm</b> tool - this transformation is one way.
+
+<A NAME="lbAE">&nbsp;</A>
+<H2>OPTIONS</H2>
+
+<DL COMPACT>
+<DT><B>-dpi=</B><I>N</I>[<B>x</B><I>N</I>]
+
+<DD>
+     <P>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.  <b>pbmtoepsi</b> assumes in
+     calculating the bounding box that each PBM pixel will become one
+     dot on the output device, and applies your <b>dpi</b>
+     specification to calculate the size and location on the page of
+     the bounding box.
+
+     <P>If you specify <I>N</I><B>x</B>N, the first number is the
+     horizontal resolution and the second number is the vertical
+     resolution.  If you specify just a single number <I>N</I>, that is the
+     resolution in both directions.
+
+     <P>The default is 72 dots per inch in both directions.
+
+     <P>This option was new In Netpbm 10.3 (June 2002).  Before that, 
+     <b>pbmtoepsi</b> always assumed 72 dots per inch in both directions.
+     
+<DT><B>-bbonly</B>
+
+<DD>
+Only create a boundary box, don't fill it with the image.
+</DL>
+
+<A NAME="lbAF">&nbsp;</A>
+<H2>SEE ALSO</H2>
+
+<B><A HREF="pbm.html">pbm</A></B>,
+
+<B><A HREF="pnmtops.html">pnmtops</A></B>,
+
+<B><A HREF="pstopnm.html">pstopnm</A></B>,
+
+<B><A HREF="psidtopgm.html">psidtopgm</A></B>,
+
+<B><A HREF="pbmtolps.html">pbmtolps</A></B>,
+
+Postscript language documentation
+
+<A NAME="lbAG">&nbsp;</A>
+<H2>AUTHOR</H2>
+
+Copyright (C) 1988 Jef Poskanzer, modified by Doug Crabill 1992
+
+<HR>
+<A NAME="index">&nbsp;</A>
+<H2>Table Of Contents</H2>
+<UL>
+<LI><A HREF="#lbAB">NAME</A>
+<LI><A HREF="#lbAC">SYNOPSIS</A>
+<LI><A HREF="#lbAD">DESCRIPTION</A>
+<LI><A HREF="#lbAE">OPTIONS</A>
+<LI><A HREF="#lbAF">SEE ALSO</A>
+<LI><A HREF="#lbAG">AUTHOR</A>
+</UL>
+</BODY>
+</HTML>