awtk/docs/manual/asset_info_t.md

asset_info_t

概述

单个资源的描述信息。

函数

函数名称	说明
asset_info_create	创建asset_info对象。
asset_info_destroy	销毁asset_info对象。
asset_info_ref	增加asset_info对象的引用计数。
asset_info_unref	减少asset_info对象的引用计数。

属性

属性名称	类型	说明
is_in_rom	uint8_t	资源是否在ROM中。
name	char*	名称。
refcount	uint32_t	引用计数。
size	uint32_t	大小。
subtype	uint8_t	子类型。
type	uint16_t	类型。

asset_info_create 函数

---

• 函数功能：

创建asset_info对象。

主要供脚本语言使用。

• 函数原型：

asset_info_t* asset_info_create (uint16_t type, uint16_t subtype, const char* name, uint32_t size);

• 参数说明：

参数	类型	说明
返回值	asset_info_t*	asset_info对象。
type	uint16_t	资源的类型。
subtype	uint16_t	资源的子类型。
name	const char*	资源的名称。
size	uint32_t	资源的数据长度(用于分配空间)。

asset_info_destroy 函数

---

• 函数功能：

销毁asset_info对象。

• 函数原型：

ret_t asset_info_destroy (asset_info_t* info);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
info	asset_info_t*	asset_info对象。

asset_info_ref 函数

---

• 函数功能：

增加asset_info对象的引用计数。

• 函数原型：

ret_t asset_info_ref (asset_info_t* info);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
info	asset_info_t*	asset_info对象。

asset_info_unref 函数

---

• 函数功能：

减少asset_info对象的引用计数。

• 函数原型：

ret_t asset_info_unref (asset_info_t* info);

• 参数说明：

参数	类型	说明
返回值	ret_t	返回RET_OK表示成功，否则表示失败。
info	asset_info_t*	asset_info对象。

is_in_rom 属性

---

资源是否在ROM中。

• 类型：uint8_t

特性	是否支持
可直接读取	是
可直接修改	否
可脚本化	是

name 属性

---

名称。

• 类型：char*

特性	是否支持
可直接读取	是
可直接修改	否
可脚本化	是

refcount 属性

---

引用计数。

is_in_rom == FALSE时才有效。

• 类型：uint32_t

特性	是否支持
可直接读取	是
可直接修改	否
可脚本化	是

size 属性

---

大小。

• 类型：uint32_t

特性	是否支持
可直接读取	是
可直接修改	否
可脚本化	是

subtype 属性

---

子类型。

• 类型：uint8_t

特性	是否支持
可直接读取	是
可直接修改	否
可脚本化	是

type 属性

---

类型。

• 类型：uint16_t

特性	是否支持
可直接读取	是
可直接修改	否
可脚本化	是