1 |
.\" SCCSid "@(#)ra_tiff.1 2.3 8/29/97 LBL" |
2 |
.TH RA_TIFF 1 8/29/97 RADIANCE |
3 |
.SH NAME |
4 |
ra_tiff - convert RADIANCE picture to/from a TIFF color or greyscale image |
5 |
.SH SYNOPSIS |
6 |
.B ra_tiff |
7 |
[ |
8 |
.B "-z|-L|-l" |
9 |
][ |
10 |
.B -b |
11 |
][ |
12 |
.B "-e +/-stops" |
13 |
][ |
14 |
.B "-g gamma" |
15 |
] |
16 |
{ |
17 |
.B "in.pic|-" |
18 |
} |
19 |
.B out.tif |
20 |
.br |
21 |
.B "ra_tiff -r" |
22 |
[ |
23 |
.B \-x |
24 |
][ |
25 |
.B "\-g gamma" |
26 |
][ |
27 |
.B "\-e +/-stops" |
28 |
] |
29 |
.B in.tif |
30 |
[ |
31 |
.B "out.pic|-" |
32 |
] |
33 |
.SH DESCRIPTION |
34 |
.I Ra_tiff |
35 |
converts between RADIANCE and TIFF image formats. |
36 |
The |
37 |
.I \-g |
38 |
option specifies the exponent used in gamma correction; |
39 |
the default value is 2.2, which is the recommended value |
40 |
for TIFF images. |
41 |
.PP |
42 |
The |
43 |
.I \-b |
44 |
option can be used to specify an 8-bit greyscale TIFF output file. |
45 |
The type of input file is determined automatically. |
46 |
.PP |
47 |
The |
48 |
.I \-z |
49 |
option will result in LZW compression of the TIFF output file. |
50 |
The |
51 |
.I \-L |
52 |
option specifies SGILOG compression, which is recommended |
53 |
to capture the full dynamic range of the Radiance picture. |
54 |
However, since many TIFF readers do not yet support this format, |
55 |
use this option under advisement. |
56 |
The |
57 |
.I \-l |
58 |
option specifies SGILOG24 compressed output, which has slightly |
59 |
less dynamic range than SGILOG, but may be smaller in some cases. |
60 |
(It may also be larger in some cases.)\0 |
61 |
Decompression is automatically determined for TIFF input. |
62 |
.PP |
63 |
The |
64 |
.I \-e |
65 |
option specifies an exposure compensation in f-stops (powers of two). |
66 |
Only integer stops are allowed, for efficiency. |
67 |
.PP |
68 |
The |
69 |
.I \-r |
70 |
option invokes a reverse conversion, from a TIFF image to |
71 |
a RADIANCE picture. |
72 |
The RADIANCE picture file can be taken from the standard input |
73 |
or sent to the standard output by using a hyphen ('-') in place |
74 |
of the file name, but the TIFF image must be to or from a file. |
75 |
The |
76 |
.I \-x |
77 |
option can be used to specify an XYZE Radiance output file, rather |
78 |
than the default RGBE. |
79 |
.SH EXAMPLES |
80 |
To convert a Radiance picture to SGILOG-compressed TIFF format: |
81 |
.IP "" .2i |
82 |
ra_tiff -L scene1.pic scene1.tif |
83 |
.PP |
84 |
To later convert this image back into Radiance and display using |
85 |
human visibility tone-mapping: |
86 |
.IP "" .2i |
87 |
ra_tiff -r scene1.tif scene1.pic |
88 |
.br |
89 |
ximage -e human scene1.pic |
90 |
.SH AUTHOR |
91 |
Greg Ward Larson |
92 |
.br |
93 |
Sam Leffler |
94 |
.SH ACKNOWLEDGEMENT |
95 |
Work on this program was initiated and sponsored by the LESO |
96 |
group at EPFL in Switzerland. |
97 |
Additions for the SGILOG data encoding were sponsored by Silicon Graphics, Inc. |
98 |
.SH BUGS |
99 |
Many TIFF file subtypes are not supported. |
100 |
.br |
101 |
A gamma value other than 2.2 is not properly recorded or understood if |
102 |
recorded in the TIFF file. |
103 |
.SH "SEE ALSO" |
104 |
pfilt(1), ra_bn(1), ra_ppm(1), ra_pr(1), ra_pr24(1), ra_t8(1), |
105 |
ra_t16(1), ximage(1) |