ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/rad.1
(Generate patch)

Comparing ray/doc/man/man1/rad.1 (file contents):
Revision 1.2 by greg, Thu Jul 3 15:00:19 2003 UTC vs.
Revision 1.6 by greg, Tue Mar 11 02:21:45 2008 UTC

# Line 1 | Line 1
1 < .\" RCSid "$Id"
1 > .\" RCSid "$Id$"
2   .TH RAD 1 2/1/99 RADIANCE
3   .SH NAME
4   rad - render a RADIANCE scene
# Line 35 | Line 35 | and makes appropriate calls to
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
# Line 131 | Line 131 | to produce a picture for each view.
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
# Line 200 | Line 200 | how to adjust the exposure for display.
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
# Line 295 | Line 295 | command line option.
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
# Line 303 | Line 303 | The letters indicate the desired view position, where
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
# Line 318 | Line 319 | generated.
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
# Line 405 | Line 406 | This is the name of the file where "ambient" or diffus
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.
# Line 445 | Line 446 | will place the appropriate rendering options.
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
# Line 486 | Line 487 | manual page for a list of valid options.
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.
# Line 526 | Line 527 | If we only want to see what 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
# Line 543 | Line 544 | result as it is needed to determine some of the opiton
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
# Line 565 | Line 566 | QUAL= MED              # default was low
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
# Line 574 | Line 575 | view.
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
# Line 653 | Line 654 | problematic on systems that don't distinguish case in
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)

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines