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  [-ran‐
12       domseed 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       The options specify various pattern types:
37
38
39
40       -gingham2
41              A gingham check pattern.  Can be tiled.
42
43              If  you  specify  -color,  give two colors: background and fore‐
44              ground, in that order.
45
46
47       -gingham3
48              A slightly more complicated gingham.  Can be tiled.
49
50              If you specify -color, give three  colors:  background  and  two
51              foregrounds, in that order.
52
53
54       -madras
55              A madras plaid.  Can be tiled.
56
57              If  you  specify  -color,  give three colors: background and two
58              foregrounds, in that order.
59
60
61       -tartan
62              A tartan plaid.  Can be tiled.
63
64              If you specify -color, give three  colors:  background  and  two
65              foregrounds, in that order.
66
67
68       -poles Color gradients centered on randomly-placed poles.
69
70              If you specify -color, give two or more colors.
71
72
73       -squig Squiggley tubular pattern.  Can be tiled.
74
75              If  you specify -color, give three or more colors.  The first is
76              the background color.
77
78
79       -camo  Camouflage pattern.
80
81              If you specify -color, give three or more colors.  The first  is
82              the  background color; the others are colors for the leafy fore‐
83              ground shapes.   The  foreground  shapes  will  probably  occupy
84              nearly  the entire image, so that the background color is barely
85              visible.
86
87
88       -anticamo
89              Anti-camouflage pattern - like -camo, but ultra-bright colors.
90
91              If you specify -color, this is the same as -camo.
92
93
94       -argyle1
95              A diamond argyle pattern, without a cross through  the  diamond,
96              with one diamond.  Can be tiled.
97
98              If  you  specify  -color,  give two colors: background and fore‐
99              ground, in that order.
100
101              This option was new in Netpbm 10.78 (March 2017).
102
103
104       -argyle2
105              A diamond argyle pattern, with a cross through the diamond, with
106              one diamond.  Can be tiled.
107
108              If  you  specify  -color,  give  three colors: background, fore‐
109              ground, and stripe, in that order.
110
111              This option was new in Netpbm 10.78 (March 2017).
112
113
114       -color colorlist
115              This specifies the colors to appear in the pattern.
116
117              If you do not specify this option, ppmpat chooses colors at ran‐
118              dom.
119
120              Different  patterns  take different numbers of colors.  Some can
121              involve variable numbers of colors.  If you specify a number  of
122              colors  incompatible with the pattern you specify, ppmpat fails,
123              telling you how many colors to specify.
124
125              colorlist is a comma-separated list of colors.
126
127              Specify  each  color  as  described  for  the  argument  of  the
128              pnm_parsecolor()                 library                 routine
129              ⟨libnetpbm_image.html#colorname⟩ .
130
131              Example: -color red, green, rgbi:1.0/0.5/.25 .
132
133              This option was new in Netpbm 10.78 (March 2017).
134
135
136       -randomseed integer
137              This is the seed for the random number generator that  generates
138              the pixels.
139
140              Use  this  to  ensure you get the same image on separate invoca‐
141              tions.
142
143              By default, ppmpat uses a seed derived from the time of day  and
144              process  ID, which gives you fairly uncorrelated results in mul‐
145              tiple invocations.
146
147              This option was new in Netpbm 10.61 (December 2012).
148
149
150
151

REFERENCES

153       Some of the patterns are from "Designer's Guide to Color 3"  by  Jeanne
154       Allen.
155
156

AUTHOR

163       Copyright (C) 1989 by Jef Poskanzer.
164

DOCUMENT SOURCE

166       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
167       source.  The master documentation is at
168
169              http://netpbm.sourceforge.net/doc/ppmpat.html
170
171netpbm documentation             2 March 2016            Ppmpat User Manual(0)