texturegroup_get_status

This function returns the status of the given Dynamic Texture Group. The status will be one of the following constants:

Texture Group Status Constant
ConstantDescriptionValue
texturegroup_status_unloadedThe Texture Group is still on disk and not in memory0
texturegroup_status_loadingThe Texture Group is currently being loaded from disk1
texturegroup_status_loadedThe Texture Group has been loaded into RAM2
texturegroup_status_fetchedThe Texture Group has been loaded and fetched into VRAM, ready for use3

For information on its use, see: Dynamic Textures

 

Syntax:

texturegroup_get_status(groupname);

ArgumentTypeDescription
groupnameStringThe name of the Texture Group as a string. These are defined in the Texture Groups window.

 

Returns:

Texture Group Status Constant

 

Example:

var _tg = "tg_UI";
var _status = texturegroup_get_status(_tg);

if (_status == texturegroup_status_unloaded)
{
    texturegroup_load(_tg);
}

This gets the status of the "tg_UI" Texture Group, and if it's unloaded, it loads it.