教程不断更新中：http://www.armbbs.cn/forum.php?mod=viewthread&tid=98429
第12章 emWin6.x文本显示
本章节主要讲解emWin的文本显示，文本显示算是emWin的最基本功能，初学时掌握几个典型文本函数的用法就行，后面需要用到其它函数，再查阅emWin手册并了解其用法后实际测试即可。
学习本章节，务必保证已经学习了第9章或者第10章以及第11章。
12.1 初学者重要提示
12.2 简单文本显示
12.3 文本绘制模式
12.4 举例GUI_DispStringInRectWrap函数的使用
12.5 实验例程说明（RTOS）
12.6 实验例程说明（裸机）
12.7 总结
12.1 初学者重要提示
- 文本显示的所有API函数在emWin手册中都有讲解，下图是中文版手册里面API函数的位置
下图是是英文版手册里面API函数的位置：
- 文本显示涉及到的函数较多，初学者不需要将这些函数都掌握，会使用几个常用的函数即可。以后项目中需要用到其它函数功能了，再查阅emWin手册并了解其用法后实际测试即可。
- 文本显示就是一些API函数的调用，没有多深的技术需要掌握，对于这一点，初学者要明白。
- 如果时间充裕，可以自行在模拟器上面测试几个教程中没有用到的文本函数练练手。
12.2 简单文本显示
文本显示相对比较容易，设置好文本的前景色，背景色和文本的字体就可以调用文本API函数进行显示了。
其中前景色是用于设置文本的显示颜色，通过函数GUI_SetColor()来实现，而背景色是用来设置文本显示时的背景颜色或者说底色，通过函数GUI_SetBkColor()来实现。文本的字体设置是通过函数GUI_SetFont来实现，emWin本身支持的字体样式很多，不过，默认情况下仅支持ASCII字符显示。中文或者其它类型字符显示会在后面的教程中逐一跟大家进行讲解。对于本章节，大家掌握文本显示即可。
另外，讲解文本显示前需要介绍下emWin支持的控制字符。控制字符是指字符代码小于32的字符。控制字符被定义为ASCII代码的一部分。emWin仅支持以下两个控制字符：
其中，换行字符在字符串中非常有用，利用换行字符作为字符串的一部分，字符串就可以拆分为多行，且只需调用一个函数就能显示。
下面我们就通过一个实例来调用文本显示API，通过这个实例大家也可以测试其它的文本显示函数。我们将其移植到模拟器上面进行演示，具体移植方法，按照前面章节的讲解，将SWIPELIST_Demo.c文件里面的所有内容删掉并将下面所有代码复制到SWIPELIST_Demo.c文件即可运行。
代码语言：javascript复制#include "GUI.h"
void MainTask(void)
{
/* 初始化emWin */
GUI_Init();
/* 对于初学者，这个地方一定要注意，这里只是设置背景颜色，也就是给变量赋值了一下 */
GUI_SetBkColor(GUI_BLUE);
/* 要实现背景颜色的改变，必须的执行下面这句 */
GUI_Clear();
/* 设置字体 */
GUI_SetFont(&GUI_Font8x16);
/* 这里调用字符串显示 并实现一下换行 */
GUI_DispString("www.armfly.com navailable");
while (1)
{
GUI_Delay(10);
}
}实际显示效果如下：
函数GUI_DispStringAt()
GUI_DispStringHCenterAt()
GUI_DispStringInRect() 平时使用的也比较多，可以在模拟器上面练练手。
12.3 文本绘制模式
文本的显示是通过设置前景色和背景色实现的。为了实现项目中各种文本绘制模式，用户还可以通过调用函数GUI_SetTextMode()来实现如下几种显示模式。
- 正常文本
默认情况下，文本的显示是采用的这种模式，前景色就是文本的显示颜色，而背景色根据文本字体大小来刷新所在的显示区。
通过将函数GUI_SetTextMode()的参数设置为GUI_TM_NORMAL或0，可以实现正常模式。
- 反转文本
这种显示模式是将文本的显示采用背景色，而文本的底色采用的是前景色，比如正常模式显示是黑底白字，而反转后就是白底黑字。
通过将函数GUI_SetTextMode()的参数设置为GUI_TM_REV，可以实现反转模式。
- 透明文本
简单的说，透明模式就是不需要背景色了，仅使用前景色显示文本，这样原有的背景效果不会受到影响，比如想在背景图片上面显示文本，透明模式就很适合，而使用正常模式，文本所在位置的图片就会被文本的背景色刷掉。
通过将函数GUI_SetTextMode()的参数设置为GUI_TM_TRANS，可以实现透明模式。
- 异或文本
采用文本的异或模式，文本显示也是透明的，不过文本的显示颜色是由文本显示所在区域的背景色决定的，即对背景色取反就是文本的显示颜色。这种模式经常用于1bpp颜色配置的显示屏，比如12864单色屏，白色取反就是黑色，黑色取反就是白色。其它颜色深度采用如下的公式进行计数：
新像素颜色 = 支持的颜色数 – 实际像素颜色 – 1
通过将函数GUI_SetTextMode()的参数设置为GUI_TM_XOR，可以实现异或模式。
- 透明反转文本
这种模式是透明模式和反转模式的结合体，与透明文本一样，它不会覆盖背景，而且和反转文本一样，该文本会反转显示。
通过将函数GUI_SetTextMode()的参数设置为GUI_TM_TRANS | GUI_TM_REV，可以实现透明反转模式。
下面是这5种显示模式的具体效果实例，非常具有代表性。我们将其移植到模拟器上面进行演示，具体移植方法，按照前面章节的讲解，将SWIPELIST_Demo.c文件里面的所有内容删掉并将下面所有代码复制到SWIPELIST_Demo.c文件即可运行。
代码语言：javascript复制#include "GUI.h"
void MainTask(void)
{
/* 初始化emWin */
GUI_Init();
/* 设置字体 */
GUI_SetFont(&GUI_Font8x16);
/* 设置背景颜色 */
GUI_SetBkColor(GUI_BLUE);
GUI_Clear();
/* 设置画笔的粗细以及颜色，只有矢量函数才能设置Size */
GUI_SetPenSize(10);
GUI_SetColor(GUI_RED);
GUI_DrawLine(80, 10, 240, 90);
GUI_DrawLine(80, 90, 240, 10);
GUI_SetBkColor(GUI_BLACK);
GUI_SetColor(GUI_WHITE);
/* 设置正常模式 */
GUI_SetTextMode(GUI_TM_NORMAL);
GUI_DispStringHCenterAt("GUI_TM_NORMAL" , 160, 10);
/* 翻转文本 */
GUI_SetTextMode(GUI_TM_REV);
GUI_DispStringHCenterAt("GUI_TM_REV" , 160, 26);
/* 透明文本 */
GUI_SetTextMode(GUI_TM_TRANS);
GUI_DispStringHCenterAt("GUI_TM_TRANS" , 160, 42);
/* 异或文本 */
GUI_SetTextMode(GUI_TM_XOR);
GUI_DispStringHCenterAt("GUI_TM_XOR" , 160, 58);
/* 设置文本模式 */
GUI_SetTextMode(GUI_TM_TRANS | GUI_TM_REV);
GUI_DispStringHCenterAt("GUI_TM_TRANS | GUI_TM_REV", 160, 74);
while (1)
{
GUI_Delay(10);
}
}实际显示效果如下：
关于文本设置方面还有一个函数GUI_SetTextStyle()，有兴趣的同学，也可以在模拟器上面练练手。
12.4 举例GUI_DispStringInRectWrap函数的使用
此函数有一定的使用价值，我们这里简单的讲解下，先贴一下官方的使用说明。
根据此函数的三种参数设置模式，写出如下的实例，代码中将这三种模式都实现了。然后，我们将其移植到模拟器上面进行演示，具体移植方法，按照前面章节的讲解，将SWIPELIST_Demo.c文件里面的所有内容删掉并将下面所有代码复制到SWIPELIST_Demo.c文件即可运行。
代码语言：javascript复制#include "GUI.h"
int i;
char acText[] = "This example demonstrates text wrapping";
GUI_RECT Rect = {10, 10, 59, 59};
GUI_WRAPMODE aWm[] = {GUI_WRAPMODE_NONE,
GUI_WRAPMODE_CHAR,
GUI_WRAPMODE_WORD};
void MainTask(void)
{
/* 初始化emWin */
GUI_Init();
/* 设置文本显示模式 */
GUI_SetTextMode(GUI_TM_TRANS);
/* 函数GUI_DispStringInRectWrap三种显示模式 */
for (i = 0; i < 3; i )
{
/* 设置前景色为蓝色 */
GUI_SetColor(GUI_BLUE);
/* 使用前景色绘制的填充矩形 */
GUI_FillRectEx(&Rect);
/* 设置前景色为白色 */
GUI_SetColor(GUI_WHITE);
/* 显示文本，文本显示颜色是白色*/
GUI_DispStringInRectWrap(acText, &Rect, GUI_TA_LEFT, aWm[i]);
Rect.x0 = 60;
Rect.x1 = 60;
}
while (1)
{
GUI_Delay(10);
}
}实际显示效果如下：
12.5 实验例程说明（RTOS）
配套例子：
V7-507_emWin6.x实验_文本显示（RTOS）
实验目的：
- 学习emWin6.x的文本显示。
- emWin功能的实现在MainTask.c文件里面。
实验内容：
1、K1按键按下，串口或者RTT打印任务执行情况（串口波特率115200，数据位8，奇偶校验位无，停止位1）。
2、(1) 凡是用到printf函数的全部通过函数App_Printf实现。
(2) App_Printf函数做了信号量的互斥操作，解决资源共享问题。
3、默认上电是通过串口打印信息，如果使用RTT打印信息：
MDK AC5，MDK AC6或IAR通过使能bsp.h文件中的宏定义为1即可
#define Enable_RTTViewer 1
4、各个任务实现的功能如下：
App Task Start 任务 ：启动任务，这里用作BSP驱动包处理。
App Task MspPro任务 ：消息处理，这里用作LED闪烁。
App Task UserIF 任务 ：按键消息处理。
App Task COM 任务 ：暂未使用。
App Task GUI 任务 ：GUI任务。
μCOS-III任务调试信息（按K1按键，串口打印）：
RTT 打印信息方式：
程序设计：
任务栈大小分配：
μCOS-III任务栈大小在app_cfg.h文件中配置：
#define APP_CFG_TASK_START_STK_SIZE 512u
#define APP_CFG_TASK_MsgPro_STK_SIZE 2048u
#define APP_CFG_TASK_COM_STK_SIZE 512u
#define APP_CFG_TASK_USER_IF_STK_SIZE 512u
#define APP_CFG_TASK_GUI_STK_SIZE 2048u
任务栈大小的单位是4字节，那么每个任务的栈大小如下：
App Task Start 任务 ：2048字节。
App Task MspPro任务 ：8192字节。
App Task UserIF 任务 ：2048字节。
App Task COM 任务 ：2048字节。
App Task GUI 任务 ：8192字节。
系统栈大小分配：
μCOS-III的系统栈大小在os_cfg_app.h文件中配置：
#define OS_CFG_ISR_STK_SIZE 512u
系统栈大小的单位是4字节，那么这里就是配置系统栈大小为2KB
emWin动态内存配置：
GUIConf.c文件中的配置如下：
代码语言：javascript复制#define EX_SRAM 1/*1 used extern sram, 0 used internal sram */
#if EX_SRAM
#define GUI_NUMBYTES (1024*1024*24)
#else
#define GUI_NUMBYTES (100*1024)
#endif通过宏定义来配置使用内部SRAM还是外部的SDRAM做为emWin的动态内存，当配置：
#define EX_SRAM 1 表示使用外部SDRAM作为emWin动态内存，大小24MB。
#define EX_SRAM 0 表示使用内部SRAM作为emWin动态内存，大小100KB。
默认情况下，本教程配套的所有emWin例子都是用外部SDRAM作为emWin动态内存。
emWin界面显示效果：
800*480分辨率界面效果，小分辨率显示屏仅可以显示一部分。
12.6 实验例程说明（裸机）
配套例子：
V7-508_emWin6.x实验_文本显示（裸机）
实验目的：
- 学习emWin6.x的文本显示。
- emWin功能的实现在MainTask.c文件里面。
emWin界面显示效果：
800*480分辨率界面效果，小分辨率显示屏仅可以显示一部分。
emWin动态内存配置：
GUIConf.c文件中的配置如下：
代码语言：javascript复制#define EX_SRAM 1/*1 used extern sram, 0 used internal sram */
#if EX_SRAM
#define GUI_NUMBYTES (1024*1024*24)
#else
#define GUI_NUMBYTES (100*1024)
#endif通过宏定义来配置使用内部SRAM还是外部的SDRAM做为emWin的动态内存，当配置：
#define EX_SRAM 1 表示使用外部SDRAM作为emWin动态内存，大小24MB。
#define EX_SRAM 0 表示使用内部SRAM作为emWin动态内存，大小100KB。
默认情况下，本教程配套的所有emWin例子都是用外部SDRAM作为emWin动态内存。
12.7 总结
文本的显示属于最基本的功能，初学者要多练练这些相关的函数，实践出真知，要不以后做一些复杂的例子，往往就是这些简单的地方出错。
