Picguin is a collection of fast, pure Luau image codecs for a growing range of formats.
It provides a standardized interface for straightforward decoding & encoding.

• Fully type-safe, optimized using modern techniques for maximum performance
• Lightweight, self-contained implementations with zero dependencies
• Seamlessly compatible with Roblox, Lune, and other Luau runtimes
• Architected to easily scale and support new formats over time

Warning

Picguin is in early development, and the public API across codecs is subject to change.
All packages will remain pre-v1.0.0 until a stable design is in place.

Get Started

View the documentation to get started with Picguin.

Simplified happy-path usage example (PNG):

local png = require("@packages/png")

local source: buffer -- png binary data

local parsed = png.decode(source)  -- decode headers, metadata, etc
local cel = parsed.cel(0, "rgba8") -- decode frame 0 bitmap, region, duration, etc

Codecs

View Introduction, Installation for a quick installation guide.

Format	pesde Package	.rbxm Releases
PNG	picguin/png	Latest (v0.1.1) All Releases