Interface IImage2
interface IImage2
Extends IImage
Extended image interface with quality-controlled encoding.
Use this interface when encoding to lossy formats (JPEG, WebP)
where compression quality matters. For lossless PNG encoding,
IImage::encode is sufficient.
Obtain via QueryInterface from any IImage instance.
Methods
encodeWithQuality()
Encodes this image’s pixels into the specified format with quality control. Quality controls compression for lossy formats:u8[]encodeWithQuality(EncodedImageFormatimageFormat,u8quality)
- JPEG/WebP: 100 = highest quality/largest file, lower values increase compression. 0 = lowest quality, maximum compression, smallest file size.
- PNG: quality is ignored (lossless format)
Parameters
imageFormat
EncodedImageFormat — Required
The desired EncodedImageFormat for encoding.
quality
u8 — Required
Compression quality from 0 to 100. Values above 100 are treated as 100.
Returns
u8[]
Encoded image data as a byte array
Throws
InvalidArgumentError— if the specified format is not supported
