qoi/README.md

1.6 KiB
Raw Permalink Blame History

QOI - The “Quite OK Image” format for fast, lossless image compression

Single-file MIT licensed library for C/C++

See qoi.h for the documentation.

More info at https://phoboslab.org/log/2021/11/qoi-fast-lossless-image-compression

⚠️ Please note that this library is not yet ready to deal with untrusted input.

⚠️ 2021.11.30 the file format is not yet finalized. We're still working to fix some smaller issues. The final specification will be announced on 2021.12.20. Thanks for your patience! https://github.com/phoboslab/qoi/issues/48

These specification changes are not yet reflected in the code here reflected in qoi.h now.

Why?

Compared to stb_image and stb_image_write QOI offers 20x-50x faster encoding, 3x-4x faster decoding and 20% better compression. It's also stupidly simple and fits in about 300 lines of C.

Example Usage

  • qoiconv.c converts between png <> qoi
  • qoibench.c a simple wrapper to benchmark stbi, libpng and qoi

Tools

Implementations of QOI

Packages

AUR - system-wide qoi.h, qoiconv and qoibench install as split packages.