summary refs log tree commit diff
path: root/ppmpat.html
blob: 0ded8652832a089307818b6b10b9151b76b227d7 (plain) (blame)
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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD><TITLE>Ppmpat User Manual</TITLE></HEAD>
<BODY>
<H1>ppmpat</H1>
Updated: 24 November 2012
<BR>
<A HREF="#index">Table Of Contents</A>

<H2>NAME</H2>

ppmpat - make a pretty PPM image

<H2 id="synopsis">SYNOPSIS</H2>

<B>ppmpat</B>
{<B>-gingham2</B>|<B>-g2</B>} |
{<B>-gingham3</B>|<B>-g3</B>} |
<B>-madras</B> |
<B>-tartan</B> |
<B>-poles</B> |
<B>-squig</B> |
<B>-camo</B> |
<B>-anticamo</B>
[<b>-randomseed=</b><i>integer</i>]

<I>width</I> <I>height</I>


<P>You can abbreviate any option to its shortest unique prefix.

<H2 id="description">DESCRIPTION</H2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<p><b>ppmpat</b> produces a PPM of the specified width and height,
with a pattern in it.

<P>This program is mainly to demonstrate use of the ppmdraw routines,
a simple but powerful drawing library.  See the ppmdraw.h include file
for more info on using these routines.  Still, some of the patterns
can be rather pretty.  If you have a color workstation, something like
<B>ppmpat -squig 300 300 | pnmquant 128</B>
should generate a nice background.

<p>Some of these patterns have large numbers of colors, so if you want
a simpler pattern, use <b>pnmquant</b> on the output.

<H2 id="options">OPTIONS</H2>

<P>The options specify various pattern types:

<DL COMPACT>
<DT><B>-gingham2</B>

<DD>A gingham check pattern.  Can be tiled.

<DT><B>-gingham3</B>

<DD>A slightly more complicated gingham.  Can be tiled.

<DT><B>-madras</B>

<DD>A madras plaid.  Can be tiled.

<DT><B>-tartan</B>

<DD>A tartan plaid.  Can be tiled.

<DT><B>-poles</B>

<DD>Color gradients centered on randomly-placed poles.

<DT><B>-squig</B>

<DD>Squiggley tubular pattern.  Can be tiled.

<DT><B>-camo</B>

<DD>Camouflage pattern.

<DT><B>-anticamo</B>

<DD>Anti-camouflage pattern - like -camo, but ultra-bright colors.

<dt><b>-randomseed=</b><i>integer</i>

<dd>This is the seed for the random number generator that generates the
pixels.

<p>Use this to ensure you get the same image on separate invocations.

<p>By default, <b>ppmpat</b> uses a seed derived from the time of day
and process ID, which gives you fairly uncorrelated results in multiple
invocations.

<p>This option was new in Netpbm 10.61 (December 2012).

</DL>

<H2 id="references">REFERENCES</H2>

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

<H2 id="seealso">SEE ALSO</H2>

<A HREF="pnmtile.html">pnmtile</A>, 
<A HREF="pnmquant.html">pnmquant</A>, 
<A HREF="ppmmake.html">ppmmake</A>, 
<A HREF="ppmrainbow.html">ppmrainbow</A>, 
<A HREF="pamgradient.html">pamgradient</A>, 
<A HREF="ppm.html">ppm</A>

<H2 id="author">AUTHOR</H2>

Copyright (C) 1989 by Jef Poskanzer.

<HR>
<A NAME="index">&nbsp;</A>
<H2>Table Of Contents</H2>
<UL>
<LI><A HREF="#synopsis">SYNOPSIS</A>
<LI><A HREF="#description">DESCRIPTION</A>
<LI><A HREF="#options">OPTIONS</A>
<LI><A HREF="#references">REFERENCES</A>
<LI><A HREF="#seealso">SEE ALSO</A>
<LI><A HREF="#author">AUTHOR</A>
</UL>
</BODY>
</HTML>