$ 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









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.

This program is part of Netpbm.

pamdice 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.

See the -outstem option for information on naming of the output files.

The -width and -height options determine the size of the output

pamundice can rejoin the images. For finer control, you can also use


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 pro-
cesses it very slowly. With pamdice, you can split it into smaller
pieces, edit one at a time, and then reassemble them.

Another use for this is to print a large image in small printer-sized
pieces that you can glue together. ppmglobe does a similar thing; it
lets you glue the pieces together into a sphere.

If you want to cut pieces from an image individually, not in a regular
grid, use pamcut.







pamdice was new in Netpbm 9.25 (March 2002).

Before Netpbm 10.29 (August 2005), there was a limit of 100 slices in
each direction.

pamundice, pamcut, pnmcat, pgmslice, ppmglobe pnm

netpbm documentation 1 April 2007 Pamdice User Manual(0)