\
.\" 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 "Pcxtoppm User Manual" 1 "19 April 2004" "netpbm documentation"

.SH NAME

pcxtoppm - convert a PCX file into a PPM image

.UN synopsis
.SH SYNOPSIS

\fBpcxtoppm\fP
[\fB-stdpalette\fP]
[\fB-verbose\fP]
[\fIpcxfile\fP]

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpcxtoppm\fP reads a PCX file as input and produces a PPM image
as output.
.PP
\fBpcxtoppm\fP recognizes the following PCX types:


.IP \(bu
Colormapped files with 2-16 colors.
.sp
"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.
.sp
8 bits/pixel, 1 plane, colormap at the end of the file.

.IP \(bu
24bit truecolor files.
.sp
24bit RGB: 8 bits/pixel, 3 planes.

.IP \(bu
32bit truecolor files.
.sp
24bit RGB + 8bit intensity: 8 bits/pixel, 4 planes.



.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
\&), \fBpcxtoppm\fP recognizes the following
command line options:


.TP
\fB-stdpalette\fP
This option causes \fBpcxtoppm\fP 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.
.sp
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.

.TP
\fB-verbose\fP
Report details of the PCX header.



.UN seealso
.SH SEE ALSO
.BR "ppmtopcx" (1)\c
\&,
.BR "ppm" (1)\c
\&

.UN authors
.SH AUTHORS
.PP
Copyright 1990 by Michael Davidson.
.PP
Modified 1994 by Ingo Wilken (\fIIngo.Wilken@informatik.uni-oldenburg.de\fP)
.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/pcxtoppm.html
.PP