\
.\" 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 "Escp2topbm User Manual" 0 "" "netpbm documentation"

Created: 1 August 2003
escp2topbm - convert an ESC/P2 printer file to a PBM image

.UN synopsis
.SH SYNOPSIS

\fBescp2topbm\fP
[\fIprintfile\fP]

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR Netpbm (1)
.
.PP
\fBescp2topbm\fP reads an ESC/P2 printer control stream as input.
It produces a PBM image as output.
.PP
\fBescp2topbm\fP filters the raster graphic content from an Epson
ESC/P2 printer control stream and writes the image it would print as a
standard (raw) PBM image.
.PP
The input is from the file named by the \fIprintfile\fP argument, or
from Standard Input if you don't specify \fIprintfile\fP.  The output is
to Standard Output.
.PP
\fBescp2topbm\fP understands compression modes 0 (uncompressed)
and 1 (RLE compressed) in the Epson input stream.

.UN options
.SH OPTIONS
none

.UN hints
.SH HINTS
.PP
As \fBescp2topbm\fP is a simple program, created mainly to test
\fBpbmtoescp2\fP, there are some restrictions:


.IP \(bu
\fBescp2topbm\fP looks only at "ESC." sequences and ignores
all data outside these Escape sequences.

.IP \(bu
\fBescp2topbm\fP assumes that only one raster graphic is in the
printer stream.  If this isn't true, the result is garbage.

.IP \(bu
\fBescp2topbm\fP assumes that all "ESC."  sequences use the same
width value.  If this isn't true, the result is garbage.


.UN seealso
.SH SEE ALSO
.BR pbmtoescp2 (1)
,
.BR pbm (5)


.UN author
.SH AUTHOR
.PP
Copyright (C) 2003 by Ulrich Walcher 
(\fIu.walcher@gmx.de\fP).

.UN history
.SH HISTORY
.PP
\fBescp2topbm\fP was added to Netpbm in Release 10.18 (August 2003);
it was created around the same time.