gre.load_image(
image_name,
[optional table of parameters]
)
This function will force the loading of an image into the Storyboard application. This can be used in order to avoid load time delays that may be incurred as resources are lazy loaded into the application.
This is a convenience function for calling the more generic gre.load_resource
This call can only be made from the main Lua action execution thread.
Parameters:
resource_name The name of the resource that is to be loaded
The optional parameters are as follows:
w The width to cache the image at
h The height to cache the image at
background Whether or not to load the image asynchronously the 'background'. Asynchronous loading
capabilities are determined by the hardware rendering capabilities of the system and
may require serialization with the main rendering thread for a complete load to occur.
On completion of a 'background' loaded resource, the following event is sent:
gre.resource_loaded 1s0 resource