pnmindex man page

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









pnmfile ...

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.


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

pnmindex labels each thumbnail and, optionally, contains a title.

If you just want to concatenate some images together in a grid, use pamundice for that.

If you want to take apart the image you generated with pnmindex, use pamdice or pamcut.

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


The size of each thumbnail. The image is scaled to fit maximally inside a N x N pixel box without changing its aspect ratio. Default is 100.
The number of thumbnails in each row. Default is 6.
The maximum number of colors allowed in the overall image. If it would otherwise have more colors than these, pnmindex quantizes the result. The default is 256.

However, this value is meaningless if you specify the -noquant option.
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 -black option reverses this.
Specifies a title top place at the top of the image. Default is no title.
Enables quantization (to the number of colors specified by -colors). Quantization is on by default but you can disable it with -noquant.
See -quant.

See Also

pamscale(1) , pnmcat(1) , pbmtext(1) , pnmquant(1) , pamcut(1) , pamdice(1) , pamundice(1) , pnmtile(1) , pnm(1)


Copyright (C) 1991 by Jef Poskanzer.

-title and -noquant added 2000 by John Heidemann.

Document Source

This manual page was generated by the Netpbm tool 'makeman' from HTML source. The master documentation is at


Referenced By

pamundice(1), pcdovtoppm(1), pnmmontage(1), pnmtile(1).

Explore man page connections for pnmindex(1).

netpbm documentation 14 November 2015