diff options
author | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2006-12-25 03:06:05 +0000 |
---|---|---|
committer | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2006-12-25 03:06:05 +0000 |
commit | 1017cbebe5d5edd859e0fddad0a8600f509f4821 (patch) | |
tree | 78bdf336648566f7a7d55f42837357dea3dd674c /pbmtoescp2.html | |
parent | 16f2ac126651015a376eba864a3a35f738b0b25a (diff) | |
download | netpbm-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 'pbmtoescp2.html')
-rw-r--r-- | pbmtoescp2.html | 135 |
1 files changed, 135 insertions, 0 deletions
diff --git a/pbmtoescp2.html b/pbmtoescp2.html new file mode 100644 index 00000000..340c99f5 --- /dev/null +++ b/pbmtoescp2.html @@ -0,0 +1,135 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN"> +<HTML><HEAD><TITLE>Pbmtoescp2 User Manual</TITLE></HEAD> +<BODY> +<H1>pbmtoescp2</H1> +Updated: 4 April 2005 +<BR> +<A HREF="#index">Table Of Contents</A> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +pbmtoescp2 - convert a PBM image to a ESC/P2 printer file + +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>pbmtoescp2</B> + +[<B>-compress=</B><I>compressionmode</I>] +[<B>-resolution=</B><I>dpi</I>] + +[<I>pbmfile</I>] + +<P>All options can be abbreviated to their shortest unique prefix. You +may use two hyphens instead of one to designate an option. You may +use either white space or equals signs between an option name and its +value. + +<P>Input is read from file <I>pbmfile</I> if specified, otherwise from +stdin. Output is written to stdout. + +<A NAME="lbAD"> </A> +<H2>DESCRIPTION</H2> + +<p>This program is part of <a href="index.html">Netpbm</a>. + +<p><b>pbmtoescp2</b> reads a PBM image as input. It produces an ESC/P2 +raster graphic printer control stream as output. + +<P> This program creates an output that is printable on Epson printers +that understand the <a +href="http://www.epson.co.uk/support/manuals/pdf/ESCP/Part_1.pdf">ESC/P2 +printer control language</a> (e.g. the Stylus models). For older +Epson 9-pin dot matrix printers, which use the ESC/P protocol, see +<B>pbmtoepson</B>. + +<A NAME="lbAE"> </A> +<H2>OPTIONS</H2> + +<dl COMPACT> + +<dt><b>-compress=</b><i>compressionmode</i> + +<dd>This determines the compression mode that <b>pbmtoescp2</b> uses +in its output. Valid values for <I>compressionmode</I> are <b>0</b> +and <b>1</b>. <b>-compress=0</B> results in a printer control stream +with uncompressed raster graphic data. <b>-compress=1</b> results in +a printer control stream with RLE compressed raster graphic data +(RLE means Run Length Encoding). The default is <b>-compress=1</b>. +</dd> + +<dt><b>-resolution=</b><i>dpi</i></dt> + +<dd>This determines the horizontal and the vertical print resolution +set in the printer control stream. Another way of looking at it is a +declaration of what the resolution of the input image is (PBM images +don't have inherent resolution). Valid values for <i>dpi</i> are +<b>180</b> and <b>360</b>. See <a href="#hints">hints</a> for more +information on this. + +<p>The default is <b>-resolution=360</b>. + + +</dd> + +</dl> + +<H2 id="hints">HINTS</H2> + +<P>RLE compresses very well bitmaps of line drawings, preferably +horizontal oriented contents like texts, sheets of music, etc. +However, bitmaps derived from photographs are not ideal for RLE. In +extreme cases, when no byte repetitions occur in the input, the result +will be even slightly bigger than the input. To avoid this, use +compression mode 0 to switch off RLE. + +<p>Each pixel in the input PBM image becomes one dot in the printed +output. Therefore, you must make sure the width and height of the +input are appropriate for the print resolution you choose and the +print area you want. E.g. if you print at 180 dpi and want the image +to print as 8 inches by 10, you must supply a PBM that is 1440 +pixels wide by 1800 pixels high. You can adjust the size of the +input with <b>pamscale</b>, <b>pamstretch</b>, <b>pbmreduce</b>, or +<b>pamenlarge</b>. + + +<A NAME="lbAG"> </A> +<H2>SEE ALSO</H2> + +<B><A HREF="escp2topbm.html">escp2topbm</A></B>, +<B><A HREF="pbmtoepson.html">pbmtoepson</A></B>, +<B><A HREF="pamscale.html">pamscale</A></B>, +<B><A HREF="pamstretch.html">pamstretch</A></B>, +<B><A HREF="pbmreduce.html">pbmreduce</A></B>, +<B><A HREF="pamenlarge.html">pamenlarge</A></B>, +<B><A HREF="pbm.html">pbm</A></B> + +<A NAME="lbAH"> </A> +<H2>AUTHOR</H2> + +<P>Copyright (C) 2003 by Ulrich Walcher (<A +HREF="mailto:u.walcher@gmx.de">u.walcher@gmx.de</A>). + +<A NAME="history"> </A> +<H2>HISTORY</H2> + +<p><b>pbmtoescp2</b> was added to Netpbm in Release 10.18 (August 2003); +it was created around the same time. + +<HR> +<A NAME="index"> </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="#hints">HINTS</A> +<LI><A HREF="#lbAG">SEE ALSO</A> +<LI><A HREF="#lbAH">AUTHOR</A> +<LI><A HREF="#history">HISTORY</A> +</UL> +</BODY> +</HTML> + |