Section: User Commands (1)
Updated: 31 December 2000Index
Return to Main Contents
pnmmontage - create a montage of portable anymaps
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.
- -?, -help
Displays a (very) short usage message.
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 #defines OVERALLX and
OVERALLY are also produced, specifying the total size of the montage
to use the specified prefix on all of the #defines it generates.
Before attempting to place the subimages,
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.
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,
will find the best possible solution; however, it may take a very long
time to do so. The default is
- -0, -1, ... -9
These options control the quality at a higher level than
is the worst quality (literally pick the first solution found), while
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
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
Copyright (C) 2000 by Ben Olmstead.
- SEE ALSO