7 unstable releases (3 breaking)
0.4.1 | Apr 2, 2024 |
---|---|
0.4.0 | Apr 2, 2024 |
0.3.0 | Jan 21, 2024 |
0.2.0 | Jan 14, 2024 |
0.1.2 | Jan 14, 2024 |
#318 in Images
15KB
172 lines
dithord: Bayer ordered dithering crate
This crate provides functionality which allows for monochromatic ordered dithering using a Bayer threshold matrix. This method of dithering is less accurate than others but is fast and visually appealing.
Example of level 2 dithering using this crate:
Currently only monochromatic dithering is supported, but support for arbitrary palettes could be considered as a feature.
Add to Project
cargo add dithord
Usage
This crate provides the OrderedDither
trait which is implemented for image::DynamicImage
, along with a ThresholdMap
struct for generating and storing the Bayer matrix.
Example
use dithord::{ThresholdMap, OrderedDither};
use image::{io::Reader};
fn main() {
let mut image = Reader::open("example.png").unwrap().decode().unwrap();
// Generate level 2 (8x8) threshold map
let map = threshold_map::ThresholdMap::level(2);
// Apply dither
image = image.ordered_dither(map);
}
Using standalone
This crate provides a standalone binary for dithering images from the command line. It can be installed using cargo:
cargo install dithord --features=cli
The binary can then be used to dither images from the command line:
dithord input.png output.exr --level 2
Dependencies
~5MB
~65K SLoC