1\
2.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
4.\" the corresponding HTML page on the Netpbm website, generate a patch
5.\" against that, and send it to the Netpbm maintainer.
6.TH "Pnmquantall User Manual" 0 "05 March 2012" "netpbm documentation"
7
8.SH NAME
9
10pnmquantall - run Pnmquant on a bunch of files all at once, so they
11share a common colormap
12
13.UN synopsis
14.SH SYNOPSIS
15
16\fBpnmquantall\fP
17
18[\fB-ext\fP \fIextension\fP] \fIncolors\fP \fInetpbm_file\fP...
19.PP
20Note that the usual syntax rules for Netpbm programs \fIdon't apply\fP
21to this program.  For example, you can't abbreviate -ext and you can't put
22it anywhere on the line you want.
23
24
25.UN description
26.SH DESCRIPTION
27.PP
28This program is part of
29.BR "Netpbm" (1)\c
30\&.
31.PP
32\fBpnmquantall\fP takes a bunch of Netpbm image files as input, chooses
33\fIncolors\fP colors to best represent all of the images, maps the
34existing colors to the new ones, and \fBoverwrites the input
35files\fP with the new quantized versions.
36.PP
37If you don't want to overwrite your input files, use the
38\fB-ext\fP option.  The output files are then named the same as the
39input files, plus a period and the extension text you specify.
40.PP
41The purpose is this: Let's say you've got a dozen PPMs that you want to
42display on the screen all at the same time.  Your screen can only display 256
43different colors, but the PPMs have a total of a thousand or so different
44colors.  For a single image you solve this problem
45with \fBpnmquant\fP; \fBpnmquantall\fP solves it for multiple images.
46.PP
47Note that another approach to this problem is to pre-select a set
48of colors and then use \fBpnmremap\fP to separately quantize each PPM
49to that set.)
50.PP
51This is a rather simple program that runs \fBpnmcolormap\fP and
52\fBpnmremap\fP.  If you are considering using it in a program of any
53sophistication, you should probably just run those programs directly.
54Even if you are typing it, you may want to do the steps manually because
55it gives you access to the various options of \fBpnmcolormap\fP and
56\fBpnmremap\fP for doing the quantization differently.
57
58
59.UN seealso
60.SH SEE ALSO
61.BR "pnmquant" (1)\c
62\&,
63.BR "pnmremap" (1)\c
64\&,
65.BR "pnmcolormap" (1)\c
66\&,
67.BR "pnm" (5)\c
68\&
69.SH DOCUMENT SOURCE
70This manual page was generated by the Netpbm tool 'makeman' from HTML
71source.  The master documentation is at
72.IP
73.B http://netpbm.sourceforge.net/doc/pnmquantall.html
74.PP