AnimateEntry

Change a palette color to a specific RGB

#include <Palettes.h> Palette Manager

void AnimateEntry( destWindow, destEntry, srcRGB );

WindowPtr destWindow ; pointer to the address of a window

short destEntry ; identification of palette color being changed

RGBColor *srcRGB ; value of new color to substitute

AnimateEntry applies a source RGB's values to a destination entry in a window.

destWindow is the window having its color environment changed.

destEntry is the location of the color being changed.

srcRGB is the specified RGB value for the new color.

Returns: none

Notes: Use this routine to substitute a particular destEntry's RGB from what is

specified in the palette associated with its window to another value you'd rather

have. This routine changes the color from old to new in all device's touched by

the window. Since this is a change that only affects an animating color which,

by definition, is reserved, no other windows are modified and no change is made

to the overall color environment. This routine only works with colors you've

set aside as animating colors and is further restricted to active entries--the

index must be current.

Don't try to use this procedure if you've used SetPalette to block updates to

this particular window with CUpdates = FALSE. You'll wind up with a situation

where redrawing the window (for instance, as the result of a color update

event) will remove all the animating colors that don't belong to the window.

That happens because ActivatePalette is reserving device indexes for

animation when the window is already using them.

Referenced by (14):