depthcue(3G)

NAME
     depthcue - turns depth-cue mode on and off

C SPECIFICATION
     void depthcue(mode)
     Boolean mode;

PARAMETERS
     mode   expects either TRUE or FALSE.

            TRUE turns depthcue mode on.

            FALSE turns depthcue mode off.

DESCRIPTION
     depthcue turns depth-cue mode on or off. If depth-cue mode is on, all
     lines, points, characters, and polygons are drawn depth-cued. This means
     only the z values and the range of color values specified by lshaderange
     or lRGBrange determine the color of the lines, points, characters, or
     polygons.  The z values, whose range is set by lsetdepth, are mapped
     linearly into the range of color values.  In this mode, lines that vary
     greatly in z value span the range of colors specified by lshaderange or
     lRGBrange.

     In color index mode, the color map entries specified by lshaderange
     should be loaded with a series of colors that gradually increase or
     decrease in intensity.

SEE ALSO
     lRGBrange, lsetdepth, lshaderange

BUGS
     On Impact depthcue does not work in Color Index mode. It will always
     force GOURAUD, shading to be on.  On Impact and Infinite Reality depthcue
     will not work with a singular MPROJECTION matrix.