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
|
\
.\" 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 "Ppmpat User Manual" 0 "02 March 2016" "netpbm documentation"
.SH NAME
ppmpat - make a pretty PPM image
.UN synopsis
.SH SYNOPSIS
\fBppmpat\fP
[{\fB-gingham2\fP|\fB-g2\fP} |
{\fB-gingham3\fP|\fB-g3\fP} |
\fB-madras\fP |
\fB-tartan\fP |
\fB-poles\fP |
\fB-squig\fP |
\fB-camo\fP |
\fB-anticamo\fP |
\fB-argyle1\fP |
\fB-argyle2\fP]
[\fB-color\fP \fIcolorlist\fP]
[\fB-mesh\fP]
[\fB-randomseed\fP \fIinteger\fP]
\fIwidth\fP \fIheight\fP
.PP
You can abbreviate any option to its shortest unique prefix.
.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBppmpat\fP produces a PPM of the specified width and height,
with a pattern in it.
.PP
You could, for example, use it to create wallpaper for a computer screen.
.PP
One use of this program is as an example of the Netpbm library
.BR "drawing" (1)\c
\& functions, which it uses.
.PP
Some of the patterns have large numbers of colors, so if you want
a simpler pattern, use \fBpnmquant\fP on the output.
.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
\&), \fBppmpat\fP recognizes the following
command line options:
.UN patspec
.SS Pattern Specification
.PP
Specify the pattern type with these options. One pattern type must
be specified.
.TP
\fB-gingham2\fP \fB-g2\fP
A gingham check pattern. Can be tiled.
.sp
If you specify -color, give two colors: background and foreground, in that
order.
.TP
\fB-gingham3\fP \fB-g3\fP
A slightly more complicated gingham. Can be tiled.
.sp
If you specify -color, give three colors: background and two foregrounds,
in that order.
.TP
\fB-madras\fP
A madras plaid. Can be tiled.
.sp
If you specify -color, give three colors: background and two foregrounds,
in that order.
.TP
\fB-tartan\fP
A tartan plaid. Can be tiled.
.sp
If you specify -color, give three colors: background and two foregrounds,
in that order.
.TP
\fB-poles\fP
Color gradients centered on randomly-placed poles.
.sp
If you specify -color, give two or more colors.
.TP
\fB-squig\fP
Squiggley tubular pattern. Can be tiled.
.sp
If you specify -color, give three or more colors. The first is the
background color.
.TP
\fB-camo\fP
Camouflage pattern.
.sp
If you specify \fB-color\fP, give three or more colors. The first is the
background color; the others are colors for the leafy foreground shapes.
The foreground shapes will probably occupy nearly the entire image, so that the
background color is barely visible.
.TP
\fB-anticamo\fP
Anti-camouflage pattern - like -camo, but ultra-bright colors.
.sp
If you specify \fB-color\fP, this is the same as \fB-camo\fP.
.TP
\fB-argyle1\fP
A diamond argyle pattern, without a cross through the diamond, with one
diamond. Can be tiled.
.sp
If you specify -color, give two colors: background and foreground, in that
order.
.sp
This option was new in Netpbm 10.78 (March 2017).
.TP
\fB-argyle2\fP
A diamond argyle pattern, with a cross through the diamond, with one
diamond. Can be tiled.
.sp
If you specify -color, give three colors: background, foreground, and
stripe, in that order.
.sp
This option was new in Netpbm 10.78 (March 2017).
.UN otheropts
.SS Other Options
.TP
\fB-color\fP \fIcolorlist\fP
This specifies the colors to appear in the pattern.
.sp
If you do not specify this option, \fBppmpat\fP chooses colors at random.
.sp
Different patterns take different numbers of colors. Some can involve
variable numbers of colors. If you specify a number of colors incompatible
with the pattern you specify, \fBppmpat\fP fails, telling you how many colors
to specify.
.sp
\fIcolorlist\fP is a comma-separated list of colors.
.sp
Specify each color as described for the
.UR libnetpbm_image.html#colorname
argument of the \fBpnm_parsecolor()\fP library routine
.UE
\&.
.sp
Example: \fB-color red, green, rgbi:1.0/0.5/.25\fP .
.sp
This option was new in Netpbm 10.78 (March 2017).
.TP
\fB-mesh\fP
This option affects the patterns generated by the
\fB-gingham2\fP, \fB-gingham3\fP, \fB-madras\fP, and \fB-tartan\fP. When
this option is \fInot\fP specified, when two colors intersect, the program
mixes them and puts the average in the rectangular intersection region.
with \fB-mesh\fP, the program fills that region with a checkerboard pattern
consisting of the two colors. The resulting image looks like a true woven
fabric, with separate threads for the separate colors.
.sp
This option was new in Netpbm 10.97 (December 2021).
.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
By default, \fBppmpat\fP uses a seed derived from the time of day
and process ID, which gives you fairly uncorrelated results in multiple
invocations.
.sp
This option was new in Netpbm 10.61 (December 2012).
.UN references
.SH REFERENCES
Some of the patterns are from "Designer's Guide to Color 3"
by Jeanne Allen.
.UN seealso
.SH SEE ALSO
.BR "pnmtile" (1)\c
\&,
.BR "pnmquant" (1)\c
\&,
.BR "ppmmake" (1)\c
\&,
.BR "ppmrainbow" (1)\c
\&,
.BR "pamgradient" (1)\c
\&,
.BR "ppm" (1)\c
\&
.UN author
.SH AUTHOR
Copyright (C) 1989 by Jef Poskanzer.
.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/ppmpat.html
.PP
|
