gre.load_resource(
pool_name,
resource_name,
[pool parameters]
)
This function will force the loading of a resource, such as an image or font, 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 call can only be made from the main Lua action execution thread.
Parameters:
pool_name The name of the resource pool: image or font
resource_name The name of the resource that is to be loaded
The optional parameters vary depending on the pool being specified may not be required:
image pool:
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.
font pool:
size The point size of the font to load (required)
antialias A flag indicating if anti aliasing is to be used
These options should be passed as a table as the third parameter to ensure that the loader receives the
appropriate values.
On completion of a 'background' loaded resource, the following event is sent:
gre.resource_loaded 1s0 resource
Example:
-- Call this to pre-load the image and font into the cache
function on_app_init(mapargs)
-- Call this to pre-load a font at a 24pt size
local opt = {}
opt.size = 24
gre.load_resource("font", "fonts/DejaVu.ttf", opt)
-- Call this to pre-load the image unscaled
gre.load_resource("image", "images/tree.jpg")
-- Call this to pre-load the image and scale it to 100x100
local opt = {}
opt.w = 100
opt.h = 100
gre.load_resource("image", "images/scaledtree.jpg", opt)
-- Call this to pre-load the image and scale it to 100x100 asynchronously
local opt = {}
opt.w = 100
opt.h = 100
opt.background = 1
gre.load_resource("image", "images/scaledtreebg.jpg", opt)
end