Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 1 - Palette Manager Reference /

Palette Manager Functions / Manipulating Palette Entries

SetEntryColor

Changes the color of a palette entry.

pascal void SetEntryColor(
                        PaletteHandle dstPalette,
                        short dstEntry,
const RGBColor *srcRGB);

dstPalette

The palette whose entry color is to be changed.

dstEntry

The palette entry to be changed.

srcRGB

A pointer to an RGB color structure specifying the new RGB color value.

DISCUSSION

The SetEntryColor function stores the RGB color of the srcRGB parameter in the palette entry specified by the dstEntry parameter. SetEntryColor marks the entry as having changed, but it does not change the color environment. The change occurs upon the next call to ActivatePalette. SetEntryColor marks modified entries such that the palette is updated, even though no update is required by a change in the color environment.

SEE ALSO

For an example of using the SetEntryColor function to change the colors in a palette, see Listing 1-1 (page 1-22) in Advanced Color Imaging on the Mac OS.