pnmmontage
create a montage of portable anymaps
see also :
pnmcat - pnmindex
Synopsis
pnmmontage
[-?|-help]
[-header=headerfile]
[-quality=n]
[-prefix=prefix]
[-0|-1|-2|...|-9]
pnmfile...
add an example, a script, a trick and tips
examples
no example yet ...
... Feel free to add your own example above to help other Linux-lovers !
description
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.
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,
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 #defines it
generates.
-quality
Before attempting to place the
subimages, pnmmontage 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.
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 ,
pnmindex , pnm, pam,
pbm, pgm, ppm
author
Copyright (C)
2000 by Ben Olmstead.