System.touchImages

功能/含义

将图像读入缓存

类型

System类的成员方法

语法

touchImages(storages, limitbytes=0, timeout=0)

参数

storages	以数组（Array类对象）传递要放入缓存的图像storage名称。 　写在前面的优先度更高。 　由于吉里吉里吉以Layer.loadImages 的第一参数中指定的字符串直接作为键来管理高速缓存，为使缓存生效，这里指定的图像storage名称必须与在Layer.loadImages的第一参数中指定的名称相同。
limitbytes	指定用于调用此方法的高速缓存容量限制值（以字节为单位）。 　如果指定0，则使用全部缓存。 　如果指定为正数，则将尝试使用低于该字节数缓存。 　如果指定为负数，则将从当前缓存的限制值 ( System.graphicCacheLimit ) 中加上该数值的数量（但加上【负数】就是实际的减法）用作限制值。如果结果的限制值为0或负值，则该方法将退出而不做任何操作。 例如，如果指定-2*1024*1024，则认为指定了从当前缓存限制值减去2MB的数值。如果您想为高速缓存保留剩余空间，则此选项非常有用。
timeout	以ms为单位指定超时（时间限制）。0表示无限制。 　此方法在经过此参数指定的时间后，将停止读取后续图像的读入并返回。但是，即使在导入某个图像时超时，在该图像的读入结束之前也不会返回。

返回值

无 (void)

说明

　此方法尝试将指定的图像读入缓存。但是，该方法会尽力将图像读入缓存中，但实际上不能保证图像在缓存中。超过图像缓存的限制值或超时会中断图像读取。在storages参数中指定的图像中，越是先传入的图像，进入缓存的可能性越大（优先）。如果指定的图像已经进入缓存，则只是提高缓存中的存活顺序。
　此方法忽略图像导入过程中的所有错误。
　在当前版本中，此方法可以读入高速缓存的图像通常是 Layer.loadImages 可以读取的图像，并且不指定颜色键 ( 带aplha通道的图像则没有问题 )。也会读取的规则图像和区域图像，但不会成为高速缓存有效的数据 ( 读取的数据会浪费) ，所以请勿指定。
　有关图像在高速缓存中使用的字节数的信息，请参照 System.graphicCacheLimit 。