pamdice



Pamdice User Manual(0)                                  Pamdice User Manual(0)




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]

       [filename]

       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(1).

       pamdice reads a PAM, PBM, PGM, or PPM image as input and splits it hor-
       izontally 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 pieces.

       pnmcat can rejoin the images.

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



OPTIONS

       -outstem=filenamestem
              This option determines the names of the output files.  Each out-
              put 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
              multiple 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 multi-
              ple 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 hoverlap
              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  images.
              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 Error.




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



SEE ALSO

       pamcut(1), pnmcat(1), pgmslice(1), ppmglobe(1) pnm(1) pnm(1)



netpbm documentation             29 July 2005           Pamdice User Manual(0)

Man(1) output converted with man2html