Platform Package reference: Function EwReclaimMemory()

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

Target Configuration

Memory Footprint

Extern Bitmap interface

Integrating an External Application

Implementing Prototyper intrinsics

Certification Aspects

Platform Package reference

Function EwAlloc()

Function EwAddHeapMemoryPool()

Function EwAllocUserColor()

Function EwAnyPendingSignals()

Function EwBeginUpdate()

Function EwBeginUpdateArea()

Function EwColorToIndex()

Function EwCompString()

Function EwConfigViewport()

Function EwCreateBitmap()

Function EwDoneGraphicsEngine()

Function EwDoneHeap()

Function EwDoneViewport()

Function EwDumpHeap()

Function EwEnableGfxTaskTracing()

Function EwEndUpdate()

Function EwFindUserColor()

Function EwFree()

Function EwFreeBitmap()

Function EwFreeUserColor()

Function EwGetAutoObject()

Function _GetAutoObject()

Function EwGetHeapInfo()

Function EwGetLanguage()

Function EwGetStringLength()

Function EwGetUtf8StringLength()

Function EwGetStyles()

Function EwIndexToColor()

Function EwInitGraphicsEngine()

Function EwInitHeap()

Function EwInitInvocations()

Function EwInitViewport()

Function EwInvoke()

Function EwInvokeCopy()

Function EwLockBitmap()

Function EwLockObject()

Function _LockObject()

Function EwModifyBitmapPalette()

Function EwNewColor()

Function EwNewObject()

Function EwNewObjectIndirect()

Function _NewObject()

Function EwNewPoint()

Function EwNewRect()

Function EwNewString()

Function EwNewStringAnsi()

Function EwNewStringChar()

Function EwNewStringUtf8()

Function EwNextTimerExpiration()

Function EwPrint()

Function EwPrintPerfCounters()

Function EwPrintProfilerStatistic()

Function EwProcessSignals()

Function EwProcessTimers()

Function EwReclaimMemory()

Function EwRegisterFlashAreaReader()

Function _RequestUpdate()

Function EwResetPerfCounters()

Function EwSetLanguage()

Function EwSetStackAddressArea()

Function EwSetStyles()

Function EwSetUserColor()

Function EwStringToAnsi()

Function EwStringToUtf8()

Function EwUnlockBitmap()

Function EwUnlockObject()

Function _UnlockObject()

Function EwVerifyHeap()

Basic Data Type Definitions

Type XBitmapLock

Type XInvokeProc

Type XViewportProc

Error and Warning Codes

Platform Package reference: Function EwReclaimMemory()

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

Discussion

The function EwReclaimMemory() activates the garbage collection in order to dispose memory occupied by objects, which are not used anymore. Actually, the garbage collection consists of two phases Mark and Sweep.

In the first phase EwReclaimMemory() distinguishes between live objects and the garbage. This is done by traversing the graph of object relationships. All reached objects will be marked. The traversing starts at the root set. The user can add and remove objects to or from the root set by calling the function EwLockObject() and EwUnlockObject().

In the second phase EwReclaimMemory() deinitializes and frees every object, which has not been marked during the first phase. Similarly, all resources and strings not used anymore are released in the second phase.

CAUTION

DON'T START the garbage collection while the code of the GUI application is actually executed. Call the function EwReclaimMemory() from the main-loop of the GUI application only. Usually always at the end of the main-loop. DON'T START the garbage collection in context of a foreign thread.