pbmtoescp2(1)

1Pbmtoescp2 User Manual(0)                            Pbmtoescp2 User Manual(0)
2
3
4

NAME

6       pbmtoescp2 - convert a PBM image to a ESC/P2 printer file
7
8

SYNOPSIS

10       pbmtoescp2
11
12       [-compress=compressionmode] [-resolution=dpi] [pbmfile]
13
14       All  options  can  be abbreviated to their shortest unique prefix.  You
15       may use two hyphens instead of one to designate an option.  You may use
16       either  white  space  or  equals  signs  between an option name and its
17       value.
18
19

DESCRIPTION

21       This program is part of Netpbm(1).
22
23       pbmtoescp2 reads a PBM image as input.  It produces  an  ESC/P2  raster
24       graphic printer control stream as output.
25
26        This  program  creates  an  output that is printable on Epson printers
27       that understand the ESC/P2 printer control language  (e.g.  the  Stylus
28       models).   For  older  Epson  9-pin  dot matrix printers, which use the
29       ESC/P protocol, see pbmtoepson.
30
31

OPTIONS

33       Input is read from file pbmfile if  specified,  otherwise  from  stdin.
34       Output is written to stdout.
35
36
37
38
39       -compress=compressionmode
40              This determines the compression mode that pbmtoescp2 uses in its
41              output.  Valid values for compressionmode are 0  and  1.   -com‐
42              press=0  results  in  a printer control stream with uncompressed
43              raster graphic data.  -compress=1 results in a  printer  control
44              stream  with  RLE  compressed raster graphic data (RLE means Run
45              Length Encoding).  The default is -compress=1.
46
47
48
49       -resolution=dpi
50              This determines the horizontal and the vertical print resolution
51              set in the printer control stream.  Another way of looking at it
52              is a declaration of what the resolution of the  input  image  is
53              (PBM  images  don't have inherent resolution).  Valid values for
54              dpi are 180 and 360.  See hints ⟨#hints⟩  for  more  information
55              on this.
56
57              The default is -resolution=360.
58
59
60
61
62
63
64

HINTS

66       RLE  compresses very well bitmaps of line drawings, preferably horizon‐
67       tal oriented contents like texts, sheets of music, etc.  However,  bit‐
68       maps derived from photographs are not ideal for RLE.  In extreme cases,
69       when no byte repetitions occur in the input, the result  will  be  even
70       slightly  bigger than the input.  To avoid this, use compression mode 0
71       to switch off RLE.
72
73       Each pixel in the input PBM image becomes one dot in the  printed  out‐
74       put.   Therefore,  you must make sure the width and height of the input
75       are appropriate for the print resolution you choose and the print  area
76       you  want.  E.g. if you print at 180 dpi and want the image to print as
77       8 inches by 10, you must supply a PBM that is 1440 pixels wide by  1800
78       pixels  high.  You can adjust the size of the input with pamscale, pam‐
79       stretch, pbmreduce, or pamenlarge.
80
81
82

AUTHOR

89       Copyright (C) 2003 by Ulrich Walcher (u.walcher@gmx.de).
90
91

HISTORY

93       pbmtoescp2  was  added to Netpbm in Release 10.18 (August 2003); it was
94       created around the same time.
95
96
97
98netpbm documentation             4 April 2005        Pbmtoescp2 User Manual(0)