awtk/docs/manual/image_manager_t.md

image_manager_t

概述

图片管理器。负责加载，解码和缓存图片。

---

函数

函数名称	说明
image_manager	获取缺省的图片管理器。
image_manager_create	创建图片管理器。
image_manager_deinit	析构图片管理器。
image_manager_destroy	析构并释放图片管理器。
image_manager_get_bitmap	获取指定的图片。
image_manager_init	初始化图片管理器。
image_manager_set	设置缺省的图片管理器。
image_manager_set_assets_manager	设置资源管理器对象。
image_manager_unload_bitmap	从图片管理器中卸载指定的图片。
image_manager_unload_unused	从图片管理器中卸载指定时间内没有使用的图片。
image_manager_update_specific	更新缓存中图片的specific信息。

属性

属性名称	类型	说明

image_manager 函数

---

• 函数功能：

获取缺省的图片管理器。

• 函数原型：

image_manager_t* image_manager ();

• 参数说明：

参数	类型	说明
返回值	image_manager_t*	返回图片管理器对象。

image_manager_create 函数

---

• 函数功能：

创建图片管理器。

• 函数原型：

image_manager_t* image_manager_create ();

• 参数说明：

参数	类型	说明
返回值	image_manager_t*	返回图片管理器对象。

image_manager_deinit 函数

---

• 函数功能：

析构图片管理器。

• 函数原型：

ret_t image_manager_deinit (image_manager_t* imm);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
imm	image_manager_t*	图片管理器对象。

image_manager_destroy 函数

---

• 函数功能：

析构并释放图片管理器。

• 函数原型：

ret_t image_manager_destroy (image_manager_t* imm);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
imm	image_manager_t*	图片管理器对象。

image_manager_get_bitmap 函数

---

• 函数功能：

获取指定的图片。

先从缓存查找，如果没找到，再加载并缓存。

• 函数原型：

ret_t image_manager_get_bitmap (image_manager_t* imm, char* name, bitmap_t* image);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
imm	image_manager_t*	图片管理器对象。
name	char*	图片名称。
image	bitmap_t*	用于返回图片。

image_manager_init 函数

---

• 函数功能：

初始化图片管理器。

• 函数原型：

image_manager_t* image_manager_init (image_manager_t* imm);

• 参数说明：

参数	类型	说明
返回值	image_manager_t*	返回图片管理器对象。
imm	image_manager_t*	图片管理器对象。

image_manager_set 函数

---

• 函数功能：

设置缺省的图片管理器。

• 函数原型：

ret_t image_manager_set (image_manager_t* imm);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
imm	image_manager_t*	图片管理器对象。

image_manager_set_assets_manager 函数

---

• 函数功能：

设置资源管理器对象。

之所以需要设置资源管理器对象，而不是使用缺省的资源管理器对象，是因为在designer中有两个图片管理器：

• 一个用于designer本身加载图片。

• 一个用于被设计的窗口加载图片。

这两个图片管理器需要从不同的路径加载资源。

• 函数原型：

ret_t image_manager_set_assets_manager (image_manager_t* imm, assets_manager_t* assets_manager);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
imm	image_manager_t*	图片管理器对象。
assets_manager	assets_manager_t*	资源管理器。

image_manager_unload_bitmap 函数

---

• 函数功能：

从图片管理器中卸载指定的图片。

• 函数原型：

ret_t image_manager_unload_bitmap (image_manager_t* imm, bitmap_t* image);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
imm	image_manager_t*	图片管理器对象。
image	bitmap_t*	图片。

image_manager_unload_unused 函数

---

• 函数功能：

从图片管理器中卸载指定时间内没有使用的图片。

• 函数原型：

ret_t image_manager_unload_unused (image_manager_t* imm, uint32_t time_delta_s);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
imm	image_manager_t*	图片管理器对象。
time_delta_s	uint32_t	时间范围，单位为秒。

image_manager_update_specific 函数

---

• 函数功能：

更新缓存中图片的specific信息。

• 函数原型：

ret_t image_manager_update_specific (image_manager_t* imm, bitmap_t* image);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
imm	image_manager_t*	图片管理器对象。
image	bitmap_t*	返回图片信息。