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

NAME

6       pammixmulti - blend together multiple PAM images
7
8
9

SYNOPSIS

11       pammixmulti
12         [--blend=average|random|mask]
13         [--maskfile=filename]
14         [--stdev=number]
15         [--randomseed integer]
16         filename ...
17
18       Minimum  unique  abbreviation of an option is acceptable. You can use a
19       single hyphen instead of double hyphens to denote options. You can  use
20       white space in place of the equals sign to separate an option name from
21       its value.
22
23
24

DESCRIPTION

26       This file is part of Netpbm(1).
27
28       pammixmulti mixes two or more images to produce a new image.  The  pro‐
29       gram provides multiple ways to interpret "mix."
30
31
32

OPTIONS

34       In  addition  to  the options common to all programs based on libnetpbm
35       (most notably -quiet, see
36        Common Options ⟨index.html#commonoptions⟩  ),  pammixmulti  recognizes
37       the following command line options:
38
39
40
41       --blend=average|random|mask
42
43              This  option  specifies  how the input images should be mixed to
44              produce the output image.  With --blend=average  (the  default),
45              each  pixel  in  the  output is produced by averaging the corre‐
46              sponding pixels from all the input images.  With --blend=random,
47              each  pixel  in  the  output is produced by selecting the corre‐
48              sponding pixel from one of the input images, chosen at random on
49              a  per-pixel basis.  With --blend=mask, each pixel in the output
50              is produced by a weighted average of  the  corresponding  pixels
51              from all the input images based on the grayscale level of an ad‐
52              ditional mask image.
53
54
55
56       --maskfile=filename
57
58              In conjunction with --blend=mask, this option names a  grayscale
59              mask  file  to control the blending of each pixel.  (If the file
60              is not grayscale, the first channel is treated as gray).   Where
61              the  mask  file is black, the first image is selected. Where the
62              mask file is white, the last image  is  selected.   Intermediate
63              levels of gray select intermediate images.
64
65
66
67       --stdev=number
68
69              When  used  with --blend=mask, this option controls how smoothly
70              the various input images are mixed to produce each output pixel.
71              For  example,  consider running pammixmulti with three input im‐
72              ages and a mask image that uses gray levels from 0 to 255. Given
73              --stdev=0.0,  gray levels 0-84 produce exclusively image 1; gray
74              levels 85-170 produce  exclusively  image  2;  and  gray  levels
75              171-255 produce exclusively image 3.  If the argument to --stdev
76              is positive, images are blended according to a normal  distribu‐
77              tion.  Hence, gray levels around 85 produce an output pixel that
78              includes roughly equal amounts of the corresponding  pixel  from
79              images 1 and 2 but less of the corresponding pixel from image 3.
80              As number tends towards the number of input images (going beyond
81              that has diminishing impact), the output tends to look more like
82              --blend=average. number defaults to 0.25.
83
84
85
86       --randomseed integer
87              This is the seed for  the  random  number  generator  used  with
88              --blend=random
89
90              Use  this  to  ensure you get the same image on separate invoca‐
91              tions.
92
93
94
95

ARGUMENTS

97       You supply the names of the files to mix as non-option arguments.
98
99
100

EXAMPLES

102       Average a bunch of PPM images to produce a new PAM image:
103           pammixmulti input*.ppm >output.ppm
104
105       Mix these same images by taking each pixel from a randomly selected in‐
106       put image:
107
108           pammixmulti --blend=random input*.ppm >output.ppm
109
110       Use  a  mask image to control the fading among input images on a pixel-
111       by-pixel basis:
112
113           pammixmulti --blend=mask --maskfile=mask.pgm >output.pam \
114              one.pam two.pam three.pam four.pam
115
116       Do the same but with more abrupt transitions:
117
118           pammixmulti --blend=mask --maskfile=mask.pgm --stdev=0.0 >output.pam \
119              one.pam two.pam three.pam four.pam
120
121       and now with more gradual transitions:
122
123           pammixmulti --blend=mask --maskfile=mask.pgm --stdev=1.0 >output.pam \
124              one.pam two.pam three.pam four.pam
125
126
127

HISTORY

129       pammixmulti was new in Netpbm 10.85 (December 2018).
130
131
132

AUTHOR

134       Copyright 2018 Scott Pakin, scott+pbm@pakin.org.
135
136

SEE ALSO

138       pamcomp(1), ppmmix(1), pamarith(1), pnm(1), pam(1)
139
140
141

Table Of Contents

143       •
144
145              SYNOPSIS ⟨#synopsis⟩
146
147       •
148
149              DESCRIPTION ⟨#description⟩
150
151       •
152
153              OPTIONS ⟨#options⟩
154
155       •
156
157              ARGUMENTS ⟨#arguments⟩
158
159       •
160
161              EXAMPLES ⟨#examples⟩
162
163       •
164
165              HISTORY ⟨#history⟩
166
167       •
168
169              AUTHOR ⟨#author⟩
170
171       •
172
173              SEE ALSO ⟨#seealso⟩
174

DOCUMENT SOURCE

176       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
177       source.  The master documentation is at
178
179              http://netpbm.sourceforge.net/doc/pammixmulti.html
180
181netpbm documentation           18 November 2018     Pammixmulti User Manual(0)