DoRadiositySwitch(3D)

NAME
DoRadiositySwitch - Create radiosity switch primitive attribute object

SYNOPSIS
C:
DtObject DoRadiositySwitch(switchvalue)
DtSwitch switchvalue;

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

DESCRIPTION
DoRadiositySwitch creates a radiosity switch primitive attribute object. The parameter switchvalue specifies whether radiosity calculations and display should apply to subsequently executed primitive objects.

If the radiosity switch is DcOn <DCON>, the radiosity update type set by DvSetRadiosityUpdateType <DVSRDU> determines if calculations should be performed, ignored, or if results from previous radiosity calculations should be used for display. For the primitive objects rendered using radiosity, the DoSurfaceShade <DOSRFS> and DoInterpType <DOIT> attributes, and the light source objects of the studio group are ignored. Lights are defined as emissive primitive objects, using the emission attributes (DoEmission- functions). If DoRadiosityAmbientSwitch <DORDAS> is on, an ambient component will be estimated during the radiosity solution and its contribution will be added to primitive surfaces at display time.

If the radiosity switch attribute is DcOff <DCOFF>, radiosity is ignored for the subsequent primitive objects and shading is performed according to the shading model selected with DoSurfaceShade <DOSRFS> and and DoInterpType <DOIT>.

For the radiosity switch to have any effect, radiosity must first be initialized with a call to DsRadiosityInitialize <DSRDIN>.

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

SEE ALSO
DsRadiosityInitialize(3D), DvSetRadiosityUpdateType(3D), DvSetFormFactorCompType(3D), DvSetRadiosityConvergence(3D) DoEmissionSwitch(3D), DoEmissionColor(3D), DoEmissionFactor(3D), DoRadiosityAmbientSwitch(3D)