summary refs log tree commit diff
path: root/pamgradient.html
blob: 63f66215b7eb7be04d54c7031b8f38d265fea935 (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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
<HEAD>
  <TITLE>Pamgradient User Manual</TITLE>
</HEAD>
<BODY>

<H1>pamgradient</H1>Updated: 21 October 2005
<BR>
<A href="#index">Table Of Contents</A>

<H2>NAME</H2>
pamgradient - create a four-corner gradient PAM image

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

<B>pamgradient</B>
[<B>-maxval=</B><I>maxval</I>]
<I>color-tl</i> <i>color-tr</i> <i>color-bl</i> <i>color-br</i>
<br>
<i>width</i> <i>height</I>


<p>Minimum unique abbreviation of option is acceptable.  You may use double
hyphens instead of single hyphen to denote options.  You may use white
space in place of the equals sign to separate an option name from its value.


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

<P>This program is part of <A href="index.html">Netpbm</A>.

<P><B>pamgradient</B> creates an image of the specified
dimensions <I>width</I> by <I>height</I> which contains a smooth,
two-dimensional gradient between the specified colors of the four
corners (from top left to bottom right).

<P>Specify the colors as described for the <a
href="libppm.html#colorname">argument of the <b>ppm_parsecolor()</b>
library routine</a>.


<P>If all four colors are gray values, <B>pamgradient</B> creates a
grayscale image (PAM tuple type GRAYSCALE).  Otherwise, it creates
a color image (PAM tuple type RGB).

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

<DL compact>
  <DT><B>-maxval=</B><I>maxval</I>

  <DD>maxval of the generated image.  (See <a href="pam.html">PAM</a> and
  <a href="pnm.html">PNM</a> specifications).
</DL>

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

<A href="pamgradient.html"><b>pamgradient</b></A>,
<A href="ppmmake.html"><b>ppmmake</b></A>,
<A href="ppmrainbow.html"><b>ppmrainbow</b></A>,
<A href="pgmramp.html"><b>pgmramp</b></A>,
<A href="ppmpat.html"><b>ppmpat</b></A>,
<A href="pam.html">pam</A>,
<A href="pnm.html">pnm</A>

<H2 id="note">NOTE</H2>

<P>Only the top left corner of the generated image has exactly
the specified color.  The color of the top right corner is a bit
shifted to the left, the bottom left corner a bit up, and the
bottom right corner left and up. This ensures nice transitions
when combining adjacent (very narrow) gradients, and doesn't play
a role when the gradient butts against a solid surface.

<P>This effect is created by the integer arithmetic used for the
interpolation of the color values, and since it doesn't make a
difference for all practical purposes I might as well sell it as a
feature.

<h2 id="history">HISTORY</h2>

<p><b>pamgradient</b> was new in Netpbm 10.31 (December 2005).

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

<P>pamgradient was written by Daniel Haude in October 2005.
<HR>

<H2 id="index">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="#see_also">SEE ALSO</A>
  <LI><A href="#note">NOTE</A>
  <LI><A href="#history">HISTORY</A>
  <LI><A href="#author">AUTHOR</A>
</UL>
</BODY>
</HTML>