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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
|
\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it! If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pamlevels User Manual" 1 "13 June 2018" "netpbm documentation"
.SH NAME
pamlevels - effect a 'levels' transformation
.UN synopsis
.SH SYNOPSIS
\fBpamlevels\fP
\fB-from1\fP \fIfrom1\fP
\fB-to1\fP \fIto1\fP
\fB-from2\fP \fIfrom2\fP
\fB-to2\fP \fIto2\fP
[\fB-from3\fP \fIfrom3\fP
\fB-to3\fP \fIto3\fP]
[\fB-linear\fP]
[\fB-fitbrightness\fP]
[\fIpamfile\fP]
.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpamlevels\fP reads a Netpbm image from \fIpamfile\fP or standard
input, applies a 'levels' transformation, and sends the result to
standard output. It finds a unique transformation that maps color
\fIfrom1\fP to \fIto1\fP, color \fIfrom2\fP to \fIto2\fP,
and-if \fB-from3\fP and \fB-to3\fP are supplied-color
\fIfrom3\fP to \fIto3\fP. Transformations based on two mappings are linear
in light intensity and those based on three mappings quadratic. The
color-mapping options may be shortened to \fB-f1\fP...\fB-f3\fP and
\fB-t1\fP...\fB-t3\fP.
.PP
Color values have the following format:
\fIcolor\fP[:\fIscale\fP], where \fIcolor\fP is a
.UR libppm.html#colorname
Netpbm color specification
.UE
\& and
\fIscale\fP an optional coefficient that is applied to the intensity
(i.e. \fInot\fP gamma-adjusted) of each RGB component of \fIcolor\fP.
.PP
When the transformation is linear (i.e. uses two mappings) and preserves
zero (i.e. maps black to black), it corresponds to multiplication of light
intensity by a constant and preserves
.BR "color integrity" (1)\c
\&.
.UN examples
.SH EXAMPLES
In the examples below, \f(CW\e\fP denotes a line continuation:
.PP
To brighten an image by setting a darker white point-
.nf
pamlevels -f1 black -t1 black \e
-f2 white:0.9 -t2 white in.ppm > out.ppm
.fi
.PP
To adjust the white point-
.nf
pamlevels -f1 black -t1 black \e
-f2 rgbi:0.9/0.83/0.80 -t2 white in.ppm > out.ppm
.fi
.PP
To set a lighter black point-
.nf
pamlevels -f1 white:0.06 -t1 black \e
-f2 white -t2 white in.ppm > out.ppm
.fi
.PP
To increase brightness by compression-
.nf
pamlevels \e
-f1 black -t1 black -f2 white -t2 white \e
-f3 white:0.5 -t3 white:0.6 in.ppm > out.ppm
.fi
The latter tranformation is similar to gamma-correction.
.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see
.UR index.html#commonoptions
Common Options
.UE
\&), \fBpamlevels\fP recognizes the following
command line options:
.TP
\fB-from1\fP
.TP
\fB-to1\fP
.TP
\fB-from2\fP
.TP
\fB-to2\fP
.TP
\fB-from3\fP
.TP
\fB-to3\fP
These options define the mappings of input colors to output colors that anchor
the transformation function. See
.UR #description
DESCRIPTION
.UE
\&.
.sp
You must specify at least two of these pairs.
.TP
\fB-linear\fP
This option tells \fBpamlevels\fP to work with the intensity-linear
variation on PPM where the samples are proportional to light intensity, rather
than brightness (gamma-adjusted) as in true PPM. The input must be of this
form and the \fBpamlevels\fP makes the output of this form.
.sp
Note that the numbers in a color specification like
\fBrgbi:0.9/0.83/0.80\fP are brightness levels (gamma-adjusted) regardless of
the input and output format.
.sp
You cannot use this with \fB-fitbrightness\fP because that function is
not implemented.
.TP
\fB-fitbrightness\fP
This option selects a transformation which is not very useful - it is
linear or quadratic in brightness rather than light intensity of the pixels.
There is no physical basis for doing it this way and the result is normally
undesirable.
.sp
Note that many tools other than Netpbm do the transformation this way. One
use for this option is simply to demonstrate the poor result of this method.
.sp
One advantage of this transformation is that it is faster, because the
input and output image formats use brightness values. The result is
approximately correct.
.sp
You cannot use this with \fB-linear\fP because that function is not
implemented.
.UN seealso
.SH SEE ALSO
.BR "pnmnorm" (1)\c
\&,
.BR "pamrecolor" (1)\c
\&,
.BR "pnmgamma" (1)\c
\&,
.BR "pnm" (1)\c
\&
.UN author
.SH AUTHOR
.PP
This program was first submitted by Anton Shepelev
(\fIanton.txt@gmail.com\fP).
.UN history
.SH HISTORY
.PP
\fBpamlevels\fP was new in Netpbm 10.83 (June 2018).
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source. The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/pamlevels.html
.PP
|
