tomato/README.md

68 lines
2.2 KiB
Markdown
Raw Normal View History

2021-12-20 10:52:19 +01:00
# QOI - The “Quite OK Image Format” for fast, lossless image compression
2021-11-24 11:07:17 +01: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 10:52:19 +01:00
the documentation and format specification.
2021-11-24 11:07:17 +01:00
2021-12-20 10:52:19 +01:00
More info at https://qoiformat.org
2021-11-27 13:21:16 +01:00
2021-11-24 11:07:17 +01: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-29 11:23:33 +01: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 11:23:33 +01: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/zakarumych/rapid-qoi (Rust)
2021-11-29 11:23:33 +01:00
- https://github.com/xfmoulet/qoi (Go)
- https://github.com/panzi/jsqoi (TypeScript)
2021-12-11 17:22:41 +01:00
- https://github.com/0xd34df00d/hsqoi (Haskell)
2021-11-29 11:23:33 +01:00
- https://github.com/pfusik/qoi-ci (Ć)
- https://github.com/kodonnell/qoi (Python)
- https://github.com/NUlliiON/QoiSharp (C#)
- https://github.com/rbino/qoix (Elixir)
2021-12-08 21:22:16 +01:00
- https://github.com/elihwyma/Swift-QOI (Swift)
2021-12-13 17:44:24 +01:00
- https://github.com/saharNooby/qoi-java (Java)
2021-12-19 10:54:49 +01:00
- https://github.com/Cr4xy/lua-qoi (Lua)
2021-11-29 11:23:33 +01:00
## Packages
[AUR](https://aur.archlinux.org/pkgbase/qoi-git/) - system-wide qoi.h, qoiconv and qoibench install as split packages.