ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/util/trad.hlp
(Generate patch)

Comparing ray/src/util/trad.hlp (file contents):
Revision 2.2 by greg, Fri Oct 28 11:09:52 1994 UTC vs.
Revision 2.3 by greg, Tue Nov 1 14:38:31 1994 UTC

# Line 63 | Line 63 | all over again every time you have a question.
63  
64   .Trad.Messages
65  
66 < Informative messages, commands executed by rad, and errors
66 > Informative messages, commands executed by rad, and errors
67   appear in the message window at the bottom of the trad frame.
68 < Growing the trad window means growing this message window, and
68 > Growing the trad window means growing this message window, and
69   not much else.
70   This is not really necessary, since the window will be grown
71   automatically if the message requires it.
# Line 339 | Line 339 | All other variables will be unaffected.
339  
340   .Scene.Revert
341  
342 < The "Revert" button is a convenient way to revert to the original
342 > The "Revert" button is a convenient way to revert to the original
343   values in the rad input file.
344   Only the variables on the Scene screen will be affected, but any changes
345   to these variables since the last save will be lost.
# Line 353 | Line 353 | This zone need not correspond exactly to any interior
353   walls, as it is used primarily to set rendering parameters and
354   standard viewpoints.
355  
356 < An interior zone means that standard viewpoints will be selected
356 > An interior zone means that standard viewpoints will be selected
357   from the inside of this box.
358   An exterior zone means that standard viewpoints will be selected
359   from the outside of this box.
360 < The default zone is an exterior one computed from the bounding box
360 > The default zone is an exterior one computed from the bounding box
361   of the entire scene.
362   (Note that this is not usually desirable.)
363  
# Line 371 | Line 371 | the rad manual page.
371  
372   .Zone.Type
373  
374 < There are two types of zones understood by rad, "Interior" and
374 > There are two types of zones understood by rad, "Interior" and
375   "Exterior".
376 < An interior zone is indicated when renderings generally take place
376 > An interior zone is indicated when renderings generally take place
377   inside a specified 3-d box.
378   A typical example might be a single room or auditorium.
379   An exterior zone is indicated when renderings generally take place
# Line 505 | Line 505 | used for exterior zones and 0.01 for interior zones.
505  
506   The "Copy" button on the Zone screen takes all values for this
507   screen from another rad input file, replacing the current values.
508 < Specifically, the rad variables "ZONE, DETAIL, INDIRECT,
508 > Specifically, the rad variables "ZONE, DETAIL, INDIRECT,
509   VARIABILITY and EXPOSURE" will be copied from the named file.
510  
511   All other variables will be left untouched.
512  
513   .Zone.Revert
514  
515 < The "Revert" button is a convenient way to revert to the original
515 > The "Revert" button is a convenient way to revert to the original
516   values in the rad input file.
517   Only the variables on the Zone screen will be affected, but any changes
518   to these variables since the last save will be lost.
# Line 524 | Line 524 | This screen provides a means of setting the multi-valu
524   "view" variable.
525   Each view setting is listed by name, or by number if no name has
526   been assigned.
527 < To add a new view, enter a unique name and specify the view
527 > To add a new view, enter a unique name and specify the view
528   options,
529   then press the "Add" or "Set Default" button.
530   If a view with the same name already exists, it is unconditionally
# Line 534 | Line 534 | and/or parameters, and press the "Change" button.
534   To remove an unwanted view, select it and press the "Delete" button.
535   To undo this action, simply press the "Add" button again.
536  
537 < The first view in the list is the default given to rview during
537 > The first view in the list is the default given to rview during
538   interactive rendering, and is the first view rendered in a batch run.
539   To change the default view, select the newly desired view and press
540   the "Set Default" button.
# Line 569 | Line 569 | The standard view is "X" is used if no views are speci
569  
570   Each view has a unique name, which may be chosen at the user's
571   discretion or taken from a list of standard views, described below.
572 < An invented name should be kept as short as possible, since it is
572 > An invented name should be kept as short as possible, since it is
573   added to the picture file name along with the standard ".pic" suffix.
574  
575   The standard views are specified by strings of the form
# Line 582 | Line 582 | means maximum X, lower case "y" means minimum Y and so
582   The final letter is the view type, where 'v' is perspective (the
583   default), 'l' is parallel, 'a' is angular fisheye, and 'h' is
584   hemispherical fisheye.
585 < A perspective view from maximum X, minimum Y would be "Xy" or
585 > A perspective view from maximum X, minimum Y would be "Xy" or
586   "Xyv".
587   A parallel view from maximum Z would be "Zl".
588   If "ZONE" is an interior zone, the standard views will
# Line 624 | Line 624 | view options, all of which begin with "-v".
624   Just briefly, the "-vt?" option sets the view type, where "?" is
625   replaced by one of the letters "v, l, a or h", corresponding to
626   perspective, parallel, angular and hemispherical fisheye, respectively.
627 < The "-vp x y z" option sets the view position (eyepoint), where "x y z"
627 > The "-vp x y z" option sets the view position (eyepoint), where "x y z"
628   is replaced by the position in 3-space.
629   The "-vd xd yd zd" option sets the view direction, where "xd yd zd"
630   is a vector pointing in the desired direction.
# Line 633 | Line 633 | the eyepoint from the look-at point.  Vector normaliza
633   unnecessary.)
634   The "-vh horiz" and "-vv vert" options set the horizontal and
635   vertical view sizes, respectively.
636 < For perspective views, these correspond to full camera angles in
636 > For perspective views, these correspond to full camera angles in
637   degrees.
638   For parallel views (using the "-vtl" option), they correspond to
639   image plane size in world coordinates.
# Line 761 | Line 761 | untouched.
761  
762   .Views.Revert
763  
764 < The "Revert" button is a convenient way to revert to the original
764 > The "Revert" button is a convenient way to revert to the original
765   values in the rad input file.
766   Only the variables on the Views screen will be affected, but any changes
767   to these variables since the last save will be lost.
# Line 820 | Line 820 | details.)
820  
821   .Options.Penumbras
822  
823 < The "Penumbras" setting determines whether or not Radiance will
823 > The "Penumbras" setting determines whether or not Radiance will
824   make a special effort to generate soft shadows from area light sources.
825   Since this is a potentially expensive calculation, penumbras should
826   only be switched "On" when they are really needed.
# Line 848 | Line 848 | vary according to the location and characteristics of
848  
849   .Options.AmbDelete
850  
851 < The "Delete" button next to the "Ambfile" window on the Options
851 > The "Delete" button next to the "Ambfile" window on the Options
852   screens allows you to remove the named ambient file.
853   This is usually done when a change to one or more rad variables
854   casts doubt on the accuracy of the values stored in this file.
# Line 884 | Line 884 | If you wish these reports and errors to be directed to
884   file, follow the time interval by a space and a file name.
885  
886   No setting on this variable means do not report rendering progress.
887 < A zero setting means the same thing, and may be used when a
887 > A zero setting means the same thing, and may be used when a
888   separate error file is desired but progress reports are not.
889  
890   .Options.Oconv
# Line 925 | Line 925 | since rad does not have the intelligence to do it for
925  
926   The "render opts" window is used to specify additional options to
927   the rview(1) and rpict(1) rendering programs.
928 < Most of the important parameters are computed by rad, so this
928 > Most of the important parameters are computed by rad, so this
929   window is usually used to override specific parameters or to give
930   additional information, such as which materials to exclude from the
931   interreflection calculation.
# Line 978 | Line 978 | foreground.
978   The next set of buttons provides for the control of a batch
979   rendering process, taking place in the background.
980   Finally, the bottom set of buttons allows you to preview what would
981 < happen during a batch rendering, or (equivalently) make a script of
981 > happen during a batch rendering, or (equivalently) make a script of
982   UNIX commands for later execution.
983  
984   When the Action screen is first brought up, the message window
# Line 1053 | Line 1053 | unfortunately.)
1053  
1054   .Action.Rview
1055  
1056 < The "rview" button on the Action screen starts an interactive
1057 < rendering for the selected view, indicated by the menu button
1056 > The "rview" button on the Action screen starts an interactive
1057 > rendering for the selected view, indicated by the menu button
1058   just to the right.
1059 < Other views may be accessed within rview using the "L name"
1060 < command, and new views can be added with the "V name"
1059 > Other views may be accessed within rview using the "L name"
1060 > command, and new views can be added with the "V name"
1061   command.
1062 < (See the rview(1) man page and the "View" topic in the current
1062 > (See the rview(1) man page and the "View" topic in the current
1063   help category for more information.)
1064  
1065 < If the octree is out-of-date, it will be rebuilt before rendering
1065 > If the octree is out-of-date, it will be rebuilt before rendering
1066   begins.
1067  
1068   .Action.View
1069  
1070   The Action screen contains two menus for selecting views.
1071 < The top menu, next to the "rview" button, sets the view to start
1071 > The top menu, next to the "rview" button, sets the view to start
1072   with in rview, and is selected from the current view list.
1073 < The second view menu, next to the "Start" button for batch
1073 > The second view menu, next to the "Start" button for batch
1074   rendering, selects the view or views to render in batch mode.
1075 < If the special entry "ALL" is selected, then every view in the
1075 > If the special entry "ALL" is selected, then every view in the
1076   current list will be rendered if it hasn't been already.
1077  
1078 < The batch rendering view menu also selects the view or views
1078 > The batch rendering view menu also selects the view or views
1079   to use in producing a script during a dry run.
1080  
1081   .Action.Start
1082  
1083 < The "Start" button for batch rendering on the Action screen
1084 < initiates a rad rendering process in the background using the
1083 > The "Start" button for batch rendering on the Action screen
1084 > initiates a rad rendering process in the background using the
1085   selected view or views shown on the menu button to the right.
1086  
1087   If any of the rad variables have been changed since the
# Line 1090 | Line 1090 | your changes before starting a background process.
1090   If you discard these changes, then the batch rendering will be
1091   conducted using the previously saved values.
1092  
1093 < Once a background process is going, the "Start" button is
1094 < disabled, and rendering progress can be monitored by checking
1093 > Once a background process is going, the "Start" button is
1094 > disabled, and rendering progress can be monitored by checking
1095   the error file periodically.
1096 < (This file is named by the root of the rad input file followed by
1096 > (This file is named by the root of the rad input file followed by
1097   ".err".)
1098 < When a batch process is started or already running, this button
1098 > When a batch process is started or already running, this button
1099   will be disabled.
1100  
1101 < The background process can be killed during this or later
1101 > The background process can be killed during this or later
1102   invocations of trad using the "Kill" button.
1103  
1104   .Action.Kill
1105  
1106 < The batch rendering "Kill" button kills the
1106 > The batch rendering "Kill" button kills the
1107   background process started earlier with the "Start" button.
1108 < The rad process id is taken from the first line of the error file,
1108 > The rad process id is taken from the first line of the error file,
1109   and this process and all its children are killed when the
1110   button is pressed.
1111  
1112 < So long as there is an ambient file specified in the Options
1113 < screen, no data is lost by killing and restarting a batch
1112 > So long as there is an ambient file specified in the Options
1113 > screen, no data is lost by killing and restarting a batch
1114   rendering, though some new startup costs will be incurred.
1115  
1116 < The "Kill" button is disabled if no running batch process is
1116 > The "Kill" button is disabled if no running batch process is
1117   detected.
1118  
1119   .Action.CheckErr
1120  
1121   Pressing the "Check errors" button
1122 < displays the contents of the batch rendering error file, named
1123 < by the root of the current rad input file followed by the ".err"
1122 > displays the contents of the batch rendering error file, named
1123 > by the root of the current rad input file followed by the ".err"
1124   suffix.
1125 < This file will contain the command lines executed by rad so far,
1126 < and may or may not contain additional progress reports from
1125 > This file will contain the command lines executed by rad so far,
1126 > and may or may not contain additional progress reports from
1127   rpict, depending on the initial setting of the "REPORT" variable.
1128  
1129   If no error file exists, this button will be disabled.
# Line 1131 | Line 1131 | If no error file exists, this button will be disabled.
1131   .Action.Script
1132  
1133   The dry run "Script" button runs rad with the
1134 < "-n" option so that you may see the commands that would be
1134 > "-n" option so that you may see the commands that would be
1135   executed during a batch run without actually executing them.
1136 < If a file is named in the window next to this button, the output
1136 > If a file is named in the window next to this button, the output
1137   will simply be written to that file.
1138 < If no file is named, a temporary file is created and an editor
1138 > If no file is named, a temporary file is created and an editor
1139   window is opened on it.
1140  
1141   Producing a dry run also writes the "Optfile" if one is specified
# Line 1143 | Line 1143 | on the Options screen.
1143   This may be useful for computing rendering parameters for rtrace(1)
1144   or rpiece(1).
1145  
1146 < The view or views are selected by the same menu used for
1146 > The view or views are selected by the same menu used for
1147   batch rendering.
1148 < (See the "View" topic under the current help category for more
1148 > (See the "View" topic under the current help category for more
1149   information.)
1150  
1151   .Action.Edit
1152  
1153 < The dry run "Edit" button is used to edit the named script file
1153 > The dry run "Edit" button is used to edit the named script file
1154   created by pressing the "Script" button.
1155   If no file is named, this button is ineffective.
1156  
1157   .Action.Delete
1158  
1159 < The "Delete" button removes the named script file, created by the
1159 > The "Delete" button removes the named script file, created by the
1160   "Script" button.
1161 < If no file is named, or the named file does not exist, this button has
1161 > If no file is named, or the named file does not exist, this button has
1162   no effect.
1163  
1164   .Results.Intro
1165  
1166   This button selects the trad Results screen.
1167 < This screen permits rendered pictures to be displayed,
1167 > This screen permits rendered pictures to be displayed,
1168   converted to other image formats, and printed.
1169 < Only finished pictures may be converted or printed, but
1170 < incomplete pictures (i.e. aborted renderings or renderings in
1169 > Only finished pictures may be converted or printed, but
1170 > incomplete pictures (i.e. aborted renderings or renderings in
1171   progress) may be displayed interactively.
1172  
1173   The left-hand window shows a list of completed views, and the
1174 < right-hand window shows views that have been started but not
1174 > right-hand window shows views that have been started but not
1175   finished.
1176 < Note that other views may not even be started, thus may not
1176 > Note that other views may not even be started, thus may not
1177   appear in either list.
1178 < Also, just because a view appears on the Results screen, it does
1179 < not mean that view is up-to-date with respect to the Radiance
1178 > Also, just because a view appears on the Results screen, it does
1179 > not mean that view is up-to-date with respect to the Radiance
1180   input files.
1181 < (The best way currently to tell which pictures are out-of-date
1182 < is to press the "Script" button on the Action screen and examine
1181 > (The best way currently to tell which pictures are out-of-date
1182 > is to press the "Script" button on the Action screen and examine
1183   the output.)
1184  
1185   .Results.Finished
# Line 1212 | Line 1212 | Shift-click also allows views to be added to the selec
1212  
1213   .Results.Rescan
1214  
1215 < The "Rescan" button on the Results screen is used to update the
1216 < finished and unfinished view lists, in case one or more pictures
1215 > The "Rescan" button on the Results screen is used to update the
1216 > finished and unfinished view lists, in case one or more pictures
1217   has completed since the Results screen was brought up.
1218  
1219   .Results.Delete

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines