NAME

DoAmbientSwitch − Create a primitive attribute object for enabling or disabling use of the ambient component of a surface’s response to light

SYNOPSIS

C:

DtObject DoAmbientSwitch(switchvalue)
DtSwitch switchvalue;

FORTRAN:

INTEGER∗4 DOAMBS(SWVAL)
INTEGER∗4 SWVAL

DESCRIPTION

DoAmbientSwitch creates an ambient switch primitive attribute object.  The parameter switch specifies whether or not the surfaces of subsequently executed primitive objects have an ambient component contribution. 

The ambient component of an object’s surface shade will be computed using the diffuse color (see DoDiffuseColor) and the ambient intensity (see DoAmbientIntens) attributes to determine the response of the surface to ambient light. 

If the ambient switch attribute of an object is DcOff <DCOFF>, that object will render itself without an ambient shading component regardless of the settings of the diffuse color and ambient intensity attributes. 

DEFAULTS

The default value for DoAmbientSwitch is DcOn <DCON>. 

SEE ALSO

DoDiffuseColor(3D), DoAmbientIntens(3D)

September 02, 1992