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


  • 函数功能:

获取缺省的图片管理器。

  • 函数原型:
  1. image_manager_t* image_manager ();
  • 参数说明:
参数 类型 说明
返回值 image_manager_t* 返回图片管理器对象。

image_manager_create 函数


  • 函数功能:

创建图片管理器。

  • 函数原型:
  1. image_manager_t* image_manager_create (image_loader_t* loader);
  • 参数说明:
参数 类型 说明
返回值 image_manager_t* 返回图片管理器对象。
loader image_loader_t* 图片加载器。

image_manager_deinit 函数


  • 函数功能:

析构图片管理器。

  • 函数原型:
  1. ret_t image_manager_deinit (image_manager_t* imm);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
imm image_manager_t* 图片管理器对象。

image_manager_destroy 函数


  • 函数功能:

析构并释放图片管理器。

  • 函数原型:
  1. ret_t image_manager_destroy (image_manager_t* imm);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
imm image_manager_t* 图片管理器对象。

image_manager_get_bitmap 函数


  • 函数功能:

获取指定的图片。
先从缓存查找,如果没找到,再加载并缓存。

  • 函数原型:
  1. 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 函数


  • 函数功能:

初始化图片管理器。

  • 函数原型:
  1. 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_set 函数


  • 函数功能:

设置缺省的图片管理器。

  • 函数原型:
  1. ret_t image_manager_set (image_manager_t* imm);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
imm image_manager_t* 图片管理器对象。

image_manager_set_assets_manager 函数


  • 函数功能:

设置资源管理器对象。

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

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

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

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

  • 函数原型:
  1. 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 函数


  • 函数功能:

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

  • 函数原型:
  1. 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 函数


  • 函数功能:

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

  • 函数原型:
  1. 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信息。

  • 函数原型:
  1. ret_t image_manager_update_specific (image_manager_t* imm, bitmap_t* image);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
imm image_manager_t* 图片管理器对象。
image bitmap_t* 返回图片信息。