Image Data

`image_data` stores one static image in memory. It can load an image file, create an image from raw bytes, expose image metadata, and save supported image formats.

`image_data` is cloneable. `clone()` returns a copy of the image.

Creates an empty image object.

img = image_data();
print(img.valid);       // false

img = image_data().load("picture.png");
print(img.width);
print(img.height);

Loads an image from `filePath` and returns the image object.

Arguments:

img = image_data().load("images/logo.png");
if (img.valid)
{
    print(img.width, " x ", img.height);
}
else
{
    print(img.error);
}

Saves the image and returns `true` on success. The output format is selected from the file extension.

Supported save extensions:

img = image_data().load("input.png");
ok = img.save("output.webp");

Clears the image and returns the image object.

img.clear();
print(img.valid);       // false

Creates an image from raw bytes in a `data_array` and returns the image object.

Arguments:

raw = data_array();
raw.add_u8(255); raw.add_u8(0); raw.add_u8(0);
img = image_data().create(1, 1, 3, raw);
img.save("red.png");

Creates an image from raw bytes and specifies the byte layout.

Supported `format` values:

raw = data_array();
raw.add_u8(0); raw.add_u8(0); raw.add_u8(255);
img = image_data().create(1, 1, 3, raw, "bgr");

Previous: data_array

Next: Image stream