summary refs log tree commit diff
path: root/pnmindex.html
blob: b1c98b66efb59175210fc65b2cdd1adddb673389 (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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
<html><head><title>Pnmindex User Manual</title></head>
<body>
<h1>pnmindex</h1>
Updated: 14 November 2015
<br>
<a href="#index">Table Of Contents</a>

<h2>NAME</h2>
pnmindex - build a visual index of a bunch of PNM images

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

<b>pnmindex</b>

[<b>-size=</b><i>N</i>]

[<b>-across=</b><i>N</i>]

[<b>-colors=</b><i>N</i>]

[<b>-black</b>]

[<b>-title=</b><i>title</i>]

[<b>-quant</b>|<b>-noquant</b>]

<i>pnmfile</i> ...

<p>You can use the minimum unique abbreviation of the options.  You can use
two hyphens instead of one.  You can separate an option name from its value
with white space instead of an equals sign.


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

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

<b>pnmindex</b> creates an index image containing thumbnail (small)
versions of a bunch of PNM files you supply.  (Akin to a photographic
"contact sheet").

<p><b>pnmindex</b> labels each thumbnail and, optionally, contains a
title.

<p>If you just want to concatenate some images together in a grid, use
<b>pamundice</b> for that.

<p>If you want to take apart the image you generated with <b>pnmindex</b>,
use <b>pamdice</b> or <b>pamcut</b>.

<p>The program can generate large temporary files.  By default, these go in
directory <b>/tmp</b>, but you can usse the <b>TMPDIR</b> environment variable
to have them somewhere else.


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

<p>In addition to the options common to all programs based on libnetpbm
(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
Common Options</a>), <b>pnmindex</b> recognizes the following
command line options:

<dl compact>
<dt><b>-size=</b><i>N</i>

<dd>The size of each thumbnail.  The image is scaled to fit maximally
inside a <i>N</i> x <i>N</i> pixel box without changing its aspect
ratio.  Default is 100.

<dt><b>-across=</b><i>N</i>

<dd>The number of thumbnails in each row.  Default is 6.

<dt><b>-colors=</b><i>N</i>

<dd>The maximum number of colors allowed in the overall image.  If it
would otherwise have more colors than these, <b>pnmindex</b> quantizes
the result.  The default is 256.

<p>However, this value is meaningless if you specify the
<b>-noquant</b> option.

<dt><b>-black</b>

<dd>This controls the color of the padding between the images;
normally it's white and the labels are black lettering on white
background, but the <b>-black</b> option reverses this.

<dt><b>-title=</b><i>title</i>

<dd>
Specifies a title top place at the top of the image.
Default is no title.

<dt><b>-quant</b>

<dd>Enables quantization (to the number of colors specified by
<b>-colors</b>).  Quantization is on by default but you can disable
it with <b>-noquant.</b>

<dt><b>-noquant</b>

<dd>See <b>-quant</b>.

</dl>

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

<b><a href="pamscale.html">pamscale</a></b>,

<b><a href="pnmcat.html">pnmcat</a></b>,

<b><a href="pbmtext.html">pbmtext</a></b>,

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

<b><a href="pamcut.html">pamcut</a></b>,

<b><a href="pamdice.html">pamdice</a></b>,

<b><a href="pamundice.html">pamundice</a></b>,

<b><a href="pnmtile.html">pnmtile</a></b>,

<b><a href="pnm.html">pnm</a></b>

<h2 id="author">AUTHOR</h2>

<p>Copyright (C) 1991 by Jef Poskanzer.

<p><b>-title</b> and <b>-noquant</b> added 2000 by John Heidemann.

<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>
<li><a href="#author">AUTHOR</a>
</ul>
</body>
</html>