2021-12-20 09:52:19 +00:00
|
|
|
# QOI - The “Quite OK Image Format” for fast, lossless image compression
|
2021-11-24 10:07:17 +00:00
|
|
|
|
|
|
|
|
Single-file MIT licensed library for C/C++
|
|
|
|
|
|
|
|
|
|
See [qoi.h](https://github.com/phoboslab/qoi/blob/master/qoi.h) for
|
2021-12-20 09:52:19 +00:00
|
|
|
the documentation and format specification.
|
2021-11-24 10:07:17 +00:00
|
|
|
|
2021-12-20 09:52:19 +00:00
|
|
|
More info at https://qoiformat.org
|
2021-11-27 17:36:17 +00:00
|
|
|
|
2021-11-27 12:21:16 +00:00
|
|
|
|
2021-11-24 10:07:17 +00:00
|
|
|
## 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](https://github.com/phoboslab/qoi/blob/master/qoiconv.c)
|
|
|
|
|
converts between png <> qoi
|
|
|
|
|
- [qoibench.c](https://github.com/phoboslab/qoi/blob/master/qoibench.c)
|
|
|
|
|
a simple wrapper to benchmark stbi, libpng and qoi
|
2021-11-28 15:12:08 +00:00
|
|
|
|
2021-11-29 10:23:33 +00:00
|
|
|
|
2021-12-16 19:12:27 +00:00
|
|
|
## Limitations
|
|
|
|
|
|
|
|
|
|
The QOI file format allows for huge images with up to 18 exa-pixels. A streaming
|
|
|
|
|
en-/decoder can handle these with minimal RAM requirements, assuming there is
|
|
|
|
|
enough storage space.
|
|
|
|
|
|
|
|
|
|
This particular implementation of QOI however is limited to images with a
|
|
|
|
|
maximum size of 400 million pixels. It will safely refuse to en-/decode anything
|
|
|
|
|
larger than that. This is not a streaming en-/decoder. It loads the whole image
|
|
|
|
|
file into RAM before doing any work and is not extensively optimized for
|
|
|
|
|
performance (but it's still very fast).
|
|
|
|
|
|
|
|
|
|
If this is a limitation for your use case, please look into any of the other
|
|
|
|
|
implementations listed below.
|
|
|
|
|
|
|
|
|
|
|
2021-11-29 10:23:33 +00:00
|
|
|
## Tools
|
|
|
|
|
|
2021-12-20 16:26:18 +00:00
|
|
|
- https://github.com/floooh/qoiview - native QOI viewer
|
2021-12-20 18:31:57 +00:00
|
|
|
- https://github.com/pfusik/qoi-ci/releases/tag/qoi-ci-1.0.0 - QOI Plugin installer for GIMP, Paint.NET and XnView MP
|
|
|
|
|
- https://github.com/iOrange/QoiFileTypeNet/releases/tag/v0.2 - QOI Plugin for Paint.NET
|
2021-11-29 10:23:33 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
## Implementations of QOI
|
|
|
|
|
|
|
|
|
|
- https://github.com/MasterQ32/zig-qoi (Zig)
|
|
|
|
|
- https://github.com/steven-joruk/qoi (Rust)
|
|
|
|
|
- https://github.com/ChevyRay/qoi_rs (Rust)
|
2021-12-01 14:48:53 +00:00
|
|
|
- https://github.com/zakarumych/rapid-qoi (Rust)
|
2021-11-29 10:23:33 +00:00
|
|
|
- https://github.com/xfmoulet/qoi (Go)
|
|
|
|
|
- https://github.com/panzi/jsqoi (TypeScript)
|
2021-12-11 16:22:41 +00:00
|
|
|
- https://github.com/0xd34df00d/hsqoi (Haskell)
|
2021-12-20 10:40:39 +00:00
|
|
|
- https://github.com/pfusik/qoi-ci (Ć, transpiled to C, C++, C#, Java, JavaScript, Python and Swift)
|
2021-12-05 09:18:49 +00:00
|
|
|
- https://github.com/kodonnell/qoi (Python)
|
2021-12-05 20:23:24 +00:00
|
|
|
- https://github.com/NUlliiON/QoiSharp (C#)
|
2021-12-06 01:46:10 +00:00
|
|
|
- https://github.com/rbino/qoix (Elixir)
|
2021-12-08 20:22:16 +00:00
|
|
|
- https://github.com/elihwyma/Swift-QOI (Swift)
|
2021-12-13 16:44:24 +00:00
|
|
|
- https://github.com/saharNooby/qoi-java (Java)
|
2021-12-19 09:54:49 +00:00
|
|
|
- https://github.com/Cr4xy/lua-qoi (Lua)
|
2021-12-20 21:35:13 +00:00
|
|
|
- https://github.com/superzazu/SDL_QOI (C, SDL2 bindings)
|
2021-11-29 10:23:33 +00:00
|
|
|
|
|
|
|
|
|
2021-11-28 15:12:08 +00:00
|
|
|
## Packages
|
|
|
|
|
|
|
|
|
|
[AUR](https://aur.archlinux.org/pkgbase/qoi-git/) - system-wide qoi.h, qoiconv and qoibench install as split packages.
|
