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