嵌入式用户图形接口uC/GUI在uC/OSII上的嵌入

4.1 uC/GUI简介

uC/GUI是Micrium公司开发的通用的嵌入式用户图形界面软件。它给任何使用图形LCD的应用程序提供独立于处理器和LCD控制器之外的有效的图形用户接口。可以应用于单一任务环境，也可以应用于多任务环境中。uC/GUI能够应用于任何LCD控制器和CPU的任何尺寸的物理显示或者模拟显示中。
uC/GUI的特点如下：
◆ 适用于任何8位/16位/32位CPU，可允许于支持ANSI C的任何编译器
◆ 适用于任何控制器驱动任何LCD（单色，灰度，或者彩色）
◆ 通过配置宏，可支持任何接口
◆ 可配置显示尺寸
◆ 可在LCD的任何一点上显示字符和画位图
◆ 对于显示尺寸和速度提供优化进程，编译时间依赖于采用的优化进程
◆ 支持虚拟显示，虚拟显示的尺寸比实际显示大。
4.2 uC/GUI文件组织




uC/GUI目录下的文件有配置文件目录Config，GUI库函数目录，以及为GUI编写的应用程序目录。下面分别简要介绍相应目录下的函数，更为详细的文件介绍请参考我的uC/GUI移植的源代码。
◆ uC/GUI/Config/目录：
GUICONF.h： 配置GUI移植到不同操作系统的选项。在本论文中配置移植到uC/OSII中，允许多任务调用uC/GUI函数。
GUITouchConf.h：配置触摸屏的选项以及编写触摸屏的驱动。本文移植uC/GUI所使用的LCD屏不支持触摸屏，所以此文件为空。

LCD_Init.C: LCD控制器的初始化文件。
LCD_Conf.h： LCD显示屏的选项文件，包括bpp，调试板模式，水平、竖直方向的分辨率等等。
◆ uC/GUI/GUI/AntiAlias/目录：
这个目录中包含9个文件，处理显示的边缘模糊效果，也就是抗锯齿和优化LCD锯齿。液晶屏上画斜线往往都有锯齿，所以通过优化算法进行美化。
◆ uC/GUI/GUI/ConvertColor/目录：
这个目录中包含14个.C文件，涉及调色板模式。uC/GUI的调色板模式支持111模式，222模式，223，323，332，444，555，565，8666等相关模式。我在论文中使用的LCD屏，为单色16级灰度屏，因而不涉及到这些模式。但为了保持UC/GUI文件的完整性，该目录以及目录下14个文件，仍然保存在移植文件中。
◆ uC/GUI/GUI/ConvertMono/目录：
此目录下的文件描述单色显示的不同模式，包含4个文件。
◆ uC/GUI/GUI/Core
此目录下包含129个文件，是uC/GUI的核心部分。包括GUI头文件，GUI显示各种文本，二进制，十进制，十六进制，字符型文本，字符串，在不同的位置显示二进制，十进制，十六进制，字符型文本，字符串等；GUI设置各种字体；GUI的2-D图形库，GUI绘图函数，在各种位置绘各种点，线，位图，多边形，长方形，圆等等；GUI获取函数，获取当前点，线，位图，多边形，长方形，圆，当前字体，当前二进制，十进制，十六进制，字符型文本，字符串等函数；设置GUI画笔函数；GUI支持的鼠标函数；GUI支持的键盘函数，GUI支持的触摸屏函数；GUI设置LCD函数等等。这些函数，在uC/GUI系统中都是必须的函数。正是这些函数的组合，使得uC/GUI具有复杂而且完备的图形用户接口。而且，这些函数的组合，使得uC/GUI可以单独的使用，也可以通过配置文件，移植到各种操作系统中使用。
◆ uC/GUI/GUI/Font
此目录下包含的是uC/GUI支持的字体。
◆ uC/GUI/GUI/LCDDriver
LCD API目录。该目录下包含很多已经完备的LCD控制器的驱动程序以及API函数。
◆ uC/GUI/GUI/MemDev
MemDev目录。
MemDev主要用于防止在画交迭图时产生的抖动。uC/GUI函数绘图不使用MemDev时，画图操作直接写到终端上显示，交迭绘图执行时刷新屏幕，多次刷新时就会出现抖动。例如，要在背景色中画图，且在前景中写一些透明的文字，实现的步骤就是先画图，然后写文字，那么结果就会出现文字的抖动。如果在程序中使用MemDev，则所有的执行操作都在MemDev中执行，当所有的操作都执行完毕之后，最后的结果才会送到屏幕上显示，因而可以避免多次刷新，从而避免抖动。
此目录下包含这MemDev的所有函数，包括创建MemDev函数，激活MemDev，执行画图操作，显示到终端，删除MemDev函数等等。
◆ uC/GUI/GUI/Touch
触摸屏驱动函数所在目录。uC/GUI只支持模拟的触摸屏。因而此目录下只包含模拟触摸屏。
◆ uC/GUI/GUI/Widget
此目录包含窗口控件函数，总共46个函数。UC/GUI中窗口控件机制时uC/GUI的实现难点，也是应用难点。运用窗口管理和回调机制，运用窗口控件函数，可以任意在LCD屏幕上实现类似于windows的界面，这样完备的功能在工业自动化控制和触摸屏应用上有着深远而积极的意义。
此目录下的函数主要包括uC/GUI的窗口控件，如按钮BUTTON，校验窗CHECKBOX，编辑区EDIT，窗口框FRAMEWIN，列表LISTBOX，进度条PROGBAR，音频按钮RADIOBUTTON,滚动条SCROLLERBAR，改变值的灰度条SLIDER，以及文本框TEXT相关的各种函数。
◆ uC/GUI/GUI/WM
此目录包括窗口管理函数，总共52个函数。UC/GUI中，窗口管理中的消息传递机制和回调机制，也是uC/GUI的实现难点和应用难点。4.3节中将详细介绍这两点。
此目录下的函数主要包括设置、返回、建立背景窗口、父窗口、各种子窗口以及相应的尺寸、窗口句柄，起点x，y坐标，窗口宽度，高度，位置等等，还包括改变窗口的大小，以及最关键的窗口的回调函数，窗口重绘函数等等。
4.3 uC/GUI的窗口管理
4.3.1简介
uC/GUI的窗口管理是一个单独的软件，不是uC/GUI的基本组成部分。详细代码见/uCGUI/GUI/WM。
当使用uC/GUI窗口管理时，任何能显示在显示终端上的内容都包含在一个窗口里面，这个窗口是LCD屏幕上的一个给用户画图或者显示目标的区域。窗口可以是任何尺寸的，可以一次在屏幕上显示多个窗口，也可以在其它窗口当中或之前显示窗口。
窗口管理的几个名词：
◆ 活动窗口：
当前正在用来画图或是显示操作的窗口。
◆ 回调函数
回
调函数是由用户定义的，当特定事件发生时，指示图形系统调用特定函数的函数。通常当窗口的内容发生改变时，它们用来自动重绘窗口。例如，窗口内显示一幅位
图，当窗口移动时，位图并不会自动移动，此时，就需要调用回调函数对窗口进行重绘，即，从观众的角度来看，移动窗口和窗口内容。
◆ 子/父窗口
子窗口是相对于父窗口定义的窗口。无论何时，只要父窗口移动，则子窗口们都要相应移动。子窗口被父窗口完全包含。拥有同一个父窗口的子窗口们互相间称为兄弟。
◆ 客户区
窗口的客户区就是窗口的可用区。如果窗口包含方框或标题栏，则客户区就是方框或标题栏的内部区域。
◆ 句柄
当一个新的窗口被创建时，WM分配一个唯一的标识符，称为句柄。句柄用在后续对该窗口操作的所有函数中，而且可以利用该句柄唯一标识该窗口。
◆ 有效窗口/无效窗口
有效窗口是一个已经完全更新，不需要重绘的窗口。不管是完全重绘还是局部重绘。当窗口内容发生改变时，WM则标识窗口无效。下一次重绘之后（调用回调函数），窗口又变为有效。
4.3.2回调机制
uC/GUI提供给窗口和窗口控件的回调机制的背后，是一个事件驱动标志。在大多数的窗口系统中，流控不仅仅时从用户程序到图形系统，而且还要能够从用户程序到图形系统，并且能够通过用户程序提供的回调函数，返回到用户程序。这个机制，就称为回调机制。在uC/GUI中，回到机制用来在窗口管理中出控制窗口的重绘操作，这使得窗口管理的有效性成为可能。
4.3.3 回调函数的使用
使用回调函数建立一个窗口时，必须有一个回调函数。所用的回调函数必须有如下原型：
void callback (WM_MESSAGE *pMsg)。 其中pMsg为指向消息的指针。
回调函数执行的功能依赖于所接收到的消息。以上原型后一般跟着switch表达式，表达式定义不同的case表达式下不同的信息对应的不同行为，至少要有一个重绘函数：WM_PAINT()。如程序清单4.1,建立一个自动更新窗口的回调函数

程序清单 4.1 建立一个自动更新窗口的回调函数 void WinHandler (WM_MESSAGE * pMsg) { switch (pMsg->MsgId) { case: WM_PAINT GUI_SetBkColor(0xff00); GUI_Clear(); GUI_DispStringAt(“hello world”,0,0); Break; } }

使用回调函数，更为详细的示例如程序清单4.2所示：

程序清单4.2 回调函数 #include "GUI.H" /* 背景窗的回调函数 */ static void cbBackgroundWin(WM_MESSAGE* pMsg) { switch (pMsg->MsgId) { case WM_PAINT: GUI_Clear(); default: WM_DefaultProc(pMsg); } } /* 前景窗的回调函数 */ static void cbForegroundWin(WM_MESSAGE* pMsg) { switch (pMsg->MsgId) { case WM_PAINT: GUI_SetBkColor(GUI_GREEN); GUI_Clear(); GUI_DispString("Foreground window"); default: WM_DefaultProc(pMsg); } } /* 回调机制 */ static void DemoRedraw(void) { GUI_HWIN hWnd; while(1) { /*创建一个前景窗 */ hWnd = WM_CreateWindow(10, 10, 100, 100, WM_CF_SHOW, cbForegroundWin, 0); /*显示前景窗*/ GUI_Delay(1000); /* 删除前景窗 */ WM_DeleteWindow(hWnd); GUI_DispStringAt("Background of window has not been redrawn", 10, 10); /* 等待，显示并不重绘 */ GUI_Delay(1000); GUI_Clear(); /* 设置背景窗的回调功能 */ WM_SetCallback(WM_HBKWIN, cbBackgroundWin);

/*创建一个前景窗 */ hWnd = WM_CreateWindow(10, 10, 100, 100,WM_CF_SHOW, cbForegroundWin, 0); /* 显示前景窗*/ GUI_Delay(1000); /*删除前景窗 */ WM_DeleteWindow(hWnd); /* 等待，显示将重绘*/ GUI_Delay(1000); /* 删除回调函数 */ WM_SetCallback(WM_HBKWIN, 0); } } void main(void) { GUI_Init(); DemoRedraw(); }

4.3.4 消息传递机制
程序清单4.2中，回调函数执行的功能依赖于所接收到的消息。Switch语句中根据消息的类型，分别执行不同的功能。
WM_MESSAGE的成员如下：
MsgId：消息类型
HWin: 目的窗口
HWinSrc: 源窗口
Data.p : 数据指针
Data.v: 数据值
其中MsgId的类型如下：
WM_PAINT: 窗口重绘
WM_CREATE: 窗口一建立就发送
WM_DELETE: 窗口一删除就发送
WM_SIZE : 窗口尺寸发生改变就发送
WM_MOVE : 窗口移动就发送
WM_SHOW : 接收到show命令就发送
WM_HIDE : 接收到hide命令就发送
WM_TOUCH: 触摸屏信息
应用程序还可以为自己定义额外的消息。为保证它们不用到uC/GUI的消息ID，用户定义的消息从WM_USER后面开始，如：
#define MY_MESSAGE_AAA WM_USER +0

#define MY_MESSAGE_BBB WM_USER +1