[ViewVC] Annotation of: radiance/ray/doc/notes/compile_switches

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
                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 rvu 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.

-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).

-DSMLFLT        This setting tells Radiance to use short floats
                (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%).  This value indirectly
                controls the maximum number of ambient bounces,
                which can never be more than the log of the -ad
                setting times the log of AVGREFL.
Revision:	1.3
Committed:	Wed Feb 23 18:24:00 2005 UTC (19 years, 2 months ago) by greg
Branch:	MAIN
Changes since 1.2:	+8 -0 lines
Log Message:	Added ability to redefine AVGREFL with a compile switch
#	User	Rev	Content
1	greg	1.1	Here is a list of compile switches, used to customize Radiance code
2			for specific machines and users:
3
4			-DMC If set, switches from default low-discrepency sequence
5			sampling to true (pseudorandom) Monte Carlo. Use if
6			the "brushed" appearance of specular highlights and
7			penumbras bothers you.
8
9			-DALIGN=(type) Alignment type, machine-dependent. Most RISC
10			architectures align on 8-word boundaries (double).
11			The default alignment type is int.
12
13			-DSPEED=(MIPS) Millions of instructions per second for this
14			processor (approximate). This is used to decide
15			certain unimportant timing issues such as how many
16	greg	1.2	rays to trace before checking input in rvu and
17	greg	1.1	whether or not to optimize the color table in ximage
18			on 8-bit displays.
19
20	greg	1.2	-DWFLUSH=(rays) Override for number of rays before flush in rvu.
21	greg	1.1
22			-DBSD Operating system has a strong Berkeley flavor, meaning
23			that bcopy() and bzero() are present but maybe memcpy()
24			and memset() are not. (See common/standard.h for other
25			things this flag affects.) Also affects certain system
26			calls, such as signal handling and resource tracking.
27
28	greg	1.2	-DSMLMEM The system has little RAM available, so size hash
29			tables and the like accordingly. Only allows for
30			small scene descriptions (32,256 primitives).
31	greg	1.1
32			-DSMLFLT This setting tells Radiance to use short floats
33	greg	1.2	(32 bits) throughout, which saves lots of memory
34	greg	1.1	but can cause calculation inaccuracies in many
35			cases. Its use has been discontinued for this reason.
36	greg	1.2
37			-DSHADCACHE=N The array size to use for caching occluders.
38			Setting this to 0 turns off this optimization.
39			Values greater than 20 use over 4 Kbytes per
40			light source, which can add up to a lot of
41			memory in scenes with many sources.
42	greg	1.3
43			-DAVGREFL=R Set the average surface reflectance for the purpose
44			of indirect irradiance calculations to R, where
45			R is a real number in the range (0,1.0). The
46			default value is 0.50 (50%). This value indirectly
47			controls the maximum number of ambient bounces,
48			which can never be more than the log of the -ad
49			setting times the log of AVGREFL.