Debian Codegraph @

upstream/debian-unstable/man1/pamgradient.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 "Pamgradient User Manual" 1 "21 October 2005" "netpbm documentation"
7
8 .SH NAME
9 pamgradient - create a four-corner gradient PAM image
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpamgradient\fP
15 [\fB-maxval=\fP\fImaxval\fP]
16 \fIcolor-tl\fP \fIcolor-tr\fP \fIcolor-bl\fP \fIcolor-br\fP
17 \fIwidth\fP \fIheight\fP
18 .PP
19 Minimum unique abbreviation of option is acceptable. You may use double
20 hyphens instead of single hyphen to denote options. You may use white
21 space in place of the equals sign to separate an option name from its value.
22
23
24 .UN description
25 .SH DESCRIPTION
26 .PP
27 This program is part of
28 .BR "Netpbm" (1)\c
29 \&.
30 .PP
31 \fBpamgradient\fP creates an image of the specified
32 dimensions \fIwidth\fP by \fIheight\fP which contains a smooth,
33 two-dimensional gradient between the specified colors of the four
34 corners (from top left to bottom right).
35 .PP
36 Specify the colors as described for the
37 .UR libnetpbm_image.html#colorname
38 argument of the \fBpnm_parsecolor()\fP library routine
39 .UE
40 \&.
41 .PP
42 If all four colors are gray values, \fBpamgradient\fP creates a
43 grayscale image (PAM tuple type GRAYSCALE). Otherwise, it creates
44 a color image (PAM tuple type RGB).
45
46 .UN options
47 .SH OPTIONS
48 .PP
49 In addition to the options common to all programs based on libnetpbm
50 (most notably \fB-quiet\fP, see
51 .UR index.html#commonoptions
52 Common Options
53 .UE
54 \&), \fBpamgradient\fP recognizes the following
55 command line option:
56
57
58 .TP
59 \fB-maxval=\fP\fImaxval\fP
60
61
62 maxval of the generated image. (See
63 .BR "PAM" (1)\c
64 \& and
65 .BR "PNM" (1)\c
66 \& specifications).
67
68
69 .UN seealso
70 .SH SEE ALSO
71 .BR "\fBpamgradient\fP" (1)\c
72 \&,
73 .BR "\fBppmmake\fP" (1)\c
74 \&,
75 .BR "\fBppmrainbow\fP" (1)\c
76 \&,
77 .BR "\fBpgmramp\fP" (1)\c
78 \&,
79 .BR "\fBppmpat\fP" (1)\c
80 \&,
81 .BR "pam" (1)\c
82 \&,
83 .BR "pnm" (1)\c
84 \&
85
86 .UN note
87 .SH NOTE
88 .PP
89 Only the top left corner of the generated image has exactly
90 the specified color. The color of the top right corner is a bit
91 shifted to the left, the bottom left corner a bit up, and the
92 bottom right corner left and up. This ensures nice transitions
93 when combining adjacent (very narrow) gradients, and doesn't play
94 a role when the gradient butts against a solid surface.
95 .PP
96 This effect is created by the integer arithmetic used for the
97 interpolation of the color values, and since it doesn't make a
98 difference for all practical purposes I might as well sell it as a
99 feature.
100
101 .UN history
102 .SH HISTORY
103 .PP
104 \fBpamgradient\fP was new in Netpbm 10.31 (December 2005).
105
106 .UN author
107 .SH AUTHOR
108 .PP
109 pamgradient was written by Daniel Haude in October 2005.
110 .SH DOCUMENT SOURCE
111 This manual page was generated by the Netpbm tool 'makeman' from HTML
112 source. The master documentation is at
113 .IP
114 .B http://netpbm.sourceforge.net/doc/pamgradient.html
115 .PP