about summary refs log tree commit diff
diff options
context:
space:
mode:
authorgiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2007-04-01 17:59:28 +0000
committergiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2007-04-01 17:59:28 +0000
commit0489fedf1457a3752d22ef00ba37703e4ee27474 (patch)
treeaef44f210d4014eac27aa8c68aad85202bbeed46
parent08ea033ee3237833c9535dcc88179ce8a290bcd9 (diff)
downloadnetpbm-mirror-0489fedf1457a3752d22ef00ba37703e4ee27474.tar.gz
netpbm-mirror-0489fedf1457a3752d22ef00ba37703e4ee27474.tar.xz
netpbm-mirror-0489fedf1457a3752d22ef00ba37703e4ee27474.zip
Add pamdice/pamundice cross references
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@271 9d0c8265-081b-0410-96cb-a4ca84ce46f8
-rw-r--r--directory.html3
-rw-r--r--pamcut.html7
-rw-r--r--pamdice.html48
-rw-r--r--pnmcat.html44
4 files changed, 57 insertions, 45 deletions
diff --git a/directory.html b/directory.html
index 905f9dd1..de17ce4d 100644
--- a/directory.html
+++ b/directory.html
@@ -758,6 +758,9 @@ All of these generate Netpbm format output.
 <DT><B><a href=pamdice.html>pamdice</a></B>
 <DD>slice an image into many horizontally and/or vertically
 
+<DT><B><a href=pamundice.html>pamundice</a></B>
+<DD>Assemble an image from tiles (opposite of <b>pamdice</b>)
+
 <DT><B><a href=pamdeinterlace.html>pamdeinterlace</a></B>
 
 <DD>remove every other row from an image
diff --git a/pamcut.html b/pamcut.html
index b7359136..40c9d39c 100644
--- a/pamcut.html
+++ b/pamcut.html
@@ -91,7 +91,8 @@ stream independently and produces a multi-image stream output.  Before
 Netpbm 10.32 (March 2006), it ignored all but the first image in the stream.
 
 <P>If you are splitting a single image into multiple same-size images,
-<B>pamdice</B> is faster than running <B>pamcut</B> multiple times.
+<B>pamdice</B> is faster and easier than running <B>pamcut</B>
+multiple times.
 
 <p><b>pamcomp</b> is also useful for cutting and padding an image to a
 certain size.  You create a background image of the desired frame
@@ -170,6 +171,7 @@ Print information about the processing to Standard Error.
 <H2 id="seealso">SEE ALSO</H2>
 
 <B><A HREF="pnmcrop.html">pnmcrop</A></B>,
+<B><A HREF="pamdice.html">pamdice</A></B>,
 <B><A HREF="pamcomp.html">pamcomp</A></B>,
 <B><A HREF="pnmpad.html">pnmpad</A></B>,
 <B><A HREF="pnmcat.html">pnmcat</A></B>,
@@ -191,8 +193,7 @@ package.
 Copyright (C) 1989 by Jef Poskanzer.
 
 <HR>
-<A NAME="index">&nbsp;</A>
-<H2>Table Of Contents</H2>
+<H2 id="index">Table Of Contents</H2>
 <UL>
 <LI><A HREF="#synopsis">SYNOPSIS</A>
 <LI><A HREF="#description">DESCRIPTION</A>
diff --git a/pamdice.html b/pamdice.html
index 1495cc80..28d45778 100644
--- a/pamdice.html
+++ b/pamdice.html
@@ -2,17 +2,27 @@
 <HTML><HEAD><TITLE>Pamdice User Manual</TITLE></HEAD>
 <BODY>
 <H1>pamdice</H1>
-Updated: 29 July 2005
+Updated: 1 April 2007
 <BR>
 <A HREF="#index">Table Of Contents</A>
 
-<A NAME="lbAB">&nbsp;</A>
 <H2>NAME</H2>
 
 pamdice - slice a Netpbm image into many horizontally and/or vertically
 
-<A NAME="lbAC">&nbsp;</A>
-<H2>SYNOPSIS</H2>
+<h2 id="example">EXAMPLE</h2>
+
+<pre>
+<kbd>
+    $ pamdice myimage.ppm -outstem=myimage_part -width=10 -height=8
+    $ pamundice myimage_part_%1d_%1a.ppm -across=10 -down=8 &gt;myimage.ppm
+
+    $ pamdice myimage.ppm -outstem=myimage_part -height=12 -voverlap=9
+</kbd>
+</pre>
+
+
+<H2 id="synopsis">SYNOPSIS</H2>
 
 <B>pamdice</B>
 
@@ -34,8 +44,7 @@ pamdice - slice a Netpbm image into many horizontally and/or vertically
 two hyphens instead of one.  You can separate an option name from its value
 with white space instead of an equals sign.
 
-<A NAME="lbAD">&nbsp;</A>
-<H2>DESCRIPTION</H2>
+<H2 id="description">DESCRIPTION</H2>
 
 <p>This program is part of <a href="index.html">Netpbm</a>.
 
@@ -50,7 +59,8 @@ output files.
 <P>The <B>-width</B> and <B>-height</B> options determine the size of
 the output pieces.
 
-<P><B>pnmcat</B> can rejoin the images.
+<p><b>pamundice</b> can rejoin the images.  For finer control, you can
+also use <P><B>pnmcat</B>.
 
 <p>One use for this is to make pieces that take less computer resources
 than the whole image to process.  For example, you might have an image
@@ -62,8 +72,11 @@ edit one a time, and then reassemble them.
 pieces that you can glue together.  <b>ppmglobe</b> does a similar thing;
 it lets you glue the pieces together into a sphere.
 
-<A NAME="lbAE">&nbsp;</A>
-<H2>OPTIONS</H2>
+<p>If you want to cut pieces from an image individually, not in a regular
+grid, use <b>pamcut</b>.
+
+
+<H2 id="options">OPTIONS</H2>
 
 <DL COMPACT>
 <DT><B>-outstem=</B>filenamestem
@@ -116,9 +129,9 @@ pixels.  By default, there is no overlap.
 <p>Before Netpbm 10.29 (August 2005), there was a limit of 100 slices
 in each direction.
 
-<A NAME="lbAF">&nbsp;</A>
-<H2>SEE ALSO</H2>
+<H2 id="seealso">SEE ALSO</H2>
 
+<B><A HREF="pamundice.html">pamundice</A></B>,
 <B><A HREF="pamcut.html">pamcut</A></B>,
 <B><A HREF="pnmcat.html">pnmcat</A></B>,
 <B><A HREF="pgmslice.html">pgmslice</A></B>,
@@ -127,15 +140,14 @@ in each direction.
 <B><A HREF="pam.html">pnm</A></B>
 
 <HR>
-<A NAME="index">&nbsp;</A>
-<H2>Table Of Contents</H2>
+<H2 id="index">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="#example">EXAMPLE</A>
+<LI><A HREF="#synopsis">SYNOPSIS</A>
+<LI><A HREF="#description">DESCRIPTION</A>
+<LI><A HREF="#options">OPTIONS</A>
 <LI><A HREF="#history">HISTORY</A>
-<LI><A HREF="#lbAF">SEE ALSO</A>
+<LI><A HREF="#seealso">SEE ALSO</A>
 </UL>
 </BODY>
 </HTML>
diff --git a/pnmcat.html b/pnmcat.html
index e47b9b51..d129f774 100644
--- a/pnmcat.html
+++ b/pnmcat.html
@@ -2,17 +2,15 @@
 <HTML><HEAD><TITLE>Pnmcat User Manual</TITLE></HEAD>
 <BODY>
 <H1>pnmcat</H1>
-Updated: 12 March 1989
+Updated: 01 April 2007
 <BR>
 <A HREF="#index">Table Of Contents</A>
 
-<A NAME="lbAB">&nbsp;</A>
 <H2>NAME</H2>
 
 pnmcat - concatenate Netpbm images
 
-<A NAME="lbAC">&nbsp;</A>
-<H2>SYNOPSIS</H2>
+<H2 id="synopsis">SYNOPSIS</H2>
 
 <B>pnmcat</B>
 
@@ -25,13 +23,12 @@ pnmcat - concatenate Netpbm images
 <I>pnmfile</i> ...
 
 
-<P>
-Minimum unique abbreviation of option is acceptable.  You may use double
-hyphens instead of single hyphen to denote options.  You may use white
-space in place of the equals sign to separate an option name from its value.
+<P>Minimum unique abbreviation of option is acceptable.  You may use
+double hyphens instead of single hyphen to denote options.  You may
+use white space in place of the equals sign to separate an option name
+from its value.
 
-<A NAME="lbAD">&nbsp;</A>
-<H2>DESCRIPTION</H2>
+<H2 id="description">DESCRIPTION</H2>
 
 <p>This program is part of <a href="index.html">Netpbm</a>.
 
@@ -39,14 +36,15 @@ space in place of the equals sign to separate an option name from its value.
 either left to right or top to bottom, and produces a single PNM image
 as output.
 
+<p>To assemble a regular grid of images, you can use <b>pamundice</b>.
+
 <p>To do the reverse, you might use <B>pamdice</B> to split an image
 up into smaller ones of equal size or <B>pamcut</B> to chop off part
 of an image or extract part of an image.
 
 <P><B>pnmtile</B> concatenates a single input image to itself repeatedly.
 
-<A NAME="lbAE">&nbsp;</A>
-<H2>OPTIONS</H2>
+<H2 id="options">OPTIONS</H2>
 
 <P>If the PNM images are not all the same height (left-right) or width
 (top-bottom), the smaller ones have to be justified with the largest.
@@ -60,8 +58,9 @@ use to fill in the extra space when doing this justification.  If
 neither is specified, <b>pnmcat</b> chooses whichever seems to be
 right for the images.
 
-<A NAME="lbAF">&nbsp;</A>
-<H2>SEE ALSO</H2>
+<H2 id="seealso">SEE ALSO</H2>
+
+<B><A HREF="pamundice.html">pamundice</A></B>,
 
 <B><A HREF="pamdice.html">pamdice</A></B>,
 
@@ -71,21 +70,18 @@ right for the images.
 
 <B><A HREF="pnm.html">pnm</A></B>
 
-<A NAME="lbAG">&nbsp;</A>
-<H2>AUTHOR</H2>
+<H2 id="author">AUTHOR</H2>
 
 Copyright (C) 1989 by Jef Poskanzer.
 
 <HR>
-<A NAME="index">&nbsp;</A>
-<H2>Table Of Contents</H2>
+<H2 id="index">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">SEE ALSO</A>
-<LI><A HREF="#lbAG">AUTHOR</A>
+<LI><A HREF="#synopsis">SYNOPSIS</A>
+<LI><A HREF="#description">DESCRIPTION</A>
+<LI><A HREF="#options">OPTIONS</A>
+<LI><A HREF="#seealso">SEE ALSO</A>
+<LI><A HREF="#author">AUTHOR</A>
 </UL>
 </BODY>
 </HTML>