.TL
Xpmtoppm User Manual
.SH 1
xpmtoppm
.LP
Updated: 05 October 2005
.br
Table Of Contents
.SH 2
NAME
.LP
xpmtoppm - convert an X11 pixmap to a PPM image
.SH 2
SYNOPSIS
.LP
\fBxpmtoppm\fR
[\fB--alphaout=\fR{\fIalpha-filename\fR,\fB-\fR}]
[\fB-verbose\fR]
[\fIxpmfile\fR]
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBxpbtoppm\fR reads an X11 pixmap (XPM version 1 or 3) as input
and produces a PPM image as output.
.SH 2
OPTIONS
.LP
.RS
.IP "\fB--alphaout=\fR\fIalpha-filename\fR"
\fBxpmtoppm\fR creates a PBM file containing the transparency
mask for the image.  If the input image doesn't contain transparency
information, the \fIalpha-filename\fR file contains all white
(opaque) alpha values.  If you don't specify \fB--alphaout\fR,
\fBxpmtoppm\fR does not generate an alpha file, and if the input
image has transparency information, \fBxpmtoppm\fR simply discards
it.
.LP
If you specify \fB-\fR as the filename, \fBxpmtoppm\fR writes the
alpha output to Standard Output and discards the image.
.LP
See \fBpamcomp\fR for one way to use
the alpha output file.
.LP
\fBxpmtoppm\fR can't handle a line longer than 8K characters in
the the XPM input.  If an input line exceeds this limit,
\fBxpmtoppm\fR quits with an error message to that effect.  Before
Netpbm 10.30 (October 2005), the limit was 2K.
.IP "\fB--verbose\fR"
\fBxpmtoppm\fR prints information about its processing on Standard Error.
.RE
.SH 2
LIMITATIONS
.LP
.LP
The recogized XPM version 3 features are limited.  Comments can
only be single lines and there must be for every pixel a default
colorname for a color type visual.
.SH 2
SEE ALSO
.LP
\fBppmtoxpm\fR,
\fBpamcomp\fR,
\fBppm\fR
.SH 2
AUTHOR
.LP
.LP
Copyright (C) 1991 by Jef Poskanzer.
.LP
Upgraded to work with XPM version 3 by
ArnaudLeHors<lehors@mirsa.inria.fr>, Tue
Apr 9 1991.
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
LIMITATIONS
.IP \(bu
SEE ALSO
.IP \(bu
AUTHOR
.LP