diff options
Diffstat (limited to 'upstream/mageia-cauldron/man1/pbmtoescp2.1')
| -rw-r--r-- | upstream/mageia-cauldron/man1/pbmtoescp2.1 | 179 |
1 files changed, 179 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/pbmtoescp2.1 b/upstream/mageia-cauldron/man1/pbmtoescp2.1 new file mode 100644 index 00000000..71ded5b5 --- /dev/null +++ b/upstream/mageia-cauldron/man1/pbmtoescp2.1 @@ -0,0 +1,179 @@ +\ +.\" This man page was generated by the Netpbm tool 'makeman' from HTML source. +.\" Do not hand-hack it! If you have bug fixes or improvements, please find +.\" the corresponding HTML page on the Netpbm website, generate a patch +.\" against that, and send it to the Netpbm maintainer. +.TH "Pbmtoescp2 User Manual" 0 "14 July 2015" "netpbm documentation" + +.SH NAME + +pbmtoescp2 - convert a PBM image to a ESC/P2 printer file + +.UN synopsis +.SH SYNOPSIS + +\fBpbmtoescp2\fP + +[\fB-compress=\fP\fIcompressionmode\fP] +[\fB-resolution=\fP{\fB180\fP|\fB360\fP|\fB720\fP}] +[\fB-stripeheight=\fP\fIn\fP] +[\fB-formfeed\fP] +[\fB-raw\fP] +[\fIpbmfile\fP] +.PP +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. + +.UN description +.SH DESCRIPTION +.PP +This program is part of +.BR "Netpbm" (1)\c +\&. +.PP +\fBpbmtoescp2\fP reads a PBM image as input. It produces an ESC/P2 +raster graphic printer control stream as output. +.PP + This program creates an output that is printable on Epson printers that +understand the ESC/P2 printer control language (e.g. the Stylus models). For +older Epson 9-pin dot matrix printers, which use the ESC/P protocol, see +\fBpbmtoepson\fP. +.PP +The printed output has one pixel for each pixel of the input image, except +that it is padded up to the stripe size (see \fB-stripeheight\fP option) +vertically and to a multiple of 8 columns horizontally. Before Netpbm 10.72 +(September 2015), the output is instead truncated to those boundaries. +.PP +Input is read from file \fIpbmfile\fP if specified, otherwise from +stdin. Output is written to stdout. + +.UN options +.SH OPTIONS +.PP +In addition to the options common to all programs based on libnetpbm +(most notably \fB-quiet\fP, see +.UR index.html#commonoptions + Common Options +.UE +\&), \fBpbmtoescp2\fP recognizes the following +command line options: + + + +.TP +\fB-compress=\fP\fIcompressionmode\fP +This determines the compression mode that \fBpbmtoescp2\fP uses +in its output. Valid values for \fIcompressionmode\fP are \fB0\fP +and \fB1\fP. \fB-compress=0\fP results in a printer control stream +with uncompressed raster graphic data. \fB-compress=1\fP results in +a printer control stream with RLE compressed raster graphic data +(RLE means Run Length Encoding). The default is \fB-compress=1\fP. + + +.TP +\fB-resolution=\fP\fIdpi\fP +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 \fIdpi\fP are +\fB180\fP, \fB360\fP, and \fB720\fP. See +.UR #hints +hints +.UE +\& for +more information on this. +.sp +The default is \fB-resolution=360\fP. +.sp +Before Netpbm 10.72 (September 2015), \fB720\fP is not valid. + + + +.TP +\fB-stripeheight=\fP\fIn\fP +This option controls the height in lines of the stripes in the output. +.sp +The valid stripe heights in the printer language are 1, 8, and 24, but +it is capable of expressing any height up to 255 and \fBpbmtoescp2\fP +accepts any value in the range 1-255. It issues a warning, though, if you +choose something other than 1, 8, or 24. +.sp +The default is 24. +.sp +This option was new in Netpbm 10.72 (September 2015). Before that, the +stripe size is always 24. + +.TP +\fB-formfeed\fP +This option causes \fBpbmtoescp2\fP to place a formfeed command at the +end of the output. +.sp +This option was new in Netpbm 10.72 (September 2015). + + +.TP +\fB-raw\fP +This option causes \fBpbmtoescp2\fP to generate only the data blocks. +It does not generate printer commands to set up the output (for example, +setting the line spacing). +.sp +You can use this to insert graphics into a larger printer command stream. +.sp +This option was new in Netpbm 10.72 (September 2015). + + + +.UN hints +.SH HINTS +.PP +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. +.PP +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 \fBpamscale\fP, \fBpamstretch\fP, \fBpbmreduce\fP, or +\fBpamenlarge\fP. + + +.UN seealso +.SH SEE ALSO +.BR "escp2topbm" (1)\c +\&, +.BR "pbmtoepson" (1)\c +\&, +.BR "pamscale" (1)\c +\&, +.BR "pamstretch" (1)\c +\&, +.BR "pbmreduce" (1)\c +\&, +.BR "pamenlarge" (1)\c +\&, +.BR "pbm" (1)\c +\& + +.UN author +.SH AUTHOR +.PP +Copyright (C) 2003 by Ulrich Walcher (\fIu.walcher@gmx.de\fP). + +.UN history +.SH HISTORY +.PP +\fBpbmtoescp2\fP was added to Netpbm in Release 10.18 (August 2003); +it was created around the same time. +.SH DOCUMENT SOURCE +This manual page was generated by the Netpbm tool 'makeman' from HTML +source. The master documentation is at +.IP +.B http://netpbm.sourceforge.net/doc/pbmtoescp2.html +.PP
\ No newline at end of file |