Platform Package reference: Function EwModifyBitmapPalette()

Description of the function EwModifyBitmapPalette() available in all Platform Packages for ANSI 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.