about summary refs log tree commit diff
path: root/ppmrainbow.html
blob: f1d362682a8be1a568aa3c728d897068675d3cef (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
131
132
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD><TITLE>Ppmrainbow User Manual</TITLE></HEAD>
<BODY>
<H1>ppmrainbow</H1>
Updated: 14 October 2005
<BR>
<A HREF="#index">Table Of Contents</A>

<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>

ppmrainbow - Generate a rainbow

<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>

<B>ppmrainbow</B>

[<B>-width=</B><I>number</I>]

[<B>-height=</B><I>number</I>]

<BR>

[<B>-tmpdir=</B><I>directory</I>]

[<B>-norepeat</B>]

[<B>-verbose</B>]

<I>color</I> ...

<P>All options can be abbreviated to their shortest unique prefix.
You may use two hyphens instead of one to designate an option.  You
may use either white space or equals signs between an option name and
its value.

<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>

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

<B>ppmrainbow</B> generates a PPM image that fades from one color to
another to another from left to right, like a rainbow.  The colors are
those you specify on the command line, in that order.  The first color
is added again on the right end of the image unless you specify the
<b>-norepeat</b> option.

<P>If you want a vertical or other non-horizontal rainbow, run the output
through <B>pnmrotate</B> or <b>pamflip</b>.

<P>One use for such a rainbow is to compose it with another image
under an alpha mask in order to add a rainbow area to another image.
In fact, you can make rainbow-colored text by using <B>pbmtext</B>,
<B>pamcomp</B>, and <B>ppmrainbow</B>.

<p><b>pgmramp</b> does a similar thing for grayscale images.

<p>If you just want an image containing all the possible colors (for some
kind of processing; not to look at), see <b>pamseq</b>.

<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>

<DL COMPACT>
<DT><B>-width </B><I>number</I>

<DD>
The width in pixels of the output image.

<P>Default is 600.

<DT><B>-height </B><I>number</I>

<DD>
The height in pixels of the output image.

<P>Default is 8.

<DT><b>-norepeat</b>
     
<dd>This option makes <b>ppmrainbow</b> end the rainbow with the last
color you specify.  Without this option, <b>ppmrainbow</b> adds the
first color you specify to the right end of the rainbow as if you had
repeated it.  <i>(I don't understand the point of this default behavior;
it exists today just for backward compatibility).</i>

<DT><B>-tmpdir</B>

<DD>The directory specification of the directory <B>ppmrainbow</B> is
to use for temporary files.

<P>Default is the value of the <B>TMPDIR</B> environment variable, or
<b>/tmp</b> if <B>TMPDIR</B> is not set.

<DT><B>-verbose</B>

<DD>Print the &quot;commands&quot; (invocations of other Netpbm
programs) that <B>ppmrainbow</B> uses to create the image.

</DL>

<A NAME="lbAF">&nbsp;</A>
<H2>SEE ALSO</H2>

<B><A HREF="pgmramp.html">pgmramp</A></B>,
<B><A HREF="pamseq.html">pamseq</A></B>,
<B><A HREF="pamgradient.html">pamgradient</A></B>,
<B><A HREF="ppmmake.html">ppmmake</A></B>,
<B><A HREF="ppmfade.html">ppmfade</A></B>,
<B><A HREF="ppm.html">ppm</A></B>.

<A NAME="lbAG">&nbsp;</A>
<H2>AUTHOR</H2>

<P>Arjen Bax wrote <B>ppmrainbow</B> in June 2001 and contributed it
to the Netpbm package.  Bryan Henderson wrote this manual in July
2001.

<HR>
<A NAME="index">&nbsp;</A>
<H2>Table Of Contents</H2>
<UL>
<LI><A HREF="#lbAB">NAME</A>
<LI><A HREF="#lbAC">SYNOPSIS</A>
<LI><A HREF="#lbAD">DESCRIPTION</A>
<LI><A HREF="#lbAE">OPTIONS</A>
<LI><A HREF="#lbAF">SEE ALSO</A>
<LI><A HREF="#lbAG">AUTHOR</A>
</UL>
</BODY>
</HTML>