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)