awtk/docs/manual/canvas_offline_t.md

canvas_offline_t

概述

离线画布 canvas。

函数

函数名称	说明
canvas_offline_begin_draw	设置离线 canvas 开始绘图
canvas_offline_create	创建一个离线的 canvas
canvas_offline_destroy	释放离线 canvas 和离线 bitmap
canvas_offline_end_draw	设置离线 canvas 结束绘图
canvas_offline_flush_bitmap	把离线 canvas 的数据放到绑定的 bitmap 中
canvas_offline_get_bitmap	获取离线 canvas 的离线 bitmap。

属性

属性名称	类型	说明
bitmap	bitmap_t*	绑定的离线 bitmap

canvas_offline_begin_draw 函数

---

• 函数功能：

设置离线 canvas 开始绘图

• 函数原型：

ret_t canvas_offline_begin_draw (canvas_t* canvas);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
canvas	canvas_t*	离线 canvas 对象。

canvas_offline_create 函数

---

• 函数功能：

创建一个离线的 canvas

在 opengl 模式下 format 参数只能为 BITMAP_FMT_RGBA8888 在其他模式下，离线 canvas 格式可以为 rgba，bgar，bgr565和rgb565

• 函数原型：

canvas_t* canvas_offline_create (uint32_t w, uint32_t h, bitmap_format_t format);

• 参数说明：

参数	类型	说明
返回值	canvas_t*	成功返回 canvas ，失败返回 NULL。
w	uint32_t	离线 canvas 的宽。
h	uint32_t	离线 canvas 的高。
format	bitmap_format_t	离线 canvas 的格式。

canvas_offline_destroy 函数

---

• 函数功能：

释放离线 canvas 和离线 bitmap

• 函数原型：

ret_t canvas_offline_destroy (canvas_t* canvas);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
canvas	canvas_t*	离线 canvas 对象。

canvas_offline_end_draw 函数

---

• 函数功能：

设置离线 canvas 结束绘图

• 函数原型：

ret_t canvas_offline_end_draw (canvas_t* canvas);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
canvas	canvas_t*	离线 canvas 对象。

canvas_offline_flush_bitmap 函数

---

• 函数功能：

把离线 canvas 的数据放到绑定的 bitmap 中

该函数只有在 opengl 模式才需要调用，是否把显存中的数据回传到内存中。

• 函数原型：

ret_t canvas_offline_flush_bitmap (canvas_t* canvas);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
canvas	canvas_t*	离线 canvas 对象。

canvas_offline_get_bitmap 函数

---

• 函数功能：

获取离线 canvas 的离线 bitmap。

• 函数原型：

bitmap_t* canvas_offline_get_bitmap (canvas_t* canvas);

• 参数说明：

参数	类型	说明
返回值	bitmap_t*	返回 bitmap_t 对象表示成功，返回 NULL 表示失败。
canvas	canvas_t*	离线 canvas 对象。

bitmap 属性

---

绑定的离线 bitmap

• 类型：bitmap_t*

特性	是否支持
可直接读取	是
可直接修改	否