Name

requestImage()

Examples
def setup():
    global bigImage
    bigImage = requestImage("something.jpg")

def draw():
    if bigImage.width == 0:
        pass # Image is not yet loaded
    elif bigImage.width == -1:
        pass # This means an error occurred during image loading
    else:
        # Image is ready to go, draw it
        image(bigImage, 0, 0)
Description This function loads images on a separate thread so that your sketch doesn't freeze while images load during setup(). While the image is loading, its width and height will be 0. If an error occurs while loading the image, its width and height will be set to -1. You'll know when the image has loaded properly because its width and height will be greater than 0. Asynchronous image loading (particularly when downloading from a server) can dramatically improve performance.

The extension parameter is used to determine the image type in cases where the image filename does not end with a proper extension. Specify the extension as the second parameter to requestImage().
Syntax
requestImage(filename)
requestImage(filename, extension)
Parameters
filenameString: name of the file to load, can be .gif, .jpg, .tga, or a handful of other image types depending on your platform
extensionString: the type of image to load, for example "png", "gif", "jpg"
Related PImage
loadImage()

Updated on Tue Feb 27 14:07:12 2024.

If you see any errors or have comments, please let us know.