QOI - The “Quite OK Image” format
This is a Rust encoder and decoder for Dominic Szablewski's QOI format for fast, lossless image compression. See the QOI File Format Specification for more details.
This was ported from Dominic's original C code, but modified to be much more idiomatic in Rust.
QOI encodes and decodes images in a lossless format. An encoded QOI image is usually around 10-30% larger than a decently optimized PNG image.
QOI outperforms simpler PNG encoders in compression ratio and performance. QOI images are typically 20% smaller than PNGs written with stbi_image but 10% larger than with libpng. Encoding is 25-50x faster and decoding is 3-4x faster than stbi_image or libpng.
Usage
You can call encode() to encode an image. You supply it with an iterator of Pixel values, and a writer to output to.
use std::num::NonZeroUsize;
use qoi::Pixel;
// Create a 512x256 red image here to demonstrate
let width = 512;
let height = 256;
let mut pixels: Vec<Pixel> = Vec::new();
pixels.resize(width * height, Pixel::rgba(255, 0, 0, 255));
// Encode the image and write it to a file
let file = File::create("my_image.qoi").unwrap();
qoi::encode(
NonZeroUsize::new(width).unwrap(),
NonZeroUsize::new(height).unwrap(),
pixels.into_iter(),
BufWriter::new(file),
)
.unwrap();
There are several helpful decode functions, here's the inverse of the above:
use qoi::Pixel;
let mut pixels: Vec<Pixel> = Vec::new();
let (width, height) =
qoi::decode_file_into_vec("my_image.qoi", &mut pixels)
.unwrap();
3 Dec 22, 2021
115 Jan 5, 2023
160 Jan 3, 2023
258 Dec 5, 2022
3 Sep 23, 2021
22 Dec 6, 2022
7 Sep 16, 2022
97 Oct 18, 2022
166 Dec 20, 2022
1 Jan 30, 2022
1.8k Dec 28, 2022
31 May 10, 2022
487 Dec 25, 2022
3 Aug 17, 2022
4 Apr 9, 2022
242 Dec 22, 2022
258 Dec 30, 2022
9 Dec 9, 2021
47 Dec 30, 2022