| 1 |
greg |
1.3 |
.\" RCSid "$Id: ran2tiff.1,v 1.2 2007/09/04 17:36:41 greg Exp $"
|
| 2 |
greg |
1.1 |
.TH RAN2TIFF 1 9/16/2005 RADIANCE
|
| 3 |
|
|
.SH NAME
|
| 4 |
|
|
ran2tiff - expose and convert a RADIANCE animation to TIFF frames
|
| 5 |
|
|
.SH SYNOPSIS
|
| 6 |
|
|
.B ran2tiff
|
| 7 |
|
|
[
|
| 8 |
|
|
.B "-W prev_frame_wt"
|
| 9 |
|
|
][
|
| 10 |
|
|
.B "-H histo"
|
| 11 |
|
|
][
|
| 12 |
|
|
.B "-D dir"
|
| 13 |
|
|
]
|
| 14 |
|
|
[
|
| 15 |
|
|
.B "pcond opts"
|
| 16 |
|
|
]
|
| 17 |
|
|
[
|
| 18 |
|
|
.B "ra_tiff opts"
|
| 19 |
|
|
]
|
| 20 |
greg |
1.3 |
.B "frame1.hdr frame2.hdr .."
|
| 21 |
greg |
1.1 |
.SH DESCRIPTION
|
| 22 |
|
|
.I Ran2tiff
|
| 23 |
|
|
takes an animated sequence of Radiance pictures and converts them by calling
|
| 24 |
|
|
.I pcond(1)
|
| 25 |
|
|
and
|
| 26 |
|
|
.I ra_tiff(1)
|
| 27 |
|
|
in such a way that exposure changes gradually
|
| 28 |
|
|
from one frame to the next.
|
| 29 |
|
|
It accomplishes this by computing a histogram for each image and
|
| 30 |
|
|
blending it with a weighted histogram from the previous frame,
|
| 31 |
|
|
where the weight is set by the
|
| 32 |
|
|
.I \-W
|
| 33 |
|
|
option, or 0.9 by default.
|
| 34 |
|
|
A value of 0.5 would mean that the previous frame carries 1/2 the weight
|
| 35 |
|
|
of the current one, and the frame before that 1/4, 1/8 before that,
|
| 36 |
|
|
and so on.
|
| 37 |
|
|
.PP
|
| 38 |
|
|
The
|
| 39 |
|
|
.I \-H
|
| 40 |
|
|
option specifies a histogram file to be used to ensure continuous
|
| 41 |
|
|
exposure between the current sequence and one before it.
|
| 42 |
|
|
If the file does not exist, it will be created at the end of
|
| 43 |
|
|
the conversion.
|
| 44 |
|
|
If it does exist, its contents will be used as the histogram
|
| 45 |
|
|
at the end of the previous sequence.
|
| 46 |
|
|
.PP
|
| 47 |
|
|
The
|
| 48 |
|
|
.I \-D
|
| 49 |
|
|
option may be used to specify an output directory for the resulting
|
| 50 |
|
|
TIFF frames.
|
| 51 |
|
|
Otherwise, the current directory will be used.
|
| 52 |
|
|
The output file names will correspond to the input names, but
|
| 53 |
|
|
with a ".tif" suffix.
|
| 54 |
|
|
.PP
|
| 55 |
|
|
Ran2tiff also accepts the standard options for
|
| 56 |
|
|
.I pcond
|
| 57 |
|
|
and
|
| 58 |
|
|
.I ra_tiff,
|
| 59 |
|
|
though output to LogLuv TIFF formats is not supported.
|
| 60 |
|
|
(There would be no point in adjusting the exposure if the output were HDR.)\0
|
| 61 |
|
|
.SH EXAMPLE
|
| 62 |
|
|
To convert a sequence of frames using a rapid human exposure response
|
| 63 |
|
|
and LZW compression on the output:
|
| 64 |
|
|
.IP "" .2i
|
| 65 |
greg |
1.3 |
ran2tiff \-W 0.7 \-h \-z frame*.hdr
|
| 66 |
greg |
1.1 |
.PP
|
| 67 |
|
|
Similar to
|
| 68 |
|
|
.I fieldcomb(1),
|
| 69 |
|
|
this program works well with the "TRANSFER" facility of
|
| 70 |
|
|
.I ranimate(1).
|
| 71 |
|
|
.SH AUTHOR
|
| 72 |
|
|
Greg Ward
|
| 73 |
|
|
.SH "SEE ALSO"
|
| 74 |
|
|
fieldcomb(1), getinfo(1), pcond(1), pfilt(1), phisto(1),
|
| 75 |
|
|
ra_tiff(1), ranimate(1), rpict(1)
|
