\
.\" 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 "Ppmquant User Manual" 0 "22 October 2003" "netpbm documentation"

.SH NAME

ppmquant - quantize the colors in a PPM image down to a specified number

.UN synopsis
.SH SYNOPSIS

\fBppmquant\fP
[\fB-floyd\fP|\fB-fs\fP]
\fIncolors\fP
[\fIppmfile\fP]
\fBppmquant\fP
[\fB-floyd\fP|\fB-fs\fP]
[\fB-nofloyd\fP|\fB-nofs\fP]
\fB-mapfile\fP
\fImapfile\fP
[\fIppmfile\fP]
.PP
All options can be abbreviated to their shortest unique prefix.  You
may use two hyphens instead of one to designate an option.  You may
use either white space or equals signs between an option name and its
value.


.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBppmquant\fP is obsolete.  All it does now is invoke
\fBpnmquant\fP or \fBpnmremap\fP.  You should use one of those
programs in any new program, or if you are modifying an old program,
and your program does not have to work with a version of Netpbm before
9.21 (January 2001).  \fBppmquant\fP exists only for name
compatibility.
.PP
\fBpnmquant\fP is fully backward compatible with \fBppmquant\fP
\fIwithout\fP the \fB-mapfile\fP option; \fBpnmremap\fP is fully
backward compatible with \fBppmquant\fP \fIwith\fP the
\fB-mapfile\fP option.
.PP
Except with differences suggested by the syntax synopsis above,
\fBppmquant\fP's function is the same as \fBpnmquant\fP and
\fBpnmremap\fP.
.PP
Before Netpbm 10.19 (November 2003), \fBppmquant\fP was a completely
separate program from \fBpnmquant\fP, and was a bona fide PPM program.
That means if you gave it a PGM or PBM image as input, it would process it
as if it were PPM and generate a PPM output.  Now, since it is really a
PNM program, it processes PBM and PGM inputs as what they are and produces
the same kind of output.
.PP
Note: The reason \fBppmquant\fP was changed in Netpbm 10.19 is
that for some time before that, \fBppmquant\fP had a serious bug that
would have been difficult to fix -- it chose the wrong color set.
Maintaining two versions of the same code did not make sense.

.UN seealso
.SH SEE ALSO
.BR "pnmquant" (1)\c
\&,
.BR "pnmremap" (1)\c
\&,
.BR "pnmcolormap" (1)\c
\&,
.BR "pamseq" (1)\c
\&,
.BR "ppm" (1)\c
\&

.UN author
.SH AUTHOR

Copyright (C) 1989, 1991 by Jef Poskanzer.
.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/ppmquant.html
.PP