emWin - SEGGER Microcontroller

904 CHAPTER Foreign Language Support
The following example shows how bidirectional text is rendered by emWin:
28.3.4 Requirements
Arabic language support is part of the emWin basic package. emWin standard fonts
do not contain Arabic characters. Font files containing Arabic characters can be created
using the Font Converter.
Memory
The bidirectional text alignment and Arabic character transformation uses app. 60 KB
of ROM and app. 800 bytes of additional stack.
28.3.5 How to enable Arabic support
Per default emWin writes text always from the left to the right and there will be no
Arabic character transformation as described above. To enable support for bidirectional
text and Arabic character transformation, add the following line to your application:
GUI_UC_EnableBIDI(1);
If enabled, emWin follows the rules of the bidirectional algorithm, described by the
Unicode consortium, to get the right visual order before drawing text.
28.3.6 Example
UTF-8 text Rendering
\xd8\xb9\xd9\x84\xd8\xa7 1, 2, 345
\xd8\xba\xd9\x86\xd9\x8a XYZ
\xd8\xa3\xd9\x86\xd8\xa7
The Sample folder contains the example FONT_Arabic, which shows how to draw Arabic
text. It contains an emWin font with Arabic characters and some small Arabic text
examples.
28.3.7 Font files used with Arabic text
Font files used to render Arabic languages need to include at least all characters
defined in the ’Arabic’ range 0x600-0x6FF and the notation forms and ligatures listed
in the tables of this chapter.
UM03001 User & Reference Guide for emWin V5.18 © 1997 - 2012 SEGGER Microcontroller GmbH & Co. KG