Debian Codegraph @

userguide/pamhue.html

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
2 <html><head><title>Pamhue User Manual</title></head>
3 <body>
4 <h1>pamhue</h1>
5 Updated: 07 January 2018
6 <br>
7 <a href="#index">Table Of Contents</a>
8
9 <h2>NAME</h2>
10 pamhue - change a Netpbm image's hues
11
12 <h2 id="synopsis">SYNOPSIS</h2>
13
14 <b>pamhue</b>
15 [<b>-huechange=</b>[<i>degrees</i>]]
16 <i>filename</i>
17
18 <p>Minimum unique abbreviation of option is acceptable. You may use
19 double hyphens instead of single hyphen to denote options. You may use
20 white space in place of the equals sign to separate an option name
21 from its value.
22
23 <h2 id="description">DESCRIPTION</h2>
24
25 <p>This program is part of <a href="index.html">Netpbm</a>.
26
27 <p><b>pamhue</b> shifts the hue of every pixel in an image by the same amount.
28
29 <p>If the image is in a black and white or grayscale format, the image is
30 fully desaturated, so the hue is meaningless and <b>pamhue</b> leaves the
31 image unchanged.
32
33 <p>Hue-Saturation-Value, or HSV, is one way to represent a color, like the
34 more well-known RGB. Hue is an indication of the secondary color with the
35 same brightness that most closely approximates the color. A secondary color
36 is made of a combination of at most two of the primary colors.
37
38 <p>In the HSV model, hue is an angular position on the color wheel.
39
40 <p>With <b>pamhue</b>, you indicate an angle by which to change all the hues
41 in the image; for example you can say move it 60 degrees clockwise. That
42 would change all red pixels to yellow and all yellow pixels to green, etc.
43
44 <p>To modify the saturation and value components of the colors, use
45 <b>pambrighten</b>.
46
47
48 <h2 id="examples">EXAMPLES</h2>
49
50 <p>To shift the color of each pixel 120 degrees clockwise:
51 <pre>
52 pamhue -huechange=120
53 </pre>
54
55 <p>To shift the color of each pixel 120 degrees counterclockwise:
56 <pre>
57 pamhue -huechange=-120
58 </pre>
59
60
61 <h2 id="options">OPTIONS</h2>
62
63 <p>In addition to the options common to all programs based on libnetpbm
64 (most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
65 Common Options</a>), <b>pamhue</b> recognizes the following
66 command line option:
67
68 <dl>
69 <dt><b>-huechange=</b><i>degrees</i>
70
71 <dd>This option specifies the amount to shift each color. It is in degrees,
72 with positive meaning clockwise and negative meaning counterclockwise. It may
73 be fractional and may be more than a full revolution.
74
75 <p>This option is mandatory.
76
77 </dl>
78
79 <h2 id="history">HISTORY</h2>
80
81 <p><b>pamhue</b> was new in Netpbm 10.86 (March 2019).
82
83
84 <h2 id="seealso">SEE ALSO</h2>
85
86 <a href="pambrighten.html">pambrighten</a>,
87 <a href="ppmflash.html">ppmflash</a>,
88 <a href="ppmhist.html">ppmhist</a>,
89 <a href="ppm.html">ppm</a>
90
91 <h2 id="author">AUTHOR</h2>
92
93 <p>Copyright (C) 2018 by Willem van Schaik.
94 Copyright (C) 1990 by Brian Moffet.
95 Copyright (C) 1989 by Jef Poskanzer.
96
97 <p>
98 Permission to use, copy, modify, and distribute this software and its
99 documentation for any purpose and without fee is hereby granted, provided
100 that the above copyright notice appear in all copies and that both that
101 copyright notice and this permission notice appear in supporting
102 documentation. This software is provided "as is" without express or
103 implied warranty.
104
105 <hr>
106 <h2 id="index">Table Of Contents</h2>
107 <ul>
108 <li><a href="#synopsis">SYNOPSIS</a>
109 <li><a href="#description">DESCRIPTION</a>
110 <li><a href="#examples">EXAMPLES</a>
111 <li><a href="#options">OPTIONS</a>
112 <li><a href="#history">HISTORY</a>
113 <li><a href="#seealso">SEE ALSO</a>
114 <li><a href="#author">AUTHOR</a>
115 </ul>
116 </body>
117 </html>