Struct ErrorPropagator 

pub struct ErrorPropagator<'name, 'matrix, S: PropagatorState> {
    pub name: &'name str,
    pub matrix: &'matrix [(i8, i8, u8)],
    pub portions: u16,
    /* private fields */
}

This struct defines an error propagation algorithm. For existing algorithms, the constants should be used instead.

An ErrorPropagator doesn’t start out as an effect, as it requires a colour palette to actually perform the dithering.

This can be done by simply calling .with_palette, which will generate a configured version of the propagator.

Fields

name: &'name str

The name of the algorithm in question.

matrix: &'matrix [(i8, i8, u8)]

The error propagation matrix, in the form of (dx, dy, portion).

For example, (1, 0, 1) will propagate 1/portion of the error to the next pixel on the right.

portions: u16

The total amount of portions. Note that this doesn’t need to equal the sum of portions in the matrix.

For example, Atkinson doesn’t distribute all portions - and one could theoretically over-propagate by distributing more portions in the matrix than listed here.

Implementations

impl<'a, 'b> ErrorPropagator<'a, 'b, Base>

pub const fn new( name: &'a str, matrix: &'b [(i8, i8, u8)], portions: u16, ) -> Self

impl<'a, 'b, S: PropagatorState> ErrorPropagator<'a, 'b, S>

pub fn with_palette( &self, palette: Vec<Srgb>, ) -> ErrorPropagator<'a, 'b, WithPalette>

Trait Implementations

impl<'a, 'b> Effect<Vec<Vec<[u8; 3]>>> for ErrorPropagator<'a, 'b, WithPalette>

fn affect(&self, image: Vec<Vec<[u8; 3]>>) -> Vec<Vec<[u8; 3]>>

Affects T using self.