If an error or warning is detected during the runtime of your GUI application, the error (or warning) code and eventually additional information (known as info, info1 and info2) are output on the debug console of your target device. The following sections provide detailed description of all codes together with few hints to help you to localize and fix the cause of the problem.

Please don't worry about the amount of different error and warning codes addressing the same error case. We use the different codes to distinguish the different locations within the code where the errors can occur. Knowing the error number we can analyze the cause of the error. In case you have the source code of the Run Time Environment and Graphics Engine (available in Professional license of the Platform Package) you can also search in the source code for the given error code number.

Out of memory.

Out of memory.

Out of memory.

Out of memory.

Out of memory.

Out of memory.

Failed to initialize the graphics subsystem in the target device.

Failed to load the global CLUT (color look up table).

Failed to initialize the Graphics Engine core functionality.

Failed to initialize the bitmap resource loader.

Failed to initialize the font resource loader.

Failed to initialize the Attributed Text sub-system.

Failed to initialize the graphics tasks sub-system.

Failed to create surface with format EW_PIXEL_FORMAT_NATIVE, width=info1, height=info2.

Failed to create surface with format EW_PIXEL_FORMAT_ALPHA8, width=info1, height=info2.

Failed to create surface with format EW_PIXEL_FORMAT_INDEX8, width=info1, height=info2.

Failed to create surface with format EW_PIXEL_FORMAT_RGB565, width=info1, height=info2.

Failed to create constant surface with format EW_PIXEL_FORMAT_NATIVE, width=info1, height=info2.

Failed to create constant surface with format EW_PIXEL_FORMAT_ALPHA8, width=info1, height=info2.

Failed to create constant surface with format EW_PIXEL_FORMAT_INDEX8, width=info1, height=info2.

Failed to create constant surface with format EW_PIXEL_FORMAT_RGB565, width=info1, height=info2.

Can't create a bitmap with format EW_PIXEL_FORMAT_SCREEN.

Failed to initialize new issue for destination bitmap info1.

Failed to load bitmap resource info1.

Failed to lock the surface info1 for direct memory access.

Failed to obtain the pixel data of a bitmap resource info1.

Failed to load the CLUT of the bitmap resource info1.

Invalid parameters to lock bitmap info1, frame number info2.

Invalid parameters to modify the palette of the bitmap info1.

Failed to load font resource info1.

The glyph cache is too small to load the glyph info2 from the font resource info1. Please increase the glyph cache size.

Invalid parameters to create viewport.

Failed to create viewport.

Invalid viewport info1 to perform screen update.

Failed to start the update of the viewport info1.

Invalid destination bitmap info1, frame number info2 in the drawing operation.

Invalid destination bitmap info1, frame number info2 in the copy bitmap operation.

Invalid source bitmap info1, frame number info2 in the copy bitmap operation.

Not convex destination polygon to warp bitmap.

Invalid destination bitmap info1, frame number info2 in the text output operation.

Invalid font info1 in the text output operation.

Invalid font info1 in text extent calculation.

Invalid parameters to get glyph metrics.

Invalid parameters to lock glyph.

Invalid parameters to get kerning information.

No free global CLUT entries to alloc user color.

Invalid global CLUT entry info1 to free user color.

Invalid global CLUT entry info1 to modify user color.

Invalid size (width=info1, height=info2) of bitmap to create.

Failed to get metrics for glyph info2 from the font info1.

Failed to create glyph info2 from the font info1.

Failed to load glyph info2 from the font info1.

Incomplete interface to the underlying graphical subsystem. Missing the implementation of the EwGfxBeginUpdateArea() function.

The 'IssueBuffer' for destination bitmap info1 is too small for polygon data with info2 edges. Adjust in your project the macro definition EW_MAX_ISSUE_TASKS and rebuild the entire application. You can also reduce the number of edges stored in the path. If you are using one of our prepared Build Environments you can configure the macro EW_MAX_ISSUE_TASKS in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

EwWarpBitmap() operation has been omitted because of the resulting destination area being wider or higher than 4096 pixel. Trying to warp bitmap for such big area will lead to integer arithmetic overflows.

To use EwEnableGfxTaskTracing() you have to rebuild Graphics Engine with the define EW_SUPPORT_GFX_TASK_TRACING. Otherwise the function has no effect.

The support for operations to fill and stroke paths is not available because the Graphics Engine is compiled with the defined macro EW_DONT_USE_PATH_FUNCTIONS. If you are using one of our prepared Build Environments you can configure this macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

The support for operations to scale, rotate or warp bitmaps is not available because the Graphics Engine is compiled with the defined macro EW_DONT_USE_WARP_FUNCTIONS. This error can also occur when your application uses the Line view to display a line with thickness greater than 1 pixel. In such case the line is rendered using the warp functionality. If you are using one of our prepared Build Environments you can configure this macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

The support for operations involving EW_PIXEL_FORMAT_INDEX8 bitmaps is not available because the Graphics Engine is compiled with the defined macro EW_DONT_USE_INDEX8_SURFACES. If you are using one of our prepared Build Environments you can configure this macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

The support for operations involving EW_PIXEL_FORMAT_RGB565 bitmaps is not available because the Graphics Engine is compiled with the defined macro EW_DONT_USE_RGB565_SURFACES. If you are using one of our prepared Build Environments you can configure this macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

No font (NULL) in text extent calculation.

The support for bi-directional text is not available because the Graphics Engine is compiled with the defined macro EW_DONT_USE_BIDI_FUNCTIONS. If you are using one of our prepared Build Environments you can configure this macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

Incomplete interface to the underlying graphical subsystem. Missing the implementation of the EwGfxCreateConstNativeSurface() function. This error can occur when your Embedded Wizard project is configured to generate bitmap resources in the DirectAccess format. Please verify the attribute ModeOfBitmapResources in your Embedded Wizard project. You can also try to clean/rebuild your project.

Incomplete interface to the underlying graphical subsystem. Missing the implementation of the EwGfxCreateConstAlpha8Surface() function. This error can occur when your Embedded Wizard project is configured to generate bitmap resources in the DirectAccess format. Please verify the attribute ModeOfBitmapResources in your Embedded Wizard project. You can also try to clean/rebuild your project.

Incomplete interface to the underlying graphical subsystem. Missing the implementation of the EwGfxCreateConstIndex8Surface() function. This error can occur when your Embedded Wizard project is configured to generate bitmap resources in the DirectAccess format. Please verify the attribute ModeOfBitmapResources in your Embedded Wizard project. You can also try to clean/rebuild your project.

Incomplete interface to the underlying graphical subsystem. Missing the implementation of the EwGfxCreateConstRGB565Surface() function. This error can occur when your Embedded Wizard project is configured to generate bitmap resources in the DirectAccess format. Please verify the attribute ModeOfBitmapResources in your Embedded Wizard project. You can also try to clean/rebuild your project.

Trying to open an invalid font resource info1.

The font info is not available. Ensure, that the font is installed and registered properly. On the target system use the function EwRegisterFont(). For prototyping, install the font file in the Windows font directory.

Wrong Bitmap Loader and Software Pixel Driver combination. The color formats differ.

The bitmap resource info has not the expected format. Please verify the attribute PlatformPackage in your Embedded Wizard project. It should correspond to the color format of your target system. You can also try to clean/rebuild your project.

The rotation of the bitmap resource info doesn't correspond to the configuration the Graphics Engine has been built for. Please verify whether the attribute ScreenOrientation in your Embedded Wizard project does correctly conform the value of the define EW_SURFACE_ROTATION used during the build process (e.g. within your MAKE file, etc.). If you are using one of our prepared Build Environments you can configure this macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process. Then try to clean/rebuild your project.

The bitmap resource info is stored with wrong color format. Please verify whether the attributes ColorPremultipliedAlpha and ColorChannelsOrder in your Embedded Wizard project do correctly conform the values of the defines EW_COLOR_CHANNEL_BIT_OFFSET_RED, EW_COLOR_CHANNEL_BIT_OFFSET_GREEN, EW_COLOR_CHANNEL_BIT_OFFSET_BLUE, EW_COLOR_CHANNEL_BIT_OFFSET_ALPHA and EW_PREMULTIPLY_COLOR_CHANNELS used during the build process (e.g. within your MAKE file, etc.). If you are using one of our prepared Build Environments you can configure the macros in the file ewconfig.h. Otherwise configure the macro in the make file or your build process. Then try to clean/rebuild your project.

The RGB565 bitmap resource info is stored with wrong color format. Please verify whether the attribute ColorChannelsOrderOfRGB565 in your Embedded Wizard project does correspond to the values of the defines EW_RGB565_COLOR_CHANNEL_BIT_OFFSET_RED, EW_RGB565_COLOR_CHANNEL_BIT_OFFSET_GREEN and EW_RGB565_COLOR_CHANNEL_BIT_OFFSET_BLUE used during the build process (e.g. within your MAKE file, etc.). If you are using one of our prepared Build Environments you can configure the macros in the file ewconfig.h. Otherwise configure the macro in the make file or your build process. Then try to clean/rebuild your project.

The bitmap resource info has not the expected format. Please verify the attribute PlatformPackage in your Embedded Wizard project. It should correspond to the color format of your target system. You can also try to clean/rebuild your project.

The rotation of the bitmap resource info doesn't correspond to the configuration the Graphics Engine has been built for. Please verify whether the attribute ScreenOrientation in your Embedded Wizard project does correctly conform the value of the define EW_SURFACE_ROTATION used during the build process (e.g. within your MAKE file, etc.). If you are using one of our prepared Build Environments you can configure this macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process. Then try to clean/rebuild your project.

Wrong Bitmap Loader and Software Pixel Driver combination. Color format differ.

The image file info is not available or the format of the image file is not supported by the extern loader. Ensure, that a valid file is available on the target system.

Trying to load an invalid bitmap resource info1.

Wrong Viewport Interface and Pixel Driver combination.

Calling twice the function EwRegisterFlashAreaReader() with different flash start/end addresses.

Not convex destination polygon to warp bitmap. One of the W parameters is 0 (zero).

Timer info1 not in the timers list.

String index out of the string length.

Trying to modify a constant string.

Trying to release a string with usage counter 0.

Maximum value for a string usage counter (65535) reached.

postsignal is failed. The signal is just delivered.

No class (NULL).

Object info1 is not in the root set.

The specified class parameter to create a new instance is not a valid class.

Recursive access to an autoobject info1 performing the initialization.

Trying to use the function EwSetStackBaseAddress() with Runtime Environment not configured to run Immediate Garbage Collection. Operation is ignored.

No CPU stack information available to start the Immediate Garbage Collection. Please call the function EwSetStackBaseAddress() at the initialization time of the application to provide to the Runtime Environment the base address of the CPU stack. Immediate Garbage Collection is not started.

New Garbage Collection started while the actual Garbage Collection is not yet finished. Recursive Garbage Collections are not permitted. Operation is ignored.

Try to use the function EwModifyBitmapPalette() to modify the palette of loaded originally from a resource. Such bitmaps and their associated palettes are considered as immutable. Operation is ignored. info1 contains the address of the respective bitmap.

Bitmap is corrupted. This error should usually never occur unless the data structure of the bitmap has not been initialized correctly or it has been overwritten. info1 contains the address of the respective bitmap and info2 contains the number of the frame addressed in actual operation.

Failed to map a bitmap frame in the function EwModifyBitmapPalette().

Failed to map a bitmap frame in the function EwCreateBitmap().

Failed to map a bitmap frame during loading of a bitmap resource info1.

Trying to use EwAllocHeapBlock() without initializing the Heap Manager. Use EwInitHeap() and EwAddHeapMemoryPool() first.

Trying to use EwFreeHeapBlock() with an invalid memory block address or the internal heap management structures are corrupted. In the last case you can use the function EwVerifyHeap() to check the heap for its coherence.

The memory area specified in the function call EwAddHeapMemoryPool() is too small to be added to the memory pool of the Heap Manager. The operation is ignored.

The function EwVerifyHeap() has detected an incoherence in internal Heap Management structures. info1 specifies the address of the affected memory area within the memory pool (see function EwAddHeapMemoryPool()). info2 specifies the number of the failed coherence test.

Trying to perform a drawing operation within a bitmap loaded originally from a resource. Such bitmaps are considered as immutable. Operation is ignored. info1 contains the address of the respective bitmap. info2 contains the specified frame number.

Missing metric information in TrueType font file. The external TrueType font engine was not able to find the tables OS/2 nor hhea within the font file. info contains the name of the affected font. The tables are required to estimate the correct font size.

Drawing into a Native bitmap but the support for Native surfaces as drawing destination is disabled in the Graphics Engine (the Graphics Engine is compiled with the C macro EW_DONT_USE_NATIVE_SURFACES_AS_DESTINATION). In such case the operation to draw into a Native bitmap has no effect. info1 contains the address of the affected Native bitmap and info2 the frame number within the bitmap. If you are using one of our prepared Build Environments you can configure the macro EW_DONT_USE_NATIVE_SURFACES_AS_DESTINATION in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

Printing rotated text (Orientation other than Normal) but the support for Warp operations (texture mapping operations) is disabled in the Graphics Engine (the Graphics Engine is compiled with the C macro EW_DONT_USE_WARP_FUNCTIONS). In such case the operation to draw the text has no effect. If you are using one of our prepared Build Environments you can configure the macro EW_DONT_USE_WARP_FUNCTIONS in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

Performing a drawing operation with color or opacity gradient but the support for gradients is disabled in the Graphics Engine (the Graphics Engine is compiled with the C macro EW_DONT_USE_GRADIENTS). In such case the operation to draw with color or opacity gradient has no effect. If you are using one of our prepared Build Environments you can configure the macro EW_DONT_USE_GRADIENTS in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

Trying to create a Native bitmap but the support for Native bitmaps is disabled in the Graphics Engine (the Graphics Engine is compiled with the both C macros EW_DONT_USE_NATIVE_SURFACES_AS_DESTINATION and EW_DONT_USE_NATIVE_SURFACES). In such case no bitmap is created. If you are using one of our prepared Build Environments you can configure the macros in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

Trying to load a Native bitmap resource but the support for Native bitmaps is disabled in the Graphics Engine (the Graphics Engine is compiled with the C macro EW_DONT_USE_NATIVE_SURFACES). In such case no bitmap resource is loaded. If you are using one of our prepared Build Environments you can configure the macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

Trying to load a string constant stored in compressed format but the support for string decompression is disabled in the Runtime Environment (the Runtime Environment is compiled with the C macro EW_DONT_USE_COMPRESSION). In such case the string load operation fails resulting in an empty string. If you are using one of our prepared Build Environments you can configure the macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

Trying to load a bitmap resource stored in compressed format but the support for bitmap decompression is disabled in the Runtime Environment (the Runtime Environment is compiled with the C macro EW_DONT_USE_COMPRESSION). In such case no bitmap resource is loaded. info1 contains the pointer to the affected bitmap resource. If you are using one of our prepared Build Environments you can configure the macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

This error is reported when the application runs out the CPU stack or the code is executed in context of a foreign thread. Please ensure to invoke Embedded Wizard related code always in context of the GUI thread. See also Take care in multi-threading environments. If the multi threading is not the cause of this error, your CPU stack is possibly too small. Enlarge it.

Failed to create a wrapped surface.

Incomplete interface to the underlying graphical subsystem. Missing the implementation of the EwGfxCreateConstNativeSurfaceWrapped() function.

Incomplete interface to the underlying graphical subsystem. Missing the implementation of the EwGfxCreateConstAlpha8SurfaceWrapped() function.

Incomplete interface to the underlying graphical subsystem. Missing the implementation of the EwGfxCreateConstIndex8SurfaceWrapped() function.

Incomplete interface to the underlying graphical subsystem. Missing the implementation of the EwGfxCreateConstRGB565SurfaceWrapped() function.

Invalid destination bitmap info1, frame number info2 in the bitmap filter operation.

Invalid source bitmap info1, frame number info2 in the bitmap filter operation. Please note, filter operations are restricted to single-frame bitmaps only.

Invalid mask bitmap info1 in the bitmap filter operation. Expected is a bitmap in format ALPHA8 containing exact 1 frame only. Multi-frame bitmaps are not supported by the bitmap filter operation.

Failed to initialize new issue for destination bitmap info1.

The support for operations to mask, tint or blur bitmaps is not available because the Graphics Engine is compiled with the following three macros being defined: EW_DONT_USE_BLUR_FUNCTIONS, EW_DONT_USE_MASK_FUNCTIONS and EW_DONT_USE_TINT_FUNCTIONS. If you are using one of our prepared Build Environments you can configure the macros in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

The support for operations to blur bitmaps is not available because the Graphics Engine is compiled with the defined macro EW_DONT_USE_BLUR_FUNCTIONS. If you are using one of our prepared Build Environments you can configure the macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

The support for operations to mask bitmaps is not available because the Graphics Engine is compiled with the defined macro EW_DONT_USE_MASK_FUNCTIONS. If you are using one of our prepared Build Environments you can configure the macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

The support for operations to tint bitmaps is not available because the Graphics Engine is compiled with the defined macro EW_DONT_USE_TINT_FUNCTIONS. If you are using one of our prepared Build Environments you can configure the macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

Could not create a temporary surface needed to store intermediate contents when performing a blur bitmap operation.

The support for blur operations is restricted for target systems using the format RGB565, RGB888 or RGBA8888 for the frame buffer. In your application case other frame buffer format is used. The color space in such case is too small for the fine gradients resulting from the blur effect.

Unexpected race condition detected when using the function EwInvoke() or EwInvokeCopy(). This error indicates that the low-level Runtime Environment function EwAtomicFetchAndAdd() has not been adapted properly on your target system.

Trying to use the function EwInvoke() or EwInvokeCopy() but there is no invocation queue configured. See the function EwInitInvocations().

The amount of data to copy to the invocation queue passed to the function EwInvokeCopy() is larger than the queue itself. It will never fit inside the queue even if the queue were empty.

Failed to create an ALPHA8 surface to store blurred contents of a vector graphic object. See preceding error messages. Possibly there is not sufficient memory available to create the surface.

Failed to lock the ALPHA8 surface info1 for direct memory access. The surface is used as source in a blur operation.

Failed to create an ALPHA8 surface needed to store intermediate results of a blur operation. See preceding error messages. Possibly there is not sufficient memory available to create the surface.

Trying to display a rounded rectangle, rounded border or rounded rectangular shadow. This operation requires vector graphic functionality. The support for operations to fill and stroke paths is however not available because the Graphics Engine is compiled with the defined macro EW_DONT_USE_PATH_FUNCTIONS. If you are using one of our prepared Build Environments you can configure this macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.

Trying to render an ALPHA8 bitmap with blurred content of a vector graphic shape. This function requires vector graphic functionality. The support for operations to fill and stroke paths is however not available because the Graphics Engine is compiled with the defined macro EW_DONT_USE_PATH_FUNCTIONS. If you are using one of our prepared Build Environments you can configure this macro in the file ewconfig.h. Otherwise configure the macro in the make file or your build process.