--- ray/src/util/trad.hlp	2012/06/02 05:06:33	2.22
+++ ray/src/util/trad.hlp	2015/05/27 13:16:11	2.25
@@ -584,17 +584,17 @@ 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]?[vlahc]?".
+"[Xx]?[Yy]?[Zz]?[vlahsc]?".
 (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, H or C.)
+followed by an optional lower case view type.)
 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, 'h' is
-hemispherical fisheye and 'c' is for cylindrical panorama.
-A perspective view from maximum X, minimum Y would be "Xy" or
-"Xyv".
+hemispherical fisheye, 's' is for planisphere (stereographic) 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".
 If "ZONE" is an interior zone, the standard views will
 be inside the perimeter.
@@ -633,7 +633,7 @@ 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, h or c", corresponding to
+replaced by one of the letters "v, l, a, h, s 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"
@@ -883,6 +883,47 @@ will be treated as points.
 It only means that some accuracy and possibly some smoothness
 will be traded for speed in the shadow calculations.
 
+.Options.Pgmap
+
+The "Pgmap" specifies the file to hold the global photons computed
+by the "mkpmap" command, followed by the number of photons to generate
+(required).
+A typical photon count for a global map is on the order of 100-200K.
+(A 'K', 'M', or 'G' may follow the value to indicate 1000's, millions,
+or billions of photons.)
+By convention, photon map files are given a ".pmp" suffix.
+An optional third parameter specifies the bandwidth to use 
+for the global photons during rendering, and this value should be
+around 50.
+
+.Options.PgmDelete
+
+The "Delete" button next to the "Pgmap" window on the Options
+screen allows you to remove the named global photon map file.
+This is usually done when a change is made to the "mkpmap" options,
+as the file will be regenerated automatically after most scene changes.
+
+.Options.Pcmap
+
+The "Pcmap" specifies the file to hold the caustic photons computed
+by the "mkpmap" command, followed by the number of photons to generate
+(required).
+A typical photon count for a global map is on the order of 1000K (1M).
+(A 'K', 'M', or 'G' may follow the value to indicate 1000's, millions,
+or billions of photons.)
+By convention, photon map files are given a ".pmp" suffix.
+An optional third parameter specifies the bandwidth to use 
+for the global photons during rendering, and this value should be
+around 50.
+(See the "Pgmap" topic under the current help category.)
+
+.Options.PcmDelete
+
+The "Delete" button next to the "Pcmap" window on the Options
+screen allows you to remove the named caustic photon map file.
+This is usually done when a change is made to the "mkpmap" options,
+as the file will be regenerated automatically after most scene changes.
+
 .Options.Ambfile
 
 The "Ambfile" is the file used to store Radiance ambient values for
@@ -967,12 +1008,19 @@ indicate this by not specifying any illum or scene fil
 .Options.Mkillum
 
 The "mkillum opts" window may be used to specify options to the
-mkillum(1) command, whose options are actually passed to rtrace(1).
+mkillum(1) command.
 These options apply only if there are one or more "Illum" files
 named on the Scene screen.
 
 It is very important to set mkillum options sensibly,
 since rad does not have the intelligence to do it for you.
+
+.Options.Mkpmap
+
+The "mkpmap opts" window may be used to specify options
+to the mkpmap(1) command.
+There are no default values, and rad does not set these
+options intelligently.
 
 .Options.Render
 
