Platform Package reference: Function EwModifyBitmapPalette()
Description of the function EwModifyBitmapPalette() available in all Platform Packages for C compatible target systems. This function is intended to be used when integrating the Embedded Wizard created GUI application with the underlying graphics subsystem, graphics hardware or other external GUI applications coexisting on the same system.
Declaration
void EwModifyBitmapPalette
(
XBitmap* aBitmap,
XInt32 aIndex,
XInt32 aCount,
XColor* aColors
)
Parameters
aBitmap
Bitmap to modify its palette. The bitmap has to be created with EW_PIXEL_FORMAT_INDEX8 format.
aIndex
Number of the first bitmap palette entry affected by the modification. The value lies in range 0 .. 255.
aCount
Number of consecutive palette entries to modify starting with the entry aIndex.
aColors
Array with aCount colors to copy to the palette within the area specified by the parameter aIndex and aCount.
Discussion
The function EwModifyBitmapPalette() changes color values within the palette of the given Index8 bitmap (see format EW_PIXEL_FORMAT_INDEX8 in the description of the function EwCreateBitmap). If applied on a non Index8 bitmap, the function will ignore the operation. In case of a multi-frame bitmap, the modification affects all frames within this bitmap.