NAME

DdSetColorEntries − Set the color lookup table entries of a device

SYNOPSIS

C:

void DdSetColorEntries(device, colormodel, start, count,
entries)
DtObject device;
DtColorModel colormodel;
DtInt start;
DtInt count;
DtReal entries[];

FORTRAN:

CALL DDSCE(DEVICE, COLMOD, START, COUNT,
ENTRYS)
INTEGER∗4 DEVICE
INTEGER∗4 COLMOD
INTEGER∗4 START
INTEGER∗4 COUNT
REAL∗8 ENTRYS(∗)

DESCRIPTION

DdSetColorEntries sets the color entries in the color lookup table of a pseudocolor device, device, starting at the start location for count number of entries in the array, entries.  Many actual devices use a color lookup table or a fixed set of colors or grey values.  DdSetColorEntries allows the user to specify a set of colors for these tables if they are user-writable.  Use DdInqVisualType <DDQVT> to determine whether a device has user-writable tables.  The valid visual types are DcGreyScale <DCGRYS>, DcDirectColor <DCDRCC>, and DcPseudoColor <DCPSUC>:

DcPseudoColor <DCPSUC>
A pixel value indexes a color map to determine the color to be displayed; the entries in the color map can be changed dynamically.

DcGreyScale <DCGRYS>
These devices are the same as pseudocolor devices, except that only the intensities of the entries specified in the lookup table are displayed.

DcDirectColor <DCDRCC>
A pixel value is decomposed into separate subfields, and each subfield separately indexes the color map for the corresponding value. The entries in the color map can be changed dynamically. Typically, the color map is used for displaying false color or for performing gamma correction.

colormodel
Specifies the color model of the colors in the array entries. 

start    
Specifies the beginning entry.

countSpecifies the total number of colors to be set. 

entriesThe array of values for the kind of color specified by colormodel.  For example, entries of color values for colormodel DcRGB <DCRGB> would take three components: a red value, a green value, and a blue value. 

ERRORS

DdSetColorEntries will fail if the device handle is invalid. 

[WARNING - invalid device handle]

DdSetColorEntries will fail if the start or count parameters refer to entries outside the color lookup table boundaries. 

[WARNING - bad start and/or count values]

SEE ALSO

DdInqColorEntries(3D), DdInqColorTableSize(3D), DdInqVisualType(3D)

September 02, 1992