ppmpat(1)

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

NAME

6       ppmpat - make a pretty PPM image
7
8

SYNOPSIS

10       ppmpat  [{-gingham2|-g2} | {-gingham3|-g3} | -madras | -tartan | -poles
11       | -squig | -camo | -anticamo | -argyle1 | -argyle2] [-color  colorlist]
12       [-randomseed integer]
13
14       width height
15
16       You can abbreviate any option to its shortest unique prefix.
17
18

DESCRIPTION

20       This program is part of Netpbm(1).
21
22       ppmpat produces a PPM of the specified width and height, with a pattern
23       in it.
24
25       You could, for example, use it  to  create  wallpaper  for  a  computer
26       screen.
27
28       One  use  of  this program is as an example of the Netpbm library draw‐
29       ing(1) functions, which it uses.
30
31       Some of the patterns have large numbers of colors, so  if  you  want  a
32       simpler pattern, use pnmquant on the output.
33
34

OPTIONS

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
41
42   Pattern Specification
43       Specify  the pattern type with these options.  One pattern type must be
44       specified.
45
46
47
48       -gingham2 -g2
49              A gingham check pattern.  Can be tiled.
50
51              If you specify -color, give two  colors:  background  and  fore‐
52              ground, in that order.
53
54
55       -gingham3 -g3
56              A slightly more complicated gingham.  Can be tiled.
57
58              If  you  specify  -color,  give three colors: background and two
59              foregrounds, in that order.
60
61
62       -madras
63              A madras plaid.  Can be tiled.
64
65              If you specify -color, give three  colors:  background  and  two
66              foregrounds, in that order.
67
68
69       -tartan
70              A tartan plaid.  Can be tiled.
71
72              If  you  specify  -color,  give three colors: background and two
73              foregrounds, in that order.
74
75
76       -poles Color gradients centered on randomly-placed poles.
77
78              If you specify -color, give two or more colors.
79
80
81       -squig Squiggley tubular pattern.  Can be tiled.
82
83              If you specify -color, give three or more colors.  The first  is
84              the background color.
85
86
87       -camo  Camouflage pattern.
88
89              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
95
96       -anticamo
97              Anti-camouflage pattern - like -camo, but ultra-bright colors.
98
99              If you specify -color, this is the same as -camo.
100
101
102       -argyle1
103              A  diamond  argyle pattern, without a cross through the diamond,
104              with one diamond.  Can be tiled.
105
106              If you specify -color, give two  colors:  background  and  fore‐
107              ground, in that order.
108
109              This option was new in Netpbm 10.78 (March 2017).
110
111
112       -argyle2
113              A diamond argyle pattern, with a cross through the diamond, with
114              one diamond.  Can be tiled.
115
116              If you specify -color,  give  three  colors:  background,  fore‐
117              ground, and stripe, in that order.
118
119              This option was new in Netpbm 10.78 (March 2017).
120
121
122
123
124   Other Options
125       -color colorlist
126              This specifies the colors to appear in the pattern.
127
128              If you do not specify this option, ppmpat chooses colors at ran‐
129              dom.
130
131              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
136              colorlist is a comma-separated list of colors.
137
138              Specify  each  color  as  described  for  the  argument  of  the
139              pnm_parsecolor()                 library                 routine
140              ⟨libnetpbm_image.html#colorname⟩ .
141
142              Example: -color red, green, rgbi:1.0/0.5/.25 .
143
144              This option was new in Netpbm 10.78 (March 2017).
145
146
147       -randomseed integer
148              This  is the seed for the random number generator that generates
149              the pixels.
150
151              Use this to ensure you get the same image  on  separate  invoca‐
152              tions.
153
154              By  default, ppmpat uses a seed derived from the time of day and
155              process ID, which gives you fairly uncorrelated results in  mul‐
156              tiple invocations.
157
158              This option was new in Netpbm 10.61 (December 2012).
159
160
161
162

REFERENCES

164       Some  of  the patterns are from "Designer's Guide to Color 3" by Jeanne
165       Allen.
166
167

AUTHOR

174       Copyright (C) 1989 by Jef Poskanzer.
175

DOCUMENT SOURCE

177       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
178       source.  The master documentation is at
179
180              http://netpbm.sourceforge.net/doc/ppmpat.html
181
182netpbm documentation             02 March 2016           Ppmpat User Manual(0)