test/awtk
1
0
Fork 0
mirror of https://gitee.com/zlgopen/awtk.git synced 2024-12-02 12:08:16 +08:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
c602e46525
awtk/docs/manual/image_manager_t.md

260 lines
6.7 KiB
Markdown
Raw Normal View History

update docs
2018-12-20 17:33:31 +08:00
## image\_manager\_t
### 概述
图片管理器。负责加载，解码和缓存图片。
### 函数
<p id="image_manager_t_methods">
| 函数名称 | 说明 |
| -------- | ------------ |
update docs
2018-12-21 12:11:40 +08:00
| <a href="#image_manager_t_image_manager">image\_manager</a> | 获取缺省的图片管理器。 |
| <a href="#image_manager_t_image_manager_create">image\_manager\_create</a> | 创建图片管理器。 |
| <a href="#image_manager_t_image_manager_deinit">image\_manager\_deinit</a> | 析构图片管理器。 |
| <a href="#image_manager_t_image_manager_destroy">image\_manager\_destroy</a> | 析构并释放图片管理器。 |
update docs
2018-12-29 12:17:06 +08:00
| <a href="#image_manager_t_image_manager_get_bitmap">image\_manager\_get\_bitmap</a> | 获取指定的图片。 |
update docs
2018-12-21 12:11:40 +08:00
| <a href="#image_manager_t_image_manager_init">image\_manager\_init</a> | 初始化图片管理器。 |
| <a href="#image_manager_t_image_manager_set">image\_manager\_set</a> | 设置缺省的图片管理器。 |
update docs
2018-12-29 12:17:06 +08:00
| <a href="#image_manager_t_image_manager_set_assets_manager">image\_manager\_set\_assets\_manager</a> | 设置资源管理器对象。 |
update docs
2018-12-21 12:11:40 +08:00
| <a href="#image_manager_t_image_manager_unload_unused">image\_manager\_unload\_unused</a> | 从图片管理器中卸载指定时间内没有使用的图片。 |
| <a href="#image_manager_t_image_manager_update_specific">image\_manager\_update\_specific</a> | 更新缓存中图片的specific信息。 |
update docs
2018-12-20 17:33:31 +08:00
### 属性
<p id="image_manager_t_properties">
| 名属性称 | 类型 | 说明 |
| -------- | ----- | ------------ |
#### image\_manager 函数
update docs
2018-12-21 18:29:29 +08:00
-----------------------
* 函数功能：
> <p id="image_manager_t_image_manager"> 获取缺省的图片管理器。
update docs
2018-12-21 11:39:05 +08:00
* 函数原型：
```
image_manager_t* image_manager ();
```
* 参数说明：
update docs
2018-12-20 17:33:31 +08:00
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | image\_manager\_t* | 返回图片管理器对象。 |
update docs
2018-12-21 18:29:29 +08:00
#### image\_manager\_create 函数
-----------------------
update docs
2018-12-21 11:39:05 +08:00
* 函数功能：
update docs
2018-12-21 18:29:29 +08:00
> <p id="image_manager_t_image_manager_create"> 创建图片管理器。
update docs
2018-12-20 17:33:31 +08:00
update docs
2018-12-21 11:39:05 +08:00
* 函数原型：
```
image_manager_t* image_manager_create (image_loader_t* loader);
```
* 参数说明：
update docs
2018-12-20 17:33:31 +08:00
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | image\_manager\_t* | 返回图片管理器对象。 |
| loader | image\_loader\_t* | 图片加载器。 |
update docs
2018-12-21 18:29:29 +08:00
#### image\_manager\_deinit 函数
-----------------------
update docs
2018-12-21 11:39:05 +08:00
* 函数功能：
update docs
2018-12-21 18:29:29 +08:00
> <p id="image_manager_t_image_manager_deinit"> 析构图片管理器。
update docs
2018-12-20 17:33:31 +08:00
update docs
2018-12-21 11:39:05 +08:00
* 函数原型：
```
ret_t image_manager_deinit (image_manager_t* imm);
```
* 参数说明：
update docs
2018-12-20 17:33:31 +08:00
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| imm | image\_manager\_t* | 图片管理器对象。 |
update docs
2018-12-21 18:29:29 +08:00
#### image\_manager\_destroy 函数
-----------------------
update docs
2018-12-21 11:39:05 +08:00
* 函数功能：
update docs
2018-12-21 18:29:29 +08:00
> <p id="image_manager_t_image_manager_destroy"> 析构并释放图片管理器。
update docs
2018-12-20 17:33:31 +08:00
update docs
2018-12-21 11:39:05 +08:00
* 函数原型：
```
ret_t image_manager_destroy (image_manager_t* imm);
```
* 参数说明：
update docs
2018-12-20 17:33:31 +08:00
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| imm | image\_manager\_t* | 图片管理器对象。 |
update docs
2018-12-29 12:17:06 +08:00
#### image\_manager\_get\_bitmap 函数
update docs
2018-12-21 18:29:29 +08:00
-----------------------
update docs
2018-12-21 11:39:05 +08:00
* 函数功能：
update docs
2018-12-29 12:17:06 +08:00
> <p id="image_manager_t_image_manager_get_bitmap"> 获取指定的图片。
先从缓存查找，如果没找到，再加载并缓存。
update docs
2018-12-21 11:39:05 +08:00
update docs
2018-12-20 17:33:31 +08:00
update docs
2018-12-21 11:39:05 +08:00
* 函数原型：
```
update docs
2018-12-29 12:17:06 +08:00
ret_t image_manager_get_bitmap (image_manager_t* imm, char* name, bitmap_t* image);
update docs
2018-12-21 11:39:05 +08:00
```
* 参数说明：
update docs
2018-12-20 17:33:31 +08:00
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| imm | image\_manager\_t* | 图片管理器对象。 |
| name | char* | 图片名称。 |
| image | bitmap\_t* | 用于返回图片。 |
update docs
2018-12-29 12:17:06 +08:00
#### image\_manager\_init 函数
update docs
2018-12-21 18:29:29 +08:00
-----------------------
update docs
2018-12-21 11:39:05 +08:00
* 函数功能：
update docs
2018-12-29 12:17:06 +08:00
> <p id="image_manager_t_image_manager_init"> 初始化图片管理器。
update docs
2018-12-20 17:33:31 +08:00
update docs
2018-12-21 11:39:05 +08:00
* 函数原型：
```
update docs
2018-12-29 12:17:06 +08:00
image_manager_t* image_manager_init (image_manager_t* imm, image_loader_t* loader);
update docs
2018-12-21 11:39:05 +08:00
```
* 参数说明：
update docs
2018-12-20 17:33:31 +08:00
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
update docs
2018-12-29 12:17:06 +08:00
| 返回值 | image\_manager\_t* | 返回图片管理器对象。 |
update docs
2018-12-20 17:33:31 +08:00
| imm | image\_manager\_t* | 图片管理器对象。 |
update docs
2018-12-29 12:17:06 +08:00
| loader | image\_loader\_t* | 图片加载器。 |
update docs
2018-12-21 18:29:29 +08:00
#### image\_manager\_set 函数
-----------------------
update docs
2018-12-21 11:39:05 +08:00
* 函数功能：
update docs
2018-12-21 18:29:29 +08:00
> <p id="image_manager_t_image_manager_set"> 设置缺省的图片管理器。
update docs
2018-12-20 17:33:31 +08:00
update docs
2018-12-21 11:39:05 +08:00
* 函数原型：
```
ret_t image_manager_set (image_manager_t* imm);
```
* 参数说明：
update docs
2018-12-20 17:33:31 +08:00
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| imm | image\_manager\_t* | 图片管理器对象。 |
update docs
2018-12-21 18:29:29 +08:00
#### image\_manager\_set\_assets\_manager 函数
-----------------------
update docs
2018-12-21 11:39:05 +08:00
* 函数功能：
update docs
2018-12-29 12:17:06 +08:00
> <p id="image_manager_t_image_manager_set_assets_manager"> 设置资源管理器对象。
之所以需要设置资源管理器对象，而不是使用缺省的资源管理器对象，是因为在designer中有两个图片管理器：
* 一个用于designer本身加载图片。
* 一个用于被设计的窗口加载图片。
这两个图片管理器需要从不同的路径加载资源。
update docs
2018-12-20 17:33:31 +08:00
update docs
2018-12-21 11:39:05 +08:00
* 函数原型：
```
ret_t image_manager_set_assets_manager (image_manager_t* imm, assets_manager_t* assets_manager);
```
* 参数说明：
update docs
2018-12-20 17:33:31 +08:00
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| imm | image\_manager\_t* | 图片管理器对象。 |
| assets\_manager | assets\_manager\_t* | 资源管理器。 |
update docs
2018-12-21 18:29:29 +08:00
#### image\_manager\_unload\_unused 函数
-----------------------
update docs
2018-12-21 11:39:05 +08:00
* 函数功能：
update docs
2018-12-21 18:29:29 +08:00
> <p id="image_manager_t_image_manager_unload_unused"> 从图片管理器中卸载指定时间内没有使用的图片。
update docs
2018-12-20 17:33:31 +08:00
update docs
2018-12-21 11:39:05 +08:00
* 函数原型：
```
ret_t image_manager_unload_unused (image_manager_t* imm, uint32_t time_delta_s);
```
* 参数说明：
update docs
2018-12-20 17:33:31 +08:00
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| imm | image\_manager\_t* | 图片管理器对象。 |
| time\_delta\_s | uint32\_t | 时间范围，单位为秒。 |
update docs
2018-12-21 18:29:29 +08:00
#### image\_manager\_update\_specific 函数
-----------------------
update docs
2018-12-21 11:39:05 +08:00
* 函数功能：
update docs
2018-12-21 18:29:29 +08:00
> <p id="image_manager_t_image_manager_update_specific"> 更新缓存中图片的specific信息。
update docs
2018-12-20 17:33:31 +08:00
update docs
2018-12-21 11:39:05 +08:00
* 函数原型：
```
ret_t image_manager_update_specific (image_manager_t* imm, bitmap_t* image);
```
* 参数说明：
update docs
2018-12-20 17:33:31 +08:00
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | ret\_t | 返回RET\_OK表示成功，否则表示失败。 |
| imm | image\_manager\_t* | 图片管理器对象。 |
| image | bitmap\_t* | 返回图片信息。 |
Reference in New Issue Copy Permalink