--- ray/doc/notes/compile_switches	2003/03/15 17:32:55	1.1
+++ ray/doc/notes/compile_switches	2016/05/31 10:31:42	1.8
@@ -1,36 +1,87 @@
 Here is a list of compile switches, used to customize Radiance code
 for specific machines and users:
 
--DMC		If set, switches from default low-discrepency sequence
-		sampling to true (pseudorandom) Monte Carlo.  Use if
-		the "brushed" appearance of specular highlights and
-		penumbras bothers you.
-
--DALIGN=(type)	Alignment type, machine-dependent.  Most RISC
+-DALIGNT=(type)	Alignment type, machine-dependent.  Most RISC
 		architectures align on 8-word boundaries (double).
 		The default alignment type is int.
 
--DSPEED=(MIPS)	Millions of instructions per second for this
-		processor (approximate).  This is used to decide
-		certain unimportant timing issues such as how many
-		rays to trace before checking input in rview and
-		whether or not to optimize the color table in ximage
-		on 8-bit displays.
+-DWFLUSH=(rays)	Override for number of rays before flush in rvu.
 
--DWFLUSH=(rays)	Override for number of rays before flush in rview.
+-DBSD		Operating system has a strong Berkeley flavor, which
+		affects certain system calls, such as signal handling and
+		resource tracking.
 
--DBSD		Operating system has a strong Berkeley flavor, meaning
-		that bcopy() and bzero() are present but maybe memcpy()
-		and memset() are not.  (See common/standard.h for other
-		things this flag affects.)  Also affects certain system
-		calls, such as signal handling and resource tracking.
+-DSMLMEM	The system has little RAM available, so size hash
+		tables and the like accordingly.  Only allows for
+		small scene descriptions (32,256 primitives).
 
--DBIGMEM	The system has lots of RAM available, so size hash
-		tables and the like accordingly.  Also provides for
-		larger overall scene descriptions (33,553,920 primitives
-		rather than 32,256).
-
 -DSMLFLT	This setting tells Radiance to use short floats
-		(4-bytes) throughout, which saves lots of memory
+		(32 bits) throughout, which saves lots of memory
 		but can cause calculation inaccuracies in many
 		cases.  Its use has been discontinued for this reason.
+
+-DSHADCACHE=N	The array size to use for caching occluders.
+		Setting this to 0 turns off this optimization.
+		Values greater than 20 use over 4 Kbytes per
+		light source, which can add up to a lot of
+		memory in scenes with many sources.
+
+-DAVGREFL=R	Set the average surface reflectance for the purpose
+		of indirect irradiance calculations to R, where
+		R is a real number in the range (0,1.0).  The
+		default value is 0.50 (50%).
+
+-DPMAP_OOC	Builds the out-of-core photon map. The photon data resides
+		in a leaf file on disk with suffix ".leaf" and is loaded on
+		demand. This is intended for very large photon maps (up to
+		4.3 billion photons) particularly for annual simulations
+		with rcontrib. This switch is disabled by default, which
+		builds the in-core photon map used in previous releases;
+		this resides entirely in main memory. These options are
+		mutually exclusive, and the resulting photon map files are
+		incompatible.
+		
+-DPMAP_PRIMARYPOS	
+		Stores photon primary hitpoints for binning using the -f
+		option with rcontrib if the function file requires them.
+		This consumes an additional 3 floats and is disabled per
+		default to reduce the size of the resulting photon maps.
+		
+-DPMAP_FLOAT_FLUX
+		Stores photon flux as floats instead of more compact RGBE
+		(the default). In terms of accuracy, the difference would
+		only be noticeable with highly saturated colours.
+		
+-DPMAP_ROI	Enables the -api option to mkpmap. This constrains photon
+		deposition only to the specified region of interest (defined
+		as a bounding volume) for situations where it is known a
+		priori that photon map lookups will only occur inside this
+		region. This is disabled per default as it can lead to
+		biased results outside the ROI, or near its boundaries. Ziss
+		option for ze eckspertz only!
+
+-DPMAP_RUNAWAY_WARN
+		Causes mkpmap to issue a warning if a photon reaches the
+		maximum number of bounces (as specified with -apm) and is
+		terminated.
+				
+-DPMAP_LOOKUP_WARN
+		Causes rtrace et al to issue warnings when short photon
+		lookups occur, i.e.  fewer photons are found than specified
+		as lookup bandwidth with -ap.  This is generally not fatal,
+		but can increase noise, and may indicate a higher bandwidth
+		is needed. This is disabled per default as it can result in
+		excessive console clutter.
+
+-DPMAP_LOOKUP_REDO
+		Causes rtrace et al to repeat short photon map
+		lookups with a progressively larger radius until the
+		target photon count specified with -ap is met. This switch
+		has no effect in conjunction with the -am option, since this
+		disables lookup radius adaptation.
+
+-DPMAP_EPANECHNIKOV
+		Causes rtrace et al to apply an Epanechnikov filter during 
+		photon density estimates. This weights photons according to
+		the inverse distance to the lookup point in order to reduce
+		bias. The default behaviour does not perform filtering.