Struct ColorMatrix 

pub struct ColorMatrix { /* private fields */ }

A 2D colour matrix: rows × columns cells where each cell carries a palette index into an 8-entry [Rgb8; 8] colour table. Cells with palette index 0 are treated as background (typically white) by the renderer — no rect / pixel emitted.

The 8-colour palette is fixed at the symbology level (e.g. the AIM Ultracode CMYWK palette is defined in crate::symbology::ultracode::ULTRACODE_PALETTE) so the palette field is included in the struct for the renderer’s convenience.

Implementations

impl ColorMatrix

pub fn new(width: usize, height: usize, palette: [Rgb8; 8]) -> Self

Allocate an all-background (palette index 0) matrix of the given dimensions, with the given colour palette.

pub fn width(&self) -> usize

Width in modules.

pub fn height(&self) -> usize

Height in modules.

pub fn get(&self, x: usize, y: usize) -> u8

Read a cell’s palette index (0..=7).

pub fn set(&mut self, x: usize, y: usize, palette_idx: u8)

Write a cell’s palette index. Caller is responsible for passing a value in 0..=7; out-of-range values are masked to 3 bits to keep the field invariant.

pub fn palette(&self) -> &[Rgb8; 8]

Borrow the 8-entry RGB palette.

pub fn cell_color(&self, x: usize, y: usize) -> Rgb8

Resolve a cell to its RGB colour.

Trait Implementations

impl Clone for ColorMatrix

fn clone(&self) -> ColorMatrix

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ColorMatrix

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.