2022-01-02 22:40:25 +00:00
|
|
|
# qoi-fast
|
|
|
|
|
|
|
|
|
|
VERY fast encoder/decoder for [QOI image format](https://qoiformat.org/), implemented in pure Rust.
|
|
|
|
|
|
|
|
|
|
[](https://github.com/aldanor/qoi-fast/actions?query=branch%3Amaster)
|
|
|
|
|
[](https://crates.io/crates/qoi-fast)
|
|
|
|
|
[](https://docs.rs/qoi-fast)
|
|
|
|
|
[](https://opensource.org/licenses/Apache-2.0)
|
|
|
|
|
[](https://opensource.org/licenses/MIT)
|
2022-01-03 11:51:39 +00:00
|
|
|
[](https://github.com/rust-secure-code/safety-dance)
|
2022-01-02 22:40:25 +00:00
|
|
|
|
|
|
|
|
Quick summary:
|
|
|
|
|
|
2022-01-03 11:25:25 +00:00
|
|
|
- One of the [fastest](https://github.com/aldanor/qoi-fast#benchmarks)
|
|
|
|
|
QOI encoders/decoders out there.
|
2022-01-03 11:51:39 +00:00
|
|
|
- Compliant with the latest QOI [format specification](https://qoiformat.org/qoi-specification.pdf).
|
2022-01-03 11:25:25 +00:00
|
|
|
- Zero unsafe code.
|
|
|
|
|
- Supports decoding from / encoding to `std::io` streams directly.
|
|
|
|
|
- Roundtrip-tested vs the reference C implementation; fuzz-tested.
|
|
|
|
|
|
|
|
|
|
### Examples
|
|
|
|
|
|
|
|
|
|
```rust
|
|
|
|
|
todo!();
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Benchmarks
|
|
|
|
|
|
|
|
|
|
Comparison to the reference C implementation
|
|
|
|
|
(as of [00e34217](https://github.com/phoboslab/qoi/commit/00e34217)),
|
|
|
|
|
benchmarks timings collected on Apple M1 (1782 images, 1187 MB total):
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
codec decode:ms encode:ms decode:mp/s encode:mp/s
|
|
|
|
|
|
2022-01-03 16:08:38 +00:00
|
|
|
qoi-c 4409.34 5531.82 282.3 225.0
|
|
|
|
|
qoi-fast 3105.60 4726.19 400.8 263.3
|
2022-01-03 11:25:25 +00:00
|
|
|
```
|
2022-01-02 22:40:25 +00:00
|
|
|
|
|
|
|
|
### License
|
|
|
|
|
|
2022-01-03 11:51:39 +00:00
|
|
|
This project is dual-licensed under MIT and Apache 2.0.
|
