Platform Package reference: Function EwAllocUserColor()

Welcome to Embedded Wizard

Quick Tour - a Tutorial

Working with Embedded Wizard

Build Environments

Embedded Wizard Studio

Programming language Chora

Framework Mosaic

Platform Integration Aspects

Framebuffer Concepts

Memory Footprint

Extern Bitmap interface

Implementing Prototyper intrinsics

Certification Aspects

Platform Package reference

Function EwAlloc()

Function EwAllocUserColor()

Function EwAnyPendingSignals()

Function EwBeginUpdate()

Function EwBeginUpdateArea()

Function EwColorToIndex()

Function EwCompString()

Function EwConfigViewport()

Function EwCreateBitmap()

Function EwDoneGraphicsEngine()

Function EwDoneViewport()

Function EwEnableGfxTaskTracing()

Function EwEndUpdate()

Function EwFindUserColor()

Function EwFree()

Function EwFreeBitmap()

Function EwFreeUserColor()

Function EwGetAutoObject()

Function EwGetLanguage()

Function EwGetStringLength()

Function EwGetStyles()

Function EwIndexToColor()

Function EwInitGraphicsEngine()

Function EwInitViewport()

Function EwLockBitmap()

Function EwLockObject()

Function EwModifyBitmapPalette()

Function EwNewColor()

Function EwNewObject()

Function EwNewObjectIndirect()

Function EwNewPoint()

Function EwNewRect()

Function EwNewString()

Function EwNewStringAnsi()

Function EwNewStringChar()

Function EwNewStringUtf8()

Function EwNextTimerExpiration()

Function EwPrintPerfCounters()

Function EwPrintProfilerStatistic()

Function EwProcessSignals()

Function EwProcessTimers()

Function EwReclaimMemory()

Function EwResetPerfCounters()

Function EwSetLanguage()

Function EwSetStyles()

Function EwSetUserColor()

Function EwStringToAnsi()

Function EwUnlockBitmap()

Function EwUnlockObject()

Basic Data Type Definitions

Type XBitmapLock

Type XViewportProc

Platform Package reference: Function EwAllocUserColor()

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

XUInt8 EwAllocUserColor( XColor aColor )

Parameters

aColor

Color to be stored in the global CLUT (color look-up table).

Discussion

The function EwAllocUserColor() stores the given user defined color within an empty area in the global CLUT (color look-up table). 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.

If successful, the function returns the entry within the global CLUT, where the color was stored. If there are no entries available for new colors, 0 (zero) is returned. To free the previously allocated user color the function EwFreeUserColor() is available. To modify an already allocated color the function EwSetUserColor() is available.