DoRadiosityAmbientSwitch(3D)

NAME
DoRadiosityAmbientSwitch - Create radiosity ambient switch primitive attribute object

SYNOPSIS
C:
DtObject DoRadiosityAmbientSwitch(switchvalue)
DtSwitch switchvalue;

FORTRAN:
INTEGER*4 DORDAS(SWVAL)
INTEGER*4 SWVAL

DESCRIPTION
DoRadiosityAmbientSwitch creates a radiosity switch primitive attribute object. The parameter switchvalue specifies whether an estimated ambient component should be added to the radiosity of an object at the time it is displayed.

When radiosity is used, a global ambient component is computed using the total unshot energy in the scene and an average overall interreflection factor. If the DoRadiositySwitch <DORADS> switch is DcOn <DCON> for an object, the global ambient component is weighted by the object's reflectance (its diffuse color) and the result is added to the current radiosity value of the object. The ambient term is added for display purposes only and is not taken into account by the radiosity solution itself.

With progressive radiosity, energy is distributed in an iterative manner. Dark images may result when displaying the results of the first few iterations. The addition of the ambient component overestimates the actual objects' intensities. This provides a way to get brighter images early in the process. The contribution of the ambient term decreases as more iterations are computed, and becomes null when no more unshot energy remains in the scene.

DEFAULTS
The default value for DoRadiosityAmbientSwitch is DcOff <DCOFF>.

SEE ALSO
DoRadiositySwitch(3D)