texturegroup_load

此函数用于将动态纹理组从磁盘加载到RAM中。

默认情况下,它还会解压缩并将组读取到 VRAM 中。可以通过将第二个参数设置为false来禁用此函数,这将使您稍后手动预取它,或者在从中绘制图像时自动读取它。

如果纹理组加载成功,则函数返回0,否则返回-1。

有关其使用的信息,请参阅:动态纹理

 

语法:

texturegroup_load(groupname, [prefetch=true]);

参数类型描述
groupnameString作为字符串的纹理组的名称。这些在"纹理组"窗口中定义。
prefetchBoolean可选 如果为 true( 默认),则该组将被解压缩并提取到 VRAM 中。如果为 false,则仅将其加载到 RAM 中,并保持压缩状态。

 

返回:

Real

 

例子:

var _loaded = texturegroup_load("tg_UI");

if (_loaded < 0)
{
    show_debug_message("tg_UI could not be loaded.");
}

这将尝试将名为"tg_UI"的动态纹理组加载到内存中,并且还会预取它。

如果未加载"纹理组",则会将消息打印到输出日志中。