image

Loads an image from a buffer of encoded PNG or JPEG data, uploads it to the GPU, and caches it under name. If an image is already cached under the same name the cached handle is returned and the buffer is ignored. Returns the resulting Image on success, or nil on decode/upload failure.

Reads an image file from the Workspace directory, decodes it as PNG or JPEG, uploads it to the GPU, and caches it under name. If an image is already cached under the same name the cached handle is returned and the file is not re-read. Returns the resulting Image on success, or nil if the file cannot be opened, decoded, or uploaded.

Decodes a PNG or JPEG buffer and uploads it to the GPU without storing it in the cache. The returned Image keeps the texture alive for as long as you hold any copy of it; once every copy is garbage-collected the GPU memory is released. Returns nil on decode/upload failure.

Downloads a Roblox image asset by id and loads it into the image cache. Accepts either a numeric asset id (123456789) or the canonical rbxassetid://N string form. The asset is cached under rbxassetid://N and can be re-fetched via image.get("rbxassetid://N"). Returns the resulting Image on success or nil if the asset cannot be fetched / decoded.

Returns the cached Image previously stored under name by image.load or image.load_file, or nil if no such image is cached.

Removes the image cached under name from the global image cache. Any existing Image handles already pushed to Luau continue to work until they are garbage-collected.

Removes every image from the global image cache. Any existing Image handles already pushed to Luau continue to work until they are garbage-collected.

Returns the number of images currently stored in the global image cache.