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.5 by greg, Tue Sep 4 17:36:40 2007 UTC vs.
Revision 1.9 by greg, Tue May 18 00:32:23 2010 UTC

# 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 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 554 | Line 579 | rad \-V \-v Zl \-n \-s sample.rif > plan.vf    # make a p
579   rad \-t sample.rif              # update files after minor change to input
580   .br
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 566 | Line 595 | DET= low               # default was medium - our space is almost e
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"
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 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