Bash Cures Cancer
Learn the UNIX/Linux command line

Home     Man Pages     SpamDefeator


				    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:
  1. as
  2. size
  3. pnmcat
  4. make
  5. less
  6. split
  7. ppmglobe
  8. file
  9. top
  10. pamcut
  11. pgmslice