2018-12-20 17:33:31 +08:00
|
|
|
|
## assets\_manager\_t
|
|
|
|
|
### 概述
|
2019-12-14 13:25:56 +08:00
|
|
|
|
资源管理器。
|
|
|
|
|
这里的资源管理器并非Windows下的文件浏览器,而是负责对各种资源,比如字体、主题、图片、界面数据、字符串和其它数据的进行集中管理的组件。引入资源管理器的目的有以下几个:
|
|
|
|
|
|
|
|
|
|
* 让上层不需要了解存储的方式。
|
|
|
|
|
在没有文件系统时或者内存紧缺时,把资源转成常量数组直接编译到代码中。在有文件系统而且内存充足时,资源放在文件系统中。在有网络时,资源也可以存放在服务器上(暂未实现)。资源管理器为上层提供统一的接口,让上层而不用关心底层的存储方式。
|
|
|
|
|
|
|
|
|
|
* 让上层不需要了解资源的具体格式。
|
|
|
|
|
比如一个名为earth的图片,没有文件系统或内存紧缺,图片直接用位图数据格式存在ROM中,而有文件系统时,则用PNG格式存放在文件系统中。资源管理器让上层不需要关心图片的格式,访问时指定图片的名称即可(不用指定扩展名)。
|
|
|
|
|
|
|
|
|
|
* 让上层不需要了解屏幕的密度。
|
|
|
|
|
不同的屏幕密度下需要加载不同的图片,比如MacPro的Retina屏就需要用双倍解析度的图片,否则就出现界面模糊。AWTK以后会支持PC软件和手机软件的开发,所以资源管理器需要为此提供支持,让上层不需关心屏幕的密度。
|
|
|
|
|
|
|
|
|
|
* 对资源进行内存缓存。
|
|
|
|
|
不同类型的资源使用方式是不一样的,比如字体和主题加载之后会一直使用,UI文件在生成界面之后就暂时不需要了,PNG文件解码之后就只需要保留解码的位图数据即可。资源管理器配合图片管理器等其它组件实现资源的自动缓存。
|
|
|
|
|
|
|
|
|
|
当从文件系统加载资源时,目录结构要求如下:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
assets/{theme}/raw/
|
|
|
|
|
fonts 字体
|
|
|
|
|
images 图片
|
|
|
|
|
x1 普通密度屏幕的图片。
|
|
|
|
|
x2 2倍密度屏幕的图片。
|
|
|
|
|
x3 3倍密度屏幕的图片。
|
|
|
|
|
xx 密度无关的图片。
|
|
|
|
|
strings 需要翻译的字符串。
|
|
|
|
|
styles 主题数据。
|
|
|
|
|
ui UI描述数据。
|
|
|
|
|
```
|
2019-01-15 14:34:05 +08:00
|
|
|
|
----------------------------------
|
2018-12-20 17:33:31 +08:00
|
|
|
|
### 函数
|
|
|
|
|
<p id="assets_manager_t_methods">
|
|
|
|
|
|
|
|
|
|
| 函数名称 | 说明 |
|
|
|
|
|
| -------- | ------------ |
|
2018-12-21 12:11:40 +08:00
|
|
|
|
| <a href="#assets_manager_t_assets_manager">assets\_manager</a> | 获取缺省资源管理器。 |
|
|
|
|
|
| <a href="#assets_manager_t_assets_manager_add">assets\_manager\_add</a> | 向资源管理器中增加一个资源。 |
|
2019-10-19 08:35:25 +08:00
|
|
|
|
| <a href="#assets_manager_t_assets_manager_clear_all">assets\_manager\_clear\_all</a> | 清除全部缓存的资源。 |
|
2018-12-21 12:11:40 +08:00
|
|
|
|
| <a href="#assets_manager_t_assets_manager_clear_cache">assets\_manager\_clear\_cache</a> | 清除指定类型的缓存。 |
|
|
|
|
|
| <a href="#assets_manager_t_assets_manager_create">assets\_manager\_create</a> | 创建资源管理器。 |
|
|
|
|
|
| <a href="#assets_manager_t_assets_manager_deinit">assets\_manager\_deinit</a> | 释放全部资源。 |
|
|
|
|
|
| <a href="#assets_manager_t_assets_manager_destroy">assets\_manager\_destroy</a> | 释放全部资源并销毁asset manager对象。 |
|
|
|
|
|
| <a href="#assets_manager_t_assets_manager_find_in_cache">assets\_manager\_find\_in\_cache</a> | 在资源管理器的缓存中查找指定的资源(不引用)。 |
|
|
|
|
|
| <a href="#assets_manager_t_assets_manager_init">assets\_manager\_init</a> | 初始化资源管理器。 |
|
2018-12-29 17:50:22 +08:00
|
|
|
|
| <a href="#assets_manager_t_assets_manager_load">assets\_manager\_load</a> | 从文件系统中加载指定的资源,并缓存到内存中。在定义了宏WITH\_FS\_RES时才生效。 |
|
2019-04-09 09:57:16 +08:00
|
|
|
|
| <a href="#assets_manager_t_assets_manager_preload">assets\_manager\_preload</a> | 从文件系统中加载指定的资源,并缓存到内存中。在定义了宏WITH\_FS\_RES时才生效。 |
|
2018-12-21 12:11:40 +08:00
|
|
|
|
| <a href="#assets_manager_t_assets_manager_ref">assets\_manager\_ref</a> | 在资源管理器的缓存中查找指定的资源并引用它,如果缓存中不存在,尝试加载该资源。 |
|
|
|
|
|
| <a href="#assets_manager_t_assets_manager_set">assets\_manager\_set</a> | 设置缺省资源管理器。 |
|
2019-12-14 13:25:56 +08:00
|
|
|
|
| <a href="#assets_manager_t_assets_manager_set_custom_build_asset_dir">assets\_manager\_set\_custom\_build\_asset\_dir</a> | 设置一个函数,该函数用于生成资源路径。 |
|
2019-07-04 10:05:59 +08:00
|
|
|
|
| <a href="#assets_manager_t_assets_manager_set_locale_info">assets\_manager\_set\_locale\_info</a> | 设置locale_info对象。 |
|
2018-12-21 12:11:40 +08:00
|
|
|
|
| <a href="#assets_manager_t_assets_manager_set_res_root">assets\_manager\_set\_res\_root</a> | 设置资源所在的目录(其下目录结构请参考demos)。 |
|
2019-07-04 10:05:59 +08:00
|
|
|
|
| <a href="#assets_manager_t_assets_manager_set_system_info">assets\_manager\_set\_system\_info</a> | 设置system_info对象。 |
|
2019-10-19 08:35:25 +08:00
|
|
|
|
| <a href="#assets_manager_t_assets_manager_set_theme">assets\_manager\_set\_theme</a> | 设置当前的主题。 |
|
2018-12-21 12:11:40 +08:00
|
|
|
|
| <a href="#assets_manager_t_assets_manager_unref">assets\_manager\_unref</a> | 释放指定的资源。 |
|
2018-12-20 17:33:31 +08:00
|
|
|
|
#### assets\_manager 函数
|
2018-12-21 18:29:29 +08:00
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager">获取缺省资源管理器。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
assets_manager_t* assets_manager ();
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | assets\_manager\_t* | 返回asset manager对象。 |
|
2018-12-21 18:29:29 +08:00
|
|
|
|
#### assets\_manager\_add 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_add">向资源管理器中增加一个资源。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
2019-04-03 11:31:58 +08:00
|
|
|
|
ret_t assets_manager_add (assets_manager_t* am, asset_info_t info);
|
2018-12-21 11:39:05 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 |
|
2019-04-03 11:31:58 +08:00
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| info | asset\_info\_t | 待增加的资源。 |
|
2019-10-19 08:35:25 +08:00
|
|
|
|
#### assets\_manager\_clear\_all 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_clear_all">清除全部缓存的资源。
|
2019-10-19 08:35:25 +08:00
|
|
|
|
|
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
ret_t assets_manager_clear_all (assets_manager_t* am);
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 |
|
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
2018-12-21 18:29:29 +08:00
|
|
|
|
#### assets\_manager\_clear\_cache 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_clear_cache">清除指定类型的缓存。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
2019-04-03 11:31:58 +08:00
|
|
|
|
ret_t assets_manager_clear_cache (assets_manager_t* am, asset_type_t type);
|
2018-12-21 11:39:05 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 |
|
2019-04-03 11:31:58 +08:00
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| type | asset\_type\_t | 资源的类型。 |
|
2018-12-21 18:29:29 +08:00
|
|
|
|
#### assets\_manager\_create 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_create">创建资源管理器。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
assets_manager_t* assets_manager_create (uint32_t init_nr);
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | assets\_manager\_t* | 返回asset manager对象。 |
|
|
|
|
|
| init\_nr | uint32\_t | 预先分配资源的个数。 |
|
2018-12-21 18:29:29 +08:00
|
|
|
|
#### assets\_manager\_deinit 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_deinit">释放全部资源。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
2019-04-03 11:31:58 +08:00
|
|
|
|
ret_t assets_manager_deinit (assets_manager_t* am);
|
2018-12-21 11:39:05 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 |
|
2019-04-03 11:31:58 +08:00
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
2018-12-21 18:29:29 +08:00
|
|
|
|
#### assets\_manager\_destroy 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_destroy">释放全部资源并销毁asset manager对象。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
2019-04-03 11:31:58 +08:00
|
|
|
|
ret_t assets_manager_destroy (assets_manager_t* am);
|
2018-12-21 11:39:05 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 |
|
2019-04-03 11:31:58 +08:00
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
2018-12-21 18:29:29 +08:00
|
|
|
|
#### assets\_manager\_find\_in\_cache 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_find_in_cache">在资源管理器的缓存中查找指定的资源(不引用)。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
2019-04-03 11:31:58 +08:00
|
|
|
|
asset_info_t* assets_manager_find_in_cache (assets_manager_t* am, asset_type_t type, char* name);
|
2018-12-21 11:39:05 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | asset\_info\_t* | 返回资源。 |
|
2019-04-03 11:31:58 +08:00
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| type | asset\_type\_t | 资源的类型。 |
|
|
|
|
|
| name | char* | 资源的名称。 |
|
2018-12-21 18:29:29 +08:00
|
|
|
|
#### assets\_manager\_init 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_init">初始化资源管理器。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
2019-04-03 11:31:58 +08:00
|
|
|
|
assets_manager_t* assets_manager_init (assets_manager_t* am, uint32_t init_nr);
|
2018-12-21 11:39:05 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | assets\_manager\_t* | 返回asset manager对象。 |
|
2019-04-03 11:31:58 +08:00
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| init\_nr | uint32\_t | 预先分配资源的个数。 |
|
2018-12-21 18:29:29 +08:00
|
|
|
|
#### assets\_manager\_load 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_load">从文件系统中加载指定的资源,并缓存到内存中。在定义了宏WITH\_FS\_RES时才生效。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
2019-04-03 11:31:58 +08:00
|
|
|
|
asset_info_t* assets_manager_load (assets_manager_t* am, asset_type_t type, char* name);
|
2018-12-21 11:39:05 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | asset\_info\_t* | 返回资源。 |
|
2019-04-03 11:31:58 +08:00
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| type | asset\_type\_t | 资源的类型。 |
|
|
|
|
|
| name | char* | 资源的名称。 |
|
2019-04-09 09:57:16 +08:00
|
|
|
|
#### assets\_manager\_preload 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_preload">从文件系统中加载指定的资源,并缓存到内存中。在定义了宏WITH\_FS\_RES时才生效。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2019-04-09 09:57:16 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
ret_t assets_manager_preload (assets_manager_t* am, asset_type_t type, char* name);
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 |
|
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
|
|
|
|
| type | asset\_type\_t | 资源的类型。 |
|
|
|
|
|
| name | char* | 资源的名称。 |
|
2018-12-21 18:29:29 +08:00
|
|
|
|
#### assets\_manager\_ref 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_ref">在资源管理器的缓存中查找指定的资源并引用它,如果缓存中不存在,尝试加载该资源。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
2019-04-03 11:31:58 +08:00
|
|
|
|
asset_info_t* assets_manager_ref (assets_manager_t* am, asset_type_t type, char* name);
|
2018-12-21 11:39:05 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | asset\_info\_t* | 返回资源。 |
|
2019-04-03 11:31:58 +08:00
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| type | asset\_type\_t | 资源的类型。 |
|
|
|
|
|
| name | char* | 资源的名称。 |
|
2018-12-21 18:29:29 +08:00
|
|
|
|
#### assets\_manager\_set 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_set">设置缺省资源管理器。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
2019-04-03 11:31:58 +08:00
|
|
|
|
ret_t assets_manager_set (assets_manager_t* am);
|
2018-12-21 11:39:05 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 |
|
2019-04-03 11:31:58 +08:00
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
2019-10-25 17:53:38 +08:00
|
|
|
|
#### assets\_manager\_set\_custom\_build\_asset\_dir 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-12-14 13:25:56 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_set_custom_build_asset_dir">设置一个函数,该函数用于生成资源路径。
|
|
|
|
|
|
|
|
|
|
> 有时我们需要优先加载用户自定义的资源,加载失败才加载系统缺省的,可用设置一个函数去实现这类功能。
|
2019-10-25 17:53:38 +08:00
|
|
|
|
|
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
ret_t assets_manager_set_custom_build_asset_dir (assets_manager_t* am, assets_manager_build_asset_dir_t custom_build_asset_dir, void* ctx);
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 |
|
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
|
|
|
|
| custom\_build\_asset\_dir | assets\_manager\_build\_asset\_dir\_t | 回调函数。 |
|
|
|
|
|
| ctx | void* | 回调函数的上下文。 |
|
2019-07-04 10:05:59 +08:00
|
|
|
|
#### assets\_manager\_set\_locale\_info 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_set_locale_info">设置locale_info对象。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2019-07-04 10:05:59 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
ret_t assets_manager_set_locale_info (assets_manager_t* am, locale_info_t* locale_info);
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 |
|
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
|
|
|
|
| locale\_info | locale\_info\_t* | locale\_info对象。。 |
|
2018-12-21 18:29:29 +08:00
|
|
|
|
#### assets\_manager\_set\_res\_root 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_set_res_root">设置资源所在的目录(其下目录结构请参考demos)。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
2019-04-03 11:31:58 +08:00
|
|
|
|
ret_t assets_manager_set_res_root (assets_manager_t* am, const char* res_root);
|
2018-12-21 11:39:05 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 |
|
2019-04-03 11:31:58 +08:00
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| res\_root | const char* | 资源所在的目录。 |
|
2019-07-04 10:05:59 +08:00
|
|
|
|
#### assets\_manager\_set\_system\_info 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_set_system_info">设置system_info对象。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2019-07-04 10:05:59 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
ret_t assets_manager_set_system_info (assets_manager_t* am, system_info_t* system_info);
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 |
|
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
|
|
|
|
| system\_info | system\_info\_t* | system\_info对象。。 |
|
2019-10-19 08:35:25 +08:00
|
|
|
|
#### assets\_manager\_set\_theme 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_set_theme">设置当前的主题。
|
2019-10-19 08:35:25 +08:00
|
|
|
|
|
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
ret_t assets_manager_set_theme (assets_manager_t* am, const char* theme);
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 |
|
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
|
|
|
|
| theme | const char* | 主题名称。 |
|
2018-12-21 18:29:29 +08:00
|
|
|
|
#### assets\_manager\_unref 函数
|
|
|
|
|
-----------------------
|
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数功能:
|
|
|
|
|
|
2019-11-15 11:33:43 +08:00
|
|
|
|
> <p id="assets_manager_t_assets_manager_unref">释放指定的资源。
|
2019-10-16 09:02:32 +08:00
|
|
|
|
|
2018-12-21 11:39:05 +08:00
|
|
|
|
* 函数原型:
|
|
|
|
|
|
|
|
|
|
```
|
2019-04-03 11:31:58 +08:00
|
|
|
|
ret_t assets_manager_unref (assets_manager_t* am, asset_info_t* info);
|
2018-12-21 11:39:05 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
* 参数说明:
|
|
|
|
|
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| 参数 | 类型 | 说明 |
|
|
|
|
|
| -------- | ----- | --------- |
|
|
|
|
|
| 返回值 | ret\_t | 返回RET\_OK表示成功,否则表示失败。 |
|
2019-04-03 11:31:58 +08:00
|
|
|
|
| am | assets\_manager\_t* | asset manager对象。 |
|
2018-12-20 17:33:31 +08:00
|
|
|
|
| info | asset\_info\_t* | 资源。 |
|