xenial (1) pnmmontage.1.gz

NAME

       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 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(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)