Debian Codegraph @

upstream/debian-unstable/man1/pnmquantall.1

raw
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" 1 "05 March 2012" "netpbm documentation"
7
8 .SH NAME
9
10 pnmquantall - run Pnmquant on a bunch of files all at once, so they
11 share 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
20 Note that the usual syntax rules for Netpbm programs \fIdon't apply\fP
21 to this program. For example, you can't abbreviate -ext and you can't put
22 it anywhere on the line you want.
23
24
25 .UN description
26 .SH DESCRIPTION
27 .PP
28 This 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
34 existing colors to the new ones, and \fBoverwrites the input
35 files\fP with the new quantized versions.
36 .PP
37 If 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
39 input files, plus a period and the extension text you specify.
40 .PP
41 The purpose is this: Let's say you've got a dozen PPMs that you want to
42 display on the screen all at the same time. Your screen can only display 256
43 different colors, but the PPMs have a total of a thousand or so different
44 colors. For a single image you solve this problem
45 with \fBpnmquant\fP; \fBpnmquantall\fP solves it for multiple images.
46 .PP
47 Note that another approach to this problem is to pre-select a set
48 of colors and then use \fBpnmremap\fP to separately quantize each PPM
49 to that set.)
50 .PP
51 This is a rather simple program that runs \fBpnmcolormap\fP and
52 \fBpnmremap\fP. If you are considering using it in a program of any
53 sophistication, you should probably just run those programs directly.
54 Even if you are typing it, you may want to do the steps manually because
55 it gives you access to the various options of \fBpnmcolormap\fP and
56 \fBpnmremap\fP for doing the quantization differently.
57
58
59 .UN options
60 .SH OPTIONS
61 .PP
62 \fBpnmquantall\fP recognizes the following command line option:
63
64
65 .TP
66 \fB-ext\fP \fIextension\fP
67 Specify an extension for the output files. By default the input files
68 are overwritten.
69
70 .PP
71 \fBpnmquantall\fP does not recognize the options common to all
72 programs based on libnetpbm (See
73 .UR index.html#commonoptions
74 Common Options
75 .UE
76 \&.) However, the \fB-version\fP option works.
77
78 .UN seealso
79 .SH SEE ALSO
80 .BR "pnmquant" (1)\c
81 \&,
82 .BR "pnmremap" (1)\c
83 \&,
84 .BR "pnmcolormap" (1)\c
85 \&,
86 .BR "pnm" (1)\c
87 \&
88 .SH DOCUMENT SOURCE
89 This manual page was generated by the Netpbm tool 'makeman' from HTML
90 source. The master documentation is at
91 .IP
92 .B http://netpbm.sourceforge.net/doc/pnmquantall.html
93 .PP