.TL
Pcxtoppm User Manual
.SH 1
pcxtoppm
.LP
Updated: 19 April 2004
.br
Table Of Contents
.SH 2
NAME
.LP
pcxtoppm - convert a PCX file into a PPM image
.SH 2
SYNOPSIS
.LP
\fBpcxtoppm\fR
[\fB-stdpalette\fR]
[\fB-verbose\fR]
[\fIpcxfile\fR]
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBpcxtoppm\fR reads a PCX file as input and produces a PPM image
as output.
.LP
\fBpcxtoppm\fR recognizes the following PCX types:
.IP \(bu
Colormapped files with 2-16 colors.
.LP
"Packed pixel" format (1, 2 or 4 bits/pixel, 1 plane) or
bitplane format (1 bit/pixel, 1-4 planes).  The program uses a
predefined standard palette if the image does not provide one.
"Does not provide one" means the palette in the PCX header is
completely black.
.IP \(bu
Colormapped files with 256 colors.
.LP
8 bits/pixel, 1 plane, colormap at the end of the file.
.IP \(bu
24bit truecolor files.
.LP
24bit RGB: 8 bits/pixel, 3 planes.
.IP \(bu
32bit truecolor files.
.LP
24bit RGB + 8bit intensity: 8 bits/pixel, 4 planes.
.LP
.SH 2
OPTIONS
.LP
.RS
.IP "\fB-stdpalette\fR"
This option causes \fBpcxtoppm\fR to use its predefined standard 
palette even if the PCX image provides its own.  This is meaningful only
for an image in the 16 color paletted PCX format.
.LP
The image may appear to provide its own palette but in fact be created
by a program too primitive to understand palettes that created a random
palette by accident.
.RE
.SH 2
SEE ALSO
.LP
\fBppmtopcx\fR,
\fBppm\fR
.SH 2
AUTHORS
.LP
.LP
Copyright 1990 by Michael Davidson.
.LP
Modified 1994 by Ingo Wilken (Ingo.Wilken@informatik.uni-oldenburg.de)
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
SEE ALSO
.IP \(bu
AUTHORS
.LP