DdSetShadeMode(3D) — Stardent Computer Inc. (Doré)

NAME

DdSetShadeMode − Set the shade mode of a device

SYNOPSIS

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. The mode parameter can take one of the following two values: DcComponent <DCCOMP> and DcRange <DCRNG>.

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 mode attribute specifies how this compression is to be performed. This attribute can be either DcComponent <DCCOMP> or DcRange <DCRNG>. A value of DcComponent 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 into the pseudocolor device which has known ranges of shading (like gold and silver). The DdInqShadeRanges <DDQSR> and DdSetShadeRanges <DDSSR> calls inquire and setup the contents of specific shade ranges for the device. See these manual pages for further information on this 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 device is DcComponent <DCCOMP>.

Museum