picto 0.4.4

Image handling 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

//            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
//                    Version 2, December 2004
//
// Copyleft (ↄ) meh. <meh@schizofreni.co> | http://meh.schizofreni.co
//
// Everyone is permitted to copy and distribute verbatim or modified
// copies of this license document, and changing it is allowed as long
// as the name is changed.
//
//            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
//   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
//
//  0. You just DO WHAT THE FUCK YOU WANT TO.

use super::Ditherer;
use crate::{buffer::Buffer, pixel, view};

/// Trait for ditherable types.
pub trait Dither<P, C>
where
	P: pixel::Read<C> + pixel::Write<C>,
	C: pixel::Channel,
{
	/// Dither to the given number of colors.
	///
	/// # Example
	///
	/// ```
	/// use picto::read;
	/// use picto::color::Rgb;
	/// use picto::processing::prelude::*;
	///
	/// let image    = read::from_path::<Rgb, u8, _>("tests/boat.xyz").unwrap();
	/// let dithered = image.dither::<ditherer::NeuQuant>(256);
	/// ```
	fn dither<A>(self, colors: u32) -> Buffer<P, C, Vec<C>>
	where
		A: Ditherer<P, C, P, C>;
}

impl<'i, P, C, I> Dither<P, C> for I
where
	P: pixel::Read<C> + pixel::Write<C>,
	C: pixel::Channel,
	I: Into<view::Read<'i, P, C>>,
{
	fn dither<A>(self, colors: u32) -> Buffer<P, C, Vec<C>>
	where
		A: Ditherer<P, C, P, C>,
	{
		it::<A, _, P, C, P, C>(self, colors)
	}
}

/// Dither to the given number of colors.
#[inline]
pub fn it<'i, A, I, PI, CI, PO, CO>(input: I, colors: u32) -> Buffer<PO, CO, Vec<CO>>
where
	A: Ditherer<PI, CI, PO, CO>,
	PO: From<PI>,
	PO: pixel::Write<CO>,
	CO: pixel::Channel,
	PI: pixel::Read<CI>,
	CI: pixel::Channel,
	I: Into<view::Read<'i, PI, CI>>,
{
	A::dither(&input.into(), colors)
}