.TL
Pnmmontage User Manual
.SH 1
pnmmontage
.LP
Updated: 31 December 2000
.br
Table Of Contents
.SH 2
NAME
.LP
pnmmontage - create a montage of PNM images
.SH 2
SYNOPSIS
.LP
\fBpnmmontage\fR
[\fB-header=\fR\fIheaderfile\fR]
[\fB-quality=\fR\fIn\fR]
[\fB-prefix=\fR\fIprefix\fR]
[\fB-0\fR|\fB-1\fR|\fB-2\fR|\fB...\fR|\fB-9\fR]
\fIpnmfile\fR...
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBpnmmontage\fR packs images of differing sizes into a
minimum-area composite image, optionally producing a C header file
with the locations of the subimages within the composite image.
.SH 2
OPTIONS
.LP
.RS
.IP "\fB-header\fR"
Tells \fBpnmmontage\fR to write a C header file of the locations
of the original images within the packed image.  Each original image
generates four #defines within the packed file: xxxX, xxxY, xxxSZX,
and xxxSZY, where xxx is the name of the file, converted to all
uppercase.  The ouput also includes #defines OVERALLX and OVERALLY, which
specifies the total size of the montage image.
.IP "\fB-prefix\fR"
Tells \fBpnmmontage\fR to use the specified prefix on all of the
#defines it generates.
.IP "\fB-quality\fR"
Before attempting to place the subimages, \fBpnmmontage\fR will
calculate a minimum possible area for the montage; this is either the
total of the areas of all the subimages, or the width of the widest
subimage times the height of the tallest subimage, whichever is
greater.  \fBpnmmontage\fR then initiates a problem-space search to
find the best packing; if it finds a solution that is (at least) as
good as the minimum area times the quality as a percent, it will break
out of the search.  Thus, \fB-q 100\fR will find the best possible
solution; however, it may take a very long time to do so.  The default
is \fB-q 200.\fR
.IP "\fB-0\fR, \fB-1\fR, ... \fB-9\fR"
These options control the quality at a higher level than
\fB-q\fR; \fB-0\fR is the worst quality (literally pick the first
solution found), while \fB-9\fR is the best quality (perform an
exhaustive search of problem space for the absolute best packing).
The higher the number, the slower the computation.  The default is
\fB-5\fR.
.RE
.SH 2
NOTES
.LP
.LP
Using \fB-9\fR is excessively slow on all but the smallest image
sets.  If the anymaps differ in maxvals, then pnmmontage will pick the
smallest maxval which is evenly divisible by each of the maxvals of
the original images.
.SH 2
SEE ALSO
.LP
\fBpnmcat\fR,
\fBpnmindex\fR,
\fBpnm\fR,
\fBpam\fR,
\fBpbm\fR,
\fBpgm\fR,
\fBppm\fR
.SH 2
AUTHOR
.LP
Copyright (C) 2000 by Ben Olmstead.
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
NOTES
.IP \(bu
SEE ALSO
.IP \(bu
AUTHOR
.LP