diff options
Diffstat (limited to 'pnmmontage.html')
-rw-r--r-- | pnmmontage.html | 123 |
1 files changed, 123 insertions, 0 deletions
diff --git a/pnmmontage.html b/pnmmontage.html new file mode 100644 index 00000000..7273cb93 --- /dev/null +++ b/pnmmontage.html @@ -0,0 +1,123 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN"> +<HTML><HEAD><TITLE>Pnmmontage User Manual</TITLE></HEAD> +<BODY> +<H1>pnmmontage</H1> +Updated: 31 December 2000 +<BR> +<A HREF="#index">Table Of Contents</A> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +pnmmontage - create a montage of PNM images + +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>pnmmontage</B> + +[<B>-header=</B><I>headerfile</I>] + +[<B>-quality=</B><I>n</I>] + +[<B>-prefix=</B><I>prefix</I>] + +[<B>-0</B>|<B>-1</B>|<B>-2</B>|<B>...</B>|<B>-9</B>] + +<i>pnmfile</I>... + +<A NAME="lbAD"> </A> +<H2>DESCRIPTION</H2> + +<p>This program is part of <a href="index.html">Netpbm</a>. + +<p><b>pnmmontage</b> 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. + +<A NAME="lbAE"> </A> +<H2>OPTIONS</H2> + +<DL COMPACT> + +<DT><B>-header</B> + +<DD>Tells <B>pnmmontage</B> 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 ouput also includes #defines OVERALLX and OVERALLY, which +specifies the total size of the montage image. + +<DT><B>-prefix</B> + +<DD>Tells <B>pnmmontage</B> to use the specified prefix on all of the +#defines it generates. + +<DT><B>-quality</B> + +<DD>Before attempting to place the subimages, <B>pnmmontage</B> 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. <B>pnmmontage</B> 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, <B>-q 100</B> will find the best possible +solution; however, it may take a very long time to do so. The default +is <B>-q 200.</B> + +<DT><B>-0</b>, <b>-1</b>, ... <b>-9</B> + +<DD>These options control the quality at a higher level than +<B>-q</B>; <B>-0</B> is the worst quality (literally pick the first +solution found), while <B>-9</B> 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 +<B>-5</B>. + +</DL> +<A NAME="lbAF"> </A> +<H2>NOTES</H2> + +<p>Using <B>-9</B> 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. + +<A NAME="lbAG"> </A> +<H2>SEE ALSO</H2> + +<B><A HREF="pnmcat.html">pnmcat</A></B>, + +<B><A HREF="pnmindex.html">pnmindex</A></B>, + +<B><A HREF="pnm.html">pnm</A></B>, + +<B><A HREF="pam.html">pam</A></B>, + +<B><A HREF="pbm.html">pbm</A></B>, + +<B><A HREF="pgm.html">pgm</A></B>, + +<B><A HREF="ppm.html">ppm</A></B> + +<A NAME="lbAH"> </A> +<H2>AUTHOR</H2> + +Copyright (C) 2000 by Ben Olmstead. + +<HR> +<A NAME="index"> </A> +<H2>Table Of Contents</H2> +<UL> +<LI><A HREF="#lbAB">NAME</A> +<LI><A HREF="#lbAC">SYNOPSIS</A> +<LI><A HREF="#lbAD">DESCRIPTION</A> +<LI><A HREF="#lbAE">OPTIONS</A> +<LI><A HREF="#lbAF">NOTES</A> +<LI><A HREF="#lbAG">SEE ALSO</A> +<LI><A HREF="#lbAH">AUTHOR</A> +</UL> +</BODY> +</HTML> |