gre.load resource

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
            
Was this article helpful?
0 out of 0 found this helpful