NAME

DdSetShadeMode − Set the shade mode of a device

SYNOPSIS

C:

void DdSetShadeMode(device, mode)
DtObject device;
DtShadeMode mode;

FORTRAN:

CALL DDSSM(DEVICE, MODE)
INTEGER∗4 DEVICE
INTEGER∗4 MODE

DESCRIPTION

DdSetShadeMode specifies 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 at output. 

The shade mode specifies how this compression is performed. The values that can be returned are:

DcComponent <DCCOMP>
Each primary computed color (red, green, or blue) is compressed into a limited bit range and the resulting bit fields are combined with a bitwise or function to form a single n-bit value.  For each value of n, the compression algorithm is fixed.  For example, when n = 8, 3 bits are red, 3 bits are green, and 2 bits are blue. 

DcRange <DCRNG>
The user has loaded a particular color map with known ranges of shading (such as gold or silver) into the pseudocolor device. The DdInqShadeRanges <DDQSR> and DdSetShadeRanges <DDSSR> functions inquire and set up the contents of specific shade ranges for the device.  See the manual pages for those calls for more information about pseudocolor mode. 

ERRORS

DdSetShadeMode will fail if the device handle is invalid. 

[WARNING - invalid device handle]

DdSetShadeMode will fail if the mode value is invalid. 

[WARNING - bad mode value]

DEFAULTS

The default mode is DcComponent <DCCOMP>. 

SEE ALSO

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

September 02, 1992