.TL
Pamdice User Manual
.SH 1
pamdice
.LP
Updated: 29 July 2005
.br
Table Of Contents
.SH 2
NAME
.LP
pamdice - slice a Netpbm image into many horizontally and/or vertically
.SH 2
SYNOPSIS
.LP
\fBpamdice\fR
\fB-outstem=\fR\fIfilenamestem\fR
[\fB-width=\fR\fIwidth\fR]
[\fB-height=\fR\fIheight\fR]
[\fB-hoverlap=\fR\fIhoverlap\fR]
[\fB-voverlap=\fR\fIvoverlap\fR]
[\fB-verbose\fR]
[\fIfilename\fR]
.LP
You can use the minimum unique abbreviation of the options.  You can use
two hyphens instead of one.  You can separate an option name from its value
with white space instead of an equals sign.
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBpamdice\fR reads a PAM, PBM, PGM, or PPM image as input and
splits it horizontally and/or vertically into equal size pieces and
writes them into separate files as the same kind of image.  You can
optionally make the pieces overlap.
.LP
See the \fB-outstem\fR option for information on naming of the
output files.
.LP
The \fB-width\fR and \fB-height\fR options determine the size of
the output pieces.
.LP
\fBpnmcat\fR can rejoin the images.
.LP
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
so large that an image editor can't read it all into memory or processes
it very slowly.  With \fBpamdice\fR, you can split it into smaller pieces,
edit one a time, and then reassemble them.
.LP
Another use for this is to print a large image in small printer-sized
pieces that you can glue together.  \fBppmglobe\fR does a similar thing;
it lets you glue the pieces together into a sphere.
.SH 2
OPTIONS
.LP
.RS
.IP "\fB-outstem=\fRfilenamestem"
This option determines the names of the output files.  Each output
file is named
\fIfilenamestem\fR\fB_\fR\fIy\fR\fB_\fR\fIx\fR\fB.\fR\fItype\fR
where \fIfilenamestem\fR is the value of the \fB-outstem\fR option,
\fIx\fR and y are the horizontal and vertical locations,
respectively, in the input image of the output image, zero being the
leftmost and top, and \fItype\fR is \fB.pbm\fR, \fB.pgm\fR,
\fB.ppm\fR, or \fB.pam\fR, depending on the type of image.
.IP "\fB-width=\fR\fIwidth\fR"
gives the width in pixels of the output images.  The rightmost
pieces are smaller than this if the input image is not a multiple of
\fIwidth\fR pixels wide.
.IP "\fB-height=\fR\fIheight\fR"
gives the height in pixels of the output images.  The bottom
pieces are smaller than this if the input image is not a multiple of
\fIheight\fR pixels high.
.IP "\fB-hoverlap=\fR\fIhoverlap\fR"
gives the horizontal overlap in pixels between output images.
Each image in a row will overlap the previous one by \fIhoverlap\fR
pixels.  By default, there is no overlap.
.LP
This option was new in Netpbm 10.23 (July 2004).
.IP "\fB-voverlap=\fR\fIvoverlap\fR"
gives the vertical overlap in pixels between output images.
Each row of images will overlap the previous row by \fIvoverlap\fR
pixels.  By default, there is no overlap.
.LP
This option was new in Netpbm 10.23 (July 2004).
.IP "\fB-verbose\fR"
Print information about the processing to Standard Error.
.RE
.SH 2
HISTORY
.LP
.LP
Before Netpbm 10.29 (August 2005), there was a limit of 100 slices
in each direction.
.SH 2
SEE ALSO
.LP
\fBpamcut\fR,
\fBpnmcat\fR,
\fBpgmslice\fR,
\fBppmglobe\fR
\fBpnm\fR
\fBpnm\fR
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
HISTORY
.IP \(bu
SEE ALSO
.LP