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.  This attribute can be either DcComponent <DCCOMP> or DcRange <DCRNG>.  A value of DcComponent <DCCOMP> means that each primary computed color (red, green, and blue) is compressed into a limited bit range and the resulting bit fields are Or’ed together to form a single n-bit value.  The compression algorithm is fixed for a specific value of n (for n = 8; 3 bits red, 3 bits green, 2 bits blue). 

A value of DcRange <DCRNG> specifies that the user has loaded a particular color map containing known ranges of shading (like gold and silver) into the pseudocolor device.  The DdInqShadeRanges <DDQSR> and DdSetShadeRanges <DDSSR> calls inquire and setup the contents of specific shade ranges.  See these manual pages 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 29, 2021