\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pamdice User Manual" 0 "01 April 2007" "netpbm documentation"

.SH NAME
pamdice - slice a Netpbm image into many horizontally and/or vertically

.UN example
.SH EXAMPLE

.nf
\f(CW
    $ pamdice myimage.ppm -outstem=myimage_part -width=10 -height=8
    $ pamundice myimage_part_%1d_%1a.ppm -across=10 -down=8 >myimage.ppm

    $ pamdice myimage.ppm -outstem=myimage_part -height=12 -voverlap=9
\fP

.fi


.UN synopsis
.SH SYNOPSIS

\fBpamdice\fP

\fB-outstem=\fP\fIfilenamestem\fP

[\fB-width=\fP\fIwidth\fP]

[\fB-height=\fP\fIheight\fP]

[\fB-hoverlap=\fP\fIhoverlap\fP]

[\fB-voverlap=\fP\fIvoverlap\fP]

[\fB-verbose\fP]

[\fIfilename\fP]
.PP
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.

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpamdice\fP 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.
.PP
See the \fB-outstem\fP option for information on naming of the
output files.
.PP
The \fB-width\fP and \fB-height\fP options determine the size of
the output pieces.
.PP
\fBpamundice\fP can rejoin the images.  For finer control, you can
also use 
.PP
\fBpnmcat\fP.
.PP
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\fP, you can split it into smaller pieces,
edit one at a time, and then reassemble them.
.PP
Another use for this is to print a large image in small printer-sized
pieces that you can glue together.  \fBppmglobe\fP does a similar thing;
it lets you glue the pieces together into a sphere.
.PP
If you want to cut pieces from an image individually, not in a regular
grid, use \fBpamcut\fP.


.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see 
.UR index.html#commonoptions
 Common Options
.UE
\&), \fBpamdice\fP recognizes the following
command line options:


.TP
\fB-outstem=\fPfilenamestem
This option determines the names of the output files.  Each output
file is named
\fIfilenamestem\fP\fB_\fP\fIy\fP\fB_\fP\fIx\fP\fB.\fP\fItype\fP
where \fIfilenamestem\fP is the value of the \fB-outstem\fP option,
\fIx\fP 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\fP is \fB.pbm\fP, \fB.pgm\fP,
\fB.ppm\fP, or \fB.pam\fP, depending on the type of image.

.TP
\fB-width=\fP\fIwidth\fP
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\fP pixels wide.

.TP
\fB-height=\fP\fIheight\fP
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\fP pixels high.

.TP
\fB-hoverlap=\fP\fIhoverlap\fP
gives the horizontal overlap in pixels between output images.
Each image in a row will overlap the previous one by \fIhoverlap\fP
pixels.  By default, there is no overlap.
.sp
This option was new in Netpbm 10.23 (July 2004).

.TP
\fB-voverlap=\fP\fIvoverlap\fP
gives the vertical overlap in pixels between output images.
Each row of images will overlap the previous row by \fIvoverlap\fP
pixels.  By default, there is no overlap.
.sp
This option was new in Netpbm 10.23 (July 2004).

.TP
\fB-verbose\fP
Print information about the processing to Standard Error.



.UN history
.SH HISTORY
.PP
\fBpamdice\fP was new in Netpbm 9.25 (March 2002).
.PP
Before Netpbm 10.29 (August 2005), there was a limit of 100 slices
in each direction.

.UN seealso
.SH SEE ALSO
.BR "pamundice" (1)\c
\&,
.BR "pamcut" (1)\c
\&,
.BR "pnmcat" (1)\c
\&,
.BR "pgmslice" (1)\c
\&,
.BR "ppmglobe" (1)\c
\&
.BR "pnm" (1)\c
\&
.BR "pam" (1)\c
\&
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/pamdice.html
.PP