NAME

DoReflectionSwitch − Create a primitive attribute object for enabling or disabling the use of reflection

SYNOPSIS

C:

DtObject DoReflectionSwitch(switchvalue)
DtSwitch switchvalue;

FORTRAN:

INTEGER∗4 DOREFS(SWVAL)
INTEGER∗4 SWVAL

DESCRIPTION

DoReflectionSwitch creates a reflection switch primitive attribute object. 

Reflection is the response of a surface to light from primitive objects in the environment where the reflected light is centered around the mirror direction.  In computing the reflection component of a surface shade, a surface’s response to reflected light will be determined by the specular color and the specular intensity attributes.  Hence, the reflection color of the object will appear the same as its specular color except that its response is only to light reflected from primitive objects and not directly from light sources.  Note also that the specular factor (DoSpecularFactor <DOSPCF>) is not used for reflection component calculations. 

The parameter switchvalue specifies whether the surfaces of subsequently executed primitive objects have a reflection component contribution.  Possible values are:

DcOff <DCOFF>
The object will render itself without a reflection shading component regardless of the settings of the specular color and specular intensity attributes.  These attributes will continue to be updated even though they will be ignored.

DcOn <DCON>
The object will render itself using reflections whenever possible.

DEFAULTS

The default value for DoReflectionSwitch is DcOff <DCOFF>. 

SEE ALSO

DoGlbRendRayLevel(3D), DoSpecularColor(3D), DoSpecularIntens(3D)

September 02, 1992