ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/Development/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.8 by greg, Thu Dec 18 23:26:57 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 370 | Line 371 | The default value is 0.
371   .BR PICTURE
372   This is the root name of the output picture file(s).
373   This name will have appended the view identifier (or a number if no
374 < id was used) and a ".pic" suffix.
374 > id was used) and a ".hdr" suffix.
375   If a picture corresponding to a specific view exists and is not out
376   of date with respect to the given octree, it will not be
377   re-rendered.
# 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 471 | Line 472 | There is no default value for this variable.
472   .BR oconv
473   This variable may be used to specify special options to
474   .I oconv.
475 + If the first word of the first instance of this variable is not an option,
476 + it will be used in place of the default command path, "oconv".
477   See the
478   .I oconv(1)
479   manual page for a list of valid options.
# Line 478 | Line 481 | manual page for a list of valid options.
481   .BR mkillum
482   This variable may be used to specify additional options to
483   .I mkillum.
484 + If the first word of the first instance of this variable is not an option,
485 + it will be used in place of the default command path, "mkillum".
486   See the
487   .I rtrace(1)
488   manual page for a list of valid options.
# Line 486 | Line 491 | manual page for a list of valid options.
491   This variable may be used to specify additional options to
492   .I rpict
493   or
494 < .I rview.
494 > .I rvu.
495   These options will appear after the options set automatically by
496   .I rad,
497   and thus will override the default values.
498   .TP
499 + .BR rpict
500 + This variable may be used to specify overriding options specific to
501 + .I rpict.
502 + If the first word of the first instance of this variable is not an option,
503 + it will be used in place of the default command path, "rpict".
504 + See the
505 + .I rpict(1)
506 + man page for a list of valid options.
507 + .TP
508 + .BR rvu
509 + This variable may be used to specify overriding options specific to
510 + .I rvu.
511 + If the first word of the first instance of this variable is not an option,
512 + it will be used in place of the default command path, "rvu".
513 + See the
514 + .I rvu(1)
515 + man page for a list of valid options.
516 + .TP
517   .BR pfilt
518   This variable may be used to specify additional options to
519   .I pfilt.
520 + If the first word of the first instance of this variable is not an option,
521 + it will be used in place of the default command path, "pfilt".
522   See the
523   .I pfilt(1)
524   manual page for details.
# Line 526 | Line 551 | If we only want to see what default values
551   .I rad
552   would use without actually executing anything, we can invoke it thus:
553   .IP "" .2i
554 < rad -n -e sample.rif
554 > rad \-n \-e sample.rif
555   .PP
556   This will print the variables we have given as well as default
557   values
# Line 543 | Line 568 | result as it is needed to determine some of the opiton
568   Different option combinations have specific uses, ie:
569   .IP "" .2i
570   .br
571 < rad -v 0 sample.rif OPT=samp.opt        # build octree, put options in "sample.opt"
571 > rad \-v 0 sample.rif OPT=samp.opt       # build octree, put options in "sample.opt"
572   .br
573 < rad -n -e -s sample.rif > full.rif      # make a complete rad file
573 > rad \-n \-e \-s sample.rif > full.rif   # make a complete rad file
574   .br
575 < rad -n sample.rif > script.sh   # make a script of commands
575 > rad \-n sample.rif > script.sh  # make a script of commands
576   .br
577 < rad -V -v Zl -n -s sample.rif > plan.vf # make a plan view file
577 > rad \-V \-v Zl \-n \-s sample.rif > plan.vf     # make a plan view file
578   .br
579 < rad -t sample.rif               # update files after minor change to input
579 > rad \-t sample.rif              # update files after minor change to input
580   .br
581 < rad -s sample.rif &             # execute silently in the background
581 > rad \-s sample.rif &            # execute silently in the background
582   .PP
583   If we decide that the default values
584   .I rad
# Line 565 | Line 590 | QUAL= MED              # default was low
590   DET= low                # default was medium - our space is almost empty
591   PEN= True               # we want to see soft shadows from our window
592   VAR= hi         # daylight can result in fairly harsh lighting
593 < view= XYa -vv 120       # let's try a fisheye view
594 < PICT= tutor             # our picture name will be "tutor_XYa.pic"
593 > view= XYa \-vv 120      # let's try a fisheye view
594 > PICT= tutor             # our picture name will be "tutor_XYa.hdr"
595   .fi
596   .PP
597   Note the use of abbreviations, and the modification of a standard
# Line 574 | Line 599 | view.
599   Now we can invoke
600   .I rad
601   to take a look at our scene interactively with
602 < .I rview:
602 > .I rvu:
603   .IP "" .2i
604 < rad -o x11 sample.rif
604 > rad \-o x11 sample.rif
605   .PP
606   .I Rad
607   will run
608   .I oconv
609   first to create the octree (assuming it doesn't
610   already exist), then
611 < .I rview
611 > .I rvu
612   with a long list of options.
613   Let's say that from within
614 < .I rview,
614 > .I rvu,
615   we wrote out the view files "view1.vp" and "view2.vp".
616   We could add these to "sample.rif" like so:
617   .IP "" .2i
618   .nf
619 < view= vw1 -vf view1.vp          # Our first view
620 < view= vw2 -vf view2.vp          # Our second view
619 > view= vw1 \-vf view1.vp         # Our first view
620 > view= vw2 \-vf view2.vp         # Our second view
621   RESOLUTION= 1024                # Let's go for a higher resolution result
622   .fi
623   .PP
624   To start
625 < .I rview
625 > .I rvu
626   again using vw2 instead of the default, we use:
627   .IP "" .2i
628 < rad -o x11 -v vw2 sample.rif
628 > rad \-o x11 \-v vw2 sample.rif
629   .PP
630   Once we are happy with the variable settings in our file, we can run
631   .I rad
# Line 653 | Line 678 | problematic on systems that don't distinguish case in
678   .SH "SEE ALSO"
679   glrad(1), make(1), mkillum(1), objview(1), oconv(1),
680   pfilt(1), raddepend(1), ranimate(1),
681 < rholo(1), rpict(1), rtrace(1), rview(1), touch(1), vgaimage(1), ximage(1)
681 > rholo(1), rpict(1), rtrace(1), rvu(1), touch(1), vgaimage(1), ximage(1)

Diff Legend

– Removed lines
+ Added lines
< Changed lines (old)
> Changed lines (new)