RT-Thread RTOS组件：RTGUI教程 workbench（上）

发布于 2009-11-02 22:02:06 浏览：5455 订阅该版

RTGUI教程之二 -- workbench 上

workbench从英文的意思来看，
n. 1. 工作台;作业台

RTGUI的workbench是一件很有意义的划分，特别是当RTGUI不支持窗口的时候。RTGUI中的工作台是指，屏幕上互不重叠的区域，或者说这块区域是由每个工作台独占的（如果不存在window的情况下）。

在这个概念下，相当于上层应用可以直接访问物理底层帧缓冲，而不用通知别人，我这个工作台更新了，你这里如果有重叠部分，那么应该重新刷新你的图形。所以可以说，RTGUI的工作台具备独占性。

上次和东南的研究生聊到了一个示波器的原型，他们采用的是FPGA采集数据，而且可能是采集的数据速度远远大于ARM9的处理速度。不过这个系统有个好处，FPGA的数据实际上就是一幅图像，可以直接放到帧缓冲中进行显示。类似于这类应用，可以在RTGUI如何展开呢：首先可以把显示波形的部分单独独立成一个工作台，即独占的了！然后采用DMA的方式直接从FPGA中把图像数据搬移到帧缓冲的相应位置。够直接吧，速度也超级快的，因为ARM这边的干预非常少，只有DMA的动作。

好了，工作台大致使用目的知道了，那么看看，如何在RTGUI中操作工作台呢。首先一个，需要对屏幕面板进行划分，划分出各自的互不重叠的区域：（以下的代码都可在stm32 radio开发板上运行，下同）
```
		/* register dock panel */
		rect.x1 = 0;
		rect.y1 = 0;
		rect.x2 = 240;
		rect.y2 = 25;

rtgui_panel_register("info", &rect);

/* register main panel */
		rect.x1 = 0;
		rect.y1 = 25;
		rect.x2 = 240;
		rect.y2 = 320;
		rtgui_panel_register("main", &rect);
```

这段代码的就是用来注册不同的区域的，总计包括：
(00, 00) - (240, 25)的info区域
(00, 25) - (240, 320)的main区域

rtgui_panel_register函数用来注册区域，每个区域需要一个名字，以及它的位置信息。

有了个各个互不重叠的区域信息之后，那就是如何在工作台上绘图了，先看看如何创建一个工作台：
```
/* 相类似的，GUI应用总是依赖于一个可执行的线程环境，先创建一个GUI线程 */
void workbench_init()
{
	static rt_bool_t inited = RT_FALSE;

if (inited == RT_FALSE) /* 避免重复初始化而做的保护 */
	{
		rt_thread_t tid;

tid = rt_thread_create("wb",
			workbench_entry, RT_NULL,
			2048, 25, 10);

if (tid != RT_NULL) rt_thread_startup(tid);

inited = RT_TRUE;
	}
}

#ifdef RT_USING_RTGUI
#include <finsh.h>
void workbench()
{
	workbench_init();
}
/* finsh的命令输出，可以直接执行workbench()函数以执行上面的函数 */
FINSH_FUNCTION_EXPORT(workbench, workbench demo)
#endif
```

接下来是，做一个Hello World，这个比上一节窗口稍微复杂些，上节采用的是label控件，这里则直接用绘图的形式绘制出来。
```
static void workbench_entry(void* parameter)
{
	rt_mq_t mq;
	struct rtgui_view* view;
	struct rtgui_workbench* workbench;

/* 创建GUI应用需要的消息队列 */
	mq = rt_mq_create("qWB", 256, 4, RT_IPC_FLAG_FIFO);
	/* 注册当前线程为GUI线程 */
	rtgui_thread_register(rt_thread_self(), mq);

/* 创建一个工作台 */
	workbench = rtgui_workbench_create("main", "workbench");
	if (workbench == RT_NULL) return;

/* 创建一个工作台上的一个视图 */
	view = rtgui_view_create("widget");
	rtgui_widget_set_event_handler(RTGUI_WIDGET(view), view_event_handler);

/* 在工作台上添加一个视图 */
	rtgui_workbench_add_view(workbench, view);

/* 显示这个视图 */
	rtgui_view_show(view);

/* 执行工作台事件循环 */
	rtgui_workbench_event_loop(workbench);

/* 去注册GUI线程 */
	rtgui_thread_deregister(rt_thread_self());
	rt_mq_delete(mq);
}
```

在上面的例子中，我们还看到，除了创建一个工作台之外，还创建了一个view - 视图。我们可以类比下，工作台好比自己的办公桌，桌子上满满的铺上了一张地图，占据了桌面的所有面积。但是，如何换一张地图呢？所以这里有了视图的概念，桌面上的地图可以一张张换，当然了，也可以只是一张。

另外，如上说的，这个例子中要使用的是自行绘制字符串的方式显示“Hello World”，那么如何才能自行绘制呢？要进行绘制必须首先获得一个图形设备的上下文，可以调用函数：
rtgui_dc_begin_drawing(widget);
获得，参数是一个控件（workbench、view也是一类特殊控件）

当绘图完成时，调用
rtgui_dc_end_drawing(dc);
函数即可（当应用绘制完图形时，可能这个图形还只存在于缓冲中，并没有刷新到LCD上，所以rtgui_dc_end_drawing会自动通知底层驱动，进行一次更新操作）。

RTGUI内部是完全事件驱动的，特别是当有窗口支持时，事件会显得特别重要，例如：当覆盖到一个工作台的窗口消失时，RTGUI就需要通知被覆盖的工作台做相应的更新动作。
（还记得上一节定时器窗口，当计数器减到0时，为什么窗口还在吗？因为，它所覆盖的地方没有任何应用，RTGUI也当然不会通知更新了）

应用需要做的就是截获相应的事件：
```
static rt_bool_t view_event_handler(struct rtgui_widget* widget, struct rtgui_event* event)
{
	/* 我们目前只对绘制事件感兴趣 */
	if (event->type == RTGUI_EVENT_PAINT)
	{
		struct rtgui_dc* dc;
		struct rtgui_rect rect;

/* 获得一个设备上下文 */
		dc = rtgui_dc_begin_drawing(widget);
		if (dc == RT_NULL) return RT_FALSE; /* 如果获取失败代表什么？这个控件是隐藏的或... */
		rtgui_widget_get_rect(widget, &rect); /* 获得控件的可视区域 */

/* 先对所在可视区域全部填充为背景色 */
		rtgui_dc_fill_rect(dc, &rect);

/* 绘制一个hello! */
		rtgui_dc_draw_text(dc, "hello world", &rect);

/* 通知RTGUI，绘制结束 */
		rtgui_dc_end_drawing(dc);

return RT_FALSE;
	}

/* 如果不是绘制事件，使用view原来的事件处理函数处理 */
	return rtgui_view_event_handler(widget, event);
}
```

完整的代码如下：
```
#include <rtgui/rtgui.h>
#include <rtgui/rtgui_system.h>

#include <rtgui/widgets/view.h>
#include <rtgui/widgets/workbench.h>

static rt_bool_t view_event_handler(struct rtgui_widget* widget, struct rtgui_event* event)
{
	/* 我们目前只对绘制事件感兴趣 */
	if (event->type == RTGUI_EVENT_PAINT)
	{
		struct rtgui_dc* dc;
		struct rtgui_rect rect;

/* 获得一个设备上下文 */
		dc = rtgui_dc_begin_drawing(widget);
		if (dc == RT_NULL) return RT_FALSE; /* 如果获取失败代表什么？这个控件是隐藏的或... */
		rtgui_widget_get_rect(widget, &rect); /* 获得控件的可视区域 */

/* 先对所在可视区域全部填充为背景色 */
		rtgui_dc_fill_rect(dc, &rect);

/* 绘制一个hello! */
		rtgui_dc_draw_text(dc, "hello world", &rect);

/* 通知RTGUI，绘制结束 */
		rtgui_dc_end_drawing(dc);

return RT_FALSE;
	}

/* 如果不是绘制事件，使用view原来的事件处理函数处理 */
	return rtgui_view_event_handler(widget, event);
}

static void workbench_entry(void* parameter)
{
	rt_mq_t mq;
	struct rtgui_view* view;
	struct rtgui_workbench* workbench;

/* 创建GUI应用需要的消息队列 */
	mq = rt_mq_create("qWB", 256, 4, RT_IPC_FLAG_FIFO);
	/* 注册当前线程为GUI线程 */
	rtgui_thread_register(rt_thread_self(), mq);

/* 创建一个工作台 */
	workbench = rtgui_workbench_create("main", "workbench");
	if (workbench == RT_NULL) return;

/* 创建一个工作台上的一个视图 */
	view = rtgui_view_create("view");
	rtgui_widget_set_event_handler(RTGUI_WIDGET(view), view_event_handler);

/* 在工作台上添加一个视图 */
	rtgui_workbench_add_view(workbench, view);

/* 显示这个视图 */
	rtgui_view_show(view);

/* 执行工作台事件循环 */
	rtgui_workbench_event_loop(workbench);

/* 去注册GUI线程 */
	rtgui_thread_deregister(rt_thread_self());
	rt_mq_delete(mq);
}

void workbench_init()
{
	static rt_bool_t inited = RT_FALSE;

if (inited == RT_FALSE) /* 避免重复初始化而做的保护 */
	{
		rt_thread_t tid;

tid = rt_thread_create("wb",
			workbench_entry, RT_NULL,
			2048, 25, 10);

if (tid != RT_NULL) rt_thread_startup(tid);

inited = RT_TRUE;
	}
}

#ifdef RT_USING_RTGUI
#include <finsh.h>
void workbench()
{
	workbench_init();
}
/* finsh的命令输出，可以直接执行workbench()函数以执行上面的函数 */
FINSH_FUNCTION_EXPORT(workbench, workbench demo)
#endif
```
![filelist.png](https://oss-club.rt-thread.org/uploads/53_f5fa973c9d7dbb420ea582b2fe93ffdb.png)

![SV400002.JPG](https://oss-club.rt-thread.org/uploads/53_928a7c59f7f8a97cc860fc2d123c725b.jpg)