DdInqShadeRanges(3D)

NAME
DdInqShadeRanges - Return the shade range table entries of a device

SYNOPSIS
C:
void DdInqShadeRanges(device, start, count, entries)
DtObject device;
DtInt start;
DtInt count;
DtInt entries[];

FORTRAN:
CALL DDQSR(DEVICE, START, COUNT, ENTRYS)
INTEGER*4 DEVICE
INTEGER*4 START
INTEGER*4 COUNT
INTEGER*4 ENTRYS(COUNT*2)

DESCRIPTION
DdInqShadeRanges is used to query one or more shade range table entries from a device, device.

Each entry in the shade range table consists of a pair of values defining a shade range. These values represent the color table index of the beginning and end of the range. One value represents the minimum shade value in a range, and the other represents the maximum shade value in a range. Intensities between 0.0 and 1.0 are used to linearly interpolate between these two specified limits in the color lookup table. This interpolated color table index is then sent to the device's frame buffer.

For a given shade range i, entries[2*i] is the start, or minimum value of the range, and entries[2*i+1] is the end, or maximum value of the range.

The parameter start specifies the first entry to be queried. count specifies the number of entries to be read. entries is an array containing the queried entries.

ERRORS
DdInqShadeRanges will fail if the device handle is invalid.

[WARNING - invalid device handle]

DdInqShadeRanges will also fail if the start or count parameters refer to entries outside the shade range table boundaries.

[WARNING - bad start and/or count values]

SEE ALSO
DdInqColorEntries(3D), DdInqColorTableSize(3D), DdInqShadeMode(3D), DdInqVisualType(3D), DdSetColorEntries(3D), DdSetShadeMode(3D), DdSetShadeRanges(3D), DoShadeIndex(3D)