dithr 0.3.0

Buffer-first rust dithering and halftoning library.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

#[cfg(feature = "rayon")]
use super::ordered_dither_in_place_par;
use super::{ordered_dither_in_place, DEFAULT_STRENGTH};
use crate::{
    core::{PixelLayout, Sample},
    data::{generate_bayer_16x16_flat, BAYER_2X2_FLAT, BAYER_4X4_FLAT, BAYER_8X8_FLAT},
    Buffer, QuantizeMode, Result,
};
use std::sync::OnceLock;

static BAYER_16X16_FLAT: OnceLock<[u16; 256]> = OnceLock::new();

pub fn bayer_2x2_in_place<S: Sample, L: PixelLayout>(
    buffer: &mut Buffer<'_, S, L>,
    mode: QuantizeMode<'_, S>,
) -> Result<()> {
    ordered_dither_in_place(buffer, mode, &BAYER_2X2_FLAT, 2, 2, DEFAULT_STRENGTH)
}

#[cfg(feature = "rayon")]
pub fn bayer_2x2_in_place_par<S: Sample, L: PixelLayout>(
    buffer: &mut Buffer<'_, S, L>,
    mode: QuantizeMode<'_, S>,
) -> Result<()> {
    ordered_dither_in_place_par(buffer, mode, &BAYER_2X2_FLAT, 2, 2, DEFAULT_STRENGTH)
}

pub fn bayer_4x4_in_place<S: Sample, L: PixelLayout>(
    buffer: &mut Buffer<'_, S, L>,
    mode: QuantizeMode<'_, S>,
) -> Result<()> {
    ordered_dither_in_place(buffer, mode, &BAYER_4X4_FLAT, 4, 4, DEFAULT_STRENGTH)
}

#[cfg(feature = "rayon")]
pub fn bayer_4x4_in_place_par<S: Sample, L: PixelLayout>(
    buffer: &mut Buffer<'_, S, L>,
    mode: QuantizeMode<'_, S>,
) -> Result<()> {
    ordered_dither_in_place_par(buffer, mode, &BAYER_4X4_FLAT, 4, 4, DEFAULT_STRENGTH)
}

pub fn bayer_8x8_in_place<S: Sample, L: PixelLayout>(
    buffer: &mut Buffer<'_, S, L>,
    mode: QuantizeMode<'_, S>,
) -> Result<()> {
    ordered_dither_in_place(buffer, mode, &BAYER_8X8_FLAT, 8, 8, DEFAULT_STRENGTH)
}

#[cfg(feature = "rayon")]
pub fn bayer_8x8_in_place_par<S: Sample, L: PixelLayout>(
    buffer: &mut Buffer<'_, S, L>,
    mode: QuantizeMode<'_, S>,
) -> Result<()> {
    ordered_dither_in_place_par(buffer, mode, &BAYER_8X8_FLAT, 8, 8, DEFAULT_STRENGTH)
}

pub fn bayer_16x16_in_place<S: Sample, L: PixelLayout>(
    buffer: &mut Buffer<'_, S, L>,
    mode: QuantizeMode<'_, S>,
) -> Result<()> {
    ordered_dither_in_place(buffer, mode, bayer_16x16_flat(), 16, 16, DEFAULT_STRENGTH)
}

#[cfg(feature = "rayon")]
pub fn bayer_16x16_in_place_par<S: Sample, L: PixelLayout>(
    buffer: &mut Buffer<'_, S, L>,
    mode: QuantizeMode<'_, S>,
) -> Result<()> {
    ordered_dither_in_place_par(buffer, mode, bayer_16x16_flat(), 16, 16, DEFAULT_STRENGTH)
}

fn bayer_16x16_flat() -> &'static [u16; 256] {
    BAYER_16X16_FLAT.get_or_init(generate_bayer_16x16_flat)
}