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.6 by greg, Tue Mar 11 02:21:45 2008 UTC vs.
Revision 1.12 by greg, Fri Jan 1 19:14:43 2021 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 371 | 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 439 | Line 439 | For a space with penetrating sunlight casting bright p
439   few places, it should be set to HIGH.
440   The default value is "L".
441   .TP
442 + .BR PGMAP
443 + This variable designates a global photon map to be generated by
444 + .I mkpmap(1)
445 + and used to accelerate rendering.
446 + The file name must be followed by the number of photons to be stored
447 + in the map, and this number may be followed by a bandwidth for rendering,
448 + which can be two arguments if bias compensation is desired.
449 + There is no default value, meaning that a global photon map will not
450 + normally be created.
451 + .TP
452 + .BR PCMAP
453 + This variable designates a caustic photon map to be generated by
454 + .I mkpmap(1)
455 + and used during renderings to model light transmission by reflecting
456 + and refracting surfaces.
457 + The file name must be followed by the number of photons to be stored
458 + in the map, and this number may be followed by a bandwidth for rendering,
459 + which can be two arguments if bias compensation is desired.
460 + There is no default value, meaning that a caustic photon map will not
461 + normally be created.
462 + .TP
463   .BR OPTFILE
464   This is the name of a file in which
465   .I rad
# Line 472 | Line 493 | There is no default value for this variable.
493   .BR oconv
494   This variable may be used to specify special options to
495   .I oconv.
496 + If the first word of the first instance of this variable is not an option,
497 + it will be used in place of the default command path, "oconv".
498   See the
499   .I oconv(1)
500   manual page for a list of valid options.
# Line 479 | Line 502 | manual page for a list of valid options.
502   .BR mkillum
503   This variable may be used to specify additional options to
504   .I mkillum.
505 + If the first word of the first instance of this variable is not an option,
506 + it will be used in place of the default command path, "mkillum".
507   See the
508   .I rtrace(1)
509   manual page for a list of valid options.
510   .TP
511 + .BR mkpmap
512 + This variable may be used to specify additional options to
513 + .I mkpmap.
514 + If the first word of the first instance of this variable is not an option,
515 + it will be used in place of the default command path, "mkpmap".
516 + See the
517 + .I mkpmap(1)
518 + manual page for a list of valid options.
519 + .TP
520   .BR render
521   This variable may be used to specify additional options to
522   .I rpict
# Line 492 | Line 526 | These options will appear after the options set automa
526   .I rad,
527   and thus will override the default values.
528   .TP
529 + .BR rpict
530 + This variable may be used to specify overriding options specific to
531 + .I rpict.
532 + If the first word of the first instance of this variable is not an option,
533 + it will be used in place of the default command path, "rpict".
534 + See the
535 + .I rpict(1)
536 + man page for a list of valid options.
537 + .TP
538 + .BR rvu
539 + This variable may be used to specify overriding options specific to
540 + .I rvu.
541 + If the first word of the first instance of this variable is not an option,
542 + it will be used in place of the default command path, "rvu".
543 + See the
544 + .I rvu(1)
545 + man page for a list of valid options.
546 + .TP
547   .BR pfilt
548   This variable may be used to specify additional options to
549   .I pfilt.
550 + If the first word of the first instance of this variable is not an option,
551 + it will be used in place of the default command path, "pfilt".
552   See the
553   .I pfilt(1)
554   manual page for details.
# Line 555 | Line 609 | rad \-V \-v Zl \-n \-s sample.rif > plan.vf    # make a p
609   rad \-t sample.rif              # update files after minor change to input
610   .br
611   rad \-s sample.rif &            # execute silently in the background
612 + .br
613 + rad \-N 2 sample.rif    # render views using two parallel rpict calls
614 + .br
615 + rad \-N 4 -v 1 sample.rif       # render first view with four rpiece calls
616   .PP
617   If we decide that the default values
618   .I rad
# Line 567 | Line 625 | DET= low               # default was medium - our space is almost e
625   PEN= True               # we want to see soft shadows from our window
626   VAR= hi         # daylight can result in fairly harsh lighting
627   view= XYa \-vv 120      # let's try a fisheye view
628 < PICT= tutor             # our picture name will be "tutor_XYa.pic"
628 > PICT= tutor             # our picture name will be "tutor_XYa.hdr"
629   .fi
630   .PP
631   Note the use of abbreviations, and the modification of a standard
# Line 616 | Line 674 | $(PICTURE)_$(view).unf Unfinished output of
674   .SH AUTHOR
675   Greg Ward
676   .SH BUGS
677 + You cannot run more than one
678 + .I rad
679 + process at a time on the same input file,
680 + as the second process will attempt to recover the output files
681 + of the first process, damaging the results.
682 + The exceptions to this are running interactively via the
683 + .I \-o
684 + option, or rendering different views using the
685 + .I \-v
686 + option.
687 + .PP
688   Incremental building of octrees is not supported as it would add
689   considerable complexity to
690   .I rad.
# Line 652 | Line 721 | accurately determine the ambient value for
721   The use of upper and lower case naming for the standard views may be
722   problematic on systems that don't distinguish case in filenames.
723   .SH "SEE ALSO"
724 < glrad(1), make(1), mkillum(1), objview(1), oconv(1),
724 > glrad(1), make(1), mkillum(1), mkpmap(1), objview(1), oconv(1),
725   pfilt(1), raddepend(1), ranimate(1),
726 < rholo(1), rpict(1), rtrace(1), rvu(1), touch(1), vgaimage(1), ximage(1)
726 > rholo(1), rpict(1), rpiece(1), rtrace(1), rvu(1),
727 > touch(1), vgaimage(1), ximage(1)

Diff Legend

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