Platform Package reference: Function EwFreeUserColor()

Description of the function EwFreeUserColor() available in Platform Packages for C compatible target systems running in the color format Index8 (CLUT based). 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 EwFreeUserColor( XInt32 aIndex )

Parameters

aIndex

Index of the user color entry within the global CLUT (color look-up table) to free.

Discussion

The function EwFreeUserColor() removes the user defined color entry from the global CLUT (color look-up table). After this the affected CLUT entry is considered as empty. User defined colors exist for external applications coexisting with the GUI application only. In this manner the external application can manage its own/private set of color values. To allocate a user specific color value within the CLUT the function EwAllocUserColor() is available.