Debian Codegraph @

upstream/debian-unstable/man1/pamhue.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 "Pamhue User Manual" 1 "07 January 2018" "netpbm documentation"
7
8 .SH NAME
9 pamhue - change a Netpbm image's hues
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpamhue\fP
15 [\fB-huechange=\fP[\fIdegrees\fP]]
16 \fIfilename\fP
17 .PP
18 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 .UN description
24 .SH DESCRIPTION
25 .PP
26 This program is part of
27 .BR "Netpbm" (1)\c
28 \&.
29 .PP
30 \fBpamhue\fP shifts the hue of every pixel in an image by the same amount.
31 .PP
32 If the image is in a black and white or grayscale format, the image is
33 fully desaturated, so the hue is meaningless and \fBpamhue\fP leaves the
34 image unchanged.
35 .PP
36 Hue-Saturation-Value, or HSV, is one way to represent a color, like the
37 more well-known RGB. Hue is an indication of the secondary color with the
38 same brightness that most closely approximates the color. A secondary color
39 is made of a combination of at most two of the primary colors.
40 .PP
41 In the HSV model, hue is an angular position on the color wheel.
42 .PP
43 With \fBpamhue\fP, you indicate an angle by which to change all the hues
44 in the image; for example you can say move it 60 degrees clockwise. That
45 would change all red pixels to yellow and all yellow pixels to green, etc.
46
47 .PP
48 To modify the saturation and value components of the colors, use
49 \fBpambrighten\fP.
50
51
52 .UN examples
53 .SH EXAMPLES
54 .PP
55 To shift the color of each pixel 120 degrees clockwise:
56 .nf
57 pamhue -huechange=120
58
59 .fi
60 .PP
61 To shift the color of each pixel 120 degrees counterclockwise:
62 .nf
63 pamhue -huechange=-120
64
65 .fi
66
67
68 .UN options
69 .SH OPTIONS
70 .PP
71 In addition to the options common to all programs based on libnetpbm
72 (most notably \fB-quiet\fP, see
73 .UR index.html#commonoptions
74 Common Options
75 .UE
76 \&), \fBpamhue\fP recognizes the following
77 command line option:
78
79
80 .TP
81 \fB-huechange=\fP\fIdegrees\fP
82 This option specifies the amount to shift each color. It is in degrees,
83 with positive meaning clockwise and negative meaning counterclockwise. It may
84 be fractional and may be more than a full revolution.
85 .sp
86 This option is mandatory.
87
88
89
90 .UN history
91 .SH HISTORY
92 .PP
93 \fBpamhue\fP was new in Netpbm 10.86 (March 2019).
94
95
96 .UN seealso
97 .SH SEE ALSO
98 .BR "pambrighten" (1)\c
99 \&,
100 .BR "ppmflash" (1)\c
101 \&,
102 .BR "ppmhist" (1)\c
103 \&,
104 .BR "ppm" (1)\c
105 \&
106
107 .UN author
108 .SH AUTHOR
109 .PP
110 Copyright (C) 2018 by Willem van Schaik.
111 Copyright (C) 1990 by Brian Moffet.
112 Copyright (C) 1989 by Jef Poskanzer.
113 .PP
114 Permission to use, copy, modify, and distribute this software and its
115 documentation for any purpose and without fee is hereby granted, provided
116 that the above copyright notice appear in all copies and that both that
117 copyright notice and this permission notice appear in supporting
118 documentation. This software is provided "as is" without express or
119 implied warranty.
120 .SH DOCUMENT SOURCE
121 This manual page was generated by the Netpbm tool 'makeman' from HTML
122 source. The master documentation is at
123 .IP
124 .B http://netpbm.sourceforge.net/doc/pamhue.html
125 .PP