1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
|
\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it! If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pampaintspill User Manual" 0 "02 November 2021" "netpbm documentation"
.SH NAME
.PP
pampaintspill - smoothly spill colors into the background
.UN synopsis
.SH SYNOPSIS
.PP
\fBpampaintspill\fP
[\fB--bgcolor\fP=\fIcolor\fP]
[\fB--wrap\fP]
[\fB--all\fP]
[\fB--downsample\fP=\fInumber\fP]
[\fB--near\fP=\fInumber\fP]
[\fB--power\fP=\fInumber\fP] [\fIfilename\fP]
[\fB-randomseed=\fP\fIinteger\fP]
.PP
Minimum unique abbreviations of option are acceptable. You may use
double hyphens instead of single hyphen to denote options. You may use
white space in place of the equals sign to separate an option name
from its value.
.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpampaintspill\fP produces a smooth color gradient from all of the
non-background-colored pixels in an input image, effectively "spilling
paint" onto the background. \fBpampaintspill\fP is similar to
\fBpamgradient\fP but differs in the following characteristics:
.IP \(bu
\fBpampaintspill\fP accepts any number of paint
sources (non-background-colored pixels), which can lie anywhere
on the canvas. \fBpamgradient\fP accepts exactly
four paint sources, one in each corner of the image.
.IP \(bu
\fBpampaintspill\fP requires an input image while
\fBpamgradient\fP generates a new image from
scratch.
.IP \(bu
\fBpampaintspill\fP can produce tileable output and
can control how tightly the gradient colors bind to their source
pixels.
.PP
Results are generally best when the input image contains just a few, crisp
spots of color. Use your drawing program's pencil tool - as opposed to a
paintbrush or airbrush tool - with a small nib.
.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see
.UR index.html#commonoptions
Common Options
.UE
\&), \fBpampaintspill\fP recognizes the following
command line options:
.TP
\fB--bgcolor\fP=\fIcolor\fP
Explicitly specify the background color. \fIcolor\fP can be
specified using any of the formats accepted by the
.UR libnetpbm_image.html#colorname
\f(CWpnm_parsecolor()\fP library routine
.UE
\& such as \f(CWred\fP or \f(CW#ff0000\fP. If
\fB--bgcolor\fP is not specified, \fBpampaintspill\fP makes an
educated guess about the background color based on the colors in the
image's corners.
.TP
\fB--wrap\fP
Allow gradients to wrap around image borders. That is, colors
that spill off the right side of the image reappear on the left side of
the image and likewise for left/right, top/bottom, and
bottom/top. \fB--wrap\fP makes images tileable, which is nice for
producing desktop backgrounds.
.TP
\fB--all\fP
Recolor all pixels, not just background pixels. Normally,
non-background-colored pixels in the input image appear unmodified in
the output image. With \fB--all\fP, \fIall\fP pixels are colored
based on their distance from all of the (other) non-background-colored
pixels.
.TP
\fB--downsample\fP=\fInumber\fP
Ignore all but \fInumber\fP non-background-colored pixels.
When a large number of pixels in the input image differ in color from
the background, \fBpampaintspill\fP runs very slowly. The
\fB--downsample\fP option randomly selects a given number of colored
pixels to use as paint sources for the gradients and ignores the rest,
thereby trading off image quality for speed of execution.
.TP
\fB--near\fP=\fInumber\fP
Consider only the nearest \fInumber\fP paint sources when computing
a pixel's new color. The default is to consider all paint sources.
In most cases, \fInumber\fP should be fairly small, or its impact
will be minimal and execution time will increase unnecessarily. A
value of 1 produces a coloring that looks a lot like a Voronoi
diagram.
.sp
This option was new in Netpbm 10.97 (December 2021).
.TP
\fB--power\fP=\fInumber\fP
Control how color intensity changes as a function of the
distance from a paint source. The default value for \fInumber\fP is
-2.0, which means that intensity drops (because of the minus sign) with
the square (because of the 2.0) of the distance from each paint
source. -2.0 generally works well in practice, but other values can be
specified for various special effects. With very small numbers of paint
sources, -1.0 may produce subtler gradients, but these get muddier as
the number of paint sources increases. Positive numbers (e.g., 1.0 and
2.0) make the paint sources stand out in the output image by pushing the
gradients away from them.
.TP
\fB-randomseed=\fP\fIinteger\fP
This is the seed for the random number generator that generates the
pixels.
.sp
Use this to ensure you get the same image on separate invocations.
.sp
This option was new in Netpbm 10.94 (March 2021).
.UN seealso
.SH SEE ALSO
.IP \(bu
.BR "\fBpamgradient\fP" (1)\c
\&
.IP \(bu
.BR "\fBppmmake\fP" (1)\c
\&,
.IP \(bu
.BR "\fBppmrainbow\fP" (1)\c
\&,
.IP \(bu
.BR "\fBpgmramp\fP" (1)\c
\&,
.IP \(bu
.BR "\fBppmpat\fP" (1)\c
\&,
.IP \(bu
.BR "\fBpam\fP" (1)\c
\&
.UN history
.SH HISTORY
.PP
\fBpampaintspill\fP was new in Netpbm 10.50 (March 2010).
.UN copyright
.SH COPYRIGHT
.PP
Copyright\ \(co 2010–2021 Scott Pakin,
\fI\fIscott+pbm@pakin.org\fP\fP.
.UN index
.SH Table Of Contents
.IP \(bu
.UR #synopsis
SYNOPSIS
.UE
\&
.IP \(bu
.UR #description
DESCRIPTION
.UE
\&
.IP \(bu
.UR #options
OPTIONS
.UE
\&
.IP \(bu
.UR #seealso
SEE ALSO
.UE
\&
.IP \(bu
.UR #history
HISTORY
.UE
\&
.IP \(bu
.UR #copyright
COPYRIGHT
.UE
\&
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source. The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/pampaintspill.html
.PP
|
