load_image

declaration:

::lua
function load_image(resource, startorder) => VID or BADID

Loads a resource as a image (png preferred) and maps to a VID.
The VID has zero opacity (invisible) from the beginning.
The routine is synchronous, so it may block.

example use:

vid = load_image(resource, startorder);
show_image(vid);

caveats:

If Arcan is launched in memory-conservative mode, a local copy will not be kept in memory. Thus, any context switches, external_launch or image statistics functions may force the file to be reloaded.

related functions:

[load_image_asynch]