【AWTK使用经验】如何在AWTK显示阿拉伯文本

AWTK是基于C语言开发的跨平台GUI框架。AWTK使用经验系列文章将介绍开发AWTK过程中一些常见问题与解决方案，例如：如何播放视频或摄像头画面？如何播放序列帧动画？这些都会在系列文章进行解答。

本篇文章将简单介绍阿拉伯文本相关整形与排序规则，接着介绍在AWStudio设置阿拉伯语言翻译的步骤。

阿拉伯文本整形规则

一般GUI显示英文或者中文时，内存中存储的字符串和我们人眼看到的字符串是一样的；但是阿拉伯文本比较特殊，内存中的字符串需要经过几个步骤处理（主要是整形与文本方向排序），最终才形成成我们人眼看到的字符串。
关于阿拉伯文本整形可以分为5种，下面将简单介绍这几种类型的整形。

1、字母位置不同，如在开头或结尾可能会导致不一样的变形：

图 1 字母位置变形（Shaper）

2、字母会受到前后字母影响而变形，如下图两个字符会结合形成第三个字符：

 

图 2 连写变形（Ligature）

3、元音符号和字母会有组合的特性，如下图，一个字母与一个元音符号会有位移结合的变形：

 

图 3 元音符号变形（Diacritics）

4、有时候为了美观的视觉效果会将字母延长凑成一整行的长度，这种是字母延长变形：

 图 4 字母延长变形（Kashida）

 5、字母之间插入连接符号会影响变形：

图 5 字母插入连接符号变形（Tatwell）

阿拉伯文本双向排序

Unicode不同类型字符的方向属性

Unicode字符可以分为强字符、弱字符和中性字符，不同类型的字符具有不同的方向性特征：

1、强字符：英文、汉字、阿拉伯字母等，它们方向性都是确定的，比如英文属于从左到右的LTR字符，阿拉伯属于从右到左的RTL字符，它们可能影响前后字符的方向性；

2、弱字符：数字和数字相关的符号，它们方向性是确定的，但是对前后字符不会产生影响；

3、中性字符：大部分标点符号和空格，它们方向是不确定的，由上下文bidi属性决定其方向。

AWTK支持阿拉伯文本的哪些规则

由于阿拉伯文本整形规则和排序规则比较复杂，AWTK内部调用了bidi算法对阿拉伯文本进行排序并做简单的变形，bidi算法支持文本双向排序算法，在整形规则上暂时只支持字母位置变形和连写变形，不支持元音符号变形。

如何在AWTK使用阿拉伯语言

如果想在AWTK正确使用阿拉伯语言，可以参考以下步骤：

下载阿拉伯语言字库

AWStudio新建工程的默认字库是不支持显示阿拉伯文本的，因此需要先找到支持阿拉伯文本字库文件。字库文件可以在相关字体下载网站搜索并下载，或者从awtk资源目录拷贝自带的阿拉伯语言字库文件：

awtk/design/default/fonts/trado.ttf导入阿拉伯语言字库到工程准备好字库文件后，可以使用AWStudio将字库文件导入到自己的项目工程。在AWStudio资源浏览器选择“字体”，点击右上角加号选择字库文件并导入。

 

图 6 使用AWStudio导入字库文件

在AWStudio设置阿拉伯语言翻译文本

AWStudio支持给工程设置多国语言翻译并实时切换的功能，点击AWStudio上方菜单栏的“翻译”按钮进入多语言翻译设置页面，页面操作步骤如下：1、点击界面右下角添加语言按钮；2、在对话框选择要添加的语言、国家或地区，比如阿拉伯语言选择“Arabic”；3、点击对话框确定按钮；4、在对应语言框输入翻译后的文本内容。（如果显示异常可能是字体缺失，可以在添加语言对话框点击“导入字体”添加字库文件）

图 7 使用AWStudio添加阿拉伯语言翻译

最后在AWStudio给控件text属性设置原始文本，并且开启翻译选项，之后该控件就会根据程序当前语言翻译进行翻译。

图 8 开启控件翻译选项

关于在程序实时翻译的详细步骤可以参考官方文档《多国语言互译》里面的“实时切换语言”章节：https://awstudio.zlg.cn/docs/awtk_docs/AWTK_Guide/8.Locale.html 

阿拉伯语言方向性问题

由于阿拉伯书写习惯是从右到左，在切换语言后同样需要遵循这个习惯。AWTK内置的bidi算法可以自动处理阿拉伯文本排序，也可以手动定义bidi属性（默认为auto），如强制设置RTL排序。关于bidi双向排序算法详细的使用说明可以阅读官方在线文档《如何启用文本双向排版》:https://awstudio.zlg.cn/docs/awtk_docs/HowTo/how_to_enable_bidi.html

图 9 bidi属性自动排序阿拉伯文本