ViewVC Help

View File | Revision Log | Show Annotations | Download File | Root Listing

root/Development/ray/doc/notes/compile_switches

Comparing ray/doc/notes/compile_switches (file contents):
Revision 1.2 by greg, Thu Jan 1 19:31:45 2004 UTC vs.
Revision 1.7 by rschregle, Mon May 30 12:21:56 2016 UTC

#	Line 1 | Line 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
4	>	-DALIGNT=(type) Alignment type, machine-dependent.  Most RISC
5		architectures align on 8-word boundaries (double).
6		The default alignment type is int.
7
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	–	rays to trace before checking input in rvu and
17	–	whether or not to optimize the color table in ximage
18	–	on 8-bit displays.
19	–
8		-DWFLUSH=(rays) Override for number of rays before flush in rvu.
9
10	<	-DBSD           Operating system has a strong Berkeley flavor, meaning
11	<	that bcopy() and bzero() are present but maybe memcpy()
12	<	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.
10	>	-DBSD           Operating system has a strong Berkeley flavor, which
11	>	affects certain system calls, such as signal handling and
12	>	resource tracking.
13
14		-DSMLMEM        The system has little RAM available, so size hash
15		tables and the like accordingly.  Only allows for
#	Line 39 | Line 25 | for specific machines and users:
25		Values greater than 20 use over 4 Kbytes per
26		light source, which can add up to a lot of
27		memory in scenes with many sources.
28	+
29	+	-DAVGREFL=R     Set the average surface reflectance for the purpose
30	+	of indirect irradiance calculations to R, where
31	+	R is a real number in the range (0,1.0).  The
32	+	default value is 0.50 (50%).
33	+
34	+	-DPMAP_OOC      Builds the out-of-core photon map. The photon data resides
35	+	in a leaf file on disk with suffix ".leaf" and is loaded on
36	+	demand. This is intended for very large photon maps (up to
37	+	4.3 billion photons) particularly for annual simulations
38	+	with rcontrib. This switch is disabled by default, which
39	+	builds the in-core photon map used in previous releases;
40	+	this resides entirely in main memory. These options are
41	+	mutually exclusive, and the resulting photon map files are
42	+	incompatible.
43	+
44	+	-DPMAP_PRIMARYPOS
45	+	Stores photon primary hitpoints for binning using the -f
46	+	option with rcontrib if the function file requires them.
47	+	This consumes an additional 3 floats and is disabled per
48	+	default to reduce the size of the resulting photon maps.
49	+
50	+	-DPMAP_FLOAT_FLUX
51	+	Stores photon flux as floats instead of more compact RGBE
52	+	(the default). In terms of accuracy, the difference would
53	+	only be noticeable with highly saturated colours.
54	+
55	+	-DPMAP_ROI      Enables the -api option to mkpmap. This constrains photon
56	+	deposition only to the specified region of interest (defined
57	+	as a bounding volume) for situations where it is known a
58	+	priori that photon map lookups will occur outside this
59	+	region. This is disabled per default as it can lead to
60	+	biased results outside the ROI, or near its boundaries. Ziss
61	+	option for ze eckspertz only!
62	+
63	+	-DPMAP_RUNAWAY_WARN
64	+	Causes mkpmap to issue a warning if a photon reaches the
65	+	maximum number of bounces (as specified with -apm) and is
66	+	terminated.
67	+
68	+	-DPMAP_LOOKUP_WARN
69	+	Causes rtrace et al to issue warnings when short photon
70	+	lookups occur, i.e.  fewer photons are found than specified
71	+	as lookup bandwidth with -ap.  This is generally not fatal,
72	+	but can increase noise, and may indicate a higher bandwidth
73	+	is needed. This is disabled per default as it can result in
74	+	excessive console clutter.
75	+
76	+	-DPMAP_LOOKUP_REDO
77	+	Causes rtrace et al to repeat short photon map
78	+	lookups with a progressively larger radius until the
79	+	target photon count specified with -ap is met. This switch
80	+	has no effect in conjunction with the -am option, since this
81	+	disables lookup radius adaptation.
82	+
83	+	-DPMAP_EPANECHNIKOV
84	+	Causes rtrace et al to apply an Epanechnikov filter during
85	+	photon density estimates. This weights photons according to
86	+	the inverse distance to the lookup point in order to reduce
87	+	bias. The default behaviour does not perform filtering.

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines (old)
>	Changed lines (new)