08.图片资源树

介绍

资源树（ GResource ）用于管理应用图片资源。供用户通过 GPage 选取资源后绘制。
资源树不会重复加载其他资源树已经加载过的资源，资源树将会自动寻找已经加载过相同资源的资源树，并引用过来。

NOTE:
每个页面的应用资源最好单独放置在一个文件夹中。
应用资源最好放置在Assets目录下。
该篇文档除了NewImages，NewImage，HotLoad外，其余文档可能对你的帮助不大。

NewImages 方法

该方法用于向资源树中导入图片组资源。

当参数arg1和arg2被缺省时

此时图片将按照原始大小加载。

参数名	类型	说明
path	String	图片所在文件夹的路径

当参数arg2被缺省时

此时图片将按照arg1的值等比缩放。

参数名	类型	说明
path	String	图片所在文件夹的路径
arg1	Single	图片等比缩放比率

当参数arg1和arg2都没有被缺省时

此时图片将按照arg1，arg2的值缩放到指定大小。

参数名	类型	说明
path	String	图片所在文件夹的路径
arg1	Long	图片固定宽度
arg2	Long	图片固定高度

NewImage 方法

使用方法和NewImages一致，但此处的path参数值单个图片的绝对路径。

参数名	类型	说明
path	String	单个图片的绝对路径
arg1	Long	...
arg2	Long	...
[optional] Name]	String	资源的名称，省略后直接使用文件名

SearchIndex

检索资源树资源的开始位置，默认为1。

序号为0的资源是空的。

AssetsFolder 属性

类型：String 指定应用资源的路径。

Add 方法

内部方法。不建议使用。

ImgCount 只读属性

类型：Long 资源树中的图片总数。

GetImage 函数

类型：Integer
取得指定图片的编号。

参数名	类型	说明
name	String	资源文件名

ImgSize 只读属性

类型： 没有指定
获取图片的某个信息

参数名	类型	说明
n	?	当你传入的值为String类型时，将会在资源树中以提供的文件名查找指定的资源后再绘制；当你传入的值为其他类型时，将会把传入的值视为在资源树中资源的编号
sizeIndex	imgIndex	指定想要得到的数据

imgIndex枚举

名称	值	说明
imgGetWidth	0	取得图片宽度
imgGetHeight	1	取得图片高度
imgGetGIFFrameCount	2	取得动态GIF图片的总帧数

GIFTick 方法

使指定编号的动态GIF图片资源的显示帧数编号+1。

参数名	类型	说明
index	Integer	资源的编号

ResourceGIFCount 只读属性

类型：Long
取得指定动态GIF图片资源的总帧数。

参数名	类型	说明
index	Integer	资源的编号

ResourceGIFCurrentHandle 只读属性

类型：Long
取得指定动态GIF图片资源当前显示帧的DC。

参数名	类型	说明
index	Integer	资源的编号

ResourceGIFTick 只读属性

类型：Long
取得指定动态GIF图片资源当前显示帧的编号。

参数名	类型	说明
index	Integer	资源的编号

ResourceGIFTime 只读属性

类型：Long
取得指定动态GIF图片资源当前显示帧开始播放时对应的系统时间。

参数名	类型	说明
index	Integer	资源的编号

ResourceName 只读属性

类型：String
取得指定图片资源的文件名。

参数名	类型	说明
index	Integer	资源的编号

ResourceHandle 只读属性

类型：Long
取得指定图片资源的DC。

参数名	类型	说明
index	Integer	资源的编号

ResourceHandle2 只读属性

类型：Long
取得指定图片资源的DC（带翻转）。

参数名	类型	说明
index	Integer	资源的编号
Direction	ImgDirection	翻转方向，详情参阅文档 2