1Ppmpat User Manual(0) Ppmpat User Manual(0)
2
6 ppmpat - make a pretty PPM image
7
10 ppmpat [{-gingham2|-g2} | {-gingham3|-g3} | -madras | -tartan | -poles
11 | -squig | -camo | -anticamo | -argyle1 | -argyle2] [-color colorlist]
12 [-mesh] [-randomseed integer]
13 width height
15 You can abbreviate any option to its shortest unique prefix.
17
20 This program is part of Netpbm(1).
21 ppmpat produces a PPM of the specified width and height, with a pattern
23 in it.
24 You could, for example, use it to create wallpaper for a computer
26 screen.
27 One use of this program is as an example of the Netpbm library draw‐
29 ing(1) functions, which it uses.
30 Some of the patterns have large numbers of colors, so if you want a
32 simpler pattern, use pnmquant on the output.
33
36 In addition to the options common to all programs based on libnetpbm
37 (most notably -quiet, see
38 Common Options ⟨index.html#commonoptions⟩ ), ppmpat recognizes the
39 following command line options:
40 Pattern Specification
43 Specify the pattern type with these options. One pattern type must be
44 specified.
45 -gingham2 -g2
49 A gingham check pattern. Can be tiled.
50 If you specify -color, give two colors: background and fore‐
52 ground, in that order.
53 -gingham3 -g3
56 A slightly more complicated gingham. Can be tiled.
57 If you specify -color, give three colors: background and two
59 foregrounds, in that order.
60 -madras
63 A madras plaid. Can be tiled.
64 If you specify -color, give three colors: background and two
66 foregrounds, in that order.
67 -tartan
70 A tartan plaid. Can be tiled.
71 If you specify -color, give three colors: background and two
73 foregrounds, in that order.
74 -poles Color gradients centered on randomly-placed poles.
77 If you specify -color, give two or more colors.
79 -squig Squiggley tubular pattern. Can be tiled.
82 If you specify -color, give three or more colors. The first is
84 the background color.
85 -camo Camouflage pattern.
88 If you specify -color, give three or more colors. The first is
90 the background color; the others are colors for the leafy fore‐
91 ground shapes. The foreground shapes will probably occupy
92 nearly the entire image, so that the background color is barely
93 visible.
94 -anticamo
97 Anti-camouflage pattern - like -camo, but ultra-bright colors.
98 If you specify -color, this is the same as -camo.
100 -argyle1
103 A diamond argyle pattern, without a cross through the diamond,
104 with one diamond. Can be tiled.
105 If you specify -color, give two colors: background and fore‐
107 ground, in that order.
108 This option was new in Netpbm 10.78 (March 2017).
110 -argyle2
113 A diamond argyle pattern, with a cross through the diamond, with
114 one diamond. Can be tiled.
115 If you specify -color, give three colors: background, fore‐
117 ground, and stripe, in that order.
118 This option was new in Netpbm 10.78 (March 2017).
120 Other Options
125 -color colorlist
126 This specifies the colors to appear in the pattern.
127 If you do not specify this option, ppmpat chooses colors at ran‐
129 dom.
130 Different patterns take different numbers of colors. Some can
132 involve variable numbers of colors. If you specify a number of
133 colors incompatible with the pattern you specify, ppmpat fails,
134 telling you how many colors to specify.
135 colorlist is a comma-separated list of colors.
137 Specify each color as described for the argument of the
139 pnm_parsecolor() library routine
140 ⟨libnetpbm_image.html#colorname⟩ .
141 Example: -color red, green, rgbi:1.0/0.5/.25 .
143 This option was new in Netpbm 10.78 (March 2017).
145 -mesh This option affects the patterns generated by the -gingham2,
148 -gingham3, -madras, and -tartan. When this option is not speci‐
149 fied, when two colors intersect, the program mixes them and puts
150 the average in the rectangular intersection region. with -mesh,
151 the program fills that region with a checkerboard pattern con‐
152 sisting of the two colors. The resulting image looks like a
153 true woven fabric, with separate threads for the separate col‐
154 ors.
155 This option was new in Netpbm 10.97 (December 2021).
157 -randomseed integer
161 This is the seed for the random number generator that generates
162 the pixels.
163 Use this to ensure you get the same image on separate invoca‐
165 tions.
166 By default, ppmpat uses a seed derived from the time of day and
168 process ID, which gives you fairly uncorrelated results in mul‐
169 tiple invocations.
170 This option was new in Netpbm 10.61 (December 2012).
172
177 Some of the patterns are from "Designer's Guide to Color 3" by Jeanne
178 Allen.
179
182 pnmtile(1), pnmquant(1), ppmmake(1), ppmrainbow(1), pamgradient(1),
183 ppm(1)
184
187 Copyright (C) 1989 by Jef Poskanzer.
188
190 This manual page was generated by the Netpbm tool 'makeman' from HTML
191 source. The master documentation is at
192 http://netpbm.sourceforge.net/doc/ppmpat.html
194netpbm documentation 02 March 2016 Ppmpat User Manual(0)