1Pamdice User Manual(0)                                  Pamdice User Manual(0)
2
3
4

NAME

6       pamdice - slice a Netpbm image into many horizontally and/or vertically
7
8

EXAMPLE

10           $ pamdice myimage.ppm -outstem=myimage_part -width=10 -height=8
11           $ pamundice myimage_part_%1d_%1a.ppm -across=10 -down=8 >myimage.ppm
12
13           $ pamdice myimage.ppm -outstem=myimage_part -height=12 -voverlap=9
14
15
16
17

SYNOPSIS

19       pamdice
20
21       -outstem=filenamestem
22
23       [-width=width]
24
25       [-height=height]
26
27       [-hoverlap=hoverlap]
28
29       [-voverlap=voverlap]
30
31       [-verbose]
32
33       [filename]
34
35       You  can  use  the minimum unique abbreviation of the options.  You can
36       use two hyphens instead of one.  You can separate an option  name  from
37       its value with white space instead of an equals sign.
38
39

DESCRIPTION

41       This program is part of Netpbm(1).
42
43       pamdice reads a PAM, PBM, PGM, or PPM image as input and splits it hor‐
44       izontally and/or vertically into equal size pieces and writes them into
45       separate  files as the same kind of image.  You can optionally make the
46       pieces overlap.
47
48       See the -outstem option for information on naming of the output files.
49
50       The -width and -height options determine the size of the output pieces.
51
52       pamundice can rejoin the images.  For finer control, you can also use
53
54       pnmcat.
55
56       One use for this is to make pieces that take  less  computer  resources
57       than  the whole image to process.  For example, you might have an image
58       so large that an image editor can't read it all  into  memory  or  pro‐
59       cesses  it  very  slowly.   With pamdice, you can split it into smaller
60       pieces, edit one at a time, and then reassemble them.
61
62       Another use for this is to print a large image in  small  printer-sized
63       pieces  that  you can glue together.  ppmglobe does a similar thing; it
64       lets you glue the pieces together into a sphere.
65
66       If you want to cut pieces from an image individually, not in a  regular
67       grid, use pamcut.
68
69
70

OPTIONS

72       In  addition  to  the options common to all programs based on libnetpbm
73       (most notably -quiet, see
74        Common Options ⟨index.html#commonoptions⟩ ),  pamdice  recognizes  the
75       following command line options:
76
77
78
79       -outstem=filenamestem
80              This option determines the names of the output files.  Each out‐
81              put file is named filenamestem_y_x.type  where  filenamestem  is
82              the value of the -outstem option, x and y are the horizontal and
83              vertical locations, respectively, in the input image of the out‐
84              put  image,  zero  being the leftmost and top, and type is .pbm,
85              .pgm, .ppm, or .pam, depending on the type of image.
86
87
88       -width=width
89              gives the width in pixels of the output images.   The  rightmost
90              pieces  are smaller than this if the input image is not a multi‐
91              ple of width pixels wide.
92
93
94       -height=height
95              gives the height in pixels of the  output  images.   The  bottom
96              pieces  are smaller than this if the input image is not a multi‐
97              ple of height pixels high.
98
99
100       -hoverlap=hoverlap
101              gives the horizontal overlap in pixels  between  output  images.
102              Each  image  in  a row will overlap the previous one by hoverlap
103              pixels.  By default, there is no overlap.
104
105              This option was new in Netpbm 10.23 (July 2004).
106
107
108       -voverlap=voverlap
109              gives the vertical overlap  in  pixels  between  output  images.
110              Each  row  of  images  will overlap the previous row by voverlap
111              pixels.  By default, there is no overlap.
112
113              This option was new in Netpbm 10.23 (July 2004).
114
115
116       -verbose
117              Print information about the processing to Standard Error.
118
119
120
121

HISTORY

123       pamdice was new in Netpbm 9.25 (March 2002).
124
125       Before Netpbm 10.29 (August 2005), there was a limit of 100  slices  in
126       each direction.
127
128

SEE ALSO

130       pamundice(1),  pamcut(1),  pnmcat(1),  pgmslice(1),  ppmglobe(1) pnm(1)
131       pam(1)
132

DOCUMENT SOURCE

134       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
135       source.  The master documentation is at
136
137              http://netpbm.sourceforge.net/doc/pamdice.html
138
139netpbm documentation             01 April 2007          Pamdice User Manual(0)
Impressum