Debian Codegraph @

upstream/debian-unstable/man1/ppmpat.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Ppmpat User Manual" 1 "12 November 2023" "netpbm documentation"
7
8 .SH NAME
9
10 ppmpat - make a pretty PPM image
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBppmpat\fP
16 [{\fB-gingham2\fP|\fB-g2\fP} |
17 {\fB-gingham3\fP|\fB-g3\fP} |
18 \fB-madras\fP |
19 \fB-tartan\fP |
20 \fB-poles\fP |
21 \fB-squig\fP |
22 \fB-camo\fP |
23 \fB-anticamo\fP |
24 \fB-argyle1\fP |
25 \fB-argyle2\fP]
26 [\fB-color\fP \fIcolorlist\fP]
27 [\fB-mesh\fP]
28 [\fB-randomseed\fP \fIinteger\fP]
29
30 \fIwidth\fP \fIheight\fP
31 .PP
32 You can abbreviate any option to its shortest unique prefix.
33
34 .UN description
35 .SH DESCRIPTION
36 .PP
37 This program is part of
38 .BR "Netpbm" (1)\c
39 \&.
40 .PP
41 \fBppmpat\fP produces a PPM of the specified width and height,
42 with a pattern in it.
43 .PP
44 You could, for example, use it to create wallpaper for a computer screen.
45 .PP
46 One use of this program is as an example of the Netpbm library
47 .BR "drawing" (1)\c
48 \& functions, which it uses.
49 .PP
50 Some of the patterns have large numbers of colors, so if you want
51 a simpler pattern, use \fBpnmquant\fP on the output.
52
53 .UN options
54 .SH OPTIONS
55 .PP
56 In addition to the options common to all programs based on libnetpbm
57 (most notably \fB-quiet\fP, see
58 .UR index.html#commonoptions
59 Common Options
60 .UE
61 \&), \fBppmpat\fP recognizes the following
62 command line options:
63
64 .UN patspec
65 .SS Pattern Specification
66 .PP
67 Specify the pattern type with these options. One pattern type must
68 be specified.
69
70
71 .TP
72 \fB-gingham2\fP \fB-g2\fP
73 A gingham check pattern. Can be tiled.
74 .sp
75 If you specify -color, give two colors: background and foreground, in that
76 order.
77
78 .TP
79 \fB-gingham3\fP \fB-g3\fP
80 A slightly more complicated gingham. Can be tiled.
81 .sp
82 If you specify -color, give three colors: background and two foregrounds,
83 in that order.
84
85 .TP
86 \fB-madras\fP
87 A madras plaid. Can be tiled.
88 .sp
89 If you specify -color, give three colors: background and two foregrounds,
90 in that order.
91
92 .TP
93 \fB-tartan\fP
94 A tartan plaid. Can be tiled.
95 .sp
96 If you specify -color, give three colors: background and two foregrounds,
97 in that order.
98
99 .TP
100 \fB-poles\fP
101 Color gradients centered on randomly-placed poles: a Voronoi diagram.
102 .sp
103 (There are many examples of this pattern in nature. One is the hide of a
104 giraffe).
105 .sp
106 If you specify -color, give two or more colors.
107
108 .TP
109 \fB-squig\fP
110 Squiggley tubular pattern. Can be tiled.
111 .sp
112 If you specify -color, give three or more colors. The first is the
113 background color.
114
115 .TP
116 \fB-camo\fP
117 Camouflage pattern.
118 .sp
119 If you specify \fB-color\fP, give three or more colors. The first is the
120 background color; the others are colors for the leafy foreground shapes.
121 The foreground shapes will probably occupy nearly the entire image, so that the
122 background color is barely visible.
123
124 .TP
125 \fB-anticamo\fP
126 Anti-camouflage pattern - like -camo, but ultra-bright colors.
127 .sp
128 If you specify \fB-color\fP, this is the same as \fB-camo\fP.
129
130 .TP
131 \fB-argyle1\fP
132 A diamond argyle pattern, without a cross through the diamond, with one
133 diamond. Can be tiled.
134 .sp
135 If you specify -color, give two colors: background and foreground, in that
136 order.
137 .sp
138 This option was new in Netpbm 10.78 (March 2017).
139
140 .TP
141 \fB-argyle2\fP
142 A diamond argyle pattern, with a cross through the diamond, with one
143 diamond. Can be tiled.
144 .sp
145 If you specify -color, give three colors: background, foreground, and
146 stripe, in that order.
147 .sp
148 This option was new in Netpbm 10.78 (March 2017).
149
150
151
152 .UN otheropts
153 .SS Other Options
154
155
156
157 .TP
158 \fB-color\fP \fIcolorlist\fP
159 This specifies the colors to appear in the pattern.
160 .sp
161 If you do not specify this option, \fBppmpat\fP chooses colors at random.
162 .sp
163 Different patterns take different numbers of colors. Some can involve
164 variable numbers of colors. If you specify a number of colors incompatible
165 with the pattern you specify, \fBppmpat\fP fails, telling you how many colors
166 to specify.
167 .sp
168 \fIcolorlist\fP is a comma-separated list of colors.
169 .sp
170 Specify each color as described for the
171 .UR libnetpbm_image.html#colorname
172 argument of the \fBpnm_parsecolor()\fP library routine
173 .UE
174 \&.
175 .sp
176 Example: \fB-color red, green, rgbi:1.0/0.5/.25\fP .
177 .sp
178 This option was new in Netpbm 10.78 (March 2017).
179
180 .TP
181 \fB-mesh\fP
182 This option affects the patterns generated by the
183 \fB-gingham2\fP, \fB-gingham3\fP, \fB-madras\fP, and \fB-tartan\fP. When
184 this option is \fInot\fP specified, when two colors intersect, the program
185 mixes them and puts the average in the rectangular intersection region.
186 with \fB-mesh\fP, the program fills that region with a checkerboard pattern
187 consisting of the two colors. The resulting image looks like a true woven
188 fabric, with separate threads for the separate colors.
189 .sp
190 This option was new in Netpbm 10.97 (December 2021).
191
192
193 .TP
194 \fB-randomseed\fP \fIinteger\fP
195 This is the seed for the random number generator that generates the
196 pixels.
197 .sp
198 Use this to ensure you get the same image on separate invocations.
199 .sp
200 By default, \fBppmpat\fP uses a seed derived from the time of day
201 and process ID, which gives you fairly uncorrelated results in multiple
202 invocations.
203 .sp
204 This option was new in Netpbm 10.61 (December 2012).
205
206
207
208 .UN references
209 .SH REFERENCES
210
211 Some of the patterns are from "Designer's Guide to Color 3"
212 by Jeanne Allen.
213
214 .UN seealso
215 .SH SEE ALSO
216 .BR "pnmtile" (1)\c
217 \&,
218 .BR "pnmquant" (1)\c
219 \&,
220 .BR "ppmmake" (1)\c
221 \&,
222 .BR "ppmrainbow" (1)\c
223 \&,
224 .BR "pamgradient" (1)\c
225 \&,
226 .BR "ppm" (1)\c
227 \&
228
229 .UN author
230 .SH AUTHOR
231
232 Copyright (C) 1989 by Jef Poskanzer.
233 .SH DOCUMENT SOURCE
234 This manual page was generated by the Netpbm tool 'makeman' from HTML
235 source. The master documentation is at
236 .IP
237 .B http://netpbm.sourceforge.net/doc/ppmpat.html
238 .PP