\
.\" 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 "Pbmtolj User Manual" 0 "23 April 2005" "netpbm documentation"

.SH NAME
pbmtolj - convert a PBM image to HP LaserJet format

.UN synopsis
.SH SYNOPSIS

\fBpbmtolj\fP
[\fB-resolution\fP \fIN\fP]
[\fB-float\fP]
[\fB-noreset\fP]
[\fB-packbits\fP]
[\fB-delta\fP]
[\fB-compress\fP]
[\fIpbmfile\fP]
[\fB-copies\fP \fIN\fP]
.PP
You can abbreviate any option to its shortest unique prefix.


.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR Netpbm (1)
.
.PP
\fBpbmtolj\fP reads a PBM image as input and produces HP LaserJet
data as output.  You can send this data to a LaserJet or DeskJet printer
(at least some of them).
.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 300 dpi and want the image
to print as 8 inches by 10, you must supply a PBM that is 2400
pixels wide by 3000 pixels high.  You can adjust the size of the
input with \fBpamscale\fP, \fBpamstretch\fP, \fBpbmreduce\fP, or
\fBpamenlarge\fP.
.PP
The input may be a multi-image PBM stream.  Each input image
becomes a page of output.  But before Netpbm 10.28 (June 2005), images
after the first one are ignored.
.PP
Note that there is no ljtopbm tool.

.UN options
.SH OPTIONS


.TP
\fB-resolution\fP
Specifies the resolution of the output device, in dpi.  Another
way to look at this is as a declaration of the resolution of the input
image (PBM images don't have inherent resolution).  Typical values are
75, 100, 150, 300, and 600.  The default is 75.

.TP
\fB-float\fP
Suppresses positioning commands.  By default, \fBpbmtolj\fP
places the sequence \fIESC & l 0 E\fP in the output, which means
to force the top margin to zero.  With \fB-float\fP, \fBpbmtolj\fP
omits that command.

.TP
\fB-noreset\fP
Prevents pbmtolj from writing the reset sequences to the beginning
and end of the output file.

.TP
\fB-packbits\fP
Enables use of TIFF packbits compression.

.TP
\fB-delta\fP
Enables use of delta-between-rows compression.

.TP
\fB-compress\fP
Enables use of both TIFF packbits, and delta-between-rows compression.

.TP
\fB-copies\fP
Specifies the number of copies. The default is 1.  This option
controls the 'number of copies' printer control;
\fBpbmtolj\fP generates only one copy of the image.



.UN seealso
.SH SEE ALSO
.BR \fBpnmtopclxl\fP (1)
,
.BR \fBppmtolj\fP (1)
,
.BR \fBpjtoppm\fP (1)
,
.BR \fBppmtopj\fP (1)
,
.BR \fBthinkjettopbm\fP (1)
,
.BR pbm (5)


.UN author
.SH AUTHOR

Copyright (C) 1988 by Jef Poskanzer and Michael Haberler.
\fB-float\fP and \fB-noreset\fP options added by Wim Lewis.
\fB-delta\fP, \fB-packbits\fP, and \fB-compress\fP options added by
Dave Platt.