palettize

palettize applies ordered Bayer dithering to images using custom color palettes.

Quick start

[dependencies]
image = "0.25"
palettize = "0.2"

use palettize::{dither, grayscale};

let image = image::open("photo.png")?;
let palette = grayscale(6);
let output = dither(&image, &palette);
output.save("photo-dithered.png")?;

# Ok::<(), image::ImageError>(())

Features

• Generate Bayer matrices from 2×2 through 64×64.
• Build palettes from RGB colors, hex values, or grayscale stops.
• Extract palettes with median cut or k-means++ clustering.
• Remap an image's color distribution onto a palette's distribution in Oklab before dithering.

Requirements

This crate requires Rust 1.85 or later, edition 2024.

More examples and documentation

• API documentation — every public type and function.
• Changelog
• Issue tracker

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.