--- ray/src/util/trad.hlp 2012/06/01 22:55:14 2.21 +++ 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,13 +1008,20 @@ 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 The "render opts" window is used to specify additional options to @@ -1156,9 +1204,9 @@ 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 +being rendered. +If only a single view is selected for rendering, rad +will call rpiece to render it in tiles using the given number of processes. .Action.Start