Loads an image from a file into a specified image ID, can also be used to load an atlas texture that will be used by sub images. If loading an atlas texture a subimages.txt file must exist detailing all the images contained on it.

Image width and height must be between 1 and 2048 pixels, some devices may support larger sizes but this is not guaranteed. Images do not need to be a power of 2 in size (2,4,8,16,32,etc).

If you have lots of small images you could combine them into an atlas texture to improve performance.


LoadImage( ID, sImageFilename, bBlackToAlpha )

integer LoadImage( sImageFilename, bBlackToAlpha )

integer LoadImage( sImageFilename )

LoadImage( ID, sImageFilename )