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.1 by greg, Tue Mar 11 19:20:21 2003 UTC vs.
Revision 1.9 by greg, Tue May 18 00:32:23 2010 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 7 | Line 7 | rad - render a RADIANCE scene
7   [
8   .B \-s
9   ][
10 < .B \-n
10 > .B "-n|-N npr"
11   ][
12   .B \-t
13   ][
# 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 57 | Line 57 | option tells
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
# Line 124 | 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 193 | 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 288 | 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 296 | 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 311 | 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 363 | 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 398 | 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 438 | 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 464 | 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 471 | 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 479 | 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 519 | 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 536 | 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 > .br
583 > rad \-N 2 sample.rif    # render views using two parallel rpict calls
584 > .br
585 > rad \-N 4 -v 1 sample.rif       # render first view with four rpiece calls
586   .PP
587   If we decide that the default values
588   .I rad
# Line 558 | Line 594 | QUAL= MED              # default was low
594   DET= low                # default was medium - our space is almost empty
595   PEN= True               # we want to see soft shadows from our window
596   VAR= hi         # daylight can result in fairly harsh lighting
597 < view= XYa -vv 120       # let's try a fisheye view
598 < PICT= tutor             # our picture name will be "tutor_XYa.pic"
597 > view= XYa \-vv 120      # let's try a fisheye view
598 > PICT= tutor             # our picture name will be "tutor_XYa.hdr"
599   .fi
600   .PP
601   Note the use of abbreviations, and the modification of a standard
# Line 567 | Line 603 | view.
603   Now we can invoke
604   .I rad
605   to take a look at our scene interactively with
606 < .I rview:
606 > .I rvu:
607   .IP "" .2i
608 < rad -o x11 sample.rif
608 > rad \-o x11 sample.rif
609   .PP
610   .I Rad
611   will run
612   .I oconv
613   first to create the octree (assuming it doesn't
614   already exist), then
615 < .I rview
615 > .I rvu
616   with a long list of options.
617   Let's say that from within
618 < .I rview,
618 > .I rvu,
619   we wrote out the view files "view1.vp" and "view2.vp".
620   We could add these to "sample.rif" like so:
621   .IP "" .2i
622   .nf
623 < view= vw1 -vf view1.vp          # Our first view
624 < view= vw2 -vf view2.vp          # Our second view
623 > view= vw1 \-vf view1.vp         # Our first view
624 > view= vw2 \-vf view2.vp         # Our second view
625   RESOLUTION= 1024                # Let's go for a higher resolution result
626   .fi
627   .PP
628   To start
629 < .I rview
629 > .I rvu
630   again using vw2 instead of the default, we use:
631   .IP "" .2i
632 < rad -o x11 -v vw2 sample.rif
632 > rad \-o x11 \-v vw2 sample.rif
633   .PP
634   Once we are happy with the variable settings in our file, we can run
635   .I rad
# Line 608 | Line 644 | $(PICTURE)_$(view).unf Unfinished output of
644   .SH AUTHOR
645   Greg Ward
646   .SH BUGS
647 + You cannot run more than one
648 + .I rad
649 + process at a time on the same input file,
650 + as the second process will attempt to recover the output files
651 + of the first process, damaging the results.
652 + The exceptions to this are running interactively via the
653 + .I \-o
654 + option, or rendering different views using the
655 + .I \-v
656 + option.
657 + .PP
658   Incremental building of octrees is not supported as it would add
659   considerable complexity to
660   .I rad.
# Line 646 | Line 693 | problematic on systems that don't distinguish case in
693   .SH "SEE ALSO"
694   glrad(1), make(1), mkillum(1), objview(1), oconv(1),
695   pfilt(1), raddepend(1), ranimate(1),
696 < rholo(1), rpict(1), rtrace(1), rview(1), touch(1), vgaimage(1), ximage(1)
696 > rholo(1), rpict(1), rpiece(1), rtrace(1), rvu(1),
697 > touch(1), vgaimage(1), ximage(1)

Diff Legend

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