[ Previous | Next | Contents | Glossary | Home | Search ]
GL3.2 for AIX: Graphics Library (GL) Technical Reference

depthcue Subroutine

Purpose

Turns depth-cueing on and off.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void depthcue(Int32 mode)

FORTRAN Syntax

SUBROUTINE DEPTHC(mode)
LOGICAL mode;

Description

The depthcue subroutine turns depth-cueing on or off. If the value of the mode parameter is TRUE, depth-cueing is enabled, and all lines, points, characters, and polygons drawn by the system are depth-cued. This means that the color of the lines, points, characters, or polygons are determined by the z values and the range of color indexes specified by the lshaderange or lRGBrange subroutine determines the color of the lines, points, characters, or polygons.

The z values, whose range is set by the lsetdepth subroutine, are mapped linearly into the range of color indexes. In this mode, lines that vary greatly in z value span the range of colors specified by the lshaderange subroutine.

For depth-cueing to work properly, the color map locations specified by the lshaderange subroutine must be loaded with a series of colors that gradually increase or decrease in intensity.

Parameter

mode Specifies a value indicating OFF or ON state of depth-cueing. Values for the mode parameter are as follows:
1 = True (ON)
0 = False (OFF)

Example

The example C language program depthcue.c uses the depthcue subroutine to turn on depth-cueing.

Implementation Specifics

This subroutine is part of GL in the AIXwindows Environment/6000 Version 1, Release 2 with AIXwindows/3D Feature.

Files

/usr/include/gl/gl.h Contains C language constant and variable type definitions for GL.
/usr/include/gl/fgl.h Contains FORTRAN constant and variable type definitions for GL.

Related Information

Indicating whether depth-cue mode is on or off with the getdcm subroutine.

Setting the range of RGB colors used for depth-cueing with the lRGBrange subroutine.

Setting the viewport depth range with the lsetdepth subroutine.

Setting the range of color indexes used for depth-cueing with the lshaderange subroutine.

AIX Graphics Library Overview, Performing Depth-Cueing, and Working in Color Map and RGB Modes.


[ Previous | Next | Contents | Glossary | Home | Search ]