| 1 |
< |
.\" RCSid "$Id" |
| 1 |
> |
.\" RCSid "$Id$" |
| 2 |
|
.TH RAD 1 2/1/99 RADIANCE |
| 3 |
|
.SH NAME |
| 4 |
|
rad - render a RADIANCE scene |
| 7 |
|
[ |
| 8 |
|
.B \-s |
| 9 |
|
][ |
| 10 |
< |
.B \-n |
| 10 |
> |
.B "-n|-N npr" |
| 11 |
|
][ |
| 12 |
|
.B \-t |
| 13 |
|
][ |
| 35 |
|
.I rpict(1), |
| 36 |
|
.I pfilt(1), |
| 37 |
|
and/or |
| 38 |
< |
.I rview(1) |
| 38 |
> |
.I rvu(1) |
| 39 |
|
to render a specific scene. |
| 40 |
|
Variables in |
| 41 |
|
.I rfile |
| 57 |
|
.I rad |
| 58 |
|
not to take any action (ie. not to actually execute any commands). |
| 59 |
|
The |
| 60 |
+ |
.I \-N |
| 61 |
+ |
option instructs |
| 62 |
+ |
.I rad |
| 63 |
+ |
to run as many as |
| 64 |
+ |
.I npr |
| 65 |
+ |
rendering processes in parallel. |
| 66 |
+ |
The |
| 67 |
|
.I \-t |
| 68 |
|
option tells |
| 69 |
|
.I rad |
| 131 |
|
The |
| 132 |
|
.I \-o |
| 133 |
|
option specifies an output device for |
| 134 |
< |
.I rview |
| 134 |
> |
.I rvu |
| 135 |
|
(usually "x11") |
| 136 |
|
and runs this interactive program instead, using the first view in |
| 137 |
|
.I rfile |
| 200 |
|
It is important to set this variable properly as it is used to |
| 201 |
|
determine the ambient value. |
| 202 |
|
An appropriate setting may be discovered by running |
| 203 |
< |
.I rview |
| 203 |
> |
.I rvu |
| 204 |
|
and noting the exposure given by the "exposure =" command. |
| 205 |
|
As in |
| 206 |
< |
.I rview |
| 206 |
> |
.I rvu |
| 207 |
|
and |
| 208 |
|
.I pfilt, |
| 209 |
|
the exposure setting may be given either as a multiplier or as a |
| 210 |
< |
number of f-stop adjustments (eg. +2 or -1.5). |
| 210 |
> |
number of f\-stop adjustments (eg. +2 or \-1.5). |
| 211 |
|
There is no default value for this variable. |
| 212 |
|
If it is not given, an average level will be computed by |
| 213 |
|
.I pfilt |
| 295 |
|
Also, there are several standard view identifiers defined by |
| 296 |
|
.I rad. |
| 297 |
|
These standard views are specified by strings of the form |
| 298 |
< |
"[Xx]?[Yy]?[Zz]?[vlcah]?". |
| 298 |
> |
"[Xx]?[Yy]?[Zz]?[vlcahs]?". |
| 299 |
|
(That is, an optional upper or lower case X followed by an optional |
| 300 |
|
upper or lower case Y followed by an optional upper or lower case Z |
| 301 |
|
followed by an optional lower case V, L, C, A or H.)\0 |
| 303 |
|
means maximum X, lower case means minimum and so on. |
| 304 |
|
The final letter is the view type, where 'v' is perspective (the |
| 305 |
|
default), 'l' is parallel, 'c' is a cylindrical panorama, |
| 306 |
< |
'a' is angular fisheye, and 'h' is hemispherical fisheye. |
| 306 |
> |
'a' is angular fisheye, 'h' is hemispherical fisheye, and 's' |
| 307 |
> |
is a planisphere (stereographic) fisheye. |
| 308 |
|
A perspective view from maximum X, minimum Y would be "Xy" or "Xyv". |
| 309 |
|
A parallel view from maximum Z would be "Zl". |
| 310 |
|
If "ZONE" is an interior zone, the standard views will |
| 319 |
|
.TP |
| 320 |
|
.BR UP |
| 321 |
|
The vertical axis for this scene. |
| 322 |
< |
A negative axis may be specified with a minus sign (eg. "-Y"). |
| 322 |
> |
A negative axis may be specified with a minus sign (eg. "\-Y"). |
| 323 |
|
There is no default value for this variable, although the standard |
| 324 |
|
views assume Z is up if no other axis is specified. |
| 325 |
|
.TP |
| 406 |
|
values will be stored by |
| 407 |
|
.I rpict |
| 408 |
|
or |
| 409 |
< |
.I rview. |
| 409 |
> |
.I rvu. |
| 410 |
|
Although it is not required, an ambient file should be given whenever |
| 411 |
|
an interreflection calculation is expected. |
| 412 |
|
This will optimize successive runs and minimize artifacts. |
| 446 |
|
This file can later be accessed by |
| 447 |
|
.I rpict |
| 448 |
|
or |
| 449 |
< |
.I rview |
| 449 |
> |
.I rvu |
| 450 |
|
in subsequent manual runs using the at-sign ('@') file insert option. |
| 451 |
|
(Using an "OPTFILE" also reduces the length of the rendering |
| 452 |
|
command, which improves appearance and may even be necessary on some |
| 487 |
|
This variable may be used to specify additional options to |
| 488 |
|
.I rpict |
| 489 |
|
or |
| 490 |
< |
.I rview. |
| 490 |
> |
.I rvu. |
| 491 |
|
These options will appear after the options set automatically by |
| 492 |
|
.I rad, |
| 493 |
|
and thus will override the default values. |
| 527 |
|
.I rad |
| 528 |
|
would use without actually executing anything, we can invoke it thus: |
| 529 |
|
.IP "" .2i |
| 530 |
< |
rad -n -e sample.rif |
| 530 |
> |
rad \-n \-e sample.rif |
| 531 |
|
.PP |
| 532 |
|
This will print the variables we have given as well as default |
| 533 |
|
values |
| 544 |
|
Different option combinations have specific uses, ie: |
| 545 |
|
.IP "" .2i |
| 546 |
|
.br |
| 547 |
< |
rad -v 0 sample.rif OPT=samp.opt # build octree, put options in "sample.opt" |
| 547 |
> |
rad \-v 0 sample.rif OPT=samp.opt # build octree, put options in "sample.opt" |
| 548 |
|
.br |
| 549 |
< |
rad -n -e -s sample.rif > full.rif # make a complete rad file |
| 549 |
> |
rad \-n \-e \-s sample.rif > full.rif # make a complete rad file |
| 550 |
|
.br |
| 551 |
< |
rad -n sample.rif > script.sh # make a script of commands |
| 551 |
> |
rad \-n sample.rif > script.sh # make a script of commands |
| 552 |
|
.br |
| 553 |
< |
rad -V -v Zl -n -s sample.rif > plan.vf # make a plan view file |
| 553 |
> |
rad \-V \-v Zl \-n \-s sample.rif > plan.vf # make a plan view file |
| 554 |
|
.br |
| 555 |
< |
rad -t sample.rif # update files after minor change to input |
| 555 |
> |
rad \-t sample.rif # update files after minor change to input |
| 556 |
|
.br |
| 557 |
< |
rad -s sample.rif & # execute silently in the background |
| 557 |
> |
rad \-s sample.rif & # execute silently in the background |
| 558 |
|
.PP |
| 559 |
|
If we decide that the default values |
| 560 |
|
.I rad |
| 566 |
|
DET= low # default was medium - our space is almost empty |
| 567 |
|
PEN= True # we want to see soft shadows from our window |
| 568 |
|
VAR= hi # daylight can result in fairly harsh lighting |
| 569 |
< |
view= XYa -vv 120 # let's try a fisheye view |
| 569 |
> |
view= XYa \-vv 120 # let's try a fisheye view |
| 570 |
|
PICT= tutor # our picture name will be "tutor_XYa.pic" |
| 571 |
|
.fi |
| 572 |
|
.PP |
| 575 |
|
Now we can invoke |
| 576 |
|
.I rad |
| 577 |
|
to take a look at our scene interactively with |
| 578 |
< |
.I rview: |
| 578 |
> |
.I rvu: |
| 579 |
|
.IP "" .2i |
| 580 |
< |
rad -o x11 sample.rif |
| 580 |
> |
rad \-o x11 sample.rif |
| 581 |
|
.PP |
| 582 |
|
.I Rad |
| 583 |
|
will run |
| 584 |
|
.I oconv |
| 585 |
|
first to create the octree (assuming it doesn't |
| 586 |
|
already exist), then |
| 587 |
< |
.I rview |
| 587 |
> |
.I rvu |
| 588 |
|
with a long list of options. |
| 589 |
|
Let's say that from within |
| 590 |
< |
.I rview, |
| 590 |
> |
.I rvu, |
| 591 |
|
we wrote out the view files "view1.vp" and "view2.vp". |
| 592 |
|
We could add these to "sample.rif" like so: |
| 593 |
|
.IP "" .2i |
| 594 |
|
.nf |
| 595 |
< |
view= vw1 -vf view1.vp # Our first view |
| 596 |
< |
view= vw2 -vf view2.vp # Our second view |
| 595 |
> |
view= vw1 \-vf view1.vp # Our first view |
| 596 |
> |
view= vw2 \-vf view2.vp # Our second view |
| 597 |
|
RESOLUTION= 1024 # Let's go for a higher resolution result |
| 598 |
|
.fi |
| 599 |
|
.PP |
| 600 |
|
To start |
| 601 |
< |
.I rview |
| 601 |
> |
.I rvu |
| 602 |
|
again using vw2 instead of the default, we use: |
| 603 |
|
.IP "" .2i |
| 604 |
< |
rad -o x11 -v vw2 sample.rif |
| 604 |
> |
rad \-o x11 \-v vw2 sample.rif |
| 605 |
|
.PP |
| 606 |
|
Once we are happy with the variable settings in our file, we can run |
| 607 |
|
.I rad |
| 654 |
|
.SH "SEE ALSO" |
| 655 |
|
glrad(1), make(1), mkillum(1), objview(1), oconv(1), |
| 656 |
|
pfilt(1), raddepend(1), ranimate(1), |
| 657 |
< |
rholo(1), rpict(1), rtrace(1), rview(1), touch(1), vgaimage(1), ximage(1) |
| 657 |
> |
rholo(1), rpict(1), rtrace(1), rvu(1), touch(1), vgaimage(1), ximage(1) |
