Debian Codegraph @

upstream/debian-unstable/man1/pambrighten.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 "Pambrighten User Manual" 1 "18 August 2020" "netpbm documentation"
7
8 .SH NAME
9 pambrighten - change a PPM image's Saturation and Value
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpambrighten\fP
15 [\fB-saturation=\fP[\fB+\fP|\fB-\fP]\fIsaturation_percent\fP]
16 [\fB-value=\fP[\fB+\fP|\fB-\fP]\fIvalue_percent\fP]
17 [\fInetpbmfile\fP]
18 .PP
19 Minimum unique abbreviation of option is acceptable. You may use
20 double hyphens instead of single hyphen to denote options. You may use
21 white space in place of the equals sign to separate an option name
22 from its value.
23
24 .UN description
25 .SH DESCRIPTION
26 .PP
27 This program is part of
28 .BR "Netpbm" (1)\c
29 \&.
30 .PP
31 \fBpambrighten\fP increases or decreases the Saturation and Value
32 (from the HSV color space) of each pixel of a Netpbm image. You specify
33 the percentage change for each of those parameters.
34 .PP
35 You can also remap the colors of the pixels so their Values cover the full
36 range of possible Values.
37 .PP
38 The input image is from the file named \fInetpbmfile\fP, or Standard
39 Input if \fInetpbmfile\fP is not specified.
40
41 .PP
42 The output format is the same as the input format and any extra channels,
43 such as transparency, are passed through.
44
45 .PP
46 Hue-Saturation-Value, or HSV, is one way to represent a color, like the
47 more well-known RGB. Hue, Saturation, and Value are numbers in the range from
48 0 to 1. We always capitalize them in this document when we mean the number
49 from the HSV color space, especially since "value" as a conventional English
50 word has a much more abstract meaning.
51 .PP
52 Value is a measure of how bright the color is, relative to some specified
53 maximum (the Netpbm formats are also defined in terms of a specified maximum
54 brightness -- For the purposes of this program, they are the same). In
55 particular, it is the brightness of the brightest primary color component of
56 the color divided by the maximum brightness possible for a component. Zero
57 Value means black. White has full Value.
58 .PP
59 Hue is an indication of the secondary color with the same brightness that
60 most closely approximates the color. A secondary color is made of a
61 combination of at most two of the primary colors.
62 .PP
63 Saturation is a measure of how close the color is to the color indicated by
64 the Hue and Value. A lower number means more light of the third primary color
65 must be added to get the exact color. Full Saturation means the color is a
66 secondary color. Zero Saturation means the color is gray (or black or white).
67 Decreasing the saturation of a color tends to make it washed out.
68 .PP
69 If it is impossible to increase the Value of a pixel by the amount you
70 specify (e.g. the Value is .5 and you specify +200%), \fBpambrighten\fP
71 increases it to full Value instead.
72 .PP
73 If it is impossible to increase the Saturation of a pixel by the amount
74 you specify (e.g. it is already half saturated and you specify +200%),
75 \fBpambrighten\fP increases it to full Saturation instead.
76 .PP
77 For a simpler kind of brightening, you can use \fBpamfunc -multiplier\fP
78 simply to increase the brightness of each pixel by a specified percentage,
79 clipping each RGB component where the calculated brightness would exceed full
80 brightness. Thus, the brightest colors in the image would change chromaticity
81 in addition to not getting the specified brightness boost. For
82 \fIdecreasing\fP brightness, \fBpamfunc\fP should do the same thing as
83 \fBpambrighten\fP.
84 .PP
85 \fBppmflash\fP does another kind of brightening. It changes the color of
86 each pixel to bring it a specified percentage closer to white. This increases
87 the value and saturation.
88 .PP
89 \fBpambrighten\fP is meant to replace \fBppmbrighten\fP. It is the same
90 as \fBppmbrighten\fP, except that it recognizes the various Netpbm image
91 formats rather than treating them all as PPM. The output format is the same
92 as the input format and extra channels in a PAM image (such as a
93 transparency channel) get passed through.
94 .PP
95 If you want to modify the hues in the image, use \fBpamhue\fP.
96
97
98 .UN examples
99 .SH EXAMPLES
100 .PP
101 To double the Value of each pixel:
102 .nf
103 pambrighten -value=100
104
105 .fi
106 .PP
107 To double the Saturation and halve the Value of each pixel:
108 .nf
109 pambrighten -saturation=+100 -value=-50
110
111 .fi
112
113 .UN options
114 .SH OPTIONS
115 .PP
116 In addition to the options common to all programs based on libnetpbm
117 (most notably \fB-quiet\fP, see
118 .UR index.html#commonoptions
119 Common Options
120 .UE
121 \&), \fBpambrighten\fP recognizes the following
122 command line options:
123
124
125 .TP
126 \fB-value=\fP\fIvalue_percent\fP
127 This option specifies the amount, as a percentage, by which you want to
128 increase the Value of each pixel. It may be negative.
129 .sp
130 The default is zero.
131
132 .TP
133 \fB-saturation=\fP\fIvalue_percent\fP
134 This option specifies the amount, as a percentage, by which you want to
135 increase the Saturation of each pixel. It may be negative.
136 .sp
137 The default is zero.
138
139
140
141 .UN seealso
142 .SH SEE ALSO
143 .BR "pnmnorm" (1)\c
144 \&,
145 .BR "ppmdim" (1)\c
146 \&,
147 .BR "pamfunc" (1)\c
148 \&,
149 .BR "ppmflash" (1)\c
150 \&,
151 .BR "pamaltsat" (1)\c
152 \&,
153 .BR "pamdepth" (1)\c
154 \&,
155 .BR "pnmgamma" (1)\c
156 \&,
157 .BR "pamhue" (1)\c
158 \&,
159 .BR "ppmhist" (1)\c
160 \&,
161 .BR "ppm" (1)\c
162 \&
163
164 .UN history
165 .SH HISTORY
166 .PP
167 \fBpambrighten\fP was new in Netphm 10.86 (March 2019). It was a PAM
168 conversion of the much older \fBppmbrighten\fP.
169
170
171 .UN author
172 .SH AUTHOR
173 .PP
174 Copyright (C) 1990 by Brian Moffet.
175 Copyright (C) 1989 by Jef Poskanzer.
176 .PP
177 Permission to use, copy, modify, and distribute this software and its
178 documentation for any purpose and without fee is hereby granted, provided
179 that the above copyright notice appear in all copies and that both that
180 copyright notice and this permission notice appear in supporting
181 documentation. This software is provided "as is" without express or
182 implied warranty.
183 .SH DOCUMENT SOURCE
184 This manual page was generated by the Netpbm tool 'makeman' from HTML
185 source. The master documentation is at
186 .IP
187 .B http://netpbm.sourceforge.net/doc/pambrighten.html
188 .PP