\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pnmindex User Manual" 0 "1 April 2007" "netpbm documentation"

.SH NAME

pnmindex - build a visual index of a bunch of PNM images

.UN synopsis
.SH SYNOPSIS

\fBpnmindex\fP

[\fB-size=\fP\fIN\fP]

[\fB-across=\fP\fIN\fP]

[\fB-colors=\fP\fIN\fP]

[\fB-black\fP]

[\fB-title=\fP\fItitle\fP]

[\fB-quant\fP|\fB-noquant\fP]

\fIpnmfile\fP ...
.PP
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.


.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR Netpbm (1)
.

\fBpnmindex\fP creates an index image containing thumbnail (small)
versions of a bunch of PNM files you supply.  (Akin to a photographic
\&'contact sheet.'
.PP
\fBpnmindex\fP labels each thumbnail and, optionally, contains a
title.
.PP
If you just want to concatenate some images together in a grid, use
\fBpamundice\fP for that.
.PP
If you want to take apart the image you generated with \fBpnmindex\fP,
use \fBpamdice\fP or \fBpamcut\fP.

.UN options
.SH OPTIONS


.TP
\fB-size=\fP\fIN\fP
The size of each thumbnail.  The image is scaled to fit maximally
inside a \fIN\fP x \fIN\fP pixel box without changing its aspect
ratio.  Default is 100.

.TP
\fB-across=\fP\fIN\fP
The number of thumbnails in each row.  Default is 6.

.TP
\fB-colors=\fP\fIN\fP
The maximum number of colors allowed in the overall image.  If it
would otherwise have more colors than these, \fBpnmindex\fP quantizes
the result.  The default is 256.
.sp
However, this value is meaningless if you specify the
\fB-noquant\fP option.

.TP
\fB-black\fP
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 \fB-black\fP option reverses this.

.TP
\fB-title=\fP\fItitle\fP
Specifies a title top place at the top of the image.
Default is no title.

.TP
\fB-quant\fP
Enables quantization (to the number of colors specified by
\fB-colors\fP).  Quantization is on by default but you can disable
it with \fB-noquant.\fP

.TP
\fB-noquant\fP
See \fB-quant\fP.



.UN seealso
.SH SEE ALSO
.BR pamscale (1)
,
.BR pnmcat (1)
,
.BR pbmtext (1)
,
.BR pnmquant (1)
,
.BR pamcut (1)
,
.BR pamdice (1)
,
.BR pamundice (1)
,
.BR pnmtile (1)
,
.BR pnm (5)


.UN author
.SH AUTHOR
.PP
Copyright (C) 1991 by Jef Poskanzer.
.PP
\fB-title\fP and \fB-noquant\fP added 2000 by John Heidemann.