| 1 |
< |
.\" RCSid "$Id" |
| 1 |
> |
.\" RCSid "$Id$" |
| 2 |
|
.TH PVALUE 1 1/15/99 RADIANCE |
| 3 |
|
.SH NAME |
| 4 |
|
pvalue - convert RADIANCE picture to/from alternate formats |
| 42 |
|
.TP 10n |
| 43 |
|
.BR \-u |
| 44 |
|
Print only unique values in the output, skipping runs of equal pixels. |
| 45 |
+ |
For reverse conversions, the |
| 46 |
+ |
.I \-u |
| 47 |
+ |
option writes uncompressed output rather than the standard run-length RGBE |
| 48 |
+ |
encoding. |
| 49 |
|
Specifying |
| 50 |
|
.I \+u |
| 51 |
|
turns this option off, which is the default. |
| 52 |
|
.TP |
| 53 |
|
.BR \-o |
| 54 |
|
Print original values, before exposure compensation. |
| 55 |
+ |
If the input file is in XYZE format, the Y (green) channel |
| 56 |
+ |
will correspond to units of candelas/meter^2. |
| 57 |
+ |
Otherwise, the RGB values should be in spectral watts/steradian/meter^2. |
| 58 |
|
Specifying |
| 59 |
|
.I \+o |
| 60 |
< |
uses final values, which is the default. |
| 60 |
> |
uses final exposed values, which is the default. |
| 61 |
|
.TP |
| 62 |
|
.BR \-h |
| 63 |
|
Do not print header. |
| 80 |
|
Skip the specified number of bytes on the input header. |
| 81 |
|
This option is useful for skipping unintelligible headers in |
| 82 |
|
foreign file formats. |
| 76 |
– |
(Does not work when reading from standard input.) |
| 83 |
|
.TP |
| 84 |
|
.BI \-e \ exposure |
| 85 |
|
Adjust the exposure by the amount specified. |
| 183 |
|
converts from a Radiance picture to other values, which is the |
| 184 |
|
default. |
| 185 |
|
.TP |
| 186 |
+ |
.BI \-p " xr yr xg yg xb yb xw yw" |
| 187 |
+ |
On reverse conversion, RGB input uses the given set of color primaries. |
| 188 |
+ |
These are written into the output header with the PRIMARIES variable. |
| 189 |
+ |
.TP |
| 190 |
+ |
.BR \-pXYZ |
| 191 |
+ |
On reverse conversion, input is in CIE XYZ coordinates, rather than RGB. |
| 192 |
+ |
The Y channel is assumed to be in candelas/meter^2. |
| 193 |
+ |
.TP |
| 194 |
|
.BI -y \ res |
| 195 |
|
Set the output y resolution to |
| 196 |
|
.I res. |
| 221 |
|
x or along y. |
| 222 |
|
Most Radiance pictures are sorted top to bottom, then left |
| 223 |
|
to right. |
| 224 |
< |
This corresponds to a specification of the form "-y yres +x xres". |
| 224 |
> |
This corresponds to a specification of the form "\-y yres +x xres". |
| 225 |
|
Either an upper or lower case 'X' may be used for this option. |
| 226 |
|
Like the |
| 227 |
|
.I \-y |
| 231 |
|
.SH EXAMPLE |
| 232 |
|
To look at the original, unique pixels in picture: |
| 233 |
|
.IP "" .2i |
| 234 |
< |
pvalue -o -u picture | more |
| 234 |
> |
pvalue \-o \-u picture | more |
| 235 |
|
.PP |
| 236 |
|
To convert from a 512x400 8-bit greyscale image in bottom to top, |
| 237 |
|
left to right scanline ordering: |
| 238 |
|
.IP "" .2i |
| 239 |
< |
pvalue -r -db -b -h +y 400 +x 512 input.im > flipped.pic |
| 239 |
> |
pvalue \-r \-db \-b \-h +y 400 +x 512 input.im > flipped.hdr |
| 240 |
|
.br |
| 241 |
< |
pflip -v flipped.pic > final.pic |
| 241 |
> |
pflip \-v flipped.hdr > final.hdr |
| 242 |
|
.SH AUTHOR |
| 243 |
|
Greg Ward |
| 244 |
|
.SH BUGS |
| 245 |
< |
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 |
| 245 |
> |
Input pixel locations are ignored during a reverse |
| 246 |
|
conversion, so this information is not used in determining |
| 247 |
|
the scanline ordering or picture size. |
| 248 |
|
.SH "SEE ALSO" |
| 249 |
|
getinfo(1), pcompos(1), pfilt(1), pflip(1), |
| 250 |
< |
protate(1), rpict(1), rtrace(1), rview(1) |
| 250 |
> |
protate(1), ra_xyze(1), rpict(1), rtrace(1), rvu(1) |
