awtk/docs/manual/image_manager_t.md

image_manager_t

概述

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

函数

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

属性

名属性称	类型	说明

事件

事件名称	类型	说明

image_manager 函数

• 函数原型：

image_manager_t* image_manager ();

• 参数说明：

---

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

• 函数功能：

获取缺省的图片管理器。

image_manager_add 函数

• 函数原型：

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

• 参数说明：

---

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

• 函数功能：

向缓存中加入一张图片

image_manager_create 函数

• 函数原型：

image_manager_t* image_manager_create (image_loader_t* loader);

• 参数说明：

---

参数	类型	说明
返回值	image_manager_t*	返回图片管理器对象。
loader	image_loader_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_init 函数

• 函数原型：

image_manager_t* image_manager_init (image_manager_t* imm, image_loader_t* loader);

• 参数说明：

---

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

• 函数功能：

初始化图片管理器。

image_manager_load 函数

• 函数原型：

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

• 参数说明：

---

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

• 函数功能：

加载指定的图片。

image_manager_lookup 函数

• 函数原型：

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

• 参数说明：

---

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
imm	image_manager_t*	图片管理器对象。
name	char*	图片名。
image	bitmap_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 函数

• 函数原型：

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_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 函数

• 函数原型：

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

• 参数说明：

---

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

• 函数功能：

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