Platform Integration: Platform Package reference

With Embedded Wizard you develop the GUI application in the platform independent programming language Chora. Then you compile and link the generated code together with the Platform Package modules to a single binary able to run on your target system.

Depending on your individual application case, you will eventually need to take care of adaptations of the interfaces between your finished GUI application and your particular device, the operating system, the hardware or even other applications and software modules coexisting on the same system. It is thus important to know which functions and data types are provided by the Platform Package. This chapter gives you an overview of the important Platform Package functionality, in particular the functionality of the Runtime Environment and Graphics Engine:

Function

Description

EwGetAutoObject

ANSI C Platform Package function to obtain access to an autoobject.

EwNewObject

ANSI C Platform Package function to create a new instance of Chora class.

EwNewObjectIndirect

ANSI C Platform Package function to create a new instance of Chora class.

EwLockObject

ANSI C Platform Package function to protect an object from being disposed by the garbage collection.

EwUnlockObject

ANSI C Platform Package function to remove the protection of an object from being disposed by the garbage collection.

EwReclaimMemory

ANSI C Platform Package function to run the garbage collection.

EwProcessSignals

ANSI C Platform Package function to process all signals pending actually for their delivery.

EwProcessTimers

ANSI C Platform Package function to process all expired timers.

EwAnyPendingSignals

ANSI C Platform Package function to query whether there are any signals pending for the delivery.

EwNextTimerExpiration

ANSI C Platform Package function to query when the next timer expiration is expected.

EwNewString

ANSI C Platform Package function to create a duplicate of a wide-character (16-bit) string.

EwNewStringAnsi

ANSI C Platform Package function to create a wide-character (16-bit) string from an ANSI (8-bit) coded source string.

EwNewStringUtf8

ANSI C Platform Package function to create a wide-character (16-bit) string from an UTF-8 coded source string.

EwNewStringChar

ANSI C Platform Package function to create a string filled with a character.

EwStringLength

ANSI C Platform Package function to query the length (the number of characters) of a string.

EwCompString

ANSI C Platform Package function to compare two strings.

EwStringToAnsi

ANSI C Platform Package function to convert the wide-character (16-bit) coded string in an ANSI (8-bit) string.

EwSetLanguage

ANSI C Platform Package function to select the language in a multi-lingual localized application.

EwGetLanguage

ANSI C Platform Package function to query the actually selected language in a multi-lingual localized application.

EwSetStyles

ANSI C Platform Package function to enable/disable styles in a multi-variant application.

EwGetStyles

ANSI C Platform Package function to query the actually enabled styles in a multi-variant application.

EwPrintProfilerStatistic

ANSI C Platform Package function to print statistic about the memory usage of the GUI application.

EwPrintPerfCounters

ANSI C Platform Package function to print collected performance counters during debugging.

EwResetPerfCounters

ANSI C Platform Package function to reset collected performance counters during debugging.

EwInitGraphicsEngine

ANSI C Platform Package function to initialize the Graphics Engine.

EwDoneGraphicsEngine

ANSI C Platform Package function to deinitialize (shutdown) the Graphics Engine.

EwEnableGfxTaskTracing

ANSI C Platform Package function to control the internal debugging mode of the Graphics Engine.

EwInitViewport

ANSI C Platform Package function to initialize a viewport.

EwDoneViewport

ANSI C Platform Package function to deinitialize a viewport.

EwConfigViewport

ANSI C Platform Package function to change the configuration of a viewport.

EwBeginUpdate

ANSI C Platform Package function to initiate a screen update cycle for a given viewport.

EwBeginUpdateArea

ANSI C Platform Package function to initiate a partial screen update cycle for a given viewport.

EwEndUpdate

ANSI C Platform Package function to finalize the screen update cycle for the given viewport.

EwCreateBitmap

ANSI C Platform Package function to create a new bitmap.

EwFreeBitmap

ANSI C Platform Package function to free all resources occupied by a bitmap.

EwModifyBitmapPalette

ANSI C Platform Package function to change color values within the palette of an Index8 bitmap.

EwLockBitmap

ANSI C Platform Package function to lock and direct access the pixel memory of a bitmap.

EwUnlockBitmap

ANSI C Platform Package function to unlock a bitmap.

EwIndexToColor

ANSI C Platform Package function to query color values from the global CLUT.

EwColorToIndex

ANSI C Platform Package function to determine an entry within the global CLUT corresponding to a color value.

EwAllocUserColor

ANSI C Platform Package function to store user defined colors within empty area in the global CLUT.

EwFreeUserColor

ANSI C Platform Package function to remove a user defined color entry from the global CLUT.

EwSetUserColor

ANSI C Platform Package function to change color values within the global CLUT.

EwFindUserColor

ANSI C Platform Package function to search the global CLUT for a color value.

Type definition

Description

Basic data types

ANSI C Platform Package basic type definitions.

XPoint

ANSI C Platform Package type definition for the Chora 'point' data type.

XRect

ANSI C Platform Package type definition for the Chora 'rect' data type.

XColor

ANSI C Platform Package type definition for the Chora 'color' data type.

XBitmap

ANSI C Platform Package type definition to describe the attributes of a bitmap.

XBitmapLock

ANSI C Platform Package type definition to provide access to the pixel memory of a locked bitmap.

XViewportProc

ANSI C Platform Package type definition of a user defined viewport callback function.