NAME

DoAmbientSwitch − Create an ambient switch primitive attribute object

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.  The ambient component of the surface will not be computed. 

DEFAULTS

The default value for DoAmbientSwitch is DcOn <DCON>. 

SEE ALSO

DoDiffuseColor(3D), DoAmbientIntens(3D)

September 29, 2021