pnmmontage
pnmmontage(1) General Commands Manual pnmmontage(1)
NAME
pnmmontage - create a montage of portable anymaps
SYNOPSIS
pnmmontage [-?|-help] [-header=headerfile] [-quality=n] [-prefix=pre-
fix] [-0|-1|-2|...|-9] pnmfile...
DESCRIPTION
Packs images of differing sizes into a minimum-area composite image,
optionally producing a C header file with the locations of the subim-
ages 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 im-
age 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 image.
-prefix
Tells pnmmontage to use the specified prefix on all of the #de-
fines it generates.
-quality
Before attempting to place the subimages, pnmmontage will calcu-
late 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, which-
ever 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.
NOTES
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.
31 December 2000 pnmmontage(1)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2024
Hurricane Electric.
All Rights Reserved.