pnmmontage - create a montage of portable anymaps
SYNOPSIS
pnmmontage [-?|-help] [-header=headerfile] [-quality=n]
[-prefix=prefix] [-0|-1|-2|...|-9] pnmfile...
DESCRIPTION
Packs images of differing sizes into a minimum-area com
posite image, optionally producing a C header file with
the locations of the subimages within the composite image.
OPTIONS
-?, -help
Displays a (very) short usage message.
-header
Tells pnmmontage 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, con
verted to all uppercase. The #defines OVERALLX and
OVERALLY are also produced, specifying the total
size of the montage image.
-prefix
Tells pnmmontage to use the specified prefix on all
of the #defines it generates.
-quality
Before attempting to place the subimages, pnmmon
tage 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. pnmmontage 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, -q 100 will
find the best possible solution; however, it may
take a very long time to do so. The default is -q
200.
-0, -1, ... -9
These options control the quality at a higher level
than -q; -0 is the worst quality (literally pick
the first solution found), while -9 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 -5.
Using -9 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.
SEE ALSO
pnmcat(1), pnmindex(1), pnm(5), pam(5), pbm(5), pgm(5),
ppm(5)
AUTHOR
Copyright (C) 2000 by Ben Olmstead.
Man(1) output converted with
man2html