Struct pix::Palette

pub struct Palette { /* fields omitted */ }

Color table for use with indexed Rasters.

Methods

impl Palette

pub fn new(capacity: usize) -> Self

Create a new color Palette.

• capacity Maximum number of entries.

pub fn len(&self) -> usize

Get the number of entries.

pub fn is_empty(&self) -> bool

Check if the palette is empty.

pub fn set_threshold_fn(&mut self, threshold_fn: fn(_: usize) -> SRgb8)

Set the threshold function for matching entries.

• threshold_fn Called when checking whether a color matches an existing entry. The parameter is the palette table size. Returns the maximum Channel-wise difference to match.

pub fn colors(&self) -> &[SRgb8]

Get a slice of all colors.

pub fn entry(&self, i: usize) -> Option<SRgb8>

Get a Palette entry.

• i Index of entry.

pub fn set_entry(&mut self, clr: SRgb8) -> Option<usize>

Set a Palette entry.

The table is searched for the best matching color within the threshold. If none found, a new entry is added.

• clr Color to lookup or add.

Returns

Index of best matching or added entry if successful. Otherwise, when no matches are found and the table is full, None is returned.

pub fn replace_entry(&mut self, i: usize, clr: SRgb8) -> Option<SRgb8>

Replace a Palette entry.

• i Index of entry.
• clr Color to replace entry with.

Returns

Previous entry, or None if index is larger than table size.

pub fn histogram<T>(&self, ent: &[T]) -> Option<Vec<usize>> where
    T: Copy,
    usize: From<T>, 

Create a histogram of Palette entries.

• ent Slice of entry indices (pixel values).

Trait Implementations

impl Clone for Palette

fn clone(&self) -> Palette

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.