Encoding and lifecycle

Encode images, read metadata, handle errors, and release resources.

Encode output

final png = image.encode(const PixerPngEncoder());
final jpeg = image.encode(PixerJpegEncoder(quality: 90));
final webp = image.encode(const PixerWebPEncoder());

Pixer also provides GIF, BMP, ICO, and TIFF encoders. JPEG quality accepts values from 1 through 100 and defaults to 75.

Read metadata

final metadata = image.getMetadata();
print('${metadata.width}x${metadata.height}, ${metadata.colorType}');

// Convenience getters use the same cached metadata.
print('${image.width}x${image.height}');

Release resources

Every Pixer owns a Rust image handle. Always call dispose() when finished, including for images returned by direct operations.

Native finalizers are a safety net, but they are not guaranteed to run. Web builds require explicit disposal.

Handle errors

Pixer throws typed exceptions: