1Pammixmulti User Manual(0) Pammixmulti User Manual(0)
2
3
4
5 " "netpbm documentation"
6
7
8
9
10
11
13 pammixmulti - blend together multiple PAM images
14
15
16
18 pammixmulti
19 [--blend=average|random|mask]
20 [--maskfile=filename]
21 [--stdev=number]
22 [--randomseed integer]
23 filename ...
24
25 Minimum unique abbreviation of an option is acceptable. You can use a
26 single hyphen instead of double hyphens to denote options. You can use
27 white space in place of the equals sign to separate an option name from
28 its value.
29
30
31
33 This file is part of Netpbm(1).
34
35 pammixmulti mixes two or more images to produce a new image. The pro‐
36 gram provides multiple ways to interpret "mix."
37
38
39
41 pammixmulti accepts the following command-line options:
42
43
44
45 --blend=average|random|mask
46
47 This option specifies how the input images should be mixed to
48 produce the output image. With --blend=average (the default),
49 each pixel in the output is produced by averaging the corre‐
50 sponding pixels from all the input images. With --blend=random,
51 each pixel in the output is produced by selecting the corre‐
52 sponding pixel from one of the input images, chosen at random on
53 a per-pixel basis. With --blend=mask, each pixel in the output
54 is produced by a weighted average of the corresponding pixels
55 from all the input images based on the grayscale level of an
56 additional mask image.
57
58
59
60 --maskfile=filename
61
62 In conjunction with --blend=mask, this option names a grayscale
63 mask file to control the blending of each pixel. (If the file
64 is not grayscale, the first channel is treated as gray). Where
65 the mask file is black, the first image is selected. Where the
66 mask file is white, the last image is selected. Intermediate
67 levels of gray select intermediate images.
68
69
70
71 --stdev=number
72
73 When used with --blend=mask, this option controls how smoothly
74 the various input images are mixed to produce each output pixel.
75 For example, consider running pammixmulti with three input
76 images and a mask image that uses gray levels from 0 to 255.
77 Given --stdev=0.0, gray levels 0-84 produce exclusively image 1;
78 gray levels 85-170 produce exclusively image 2; and gray levels
79 171-255 produce exclusively image 3. If the argument to --stdev
80 is positive, images are blended according to a normal distribu‐
81 tion. Hence, gray levels around 85 produce an output pixel that
82 includes roughly equal amounts of the corresponding pixel from
83 images 1 and 2 but less of the corresponding pixel from image 3.
84 As number tends towards the number of input images (going beyond
85 that has diminishing impact), the output tends to look more like
86 --blend=average. number defaults to 0.25.
87
88
89
90 --randomseed integer
91 This is the seed for the random number generator used with
92 --blend=random
93
94 Use this to ensure you get the same image on separate invoca‐
95 tions.
96
97
98
99
101 You supply the names of the files to mix as non-option arguments.
102
103
104
106 Average a bunch of PPM images to produce a new PAM image:
107 pammixmulti input*.ppm >output.ppm
108 </pre>
109
110 Mix these same images by taking each pixel from a randomly selected input
111 image:
112
113 pammixmulti --blend=random input*.ppm >output.ppm
114 </pre>
115
116 Use a mask image to control the fading among input images on a
117 pixel-by-pixel basis:
118
119 pammixmulti --blend=mask --maskfile=mask.pgm >output.pam \
120 one.pam two.pam three.pam four.pam
121 </pre>
122
123 Do the same but with more abrupt transitions:
124
125 pammixmulti --blend=mask --maskfile=mask.pgm --stdev=0.0 >output.pam \
126 one.pam two.pam three.pam four.pam
127 </pre>
128
129 and now with more gradual transitions:
130
131 pammixmulti --blend=mask --maskfile=mask.pgm --stdev=1.0 >output.pam \
132 one.pam two.pam three.pam four.pam
133 </pre>
134
135
136
138 pammixmulti was new in Netpbm 10.85 (December 2018).
139
140
141
143 Copyright 2018 Scott Pakin, scott+pbm@pakin.org.
144
145
147 pamcomp(1), ppmmix(1), pamarith(1), pnm(1), pam(1)
148
149
150
152 ·
153
154 SYNOPSIS ⟨#synopsis⟩
155
156 ·
157
158 DESCRIPTION ⟨#description⟩
159
160 ·
161
162 OPTIONS ⟨#options⟩
163
164 ·
165
166 ARGUMENTS ⟨#arguments⟩
167
168 ·
169
170 EXAMPLES ⟨#examples⟩
171
172 ·
173
174 HISTORY ⟨#history⟩
175
176 ·
177
178 AUTHOR ⟨#author⟩
179
180 ·
181
182 SEE ALSO ⟨#seealso⟩
183
185 This manual page was generated by the Netpbm tool 'makeman' from HTML
186 source. The master documentation is at
187
188 http://netpbm.sourceforge.net/doc/pammixmulti.html
189
190 18 November 2018 Pammixmulti User Manual(0)