Struct ColorMatrix 

pub struct ColorMatrix {
    pub coeffs: [[f32; 3]; 3],
    pub offsets: [f32; 3],
    pub clamp: bool,
}

3×3 colour-conversion matrix with per-row offsets, programmed into the DCMIPP Pipe1 ISP via Pipe1::set_color_matrix.

Hardware applies out = M · in + offset, optionally clamped to 8-bit unsigned. Coefficients are encoded as 11-bit signed Q2.8 (effective range -4.0 ..= +3.996, identity coefficient 1.0); offsets are 10-bit signed integers (range -512 ..= 511) added to the matrix product before the optional clamp.

Typical use: write a colour-correction matrix derived from sensor characterisation against a Macbeth chart, plus zero offsets, plus clamp = true for 8-bit display output. For pass-through use ColorMatrix::IDENTITY.

Fields

coeffs: [[f32; 3]; 3]

Row-major 3×3 coefficients. Element [i][j] multiplies input channel j to contribute to output channel i, with rows in R/G/B order.

offsets: [f32; 3]

Per-row offsets in 8-bit-output units, i.e. an offset of +16.0 shifts the corresponding output channel up by 16/255.

clamp: bool

Clamp the output to [0, 255]. Recommended true for 8-bit display / capture pipelines. Applies to the hardware’s unsigned 8-bit output mode (P1CCCR.TYPE = 0); the signed-output mode is not exposed by this struct.

Implementations

impl ColorMatrix

pub const IDENTITY: Self

Identity matrix with zero offsets and clamping enabled. Passing this to Pipe1::set_color_matrix should produce a frame pixel-identical to “no CCM applied” — a useful sanity check that the encoding into the hardware Q-format is correct.

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.

impl Format for ColorMatrix

where [[f32; 3]; 3]: Format, [f32; 3]: Format,

fn format(&self, f: Formatter<'_>)

Writes the defmt representation of self to fmt.

impl PartialEq for ColorMatrix

fn eq(&self, other: &ColorMatrix) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ColorMatrix

impl StructuralPartialEq for ColorMatrix