Platform Package reference: Function EwFindUserColor()

Description of the function EwFindUserColor() 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.


XUInt8 EwFindUserColor( XColor aColor )



Color to search for within the user defined color area of the global CLUT (color look-up table).


The function EwFindUserColor() searches the global CLUT (color look-up table) for an entry containing exactly the given user defined color. If no corresponding entry could be found, the function returns 0 (zero). In this case, the best fit color can be found by using the function EwColorToIndex().

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.