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={180|360|720}]
13       [-stripeheight=n] [-formfeed] [-raw] [pbmfile]
14
15       All options can be abbreviated to their shortest  unique  prefix.   You
16       may use two hyphens instead of one to designate an option.  You may use
17       either white space or equals signs  between  an  option  name  and  its
18       value.
19
20
21

DESCRIPTION

23       This program is part of Netpbm(1).
24
25       pbmtoescp2  reads  a  PBM image as input.  It produces an ESC/P2 raster
26       graphic printer control stream as output.
27
28        This program creates an output that is  printable  on  Epson  printers
29       that  understand  the  ESC/P2 printer control language (e.g. the Stylus
30       models).  For older Epson 9-pin dot  matrix  printers,  which  use  the
31       ESC/P protocol, see pbmtoepson.
32
33       The  printed  output  has  one pixel for each pixel of the input image,
34       except that it is padded up  to  the  stripe  size  (see  -stripeheight
35       option) vertically and to a multiple of 8 columns horizontally.  Before
36       Netpbm 10.72 (September 2015), the output is instead truncated to those
37       boundaries.
38
39
40

OPTIONS

42       Input  is  read  from  file pbmfile if specified, otherwise from stdin.
43       Output is written to stdout.
44
45
46
47
48       -compress=compressionmode
49              This determines the compression mode that pbmtoescp2 uses in its
50              output.   Valid  values  for compressionmode are 0 and 1.  -com‐
51              press=0 results in a printer control  stream  with  uncompressed
52              raster  graphic  data.  -compress=1 results in a printer control
53              stream with RLE compressed raster graphic data  (RLE  means  Run
54              Length Encoding).  The default is -compress=1.
55
56
57
58       -resolution=dpi
59              This determines the horizontal and the vertical print resolution
60              set in the printer control stream.  Another way of looking at it
61              is  a  declaration  of what the resolution of the input image is
62              (PBM images don't have inherent resolution).  Valid  values  for
63              dpi  are 180, 360, and 720.  See hints ⟨#hints⟩  for more infor‐
64              mation on this.
65
66              The default is -resolution=360.
67
68              Before Netpbm 10.72 (September 2015), 720 is not valid.
69
70
71
72
73       -stripeheight=n
74              This option controls the height in lines of the stripes  in  the
75              output.
76
77              The  valid  stripe heights in the printer language are 1, 8, and
78              24, but it is capable of expressing any height  up  to  255  and
79              pbmtoescp2  accepts  any  value in the range 1-255.  It issues a
80              warning, though, if you choose something other than 1, 8, or 24.
81
82              The default is 24.
83
84              This option was new in Netpbm 10.72  (September  2015).   Before
85              that, the stripe size is always 24.
86
87
88       -formfeed
89              This option causes pbmtoescp2 to place a formfeed command at the
90              end of the output.
91
92              This option was new in Netpbm 10.72 (September 2015).
93
94
95
96       -raw   This option causes pbmtoescp2 to generate only the data  blocks.
97              It  does not generate printer commands to set up the output (for
98              example, setting the line spacing).
99
100              You can use this to insert graphics into a larger  printer  com‐
101              mand stream.
102
103              This option was new in Netpbm 10.72 (September 2015).
104
105
106
107

HINTS

109       RLE  compresses very well bitmaps of line drawings, preferably horizon‐
110       tal oriented contents like texts, sheets of music, etc.  However,  bit‐
111       maps derived from photographs are not ideal for RLE.  In extreme cases,
112       when no byte repetitions occur in the input, the result  will  be  even
113       slightly  bigger than the input.  To avoid this, use compression mode 0
114       to switch off RLE.
115
116       Each pixel in the input PBM image becomes one dot in the  printed  out‐
117       put.   Therefore,  you must make sure the width and height of the input
118       are appropriate for the print resolution you choose and the print  area
119       you  want.  E.g. if you print at 180 dpi and want the image to print as
120       8 inches by 10, you must supply a PBM that is 1440 pixels wide by  1800
121       pixels  high.  You can adjust the size of the input with pamscale, pam‐
122       stretch, pbmreduce, or pamenlarge.
123
124
125

SEE ALSO

127       escp2topbm(1), pbmtoepson(1), pamscale(1), pamstretch(1), pbmreduce(1),
128       pamenlarge(1), pbm(1)
129
130

AUTHOR

132       Copyright (C) 2003 by Ulrich Walcher (u.walcher@gmx.de).
133
134

HISTORY

136       pbmtoescp2  was  added to Netpbm in Release 10.18 (August 2003); it was
137       created around the same time.
138

DOCUMENT SOURCE

140       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
141       source.  The master documentation is at
142
143              http://netpbm.sourceforge.net/doc/pbmtoescp2.html
144
145netpbm documentation             14 July 2015        Pbmtoescp2 User Manual(0)
Impressum