pamdice
Updated: 31 January 2002
Table Of Contents
NAME
pamdice - slice a Netpbm image into many horizontally and/or
vertically
SYNOPSIS
pamdice -outstem=filenamestem [-width=width]
[-height=height]
[-hoverlap=hoverlap] [-voverlap=voverlap] [-verbose] [file-
name]
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.
DESCRIPTION
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 out-
put files.
The -width and -height options determine the size of the out-
put pieces.
pnmcat can rejoin the images.
One use for this is to make pieces that take less computer re-
sources than
the whole image to process. For example, you might have an im-
age so large
that an image editor can't read it all into memory or process-
es it very
slowly. With pamdice, you can split it into smaller pieces,
edit one a time,
and then reassemble them.
Another use for this is to print a large image in small print-
er-sized pieces
that you can glue together. ppmglobe does a similar thing; it
lets you glue
the pieces together into a sphere.
OPTIONS
-outstem=filenamestem
This option determines the names of the output files.
Each output
file is named filenamestem_y_x.type where filenamestem
is the value
of the -outstem option, x and y are the horizontal and
vertical
locations, respectively, in the input image of the out-
put image, zero
being the leftmost and top, and type is .pbm, .pgm,
.ppm, or .pam,
depending on the type of image.
-width=width
gives the width in pixels of the output images. The
rightmost pieces
are smaller than this if the input image is not a mul-
tiple of width
pixels wide.
-height=height
gives the height in pixels of the output images. The
bottom pieces
are smaller than this if the input image is not a mul-
tiple of height
pixels high.
-hoverlap=hoverlap
gives the horizontal overlap in pixels between output
images. Each
image in a row will overlap the previous one by hover-
lap pixels. By
default, there is no overlap.
This option was new in Netpbm 10.23 (July 2004).
-voverlap=voverlap
gives the vertical overlap in pixels between output im-
ages. Each row
of images will overlap the previous row by voverlap
pixels. By
default, there is no overlap.
This option was new in Netpbm 10.23 (July 2004).
-verbose
Print information about the processing to Standard Er-
ror.
SEE ALSO
pamcut, pnmcat, pgmslice, ppmglobe pnm pnm
_________________________________________________________________
Table Of Contents
* NAME
* SYNOPSIS
* DESCRIPTION
* OPTIONS
* SEE ALSO
UNIX/Linux commands referenced on this page:
- as
- size
- pnmcat
- make
- less
- split
- ppmglobe
- file
- top
- pamcut
- pgmslice