--- ray/doc/man/man1/rad.1 2003/03/11 19:20:21 1.1 +++ ray/doc/man/man1/rad.1 2007/09/04 17:36:40 1.5 @@ -1,4 +1,4 @@ -.\" RCSid "$Id" +.\" RCSid "$Id: rad.1,v 1.5 2007/09/04 17:36:40 greg Exp $" .TH RAD 1 2/1/99 RADIANCE .SH NAME rad - render a RADIANCE scene @@ -7,7 +7,7 @@ rad - render a RADIANCE scene [ .B \-s ][ -.B \-n +.B "-n|-N npr" ][ .B \-t ][ @@ -35,7 +35,7 @@ and makes appropriate calls to .I rpict(1), .I pfilt(1), and/or -.I rview(1) +.I rvu(1) to render a specific scene. Variables in .I rfile @@ -57,6 +57,13 @@ option tells .I rad not to take any action (ie. not to actually execute any commands). The +.I \-N +option instructs +.I rad +to run as many as +.I npr +rendering processes in parallel. +The .I \-t option tells .I rad @@ -124,7 +131,7 @@ to produce a picture for each view. The .I \-o option specifies an output device for -.I rview +.I rvu (usually "x11") and runs this interactive program instead, using the first view in .I rfile @@ -193,14 +200,14 @@ how to adjust the exposure for display. It is important to set this variable properly as it is used to determine the ambient value. An appropriate setting may be discovered by running -.I rview +.I rvu and noting the exposure given by the "exposure =" command. As in -.I rview +.I rvu and .I pfilt, the exposure setting may be given either as a multiplier or as a -number of f-stop adjustments (eg. +2 or -1.5). +number of f\-stop adjustments (eg. +2 or \-1.5). There is no default value for this variable. If it is not given, an average level will be computed by .I pfilt @@ -311,7 +318,7 @@ generated. .TP .BR UP The vertical axis for this scene. -A negative axis may be specified with a minus sign (eg. "-Y"). +A negative axis may be specified with a minus sign (eg. "\-Y"). There is no default value for this variable, although the standard views assume Z is up if no other axis is specified. .TP @@ -398,7 +405,7 @@ This is the name of the file where "ambient" or diffus values will be stored by .I rpict or -.I rview. +.I rvu. Although it is not required, an ambient file should be given whenever an interreflection calculation is expected. This will optimize successive runs and minimize artifacts. @@ -438,7 +445,7 @@ will place the appropriate rendering options. This file can later be accessed by .I rpict or -.I rview +.I rvu in subsequent manual runs using the at-sign ('@') file insert option. (Using an "OPTFILE" also reduces the length of the rendering command, which improves appearance and may even be necessary on some @@ -479,7 +486,7 @@ manual page for a list of valid options. This variable may be used to specify additional options to .I rpict or -.I rview. +.I rvu. These options will appear after the options set automatically by .I rad, and thus will override the default values. @@ -519,7 +526,7 @@ If we only want to see what default values .I rad would use without actually executing anything, we can invoke it thus: .IP "" .2i -rad -n -e sample.rif +rad \-n \-e sample.rif .PP This will print the variables we have given as well as default values @@ -536,17 +543,17 @@ result as it is needed to determine some of the opiton Different option combinations have specific uses, ie: .IP "" .2i .br -rad -v 0 sample.rif OPT=samp.opt # build octree, put options in "sample.opt" +rad \-v 0 sample.rif OPT=samp.opt # build octree, put options in "sample.opt" .br -rad -n -e -s sample.rif > full.rif # make a complete rad file +rad \-n \-e \-s sample.rif > full.rif # make a complete rad file .br -rad -n sample.rif > script.sh # make a script of commands +rad \-n sample.rif > script.sh # make a script of commands .br -rad -V -v Zl -n -s sample.rif > plan.vf # make a plan view file +rad \-V \-v Zl \-n \-s sample.rif > plan.vf # make a plan view file .br -rad -t sample.rif # update files after minor change to input +rad \-t sample.rif # update files after minor change to input .br -rad -s sample.rif & # execute silently in the background +rad \-s sample.rif & # execute silently in the background .PP If we decide that the default values .I rad @@ -558,7 +565,7 @@ QUAL= MED # default was low DET= low # default was medium - our space is almost empty PEN= True # we want to see soft shadows from our window VAR= hi # daylight can result in fairly harsh lighting -view= XYa -vv 120 # let's try a fisheye view +view= XYa \-vv 120 # let's try a fisheye view PICT= tutor # our picture name will be "tutor_XYa.pic" .fi .PP @@ -567,33 +574,33 @@ view. Now we can invoke .I rad to take a look at our scene interactively with -.I rview: +.I rvu: .IP "" .2i -rad -o x11 sample.rif +rad \-o x11 sample.rif .PP .I Rad will run .I oconv first to create the octree (assuming it doesn't already exist), then -.I rview +.I rvu with a long list of options. Let's say that from within -.I rview, +.I rvu, we wrote out the view files "view1.vp" and "view2.vp". We could add these to "sample.rif" like so: .IP "" .2i .nf -view= vw1 -vf view1.vp # Our first view -view= vw2 -vf view2.vp # Our second view +view= vw1 \-vf view1.vp # Our first view +view= vw2 \-vf view2.vp # Our second view RESOLUTION= 1024 # Let's go for a higher resolution result .fi .PP To start -.I rview +.I rvu again using vw2 instead of the default, we use: .IP "" .2i -rad -o x11 -v vw2 sample.rif +rad \-o x11 \-v vw2 sample.rif .PP Once we are happy with the variable settings in our file, we can run .I rad @@ -646,4 +653,4 @@ problematic on systems that don't distinguish case in .SH "SEE ALSO" glrad(1), make(1), mkillum(1), objview(1), oconv(1), pfilt(1), raddepend(1), ranimate(1), -rholo(1), rpict(1), rtrace(1), rview(1), touch(1), vgaimage(1), ximage(1) +rholo(1), rpict(1), rtrace(1), rvu(1), touch(1), vgaimage(1), ximage(1)