QOI codec support

August 12, 2026 ยท View on GitHub

This document defines the implemented boundary of the first-party QOI codec.

Decode

  • QOI Specification v1 header and end marker
  • Three-channel RGB and four-channel RGBA files
  • sRGB with linear alpha and all-channels-linear colorspace fields
  • QOI_OP_INDEX
  • QOI_OP_DIFF
  • QOI_OP_LUMA
  • QOI_OP_RUN, including the maximum legal run
  • QOI_OP_RGB
  • QOI_OP_RGBA
  • Sequential bounded-row output

Encode

  • Deterministic RGB and RGBA output
  • Every QOI chunk operation
  • Explicit channel and colorspace selection

Validation

  • Dimension and decoded-byte allocation limits
  • Exact pixel-count and end-marker validation
  • Truncated header, chunk, and marker rejection
  • Official MIT QOI reference encoder interoperability fixture
  • Independently encoded CC0 benchmark images