#image-format #image-encoding #codec #graphics #decoding #safe #pure

no-std qoi

VERY fast encoder/decoder for QOI (Quite Okay Image) format

2 releases

0.4.1 Oct 16, 2022
0.4.0 Jan 6, 2022
0.3.1 Nov 28, 2021
0.2.0 Nov 27, 2021
0.0.1 Nov 25, 2021

#53 in Images

Download history 68895/week @ 2023-11-21 76805/week @ 2023-11-28 72423/week @ 2023-12-05 71311/week @ 2023-12-12 63945/week @ 2023-12-19 57302/week @ 2023-12-26 74755/week @ 2024-01-02 78610/week @ 2024-01-09 90108/week @ 2024-01-16 92433/week @ 2024-01-23 109500/week @ 2024-01-30 110323/week @ 2024-02-06 104437/week @ 2024-02-13 109390/week @ 2024-02-20 107699/week @ 2024-02-27 95979/week @ 2024-03-05

433,492 downloads per month
Used in 1,222 crates (7 directly)

MIT/Apache

72KB
1.5K SLoC

Rust 1K SLoC // 0.0% comments C 558 SLoC // 0.2% comments

qoi

Build Latest Version Documentation Apache 2.0 MIT unsafe forbidden

Fast encoder/decoder for QOI image format, implemented in pure and safe Rust.

  • One of the fastest QOI encoders/decoders out there.
  • Compliant with the latest QOI format specification.
  • Zero unsafe code.
  • Supports decoding from / encoding to std::io streams directly.
  • no_std support.
  • Roundtrip-tested vs the reference C implementation; fuzz-tested.

Examples

use qoi::{encode_to_vec, decode_to_vec};

let encoded = encode_to_vec(&pixels, width, height)?;
let (header, decoded) = decode_to_vec(&encoded)?;

assert_eq!(header.width, width);
assert_eq!(header.height, height);
assert_eq!(decoded, pixels);

Benchmarks

             decode:Mp/s  encode:Mp/s  decode:MB/s  encode:MB/s
qoi.h              282.9        225.3        978.3        778.9
qoi-rust           427.4        290.0       1477.7       1002.9
  • Reference C implementation: phoboslab/qoi@00e34217.
  • Benchmark timings were collected on an Apple M1 laptop.
  • 2846 images from the suite provided upstream (tarball): all pngs except two with broken checksums.
  • 1.32 GPixels in total with 4.46 GB of raw pixel data.

Benchmarks have also been run for all of the other Rust implementations of QOI for comparison purposes and, at the time of writing this document, this library proved to be the fastest one by a noticeable margin.

Rust version

The minimum required Rust version for the latest crate version is 1.61.0.

no_std

This crate supports no_std mode. By default, std is enabled via the std feature. You can deactivate the default-features to target core instead. In that case anything related to std::io, std::error::Error and heap allocations is disabled. There is an additional alloc feature that can be activated to bring back the support for heap allocations.

License

This project is dual-licensed under MIT and Apache 2.0.

Dependencies

~135KB