awtk/docs/how_to_use_mutable_image.md
2020-08-16 09:10:01 +08:00

161 lines
6.6 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 如何使用 mutable\_image 控件
有时候,需要把一个视频或者摄像头的数据绘画到屏幕上面。
这个时候就可以使用 mutable\_image 控件来实现该功能了。
## 一、基本用法
一般情况下用户只需要通过 mutable\_image\_set\_prepare\_image 函数注册绘制 bitmap 的函数就可以了,例如下面示例中注册 mutable\_image\_prepare\_image 函数,该函数不断的给 mutable\_image 控件的 bitmap 填充红色,用户也可以在该函数中绘画其他的图像数据,就可以达到动态播放视频或者摄像头的效果。
#### 备注:
> 一般情况下 mutable\_image 控件的 bitmap 的位图格式是 lcd 的格式。
#### 示例:
```
#include "awtk.h"
#include "ext_widgets/mutable_image/mutable_image.h"
ret_t mutable_image_prepare_image(void* ctx, bitmap_t* image) {
uint32_t i = 0;
uint32_t bpp = 0;
uint32_t size = 0;
uint8_t* image_data = NULL;
bpp = bitmap_get_bpp(image);
size = image->h * bitmap_get_line_length(image);
#ifdef TK_GRAPHIC_BUFFER_H
/* 新版本 AWTK 使用 bitmap_lock_buffer_for_write 函数来获取位图的数据 */
image_data = bitmap_lock_buffer_for_write(image);
#else
/* 旧版本的 AWTK 直接通过 bitmap 成员变量就可以获取位图的数据 */
image_data = (uint8_t*)(image->data);
#endif
/*
* 假设 lcd 的格式为 BGRA8888 ,那么 bpp 应该为4
* image_data 是 mutable_image 控件的 bitmap 的位图数据
* 这里给 image_data 设置为蓝色,当然也可以设置摄像头数据或者视频数据
*/
for(;i < size; i += bpp, image_data += bpp) {
image_data[0] = 0xff;
image_data[1] = 0x00;
image_data[2] = 0x00;
image_data[3] = 0xff;
}
return RET_OK;
}
ret_t application_init() {
tk_ext_widgets_init();
widget_t* win = window_create(NULL, 0, 0, 0, 0);
/* 创建 mutable_image 控件 */
widget_t* mutable = mutable_image_create(win, 0, 0, win->w, win->h);
/* 注册 mutable_image 控件的绘制图像回调函数 */
mutable_image_set_prepare_image(mutable, mutable_image_prepare_image, NULL);
return RET_OK;
}
```
> 完整的用法请参考https://github.com/zlgopen/awtk-c-demos/blob/master/demos/mutable_image.c
## 二、支持硬件图层融合用法
在某些平台下,支持多个 lcd 的硬件 framebuffer ,这些硬件 framebuffer 可以在硬件绘画的时候做合成到 lcd ,这样子可以速度会软件合成要快的多,所以 mutable\_image 控件也支持该情况。
注意:该用法只适用于多个 lcd 硬件 framebuffer 的平台,如果单 framebuffer 的平台就只能使用上面提供的基本用法了。
> 备注:
>
> 1. AWTK 的 lcd 类型必须是 32 位色的RGBA 或者 BGRA 的类型)。
> 2. 需要定义 WITH_LCD_CLEAR_ALPHA 宏,让 AWTK 支持刷新透明区域的机制和让 AWTK 支持背景色为透明的混合算法。
> 特别说明:
>
> 1. 定义 WITH_LCD_CLEAR_ALPHA 宏会降低 AWTK 的性能。
> 2. AWTK 支持刷新透明区域的机制就可以支持 window 背景色为透明或者半透明的效果,其原理是在绘图之前对脏矩形区域刷一层全透明的颜色。(主要是解决透明背景的残影问题)
> 3. AWTK 支持背景色为透明的混合算法,该算法会比背景色为不透明的混合算法更加消耗性能。(背景色为透明,需要比背景色不透明的每个像素点增加好几个乘除法的运算,但是如果背景色本身为不透明就会退化为原来的背景色不透明的混合算法)
#### 1. mutable\_image 控件用法
如果调用了 mutable\_image\_set\_framebuffer 函数设置硬件 framebuffer 了, mutable\_image 控件就不会在 AWTK 的 GUI 上面显示了,而且由于 mutable\_image 控件的刷新函数受到 AWTK 的消息循环机制影响,所以 mutable\_image 控件帧率和 AWTK 的帧率一样,但是好处是用户只需要简单的把数据刷到 mutable\_image 控件上面就可以了,剩下的交给 AWTK 处理就好了。
#### 示例:
```
#include "awtk.h"
#include "ext_widgets/mutable_image/mutable_image.h"
/* 假设 DEVICE_FB 宏的地址为 lcd 的硬件 framebuffer 地址 */
#define DEVICE_FB (uint8_t*)0XC0000000
ret_t mutable_image_prepare_image(void* ctx, bitmap_t* image) {
uint32_t i = 0;
uint32_t bpp = 0;
uint32_t size = 0;
uint8_t* image_data = NULL;
bpp = bitmap_get_bpp(image);
size = image->h * bitmap_get_line_length(image);
#ifdef TK_GRAPHIC_BUFFER_H
/* 新版本 AWTK 使用 bitmap_lock_buffer_for_write 函数来获取位图的数据 */
image_data = bitmap_lock_buffer_for_write(image);
#else
/* 旧版本的 AWTK 直接通过 bitmap 成员变量就可以获取位图的数据 */
image_data = (uint8_t*)(image->data);
#endif
/*
* 把带有透明度的蓝色填充到 lcd 的硬件 framebuffer 中
* image_data 是 mutable_image 控件的 bitmap 的位图数据
* 这里的 image 的位图格式和长宽分别,是在 mutable_image_set_framebuffer 函数中设置的
* 这里给 image_data 设置为蓝色,当然也可以设置摄像头数据或者视频数据
* 这里的 image_data 的地址就是上面 lcd 的硬件 framebuffer 地址
*/
for(;i < size; i += bpp, image_data += bpp) {
image_data[0] = 0xff;
image_data[1] = 0x00;
image_data[2] = 0x00;
image_data[3] = 0xa0;
}
return RET_OK;
}
ret_t application_init() {
tk_ext_widgets_init();
widget_t* win = window_create(NULL, 0, 0, 0, 0);
/* 创建 mutable_image 控件 */
widget_t* mutable = mutable_image_create(win, 0, 0, win->w, win->h);
/* 注册 mutable_image 控件的绘制图像回调函数 */
mutable_image_set_prepare_image(mutable, mutable_image_prepare_image, NULL);
/* mutable_image 控件设置位图格式为 BGRA8888 的 lcd 的硬件 framebuffer并且长宽分别为 win->w 和 win->h 。 */
mutable_image_set_framebuffer(mutable, win->w, win->h, BITMAP_FMT_BGRA8888, DEVICE_FB)
return RET_OK;
}
```
#### 2. 直接刷硬件方法
如果嵌入式支持多线程的话,可以使用一条线程支持刷到其中一个硬件图层中,然后另外一条线程给 AWTK 运行 GUI。
这个方法的好处是视频的刷新率不会受到 AWTK 的帧率影响,就算 AWTK 的 GUI 很卡,也不会导致视频卡顿的问题,如果硬件图层支持各种格式的透传的话,例如视频数据为 YUV 的话,就可以省下 YUV 格式转换的消耗问题,因为 mutable_image 控件只支持 RGBA8888 BGRA8888RGB888BGR888RGB565BGR565。
但是需要用户对嵌入式底层认识更多的要求一些。