1Pbmtoescp2 User Manual(0) Pbmtoescp2 User Manual(0)
2
3
4
6 pbmtoescp2 - convert a PBM image to a ESC/P2 printer file
7
8
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
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
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
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
127 escp2topbm(1), pbmtoepson(1), pamscale(1), pamstretch(1), pbmreduce(1),
128 pamenlarge(1), pbm(1)
129
130
132 Copyright (C) 2003 by Ulrich Walcher (u.walcher@gmx.de).
133
134
136 pbmtoescp2 was added to Netpbm in Release 10.18 (August 2003); it was
137 created around the same time.
138
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)