Debian Codegraph @

upstream/debian-unstable/man1/ppmrainbow.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Ppmrainbow User Manual" 1 "12 November 2014" "netpbm documentation"
7
8 .SH NAME
9
10 ppmrainbow - Generate a rainbow
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBppmrainbow\fP
16
17 [\fB-width=\fP\fInumber\fP] [\fB-height=\fP\fInumber\fP]
18 [\fB-tmpdir=\fP\fIdirectory\fP] [\fB-norepeat\fP] [\fB-verbose\fP] \fIcolor\fP ...
19
20 .UN description
21 .SH DESCRIPTION
22 .PP
23 This program is part of
24 .BR "Netpbm" (1)\c
25 \&.
26
27 \fBppmrainbow\fP generates a PPM image that fades from one color to
28 another to another from left to right, like a rainbow.
29 .PP
30 If you want a vertical or other non-horizontal rainbow, run the output
31 through \fBpnmrotate\fP or \fBpamflip\fP.
32 .PP
33 One use for such a rainbow is to compose it with another image
34 under a transparency mask in order to add a rainbow area to another image.
35 In fact, you can make rainbow-colored text by using \fBpbmtext\fP,
36 \fBpamcomp\fP, and \fBppmrainbow\fP.
37 .PP
38 \fBpgmramp\fP does a similar thing for grayscale images.
39 .PP
40 If you just want an image containing all the possible colors (for some
41 kind of processing; not to look at), see \fBpamseq\fP.
42
43
44 .UN arguments
45 .SH ARGUMENTS
46 .PP
47 \fIcolor\fP ... is the list of colors, in order from left to right,
48 to go into the rainbow.
49 .PP
50 The first color is added again on the right end of the image unless you
51 specify the \fB-norepeat\fP option. This means you can concatenate multiple
52 copies (tile, as with \fBpnmtile\fP) to make a continuous larger image.
53 .PP
54 \fIcolor\fP is as described for
55 the
56 .UR libnetpbm_image.html#colorname
57 argument of the \fBpnm_parsecolor()\fP library routine
58 .UE
59 \&.
60
61
62 .UN options
63 .SH OPTIONS
64 .PP
65 All options can be abbreviated to their shortest unique prefix.
66 You may use two hyphens instead of one to designate an option. You
67 may use either white space or equals signs between an option name and
68 its value.
69
70
71 .TP
72 \fB-width \fP\fInumber\fP
73 The width in pixels of the output image.
74 .sp
75 Default is 600.
76
77 .TP
78 \fB-height \fP\fInumber\fP
79 The height in pixels of the output image.
80 .sp
81 Default is 8.
82
83 .TP
84 \fB-norepeat\fP
85
86 This option makes \fBppmrainbow\fP end the rainbow with the last
87 color you specify. Without this option, \fBppmrainbow\fP adds the
88 first color you specify to the right end of the rainbow as if you had
89 repeated it.
90
91 .TP
92 \fB-tmpdir\fP
93 The directory specification of the directory \fBppmrainbow\fP is
94 to use for temporary files.
95 .sp
96 Default is the value of the \fBTMPDIR\fP environment variable, or
97 \fB/tmp\fP if \fBTMPDIR\fP is not set.
98 .sp
99 \fBppmrainbow\fP always creates a directory within this directory
100 and creates all its files within that directory.
101
102 .TP
103 \fB-verbose\fP
104 Print the "commands" (invocations of other Netpbm
105 programs) that \fBppmrainbow\fP uses to create the image.
106
107
108
109 .UN seealso
110 .SH SEE ALSO
111 .BR "pgmramp" (1)\c
112 \&,
113 .BR "pamseq" (1)\c
114 \&,
115 .BR "pamgradient" (1)\c
116 \&,
117 .BR "ppmmake" (1)\c
118 \&,
119 .BR "ppmfade" (1)\c
120 \&,
121 .BR "ppm" (1)\c
122 \&.
123
124 .UN author
125 .SH AUTHOR
126 .PP
127 Arjen Bax wrote \fBppmrainbow\fP in June 2001 and contributed it
128 to the Netpbm package. Bryan Henderson wrote this manual in July
129 2001.
130 .SH DOCUMENT SOURCE
131 This manual page was generated by the Netpbm tool 'makeman' from HTML
132 source. The master documentation is at
133 .IP
134 .B http://netpbm.sourceforge.net/doc/ppmrainbow.html
135 .PP