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

DESCRIPTION

16       This program is part of Netpbm(1).
17
18       pbmtoescp2  reads  a  PBM image as input.  It produces an ESC/P2 raster
19       graphic printer control stream as output.
20
21        This program creates an output that is  printable  on  Epson  printers
22       that     understand     the    ESC/P2    printer    control    language
23       ⟨http://www.epson.co.uk/support/manuals/pdf/ESCP/Part_1.pdf⟩  (e.g. the
24       Stylus  models).   For older Epson 9-pin dot matrix printers, which use
25       the ESC/P protocol, see pbmtoepson.
26
27

OPTIONS

29       All options can be abbreviated to their shortest  unique  prefix.   You
30       may use two hyphens instead of one to designate an option.  You may use
31       either white space or equals signs  between  an  option  name  and  its
32       value.
33
34       Input  is  read  from  file pbmfile if specified, otherwise from stdin.
35       Output is written to stdout.
36
37
38
39
40       -compress=compressionmode
41              This determines the compression mode that pbmtoescp2 uses in its
42              output.   Valid  values  for compressionmode are 0 and 1.  -com‐
43              press=0 results in a printer control  stream  with  uncompressed
44              raster  graphic  data.  -compress=1 results in a printer control
45              stream with RLE compressed raster graphic data  (RLE  means  Run
46              Length Encoding).  The default is -compress=1.
47
48
49
50       -resolution=dpi
51              This determines the horizontal and the vertical print resolution
52              set in the printer control stream.  Another way of looking at it
53              is  a  declaration  of what the resolution of the input image is
54              (PBM images don't have inherent resolution).  Valid  values  for
55              dpi  are  180 and 360.  See hints ⟨#hints⟩  for more information
56              on this.
57
58              The default is -resolution=360.
59
60
61
62
63
64
65

HINTS

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

SEE ALSO

85       escp2topbm(1), pbmtoepson(1), pamscale(1), pamstretch(1), pbmreduce(1),
86       pamenlarge(1), pbm(1)
87
88

AUTHOR

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

HISTORY

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