Windows 3.1 Device Drivers (ddag31qh.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
UpdateColors
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
VOID UpdateColors(wStartX, wStartY, wExtX, wExtY, lpTranslate)
WORD wStartX;         /* <x>-coordinate of upper-left corner */
WORD wStartY;         /* <y>-coordinate of upper-left corner */
WORD wExtX;           /* width in screen pixels            */
WORD wExtY;           /* height in screen pixels           */
LPWORD lpTranslate;   /* points to translation table       */
 
The UpdateColors function redraws all pixels in a region on the display
surface using the colors specified in the given translation table. For each
pixel in the region, the function reads the pixel's color index, translates
the index, and writes the translated index back to the original position.
 
A graphics driver must export the GetPalette function if the RC_PALETTE bit
is set in the dpRaster member of the driver's GDIINFO structure.
 
Parameter    Description
────────────────────────────────────────────────────────────────────────────
 
 
wStartX      Specifies the y-coordinate of the upper-left corner of the
             region to update.
 
wStartY      Specifies the y-coordinate of the upper-left corner of the
             region to update.
 
wExtX        Specifies the width of the rectangular region to update in
             pixels.
 
wExtY        Specifies the height of the rectangular region to update in
             pixels.
 
lpTranslate  Points to an array of color indexes.
 
Return Value
 
This function has no return value.
 
Comments
 
The export ordinal for this function is 26.
 
GDI assumes that the display origin is in the upper-left corner of the
screen.
 
                                      ♦