Image codec primitives for MoonBit with PNG/BMP/JPEG decode+encode, GIF/WebP/ICO/AVIF encode, and resize.
moon add mizchi/image// Auto-detect PNG / JPEG / GIF / BMP / ICO / TIFF / WebP
let img = @image.decode_image(image_bytes)
// Photos: apply the EXIF orientation so they display upright
let photo = @image.decode_image_upright(jpeg_bytes)
// Resize and re-encode
let resized = @image.resize(img, 128, 128, Bilinear)
let png = @image.encode_png(resized)
// Smallest exact PNG color type, best compression
let small_png = @image.encode_png(resized, color=Auto, compression=Best)
// JPEG encode (quality defaults to 85, subsampling to Yuv444)
let jpg = @image.encode_jpeg(resized)
let small = @image.encode_jpeg(resized, quality=75, subsampling=Yuv420)
// Other encoders
let gif = @image.encode_gif(resized) // <= 256 colors, alpha 0/255 only
let webp = @image.encode_webp(resized) // lossless
let ico = @image.encode_ico(resized) // single PNG-backed icon, <= 256x256
let avif = @image.encode_avif(resized, quality=75) // lossy AV1
// Animations: every frame is the composited canvas, with its delay
let apng = @image.decode_png_frames(png_bytes)
for frame in apng.frames {
ignore((frame.image, frame.delay_ms))
}
let gif_anim = @image.decode_gif_frames(gif_bytes)
// Encode animations (every frame is a full canvas)
let apng_out = @image.encode_apng(apng)
let gif_out = @image.encode_gif_animation(apng)
// Detect the format, or decode row by row (PNG / BMP are streamed)
let format = @image.detect_image_format(image_bytes)
let rows : Array[Bytes] = []
let info = @image.decode_image_stream(
image_bytes,
on_row=fn(_y, row) { rows.push(row) },
)
inspect((info.format, info.width, info.height))| Format | Decode | Encode | Animation | Stream decode |
|---|---|---|---|---|
| PNG | yes | yes (RGBA / RGB / gray / gray+alpha / palette) | APNG decode / encode | yes (streamed) |
| JPEG | yes | yes | n/a | yes |
| GIF | yes | yes | decode / encode | yes |
| BMP | yes | yes (32-bit) | n/a | yes (streamed) |
| ICO / CUR | yes | yes (ICO, PNG payload) | n/a | yes |
| TIFF | yes (all pages) | yes (RGB / RGBA) | n/a | yes |
| WebP | yes (lossy / lossless / alpha) | yes (lossy / lossless) | decode / encode | yes |
| AVIF | no | yes (lossy, alpha) | no | no |
// Auto-detect
pub fn decode_image(Bytes) -> ImageData raise DecodeError
pub fn decode_image_stream(Bytes, on_row~ : (Int, Bytes) -> Unit) -> StreamImageInfo raise DecodeError
pub fn detect_image_format(Bytes) -> ImageFormat?
// PNG / APNG
pub fn decode_png(Bytes) -> ImageData raise DecodeError
pub fn decode_png_frames(Bytes) -> Animation raise DecodeError
pub fn decode_png_stream(Bytes, on_row~ : (Int, Bytes) -> Unit) -> IhdrData raise DecodeError
pub fn encode_png(ImageData, color? : PngColorMode = Rgba, compression? : PngCompression = Default) -> Bytes raise EncodeError
pub fn encode_apng(Animation) -> Bytes raise EncodeError
// JPEG
pub fn decode_jpeg(Bytes) -> ImageData raise DecodeError
pub fn encode_jpeg(ImageData, quality? : Int = 85, subsampling? : JpegSubsampling = Yuv444, optimize? : Bool = false) -> Bytes raise EncodeError
// GIF
pub fn decode_gif(Bytes) -> ImageData raise DecodeError
pub fn decode_gif_frames(Bytes) -> Animation raise DecodeError
pub fn encode_gif(ImageData) -> Bytes raise EncodeError
pub fn encode_gif_animation(Animation) -> Bytes raise EncodeError
// BMP
pub fn decode_bmp(Bytes) -> ImageData raise DecodeError
pub fn decode_bmp_stream(Bytes, on_row~ : (Int, Bytes) -> Unit) -> (Int, Int) raise DecodeError
pub fn encode_bmp(ImageData) -> Bytes raise EncodeError
// ICO / CUR
pub fn decode_ico(Bytes) -> ImageData raise DecodeError
pub fn decode_ico_all(Bytes) -> Array[ImageData] raise DecodeError
pub fn encode_ico(ImageData) -> Bytes raise EncodeError
// TIFF
pub fn decode_tiff(Bytes) -> ImageData raise DecodeError
pub fn decode_tiff_pages(Bytes) -> Array[ImageData] raise DecodeError
pub fn encode_tiff(ImageData, compression? : TiffCompression = Lzw) -> Bytes raise EncodeError
// WebP / AVIF
pub fn decode_webp(Bytes) -> ImageData raise DecodeError
pub fn decode_webp_frames(Bytes) -> Animation raise DecodeError
pub fn encode_webp(ImageData) -> Bytes raise EncodeError // lossless
pub fn encode_webp_lossy(ImageData, quality? : Int = 75) -> Bytes raise EncodeError
pub fn encode_webp_animation(Animation) -> Bytes raise EncodeError
pub fn encode_avif(ImageData, quality? : Int) -> Bytes raise EncodeError
// Resize / orientation
pub fn resize(ImageData, Int, Int, ResizeMethod) -> ImageData raise EncodeError
pub fn read_exif_orientation(Bytes) -> Int?
pub fn apply_orientation(ImageData, Int) -> ImageData
pub fn decode_image_upright(Bytes) -> ImageData raise DecodeErrorpub(all) struct ImageData { width : Int; height : Int; data : Bytes } // RGBA8
pub(all) enum ResizeMethod { Nearest; Bilinear; Bicubic }
pub(all) enum JpegSubsampling { Yuv444; Yuv422; Yuv420 }
pub(all) enum PngColorMode { Rgba; Rgb; Gray; GrayAlpha; Palette; Auto }
pub(all) enum PngCompression { Stored; Fast; Default; Best }
pub(all) enum TiffCompression { NoCompression; Lzw; Deflate; PackBits }
pub(all) struct Animation { width : Int; height : Int; frames : Array[AnimationFrame]; plays : Int } // plays: 0 = forever
pub(all) struct AnimationFrame { image : ImageData; delay_ms : Int }
pub(all) enum ImageFormat { Png; Bmp; Jpeg; Gif; Ico; Tiff; WebP }
pub(all) suberror DecodeError { InvalidSignature(String); InvalidChunkCrc(String); MissingChunk(String); UnsupportedFeature(String); CorruptData(String) }
pub(all) suberror EncodeError { InvalidDimensions(String); InvalidData(String) }pub(all) suberror DecodeError {
InvalidSignature(String)
InvalidChunkCrc(String)
MissingChunk(String)
UnsupportedFeature(String)
CorruptData(String)
}impl Show for DecodeErrorpub(all) suberror EncodeError {
InvalidDimensions(String)
InvalidData(String)
}impl Show for EncodeErrorimpl Show for ImageFormatpub(all) enum JpegSubsampling {
Yuv444
Yuv422
Yuv420
}pub(all) enum PngColorMode {
Rgba
Rgb
Gray
GrayAlpha
Palette
Auto
}pub(all) enum PngCompression {
Stored
Fast
Default
Best
}pub(all) enum TiffCompression {
NoCompression
Lzw
Deflate
PackBits
}fn decode_image_stream(raw : Bytes, on_row~ : (Int, Bytes) -> Unit) -> StreamImageInfo raise DecodeErrorfn encode_jpeg(img : ImageData, quality? : Int, subsampling? : JpegSubsampling, optimize? : Bool) -> Bytes raise EncodeErrorfn encode_png(img : ImageData, color? : PngColorMode, compression? : PngCompression) -> Bytes raise EncodeErrorfn read_exif_orientation(raw : Bytes) -> Int?fn resize(img : ImageData, new_width : Int, new_height : Int, resize_method : ResizeMethod) -> ImageData raise EncodeErrorInstall
Download zipImage codec primitives for MoonBit with PNG/BMP/JPEG decode+encode, GIF/WebP/ICO/AVIF encode, and resize.