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.4 by greg, Thu Jan 1 19:31:45 2004 UTC vs.
Revision 1.10 by greg, Thu Jun 16 14:22:08 2011 UTC

# Line 7 | Line 7 | rad - render a RADIANCE scene
7   [
8   .B \-s
9   ][
10 < .B "-n|-N npr"
10 > .B "-n | -N npr"
11   ][
12   .B \-t
13   ][
# Line 207 | Line 207 | As in
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 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 491 | Line 496 | These options will appear after the options set automa
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 > .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 565 | 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 576 | Line 605 | Now we can invoke
605   to take a look at our scene interactively with
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
# Line 591 | Line 620 | 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
# Line 600 | Line 629 | To start
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 615 | 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 653 | 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), rvu(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