| 1 |
< |
.\" RCSid "$Id" |
| 1 |
> |
.\" RCSid "$Id$" |
| 2 |
|
.TH RANIMATE 1 6/24/98 RADIANCE |
| 3 |
|
.SH NAME |
| 4 |
|
ranimate - compute a RADIANCE animation |
| 157 |
|
As in |
| 158 |
|
.I pfilt, |
| 159 |
|
the exposure setting may be given either as a multiplier or as a |
| 160 |
< |
number of f-stop adjustments (eg. +2 or -1.5). |
| 160 |
> |
number of f\-stop adjustments (eg. +2 or \-1.5). |
| 161 |
|
Alternatively, a file name may be given, which |
| 162 |
|
.I ranimate |
| 163 |
|
will interpret as having one exposure value per line per frame, |
| 180 |
|
and thus should contain a |
| 181 |
|
.I printf(3) |
| 182 |
|
style integer field to distinguish one frame number from another. |
| 183 |
< |
The final frames will use this name with a ".pic" suffix. |
| 183 |
> |
The final frames will use this name with a ".hdr" suffix. |
| 184 |
|
The default value is the assigned |
| 185 |
|
.I DIRECTORY |
| 186 |
|
followed by "/frame%03d". |
| 271 |
|
Normally, the transfer command does something such as convert the |
| 272 |
|
frames to another format and/or copy them to tape or some other |
| 273 |
|
destination device before removing them. |
| 274 |
+ |
The |
| 275 |
+ |
.I fieldcomb(1) |
| 276 |
+ |
script may be used to conveniently combine fields into frames for |
| 277 |
+ |
field-based animations. |
| 278 |
|
If this variable is not given, the final frames are left where they |
| 279 |
|
are. |
| 280 |
|
(See |
| 283 |
|
.TP |
| 284 |
|
.BR RSH |
| 285 |
|
The command to use instead of |
| 286 |
< |
.I rsh(1) |
| 286 |
> |
.I ssh(1) |
| 287 |
|
to execute commands remotely on another machine. |
| 288 |
|
The arguments and behavior of this program must be identical to the UNIX |
| 289 |
< |
.I rsh |
| 289 |
> |
.I ssh |
| 290 |
|
command, except that the |
| 291 |
|
.I -l |
| 292 |
|
option will always be used to specify an alternate user name rather than the |
| 293 |
|
.I "user@host" |
| 294 |
|
convention. |
| 295 |
< |
Th |
| 295 |
> |
The |
| 296 |
|
.I -l |
| 297 |
|
option may or may not appear, but the |
| 298 |
|
.I -n |
| 299 |
|
option will always be used, and the expected starting directory will |
| 300 |
|
be that of the remote user, just as with |
| 301 |
< |
.I rsh. |
| 301 |
> |
.I ssh. |
| 302 |
|
.TP |
| 303 |
|
.BR NEXTANIM |
| 304 |
|
This variable specifies the next |
| 356 |
|
only, resulting in greater noise than the combination of |
| 357 |
|
.I rpict |
| 358 |
|
and |
| 359 |
< |
.I pinterp used otherwise. |
| 359 |
> |
.I pinterp |
| 360 |
> |
used otherwise. |
| 361 |
|
(The default value for number of samples is 5.)\0 |
| 362 |
< |
The |
| 363 |
< |
.I pmblur(1) |
| 364 |
< |
command is used to generate the given number of additional views for |
| 362 |
> |
The default fraction is 0, meaning no motion blurring. |
| 363 |
> |
This option does not currently work with the |
| 364 |
> |
.I ANIMATE |
| 365 |
> |
variable, since pinterp only works for static environments. |
| 366 |
> |
.TP |
| 367 |
> |
.BR DBLUR |
| 368 |
> |
This variable specifies the aperture diameter for depth-of-field blurring, |
| 369 |
> |
in world units. |
| 370 |
> |
A number of samples may be given as a second argument, which controls the |
| 371 |
> |
number of additional frames computed and averaged together by |
| 372 |
> |
.I pinterp. |
| 373 |
> |
If this number is less than 2, then blurring is performed by |
| 374 |
> |
.I rpict |
| 375 |
> |
only, resulting in greater noise than the combination of |
| 376 |
> |
.I rpict |
| 377 |
> |
and |
| 378 |
|
.I pinterp |
| 379 |
< |
to average together. |
| 380 |
< |
The default value is 0, meaning no motion blurring. |
| 379 |
> |
used otherwise. |
| 380 |
> |
(The default value for number of samples is 5.)\0 |
| 381 |
> |
To simulate a particular camera's aperture, divide the focal length of |
| 382 |
> |
the lens by the f-number, then convert to the corresponding |
| 383 |
> |
world coordinate units. |
| 384 |
> |
For example, if you wish to simulate a 50mm lens at f/2.0 in |
| 385 |
> |
a scene modeled in meters, then you divide 50mm by 2.0 to get 25mm, |
| 386 |
> |
which corresponds to an effective aperture of 0.025 meters. |
| 387 |
> |
The default aperture is 0, meaning no depth-of-field blurring. |
| 388 |
|
This option does not currently work with the |
| 389 |
|
.I ANIMATE |
| 390 |
|
variable, since pinterp only works for static environments. |
| 489 |
|
would use without actually executing anything, we can invoke it |
| 490 |
|
thus: |
| 491 |
|
.IP "" .2i |
| 492 |
< |
ranimate -n -e sample.ran |
| 492 |
> |
ranimate \-n \-e sample.ran |
| 493 |
|
.PP |
| 494 |
|
This will print the variables we have given as well as default |
| 495 |
|
values |
| 520 |
|
RES= 1024 # shoot for 1024x resolution |
| 521 |
|
MBLUR= .25 # apply camera motion blur |
| 522 |
|
EXP= anim1.exp # adjust exposure according to file |
| 523 |
< |
pfilt= -r .9 # use Gaussian filtering |
| 523 |
> |
pfilt= \-r .9 # use Gaussian filtering |
| 524 |
|
ARCHIVE= tar cf /dev/nrtape # save original renderings to tape |
| 525 |
|
.fi |
| 526 |
|
.PP |
| 528 |
|
.SH FILES |
| 529 |
|
$(DIRECTORY)/STATUS animation status file |
| 530 |
|
$(DIRECTORY)/* other temporary files |
| 531 |
< |
$(BASENAME).pic final animation frames |
| 531 |
> |
$(BASENAME).hdr final animation frames |
| 532 |
|
.SH AUTHOR |
| 533 |
|
Greg Ward |
| 534 |
|
.SH BUGS |
| 585 |
|
This requirement may be circumvented by substituting the |
| 586 |
|
.I on(1) |
| 587 |
|
command for |
| 588 |
< |
.I rsh(1) |
| 588 |
> |
.I ssh(1) |
| 589 |
|
using the |
| 590 |
|
.I RSH |
| 591 |
|
control variable, or by writing a custom remote execution script. |
| 609 |
|
Since most modern machines use IEEE floating point, this is not |
| 610 |
|
usually a problem, but it is something to keep in mind. |
| 611 |
|
.SH "SEE ALSO" |
| 612 |
< |
pfilt(1), pinterp(1), pmblur(1), rad(1), |
| 613 |
< |
ranimove(1), rpict(1), rsh(1), rtrace(1) |
| 612 |
> |
fieldcomb(1), pfilt(1), pinterp(1), pmblur(1), rad(1), |
| 613 |
> |
ran2tiff(1), ranimove(1), rpict(1), ssh(1), rtrace(1) |
