Simulation support:

This function is simulated by a handling routine in Revision 2.0 (or higher) of the graphics engine.

Description

GreDeviceAnimatePalette is the presentation driver version of GreAnimatePalette. It is called to process an application's GreAnimatePalette request. The purpose of this function is to modify the RGB values in the hardware palette rapidly and make the changes apparent immediately. Changes are reflected immediately for each logical palette entry that is marked as PC-RESERVED and is associated with a hardware slot. The RGB value on the logical application's palette, as well as the hardware palette itself, are updated.

This function can be hooked by the presentation driver.

#define INCL_GRE_PALETTE
#include <os2.h>

HDC       hdc;        /*  Device context handle. */
ULONG     hdevpal;    /*  Device palette handle. */
ULONG     ulFormat;   /*  Specifies the entry format. Must be LCOLF_CONSECRGB. */
ULONG     ulStart;    /*  Starting index, that is, the first palette entry to change. */
ULONG     cclr;       /*  Count of the palette entries to change. */
PULONG    pclr;       /*  Pointer to table of new RGB2 palette entries. */
PVOID     pInstance;  /*  Pointer to instance data. */
ULONG     lFunction;  /*  High-order WORD=flags; low-order WORD=NGreDeviceAnimatePalette. */
ULONG     rc;         /*  Return codes. */

rc = GreDeviceAnimatePalette(hdc, hdevpal,
       ulFormat, ulStart, cclr, pclr, pInstance,
       lFunction);