summary refs log tree commit diff
path: root/pnmquantall.html
blob: fe2cfdbf7a5a4836b1f4e9baa4f717fd27982acd (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
<html><head><title>Pnmquantall User Manual</title></head>
<body>
<h1>pnmquantall</h1>
Updated: 05 March 2012
<br>
<a href="#index">Table Of Contents</a>

<h2>NAME</h2>

pnmquantall - run Pnmquant on a bunch of files all at once, so they
share a common colormap

<h2 id="synopsis">SYNOPSIS</h2>

<b>pnmquantall</b>

[<b>-ext</b> <i>extension</i>] <i>ncolors</i> <i>netpbm_file</i>...

<p>Note that the usual syntax rules for Netpbm programs <em>don't apply</em>
to this program.  For example, you can't abbreviate -ext and you can't put
it anywhere on the line you want.


<h2 id="description">DESCRIPTION</h2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<p><b>pnmquantall</b> takes a bunch of Netpbm image files as input, chooses
<i>ncolors</i> colors to best represent all of the images, maps the
existing colors to the new ones, and <strong>overwrites the input
files</strong> with the new quantized versions.

<p>If you don't want to overwrite your input files, use the
<b>-ext</b> option.  The output files are then named the same as the
input files, plus a period and the extension text you specify.

<p>The purpose is this: Let's say you've got a dozen PPMs that you want to
display on the screen all at the same time.  Your screen can only display 256
different colors, but the PPMs have a total of a thousand or so different
colors.  For a single image you solve this problem
with <b>pnmquant</b>; <b>pnmquantall</b> solves it for multiple images.

<p>Note that another approach to this problem is to pre-select a set
of colors and then use <b>pnmremap</b> to separately quantize each PPM
to that set.)

<p>This is a rather simple program that runs <b>pnmcolormap</b> and
<b>pnmremap</b>.  If you are considering using it in a program of any
sophistication, you should probably just run those programs directly.
Even if you are typing it, you may want to do the steps manually because
it gives you access to the various options of <b>pnmcolormap</b> and
<b>pnmremap</b> for doing the quantization differently.


<h2 id="options">OPTIONS</h2>

<p><b>pnmquantall</b> recognizes the following command line option:

<dl compact>
<dt><b>-ext</b> <i>extension</i>
<dd>Specify an extension for the output files.  By default the input files
are overwritten.
</dl>

<p><b>pnmquantall</b> does not recognize the options common to all
programs based on libnetpbm (See <a href="index.html#commonoptions">
Common Options</a>.)  However, the <b>-version</b> option works.

<h2 id="seealso">SEE ALSO</h2>

<b><a href="pnmquant.html">pnmquant</a></b>,
<b><a href="pnmremap.html">pnmremap</a></b>,
<b><a href="pnmcolormap.html">pnmcolormap</a></b>,
<b><a href="pnm.html">pnm</a></b>

<hr>
<h2 id="index">Table Of Contents</h2>
<ul>
<li><a href="#synopsis">SYNOPSIS</a>
<li><a href="#description">DESCRIPTION</a>
<li><a href="#options">OPTIONS</a>
<li><a href="#seealso">SEE ALSO</a>
</ul>
</body>
</html>