NAME

DoLightSwitch − Create a primitive attribute object enabling/disabling illumination from a light

SYNOPSIS

C:

DtObject DoLightSwitch(light, switchvalue)
DtObject light;
DtSwitch switchvalue;

Fortran:

INTEGER∗4 DOLTS(LIGHT, SWVAL)
INTEGER∗4 LIGHT
INTEGER∗4 SWVAL

DESCRIPTION

DoLightSwitch creates a light switch primitive attribute.  The parameter light is a handle to a light object that has been created with DoLight <DOLT>.  The switchvalue parameter is used to specify whether or not the surfaces of subsequent primitive objects are affected by the light light.  If the switchvalue is DcOff, the primitive object will ignore the specified light when rendering itself, regardless of the type of shading.  If the switchvalue is DcOn, the primitive object will render itself using illumination from the specified light whenever possible. 

ERRORS

DoLightSwitch will fail if light is not a valid light object. 

[WARNING - invalid or deleted object]

DEFAULTS

By default all primitive objects are affected by all defined lights. 

SEE ALSO

DoLight(3D)

September 29, 2021