1 |
.\" RCSid "$Id$" |
2 |
.TH PVALUE 1 1/15/99 RADIANCE |
3 |
.SH NAME |
4 |
pvalue - convert RADIANCE picture to/from alternate formats |
5 |
.SH SYNOPSIS |
6 |
.B pvalue |
7 |
[ |
8 |
.B options |
9 |
] |
10 |
[ |
11 |
.B file |
12 |
] |
13 |
.br |
14 |
.B "pvalue -r" |
15 |
[ |
16 |
.B options |
17 |
] |
18 |
[ |
19 |
.B file1 |
20 |
[ |
21 |
.B "file2 file3" |
22 |
] |
23 |
] |
24 |
.SH DESCRIPTION |
25 |
.I Pvalue |
26 |
converts the pixels of a RADIANCE picture to or from another format. |
27 |
In the default mode, pixels are sent to the |
28 |
standard output, one per line, in the following ascii format: |
29 |
|
30 |
xpos ypos red green blue |
31 |
|
32 |
If no |
33 |
.I file |
34 |
is given, the standard input is read. |
35 |
.PP |
36 |
The reverse conversion option |
37 |
.I (-r) |
38 |
may be used with a single input file or when reading from the |
39 |
standard input, but if the second form is used with three separate |
40 |
input files, the three primaries are presumed to be separated in |
41 |
these files. |
42 |
.TP 10n |
43 |
.BR \-u |
44 |
Print only unique values in the output, skipping runs of equal pixels. |
45 |
Specifying |
46 |
.I \+u |
47 |
turns this option off, which is the default. |
48 |
.TP |
49 |
.BR \-o |
50 |
Print original values, before exposure compensation. |
51 |
Specifying |
52 |
.I \+o |
53 |
uses final values, which is the default. |
54 |
.TP |
55 |
.BR \-h |
56 |
Do not print header. |
57 |
Specifying |
58 |
.I \+h |
59 |
causes the header to be printed, which is the default. |
60 |
.TP |
61 |
.BI \-H |
62 |
Do not print the resolution string. |
63 |
(See also the |
64 |
.I \-r |
65 |
option below.) |
66 |
Specifying an input resolution for reverse conversion also turns |
67 |
this option off. |
68 |
Specifying |
69 |
.I \+H |
70 |
causes the resolution string to be printed, which is the default. |
71 |
.TP |
72 |
.BI \-s \ nbytes |
73 |
Skip the specified number of bytes on the input header. |
74 |
This option is useful for skipping unintelligible headers in |
75 |
foreign file formats. |
76 |
(Does not work when reading from standard input.) |
77 |
.TP |
78 |
.BI \-e \ exposure |
79 |
Adjust the exposure by the amount specified. |
80 |
If the exposure is being given as a conversion factor, use |
81 |
.I \+e |
82 |
instead, so an EXPOSURE line will not be recorded in the header |
83 |
(if any). |
84 |
.TP |
85 |
.BI \-g \ gamma |
86 |
Set gamma correction for conversion. |
87 |
When converting from a RADIANCE picture to another format, |
88 |
the inverse gamma is applied to correct for monitor response. |
89 |
When converting to a RADIANCE picture |
90 |
.I (\-r |
91 |
option), the gamma is applied directly to recover the linear values. |
92 |
By default, |
93 |
.I gamma |
94 |
is set to 1.0, meaning no gamma correction is performed. |
95 |
.TP |
96 |
.BR \-d |
97 |
Data only, |
98 |
do not print x and y pixel position. |
99 |
.TP |
100 |
.BR \-da |
101 |
Same as |
102 |
.I \-d. |
103 |
.TP |
104 |
.BR \-di |
105 |
Print ascii integer values from 0 to 255+. |
106 |
If |
107 |
.I \+di |
108 |
is given, the integer values will be preceded by |
109 |
the x and y pixel locations. |
110 |
.TP |
111 |
.BR \-db |
112 |
Output binary byte values from 0 to 255. |
113 |
.TP |
114 |
.BR \-dw |
115 |
Output binary 16-bit words from 0 to 65535. |
116 |
.TP |
117 |
.BR \-dW |
118 |
Output binary 16-bit words from 0 to 65535, byte-swapped. |
119 |
.TP |
120 |
.BR \-df |
121 |
Output binary float values. |
122 |
.TP |
123 |
.BR \-dF |
124 |
Output byte-swapped binary float values. |
125 |
.TP |
126 |
.BR \-dd |
127 |
Output binary double values. |
128 |
.TP |
129 |
.BR \-dD |
130 |
Output byte-swapped binary double values. |
131 |
.TP |
132 |
.BR \-R |
133 |
Reverse ordering of colors so that the output is blue then green |
134 |
then red. |
135 |
The default ordering (specified with |
136 |
.I \+R) |
137 |
is red then green then blue. |
138 |
.TP |
139 |
.BR \-n |
140 |
The RGB values are non-interleaved, meaning that all the red, green |
141 |
and blue data are stored together in separate chunks. |
142 |
Interleaving may be turned on with the |
143 |
.I \+n |
144 |
option, which is the default. |
145 |
.TP |
146 |
.BR \-b |
147 |
Print brightness values rather than RGB. |
148 |
Specifying |
149 |
.I \+b |
150 |
turns this option off, which is the default. |
151 |
.TP |
152 |
.BI \-p P |
153 |
Put out only the primary |
154 |
.I P, |
155 |
where |
156 |
.I P |
157 |
is one of upper or lower case 'R', 'G' or 'B' for red, green or |
158 |
blue, respectively. |
159 |
This option may be used to separate the Radiance primaries into |
160 |
three files with three separate runs of |
161 |
.I pvalue, |
162 |
or only one file when only one primary is needed. |
163 |
Note that there is no space between this option and its argument. |
164 |
.TP |
165 |
.BR \-r |
166 |
Perform reverse conversion. |
167 |
Input is in the format given by the other options. |
168 |
The x and y resolution must be specified on the command line, unless |
169 |
the image file contains a Radiance resolution string at the |
170 |
beginning (see |
171 |
.I \-H |
172 |
option above and |
173 |
.I \-y |
174 |
option below). |
175 |
Specifying |
176 |
.I \+r |
177 |
converts from a Radiance picture to other values, which is the |
178 |
default. |
179 |
.TP |
180 |
.BI -y \ res |
181 |
Set the output y resolution to |
182 |
.I res. |
183 |
If |
184 |
.I \+y |
185 |
is specified, then the scanlines are assumed to be in |
186 |
increasing order (ie. bottom to top). |
187 |
The default value for this option is 0, which means |
188 |
that the picture size and scanline order must appear |
189 |
as the first line after the header (if any) in the |
190 |
input file. |
191 |
Either an upper or lower case 'Y' may be used for this option. |
192 |
Since Radiance files always contain such a line, |
193 |
this option has no effect for forward conversions. |
194 |
.TP |
195 |
.BI +x \ res |
196 |
Set the output x resolution to |
197 |
.I res. |
198 |
If |
199 |
.I \-x |
200 |
is specified, then the scanlines are assumed to be in |
201 |
decreasing order (ie. right to left). |
202 |
The ordering of the |
203 |
.I \-y |
204 |
and |
205 |
.I \+x |
206 |
options determines whether the scanlines are sorted along |
207 |
x or along y. |
208 |
Most Radiance pictures are sorted top to bottom, then left |
209 |
to right. |
210 |
This corresponds to a specification of the form "-y yres +x xres". |
211 |
Either an upper or lower case 'X' may be used for this option. |
212 |
Like the |
213 |
.I \-y |
214 |
option, |
215 |
.I \-x |
216 |
options have no effect for forward conversions. |
217 |
.SH EXAMPLE |
218 |
To look at the original, unique pixels in picture: |
219 |
.IP "" .2i |
220 |
pvalue -o -u picture | more |
221 |
.PP |
222 |
To convert from a 512x400 8-bit greyscale image in bottom to top, |
223 |
left to right scanline ordering: |
224 |
.IP "" .2i |
225 |
pvalue -r -db -b -h +y 400 +x 512 input.im > flipped.pic |
226 |
.br |
227 |
pflip -v flipped.pic > final.pic |
228 |
.SH AUTHOR |
229 |
Greg Ward |
230 |
.SH BUGS |
231 |
The |
232 |
.I \-r |
233 |
option does not work with the |
234 |
.I \-u |
235 |
option. |
236 |
Also, input pixel locations are ignored during a reverse |
237 |
conversion, so this information is not used in determining |
238 |
the scanline ordering or picture size. |
239 |
.SH "SEE ALSO" |
240 |
getinfo(1), pcompos(1), pfilt(1), pflip(1), |
241 |
protate(1), rpict(1), rtrace(1), rview(1) |