--- ray/src/util/trad.hlp	1995/08/28 10:12:35	2.13
+++ ray/src/util/trad.hlp	2012/06/01 22:55:14	2.21
@@ -1,4 +1,4 @@
-	$Id: trad.hlp,v 2.13 1995/08/28 10:12:35 greg Exp $
+	trad.hlp 2.18 10/20/98
 
 This help file is associated with the trad interface to the Radiance
 rad(1) program.  Trad consists of trad.wsh and one do_*.tcl file for
@@ -398,11 +398,26 @@ long as the overall size of the given box is close to 
 size of the space.
 
 The Zone entry windows may be manipulated in the following ways.
-Control-U clears the current window.
 Control-V pastes the contents of the current selection at the
 insertion point.
 Return moves the focus to the next window in the chain.
 
+The "Auto" button may be used to set these values based on the bounding
+box of one or more Radiance scene files.
+
+.Zone.Auto
+
+Use this button to automatically determine the bounding box for this
+zone, based on the output of the "getbbox" command run on one or
+more Radiance scene files.
+The appropriate scene files are entered via a file
+selection dialogue box, which comes up after the button is pressed.
+
+The reason for selecting specific files rather than running getbbox
+on the entire scene is that a zone usually does not include large
+external objects, which may be present in the complete scene
+description.
+
 .Zone.Detail
 
 The "Detail" setting indicates the relative level
@@ -472,7 +487,7 @@ an important parameter for rendering accuracy.
 
 There are two basic ways to compute the exposure value.
 The first is by trial and error, where the value is adjusted up and
-down within rview using the "e = value" command.
+down within rvu using the "e = value" command.
 Though it sounds flaky, this is the most reliable way to set the
 exposure (and ambient level) in general lighting situations.
 
@@ -490,7 +505,7 @@ tot_flux is given in watts.
 (Divide total lumens by 179 lumens/watt to get watts.)
 
 The exposure value may either be given as a positive real value, or
-as a real value preceeded by a '+' or '-' indicating a positive or
+as a real value preceded by a '+' or '-' indicating a positive or
 negative number of f-stops (powers of two) from the original value.
 
 If no exposure is given, pfilt will automatically compute the
@@ -530,7 +545,7 @@ and/or parameters, and press the "Change" button.
 To remove an unwanted view, select it and press the "Delete" button.
 To undo this action, simply press the "Add" button again.
 
-The first view in the list is the default given to rview during
+The first view in the list is the default given to rvu during
 interactive rendering, and is the first view rendered in a batch run.
 To change the default view, select the newly desired view and press
 the "Set Default" button.
@@ -599,7 +614,7 @@ Otherwise, it is usually necessary to specify a set of
 define a view.
 
 The simplest view specification is of the form "-vf viewfile", where
-"viewfile" is a file created with the rview "view" command, or a
+"viewfile" is a file created with the rvu "view" command, or a
 Radiance picture.
 This method of naming views, although convenient, is not the best
 since it is difficult to know exactly where such a view is by
@@ -682,15 +697,12 @@ The "Clear" button simply clears the "Name" and "Optio
 for the convenience of entering a new view.
 It has no effect on the rad input variables.
 
-Note that Control-U will always clear an entry box whose cursor is
-active.
-
 .Views.Default
 
 The "Set Default" button may be used to make the selected view the
 default view for rendering.
 This simply moves the view to the top of the list in the rad input file.
-The default view will be the one normally rendered by rview when rad
+The default view will be the one normally rendered by rvu when rad
 is started interactively, and is the first view rendered in a batch
 process.
 
@@ -707,10 +719,19 @@ The standard view up vector may be set to the positive
 the positive Y axis (+Y), the positive Z axis (+Z), the negative
 X axis (-X), the negative Y axis (-Y), or the negative Z axis (-Z).
 
-This setting may always be overriden by the "-vu xd yd zd" option,
+This setting may always be overridden by the "-vu xd yd zd" option,
 and will be altered for a particular view if it happens to be
 parallel to the view direction.
 
+.Views.Eyesep
+
+The eye separation is used for generating stereo views of
+the scene.
+It is the measured distance between a viewer's pupils in world
+coordinate units.
+It is not used directly by rad, but should be set for other programs
+that need it, such as rholo and glrad.
+
 .Views.Picture
 
 The root picture file name is given in the "Picture" entry window.
@@ -817,7 +838,7 @@ The "Report" variable may be used to specify a time in
 minutes) between progress reports.
 
 Other windows allow the user to customize the options to oconv(1),
-mkillum(1), rview(1) and rpict(1), and pfilt(1).
+mkillum(1), rvu(1) and rpict(1), and pfilt(1).
 
 .Options.Quality
 
@@ -895,7 +916,7 @@ effort.
 
 The "Optfile" setting assigns a file to hold rendering options,
 which may be a convenience when these options are reused for
-rtrace(1) or rpiece(1), or manual invocations of rview or rpict.
+rtrace(1) or rpiece(1), or manual invocations of rvu or rpict.
 Using an options file also reduces the size of the command line,
 making it a little easier on the eye.
 
@@ -956,7 +977,7 @@ since rad does not have the intelligence to do it for 
 .Options.Render
 
 The "render opts" window is used to specify additional options to
-the rview(1) and rpict(1) rendering programs.
+the rvu(1) and rpict(1) rendering programs.
 Most of the important parameters are computed by rad, so this
 window is usually used to override specific parameters or to give
 additional information, such as which materials to exclude from the
@@ -1005,7 +1026,7 @@ This screen is where the actual Radiance programs are
 run, usually via rad(1).
 The top row of buttons is used to update the octree following a
 change to one or more input files.
-The "rview" button starts an interactive rendering in the
+The "rvu" button starts an interactive rendering in the
 foreground.
 The next set of buttons provides for the control of a batch
 rendering process, taking place in the background.
@@ -1083,12 +1104,12 @@ by the "Touch" button.
 (This will still cause the ambient file to be removed,
 unfortunately.)
 
-.Action.Rview
+.Action.Rvu
 
-The "rview" button on the Action screen starts an interactive
+The "rvu" button on the Action screen starts an interactive
 rendering for the selected view, indicated by the menu button
 just to the right.
-Other views may be accessed within rview using the "L name"
+Other views may be accessed within rvu using the "L name"
 command, and new views can be added with the "V name"
 command.
 
@@ -1098,7 +1119,7 @@ Instead, give it a new name (or no name, which will sh
 a number later), then use the Views screen to override the previous
 view definition with the new one.
 (See the "View" topic in the current
-help category, the "Change" topic under "Views" and the rview(1)
+help category, the "Change" topic under "Views" and the rvu(1)
 manual page for more information.)
 
 If the octree is out-of-date, it will be rebuilt before rendering
@@ -1107,14 +1128,14 @@ begins.
 .Action.View
 
 The Action screen contains two menus for selecting views.
-The top menu, next to the "rview" button, sets the view to start
-with in rview, and is selected from the current view list.
+The top menu, next to the "rvu" button, sets the view to start
+with in rvu, and is selected from the current view list.
 The second view menu, next to the "Start" button for batch
 rendering, selects the view or views to render in batch mode.
 If the special entry "ALL" is selected, then every view in the
 current list will be rendered if it hasn't been already.
 
-The view menu next to the "rview" button will be disabled if there
+The view menu next to the "rvu" button will be disabled if there
 is only one view to choose from.
 The view menu next to the "Start" button will be disabled if there
 is a batch job in progress, and thus the view cannot be changed.
@@ -1122,6 +1143,24 @@ is a batch job in progress, and thus the view cannot b
 The batch rendering view menu also selects the view or views
 to use in producing a script during a dry run.
 
+.Action.Processes
+
+The "Number of processes" slider controls how many independent
+processes are initiated by the "rvu" and "Start" buttons above
+and below.
+This should be set no greater than the number of virtual cores
+on your system.
+
+For interactive rendering, the "new" command within rvu may
+be used to change the number of processes running.
+
+For rendering in the background, the number of processes will
+never be greater than the number of views if all views are
+bing rendered.
+If only a single view is selected for batch rendering, rad
+will call rpiece to render it in sections using the selected
+number of processes.
+
 .Action.Start
 
 The "Start" button for batch rendering on the Action screen
@@ -1270,6 +1309,8 @@ has completed since the Results screen was brought up.
 
 The "Delete" button on the Results screen is used to remove the
 selected picture files from the filesystem.
+Associated raw picture and z-buffer files
+will also be deleted if they exist.
 Verification is required before any action is taken.
 
 .Results.Display
@@ -1357,10 +1398,13 @@ details.)
 The print command window on the Results screen contains the system
 command to use in printing out finished Radiance pictures.
 The "%s" format field, which must appear somewhere in the command,
-is replaced by the selected Radiance picture file name(s).
+is replaced by the selected Radiance picture file name.
+This command is executed multiple times if multiple files are
+selected.
 
 The default command is "ra_ps %s | lpr", which converts the Radiance
 picture to a black and white PostScript file and sends it to the lpr
 print spooler.
+Add a "-c" option to "ra_ps" if the printer supports color.
 If your printer does not understand PostScript, or your system does
 not support lpr, this command must obviously be changed.
