--- ray/src/util/trad.hlp	1994/11/01 14:38:31	2.3
+++ ray/src/util/trad.hlp	1995/08/28 10:12:35	2.13
@@ -1,9 +1,9 @@
-	$Id: trad.hlp,v 2.3 1994/11/01 14:38:31 greg Exp $
+	$Id: trad.hlp,v 2.13 1995/08/28 10:12:35 greg Exp $
 
 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
-each screen.  There are currently seven such screens:  Action, File,
-Options, Results, Scene, Views and Zone.
+each screen.  There are currently seven such screens:  File, Scene,
+Zone, Views, Options, Action and Results.
 
 .Trad.Intro
 
@@ -48,6 +48,8 @@ the left mouse button while holding the control key ov
 curiosity in the main trad window.
 (In general, only active windows are given help file links -- click
 on these rather than the text labels.)
+Additional search capabilities are available over all topics using
+the "Grep" button.
 
 For help on the help facility itself, Control-click on the problem
 help widget or on the window title in the upper right corner for
@@ -55,12 +57,6 @@ more general information.
 (To get back to trad-specific help, press the "HELP" button in the
 main trad window or Control-click on a trad widget.)
 
-Once the help window has been displayed, it is usually best to
-lower or iconify it rather than dismissing it if further help is
-needed.
-This way, you will not have to wait for the help file to be read in
-all over again every time you have a question.
-
 .Trad.Messages
 
 Informative messages, commands executed by rad, and errors
@@ -573,15 +569,15 @@ An invented name should be kept as short as possible, 
 added to the picture file name along with the standard ".pic" suffix.
 
 The standard views are specified by strings of the form
-"[Xx]?[Yy]?[Zz]?[vlah]?".
+"[Xx]?[Yy]?[Zz]?[vlahc]?".
 (That is, an optional upper or lower case X followed by an optional
 upper or lower case Y followed by an optional upper or lower case Z
-followed by an optional lower case V, L, A or H.)
+followed by an optional lower case V, L, A, H or C.)
 The letters indicate the desired view position, where upper case "X"
 means maximum X, lower case "y" means minimum Y and so on.
 The final letter is the view type, where 'v' is perspective (the
-default), 'l' is parallel, 'a' is angular fisheye, and 'h' is
-hemispherical fisheye.
+default), 'l' is parallel, 'a' is angular fisheye, 'h' is
+hemispherical fisheye and 'c' is for cylindrical panorama.
 A perspective view from maximum X, minimum Y would be "Xy" or
 "Xyv".
 A parallel view from maximum Z would be "Zl".
@@ -622,8 +618,9 @@ interaction mode for trad.
 Consult the rpict(1) manual page for a full description of the various
 view options, all of which begin with "-v".
 Just briefly, the "-vt?" option sets the view type, where "?" is
-replaced by one of the letters "v, l, a or h", corresponding to
-perspective, parallel, angular and hemispherical fisheye, respectively.
+replaced by one of the letters "v, l, a, h or c", corresponding to
+perspective, parallel, angular fisheye, hemispherical fisheye
+and cylindrical panorama, respectively.
 The "-vp x y z" option sets the view position (eyepoint), where "x y z"
 is replaced by the position in 3-space.
 The "-vd xd yd zd" option sets the view direction, where "xd yd zd"
@@ -648,7 +645,7 @@ In particular, make sure that each option and each arg
 space between it and whatever follows.
 
 Hitting return in the "Options" window is equivalent to pressing the
-"Add" button.
+"Add" button followed by the "Clear" button.
 
 .Views.Add
 
@@ -749,6 +746,41 @@ to maintain a specific pixel aspect ratio (1 by defaul
 
 The default value for this variable is "512".
 
+.Views.Rawfile
+
+The "Rawfile" entry window determines if and where the raw output picture
+from rpict will be saved.
+If the entry is empty, the file will be removed after rendering and
+filtering.
+This is the normal action, since the raw file
+takes up disk space and is not generally useful.
+However, if you wish to perform some special filtering function,
+this file can be renamed instead of removed by giving a
+root file name in this entry window.
+The final name in this case will be the given root plus and
+underscore plus the view name followed by a ".pic" suffix.
+
+In the special case when the raw file name and picture file name are
+the same, the raw file is saved and no filtering takes place.
+
+.Views.Zfile
+
+The "Zfile" entry window gives the root name of the file in which to
+store the raw (binary floating point) distances to pixels in the
+original generated image.
+If this entry is empty, then no z-file will be saved.
+
+The final z-file name will be the given root plus an underscore plus
+the view name plus a ".zbf" suffix.
+
+To convert this image to human-readable form, the program "od" will
+work on some systems, or the Radiance "pvalue" program may be used
+to first convert it to a greyscale Radiance picture using the
+options "-r -h -b -df `getinfo -d < pictname`" where "pictname" is
+replaced by the raw picture file name.
+(Getinfo simply gets the original image dimensions, which are not
+stored in the z-file.)
+
 .Views.Copy
 
 The "Copy" button in the Views screen permits those variables
@@ -879,7 +911,7 @@ a given rendering has progressed.
 Normally, progress reports and errors during batch renderings
 are sent to the error file given by the root of the rad input
 file name followed by the ".err" suffix.
-(See the "Errors" topic under the "Action" screen category.)
+(See the "CheckErr" topic under the "Action" screen category.)
 If you wish these reports and errors to be directed to a different
 file, follow the time interval by a space and a file name.
 
@@ -1059,9 +1091,16 @@ just to the right.
 Other views may be accessed within rview using the "L name"
 command, and new views can be added with the "V name"
 command.
-(See the rview(1) man page and the "View" topic in the current
-help category for more information.)
 
+When using the "V" command to change an existing view, do not
+give it an existing name because the previous view will not be overridden.
+Instead, give it a new name (or no name, which will show up as
+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)
+manual page for more information.)
+
 If the octree is out-of-date, it will be rebuilt before rendering
 begins.
 
@@ -1075,6 +1114,11 @@ rendering, selects the view or views to render in batc
 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
+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.
+
 The batch rendering view menu also selects the view or views
 to use in producing a script during a dry run.
 
@@ -1095,11 +1139,17 @@ disabled, and rendering progress can be monitored by c
 the error file periodically.
 (This file is named by the root of the rad input file followed by
 ".err".)
-When a batch process is started or already running, this button
-will be disabled.
+When a batch process is started or already running, or when a
+process is on another host and its status is unknown,
+this button will be disabled.
 
 The background process can be killed during this or later
 invocations of trad using the "Kill" button.
+If the process was started on another machine and the status is unknown,
+it will be necessary to run trad from the other host or remove the error
+file manually before starting a background process on this machine.
+This is to protect you from the great confusion that results when two
+machines are working from the same project file.
 
 .Action.Kill
 
@@ -1114,7 +1164,7 @@ screen, no data is lost by killing and restarting a ba
 rendering, though some new startup costs will be incurred.
 
 The "Kill" button is disabled if no running batch process is
-detected.
+detected on the current host machine.
 
 .Action.CheckErr
 
