2021-11-24 10:07:17 +00:00
|
|
|
|
# QOI - The “Quite OK Image” format for fast, lossless image compression
|
|
|
|
|
|
|
|
|
|
Single-file MIT licensed library for C/C++
|
|
|
|
|
|
|
|
|
|
See [qoi.h](https://github.com/phoboslab/qoi/blob/master/qoi.h) for
|
|
|
|
|
the documentation.
|
|
|
|
|
|
|
|
|
|
More info at https://phoboslab.org/log/2021/11/qoi-fast-lossless-image-compression
|
|
|
|
|
|
2021-11-24 21:28:35 +00:00
|
|
|
|
⚠️ Please note that this library is not yet ready to deal with untrusted input.
|
|
|
|
|
|
2021-11-27 12:21:16 +00:00
|
|
|
|
⚠️ 2021.11.27 – the specification for QOI has changed to accomodate some
|
2021-11-27 17:36:17 +00:00
|
|
|
|
concerns with the format. If you are working on a QOI implementation, please
|
|
|
|
|
refer to
|
2021-11-27 12:21:16 +00:00
|
|
|
|
[#37 The QOI File Format Specification](https://github.com/phoboslab/qoi/issues/37)
|
|
|
|
|
for the details.
|
|
|
|
|
|
2021-11-27 17:36:17 +00:00
|
|
|
|
These specification changes are ~~not yet reflected in the code here~~
|
|
|
|
|
reflected in qoi.h now.
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
|
## Tools
|
|
|
|
|
|
|
|
|
|
- https://github.com/floooh/qoiview
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Implementations of QOI
|
|
|
|
|
|
|
|
|
|
- https://github.com/MasterQ32/zig-qoi (Zig)
|
|
|
|
|
- https://github.com/steven-joruk/qoi (Rust)
|
|
|
|
|
- https://github.com/ChevyRay/qoi_rs (Rust)
|
|
|
|
|
- https://github.com/xfmoulet/qoi (Go)
|
|
|
|
|
- https://github.com/panzi/jsqoi (TypeScript)
|
|
|
|
|
- https://github.com/pfusik/qoi-ci (Ć)
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|