Struct ChromaticAdaptationTransform 

pub struct ChromaticAdaptationTransform { /* private fields */ }

A 3x3 matrix transform for adapting colors between different illuminant white points.

Chromatic adaptation transforms (CATs) model how the human visual system adjusts to changes in illumination. Each transform defines a matrix that converts XYZ tristimulus values into a cone-response-like space where adaptation scaling is applied.

Implementations

impl ChromaticAdaptationTransform

pub const BRADFORD: Self

Available on crate feature cat-bradford only.

The Bradford chromatic adaptation transform.

Widely considered the best general-purpose CAT. Used as the default.

pub const DEFAULT: Self = Self::BRADFORD

Available on crate feature cat-bradford only.

The default CAT (Bradford when the cat-bradford feature is enabled).

impl ChromaticAdaptationTransform

pub const CAT02: Self

Available on crate feature cat-cat02 only.

The CAT02 chromatic adaptation transform from the CIECAM02 color appearance model.

impl ChromaticAdaptationTransform

pub const CAT16: Self

Available on crate feature cat-cat16 only.

The CAT16 chromatic adaptation transform from the CAM16 color appearance model.

impl ChromaticAdaptationTransform

pub const CMC_CAT2000: Self

Available on crate feature cat-cmc-cat2000 only.

The CMC CAT2000 chromatic adaptation transform.

impl ChromaticAdaptationTransform

pub const CMC_CAT97: Self

Available on crate feature cat-cmc-cat97 only.

The CMC CAT97 chromatic adaptation transform.

impl ChromaticAdaptationTransform

pub const FAIRCHILD: Self

Available on crate feature cat-fairchild only.

The Fairchild chromatic adaptation transform.

impl ChromaticAdaptationTransform

pub const HPE: Self = Self::HUNT_POINTER_ESTEVEZ

Available on crate feature cat-hunt-pointer-estevez only.

Shorthand alias for Self::HUNT_POINTER_ESTEVEZ.

pub const HUNT_POINTER_ESTEVEZ: Self

Available on crate feature cat-hunt-pointer-estevez only.

The Hunt-Pointer-Estevez chromatic adaptation transform.

impl ChromaticAdaptationTransform

pub const SHARP: Self

Available on crate feature cat-sharp only.

The Sharp chromatic adaptation transform (Süsstrunk et al.).

impl ChromaticAdaptationTransform

pub const VON_KRIES: Self

Available on crate feature cat-von-kries only.

The Von Kries chromatic adaptation transform.

A simple diagonal adaptation using Hunt-Pointer-Estevez-like cone responses.

impl ChromaticAdaptationTransform

pub const XYZ_SCALING: Self

XYZ scaling (identity matrix) chromatic adaptation.

The simplest possible adaptation — scales each XYZ channel independently. Always available regardless of feature flags.

impl ChromaticAdaptationTransform

pub const fn new(name: &'static str, matrix: [[f64; 3]; 3]) -> Self

Creates a new chromatic adaptation transform from a name and 3x3 matrix.

pub fn adapt( &self, color: impl Into<Xyz>, reference_white: impl Into<Xyz>, target_white: impl Into<Xyz>, ) -> Xyz

Adapts a color from one white point to another.

Converts the color to a cone-response space using this transform’s matrix, scales each cone channel by the ratio of target to reference white, then converts back to XYZ.

pub fn inverse(&self) -> Matrix3

Returns the inverse of the transformation matrix.

pub fn matrix(&self) -> Matrix3

Returns the transformation matrix.

pub fn name(&self) -> &'static str

Returns the name of this transform (e.g., “Bradford”, “CAT16”).

Trait Implementations

impl Clone for ChromaticAdaptationTransform

fn clone(&self) -> ChromaticAdaptationTransform

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChromaticAdaptationTransform

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

Formats the value using the given formatter.

impl Default for ChromaticAdaptationTransform

fn default() -> Self

Returns the “default value” for a type.

impl Display for ChromaticAdaptationTransform

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

Formats the value using the given formatter.

impl Copy for ChromaticAdaptationTransform