NAME

DoLightSwitch − Create a primitive attribute object enabling or 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, subsequent primitive objects will ignore the specified light when rendering themselves, regardless of the type of shading.  If the switchvalue is DcOn, primitive objects will render themselves 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 02, 1992