NAME

DdInqShadeMode − Return the shade mode of a device

SYNOPSIS

C:

DtShadeMode DdInqShadeMode(device)
DtObject device;

FORTRAN:

INTEGER∗4 DDQSM(DEVICE)
INTEGER∗4 DEVICE

DESCRIPTION

DdInqShadeMode returns the shade mode of a device, device. 

Doré can produce output on devices that have limited color capability.  These devices are usually referred to as "pseudocolor" devices.  Doré always computes shades in full color, and compresses these shades to pseudocolor for output. 

The shade mode specifies how this compression is performed.  The possible values for the shade mode are:

DcComponent <DCCOMP>
Each primary computed color (red, green, and blue) is compressed into a limited bit range. The resulting bit fields are combined by a bitwise or operation to produce a single value of n bits.  Each value of n has a specific compression algorithm; for example, if n = 8, 3 bits are red, 3 bits are green, and 2 bits are blue. 

DcRange <DCRNG>
The user has loaded a color map containing specific ranges of shading (for example, gold or silver) into the pseudocolor device. The DdInqShadeRanges <DDQSR> and DdSetShadeRanges <DDSSR> calls inquire and set up the contents of specific shade ranges.  See the manual pages for those calls for further information on this pseudocolor mode. 

ERRORS

DdInqShadeMode will fail if the device handle is invalid; the returned value is undefined. 

[WARNING - invalid device handle]

SEE ALSO

DdInqColorEntries(3D), DdInqColorTableSize(3D), DdInqShadeRanges(3D), DdInqVisualType(3D), DdSetColorEntries(3D), DdSetShadeMode(3D), DdSetShadeRanges(3D), DoShadeIndex(3D), DoDevice(3D)

September 02, 1992