1Pamdice User Manual(0) Pamdice User Manual(0)
2
3
4
6 pamdice - slice a Netpbm image into many horizontally and/or vertically
7
8
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
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
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
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
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
130 pamundice(1), pamcut(1), pnmcat(1), pgmslice(1), ppmglobe(1) pnm(1)
131 pam(1)
132
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)