【第3版emWin教程】第12章 emWin6.x文本显示
教程不断更新中: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文件即可运行。
#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文件即可运行。
#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文件即可运行。
#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文件中的配置如下:
#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文件中的配置如下:
#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 总结
文本的显示属于最基本的功能,初学者要多练练这些相关的函数,实践出真知,要不以后做一些复杂的例子,往往就是这些简单的地方出错。