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.3 by greg, Tue Dec 9 15:59:06 2003 UTC vs.
Revision 1.5 by greg, Tue Sep 4 17:36:40 2007 UTC

# 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 318 | Line 318 | generated.
318   .TP
319   .BR UP
320   The vertical axis for this scene.
321 < A negative axis may be specified with a minus sign (eg. "-Y").
321 > A negative axis may be specified with a minus sign (eg. "\-Y").
322   There is no default value for this variable, although the standard
323   views assume Z is up if no other axis is specified.
324   .TP
# Line 405 | Line 405 | This is the name of the file where "ambient" or diffus
405   values will be stored by
406   .I rpict
407   or
408 < .I rview.
408 > .I rvu.
409   Although it is not required, an ambient file should be given whenever
410   an interreflection calculation is expected.
411   This will optimize successive runs and minimize artifacts.
# Line 445 | Line 445 | will place the appropriate rendering options.
445   This file can later be accessed by
446   .I rpict
447   or
448 < .I rview
448 > .I rvu
449   in subsequent manual runs using the at-sign ('@') file insert option.
450   (Using an "OPTFILE" also reduces the length of the rendering
451   command, which improves appearance and may even be necessary on some
# Line 486 | Line 486 | manual page for a list of valid options.
486   This variable may be used to specify additional options to
487   .I rpict
488   or
489 < .I rview.
489 > .I rvu.
490   These options will appear after the options set automatically by
491   .I rad,
492   and thus will override the default values.
# Line 526 | Line 526 | If we only want to see what default values
526   .I rad
527   would use without actually executing anything, we can invoke it thus:
528   .IP "" .2i
529 < rad -n -e sample.rif
529 > rad \-n \-e sample.rif
530   .PP
531   This will print the variables we have given as well as default
532   values
# Line 543 | Line 543 | result as it is needed to determine some of the opiton
543   Different option combinations have specific uses, ie:
544   .IP "" .2i
545   .br
546 < rad -v 0 sample.rif OPT=samp.opt        # build octree, put options in "sample.opt"
546 > rad \-v 0 sample.rif OPT=samp.opt       # build octree, put options in "sample.opt"
547   .br
548 < rad -n -e -s sample.rif > full.rif      # make a complete rad file
548 > rad \-n \-e \-s sample.rif > full.rif   # make a complete rad file
549   .br
550 < rad -n sample.rif > script.sh   # make a script of commands
550 > rad \-n sample.rif > script.sh  # make a script of commands
551   .br
552 < rad -V -v Zl -n -s sample.rif > plan.vf # make a plan view file
552 > rad \-V \-v Zl \-n \-s sample.rif > plan.vf     # make a plan view file
553   .br
554 < rad -t sample.rif               # update files after minor change to input
554 > rad \-t sample.rif              # update files after minor change to input
555   .br
556 < rad -s sample.rif &             # execute silently in the background
556 > rad \-s sample.rif &            # execute silently in the background
557   .PP
558   If we decide that the default values
559   .I rad
# Line 565 | Line 565 | QUAL= MED              # default was low
565   DET= low                # default was medium - our space is almost empty
566   PEN= True               # we want to see soft shadows from our window
567   VAR= hi         # daylight can result in fairly harsh lighting
568 < view= XYa -vv 120       # let's try a fisheye view
568 > view= XYa \-vv 120      # let's try a fisheye view
569   PICT= tutor             # our picture name will be "tutor_XYa.pic"
570   .fi
571   .PP
# Line 574 | Line 574 | view.
574   Now we can invoke
575   .I rad
576   to take a look at our scene interactively with
577 < .I rview:
577 > .I rvu:
578   .IP "" .2i
579 < rad -o x11 sample.rif
579 > rad \-o x11 sample.rif
580   .PP
581   .I Rad
582   will run
583   .I oconv
584   first to create the octree (assuming it doesn't
585   already exist), then
586 < .I rview
586 > .I rvu
587   with a long list of options.
588   Let's say that from within
589 < .I rview,
589 > .I rvu,
590   we wrote out the view files "view1.vp" and "view2.vp".
591   We could add these to "sample.rif" like so:
592   .IP "" .2i
593   .nf
594 < view= vw1 -vf view1.vp          # Our first view
595 < view= vw2 -vf view2.vp          # Our second view
594 > view= vw1 \-vf view1.vp         # Our first view
595 > view= vw2 \-vf view2.vp         # Our second view
596   RESOLUTION= 1024                # Let's go for a higher resolution result
597   .fi
598   .PP
599   To start
600 < .I rview
600 > .I rvu
601   again using vw2 instead of the default, we use:
602   .IP "" .2i
603 < rad -o x11 -v vw2 sample.rif
603 > rad \-o x11 \-v vw2 sample.rif
604   .PP
605   Once we are happy with the variable settings in our file, we can run
606   .I rad
# Line 653 | Line 653 | problematic on systems that don't distinguish case in
653   .SH "SEE ALSO"
654   glrad(1), make(1), mkillum(1), objview(1), oconv(1),
655   pfilt(1), raddepend(1), ranimate(1),
656 < rholo(1), rpict(1), rtrace(1), rview(1), touch(1), vgaimage(1), ximage(1)
656 > rholo(1), rpict(1), rtrace(1), rvu(1), touch(1), vgaimage(1), ximage(1)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines