doc/notes/rpict.options

                        SETTING RENDERING OPTIONS

The table below gives some useful ranges for some Radiance 2.4 parameters.
The "min" value gives the fastest, crudest rendering.  It is not
necessarily the smallest value numerically.  The "fast" value gives
a reasonably fast rendering.  The "accur" value gives a reasonably
accurate rendering.  The "max" value gives the ultimate in accuracy.

Param   Description             Min     Fast    Accur   Max     Notes
=====   ====================    =====   =====   =====   =====   =====
-ps     pixel sampling rate     16      8       4       1
-pt     sampling threshold      1       .15     .05     0
-pj     anti-aliasing jitter    0       .6      .9      1       A
-pm     pixel motion            0       0       1       1       B
-dj     source jitter           0       0       .7      1       B
-ds     source substructuring   0       .5      .15     .05
-dt     direct thresholding     1       .5      .05     0       C
-dc     direct certainty        0       .25     .5      1
-dr     direct relays           0       1       3       6
-dp     direct pretest density  32      64      512     0       C
-sj     specular jitter         0       .3      .7      1       A
-st     specular threshold      1       .85     .15     0       C
-aw     ambient weight          0       100     10      inf     A
-ab     ambient bounces         0       0       2       8
-aa     ambient accuracy        .5      .2      .1      0       C
-ar     ambient resolution      8       32      256     0       C
-ad     ambient divisions       0       128     1024    8192
-as     ambient super-samples   0       32      512     2048
-ms     mist sampling dist.     0       10      1       .01
-lr     limit reflection        0       6       8       16
-lw     limit weight            .05     .01     .002    0       C

NOTES:
        A) This option does not affect the rendering time
        B) This option adversely affects image sampling (ie. use -ps 1)
        C) Maximum value disables optimization and can be very expensive

-------------------------------------------------------------------------

                ARTIFACTS ASSOCIATED WITH OPTIONS

Param   Artifact                                Solution
=====   ===================================     =========================
-ps     "missing pieces" to objects             decrease value by 50%
-pt     some soft edges are very jagged         decrease value by 50%
-pj     diagonal edges are like staircases      increase value to 0.9
-pj     edges look too erratic                  decrease value to 0.4
-dj     shadows are unnaturally sharp           increase value to 0.7
-ds     large sources cast unnatural shadows    decrease value by 50%
-dt     some shadows disappear                  decrease value by 50%
-dc     inaccurate values with many sources     increase value to .75
-dr     missing multiple mirror reflections     increment value
-dp     incorrect mirror reflections            double value
-sj     specular reflections too fuzzy          decrease value to 0.2
-sj     specular reflections too sharp          increase value to 1
-st     some specular highlights missing        decrease value to 0.02
-aw     shadows appear to glow                  set value to 0
-ab     lighting in shadows too flat            increment value
-av     overall light level seems too high/low  decrease/increase value
-aa     uneven shading boundaries in shadows    decrease value by 25%
-ar     shading wrong in some areas             double or quadruple value
-ad     "splotches" of light                    double value
-as     "splotches" of light                    increase to half of -ad setting
-ms     "noisy" mist scattering                 divide value by 2
-lr     some multiple specular reflections gone increment value
-lw     some specular reflections gone          decrease value by 50%

-------------------------------------------------------------------------

                TIMINGS ASSOCIATED WITH OPTIONS

Param   Effect on Execution Time
=====   ==================================================================
-ps     inverse, halving value increases rendering time up to four times
-pt     minor, decreasing value causes modest increase in rendering time
-pj     no effect
-dj     indirect, increasing value requires -ps parameter to be reduced
-ds     inverse, halving value causes rendering time to approximately double
-dt     inverse, halving value causes rendering time to increase about 50%
-dc     direct, affects rendering time up to 50% over its 0 to 1 range
-dr     direct, depending on the scene each new reflection can double time
-dp     minor, affects start-up time only, higher values take longer
-sj     no effect
-st     minor, a value of zero may increase rendering by 50% over maximum of 1
-ab     direct, doubling this value can double rendering time
-aa     direct, doubling this value approximately quadruples rendering time
-ar     direct, effect depends on scene, can quadruple time for double value
-ad     direct, doubling value may double rendering time
-as     direct, effectively adds to -ad parameter and its cost
-lr     minor, increase causes very slightly longer rendering time
-lw     minor, decrease causes very slightly longer rendering time
Revision:	1.3
Committed:	Tue Oct 21 15:34:28 2003 UTC (22 years ago) by greg
Branch:	MAIN
CVS Tags:	rad3R7P2, rad3R7P1, rad3R6, rad3R6P1, rad3R8, rad3R9
Changes since 1.2:	+1 -1 lines
Log Message:	Adjusted the -ds maximum value
#	User	Rev	Content
1	greg	1.1	SETTING RENDERING OPTIONS
2
3			The table below gives some useful ranges for some Radiance 2.4 parameters.
4			The "min" value gives the fastest, crudest rendering. It is not
5			necessarily the smallest value numerically. The "fast" value gives
6			a reasonably fast rendering. The "accur" value gives a reasonably
7			accurate rendering. The "max" value gives the ultimate in accuracy.
8
9			Param Description Min Fast Accur Max Notes
10			===== ==================== ===== ===== ===== ===== =====
11			-ps pixel sampling rate 16 8 4 1
12			-pt sampling threshold 1 .15 .05 0
13			-pj anti-aliasing jitter 0 .6 .9 1 A
14			-pm pixel motion 0 0 1 1 B
15			-dj source jitter 0 0 .7 1 B
16	greg	1.3	-ds source substructuring 0 .5 .15 .05
17	greg	1.1	-dt direct thresholding 1 .5 .05 0 C
18			-dc direct certainty 0 .25 .5 1
19			-dr direct relays 0 1 3 6
20			-dp direct pretest density 32 64 512 0 C
21			-sj specular jitter 0 .3 .7 1 A
22			-st specular threshold 1 .85 .15 0 C
23			-aw ambient weight 0 100 10 inf A
24			-ab ambient bounces 0 0 2 8
25	greg	1.2	-aa ambient accuracy .5 .2 .1 0 C
26			-ar ambient resolution 8 32 256 0 C
27			-ad ambient divisions 0 128 1024 8192
28			-as ambient super-samples 0 32 512 2048
29	greg	1.1	-ms mist sampling dist. 0 10 1 .01
30	greg	1.2	-lr limit reflection 0 6 8 16
31	greg	1.1	-lw limit weight .05 .01 .002 0 C
32
33			NOTES:
34			A) This option does not affect the rendering time
35			B) This option adversely affects image sampling (ie. use -ps 1)
36			C) Maximum value disables optimization and can be very expensive
37
38			-------------------------------------------------------------------------
39
40			ARTIFACTS ASSOCIATED WITH OPTIONS
41
42			Param Artifact Solution
43			===== =================================== =========================
44			-ps "missing pieces" to objects decrease value by 50%
45			-pt some soft edges are very jagged decrease value by 50%
46			-pj diagonal edges are like staircases increase value to 0.9
47			-pj edges look too erratic decrease value to 0.4
48			-dj shadows are unnaturally sharp increase value to 0.7
49			-ds large sources cast unnatural shadows decrease value by 50%
50			-dt some shadows disappear decrease value by 50%
51			-dc inaccurate values with many sources increase value to .75
52			-dr missing multiple mirror reflections increment value
53			-dp incorrect mirror reflections double value
54			-sj specular reflections too fuzzy decrease value to 0.2
55			-sj specular reflections too sharp increase value to 1
56			-st some specular highlights missing decrease value to 0.02
57			-aw shadows appear to glow set value to 0
58			-ab lighting in shadows too flat increment value
59			-av overall light level seems too high/low decrease/increase value
60			-aa uneven shading boundaries in shadows decrease value by 25%
61			-ar shading wrong in some areas double or quadruple value
62			-ad "splotches" of light double value
63			-as "splotches" of light increase to half of -ad setting
64			-ms "noisy" mist scattering divide value by 2
65			-lr some multiple specular reflections gone increment value
66			-lw some specular reflections gone decrease value by 50%
67
68			-------------------------------------------------------------------------
69
70			TIMINGS ASSOCIATED WITH OPTIONS
71
72			Param Effect on Execution Time
73			===== ==================================================================
74			-ps inverse, halving value increases rendering time up to four times
75			-pt minor, decreasing value causes modest increase in rendering time
76			-pj no effect
77			-dj indirect, increasing value requires -ps parameter to be reduced
78			-ds inverse, halving value causes rendering time to approximately double
79			-dt inverse, halving value causes rendering time to increase about 50%
80			-dc direct, affects rendering time up to 50% over its 0 to 1 range
81			-dr direct, depending on the scene each new reflection can double time
82			-dp minor, affects start-up time only, higher values take longer
83			-sj no effect
84			-st minor, a value of zero may increase rendering by 50% over maximum of 1
85			-ab direct, doubling this value can double rendering time
86			-aa direct, doubling this value approximately quadruples rendering time
87			-ar direct, effect depends on scene, can quadruple time for double value
88			-ad direct, doubling value may double rendering time
89			-as direct, effectively adds to -ad parameter and its cost
90			-lr minor, increase causes very slightly longer rendering time
91			-lw minor, decrease causes very slightly longer rendering time