161 lines
3.9 KiB
HTML
161 lines
3.9 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of pnmmontage</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>pnmmontage</H1>
|
|
Section: User Commands (1)<BR>Updated: 31 December 2000<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="ixAAB"></A>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
pnmmontage - create a montage of portable anymaps
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>pnmmontage</B>
|
|
|
|
[<B>-?</B>|<B>-help</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>]
|
|
|
|
pnmfile<I>...</I>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
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>
|
|
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-?, -help</B>
|
|
|
|
<DD>
|
|
Displays a (very) short usage message.
|
|
<DT id="2"><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 #defines OVERALLX and
|
|
OVERALLY are also produced, specifying the total size of the montage
|
|
image.
|
|
<DT id="3"><B>-prefix</B>
|
|
|
|
<DD>
|
|
Tells
|
|
<B>pnmmontage</B>
|
|
|
|
to use the specified prefix on all of the #defines it generates.
|
|
<DT id="4"><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 id="5"><B>-0, -1, ... -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>
|
|
|
|
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="/cgi-bin/man/man2html?1+pnmcat">pnmcat</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pnmindex">pnmindex</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+pnm">pnm</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+pam">pam</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+pbm">pbm</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+pgm">pgm</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+ppm">ppm</A></B>(5)
|
|
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Copyright (C) 2000 by Ben Olmstead.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="6"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="7"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="8"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="9"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="10"><A HREF="#lbAF">NOTES</A><DD>
|
|
<DT id="11"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
<DT id="12"><A HREF="#lbAH">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:24 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|