Struct OptimalColors 

pub struct OptimalColors(/* private fields */);

Represents the set of optimal colors in colorimetry.

Optimal colors define the theoretical limits of color saturation (chroma) for given lightness and hue values. They are based on binary reflectance spectra that reflect either 0% or 100% of light at each wavelength, representing the most vivid colors physically possible under the constraints of human vision.

These colors form the boundary of the CIE color spaces (such as CIE 1931 or CIELAB), and are used to compute:

• The spectral locus in chromaticity diagrams.
• The maximum chroma values at given lightness and hue levels in perceptual spaces like CIELAB.

Although optimal colors do not correspond to real-world pigments or displays, they are essential for defining the theoretical gamut of visible colors.

Implementations

impl OptimalColors

pub fn new(observer: Observer, ref_white: CieIlluminant) -> OptimalColors

Computes the optimal colors for the observer under the specified reference white.

The resulting OptimalColors contains a matrix of tristimulus values derived from optimal spectra.

Arguments

• ref_white - The reference white illuminant to use for the calculations.

Returns

• OptimalColors - A struct containing the reference white and the matrix of optimal colors.

Notes

• The optimal colors are computed by applying a rectangular filter to the spectral locus, simulating the addition of contiguous spectral bands with increasing width.
• Each row in the resulting matrix corresponds to a different filter width, and the filter wraps around the spectrum to ensure continuity and to represent the full range of possible colors.
• The number of spectral samples, NS, is fixed at 401 throughout the library.
  • The resulting matrix has shape (NS-1, NS) = (400, 401).
  • Each column corresponds to a starting wavelength, and each row to a filter width.
• This is a theoretical construct and may not correspond to physically realizable colors.
• As it calculates about 160,000 colors, it may be computationally intensive.

pub fn white_point(&self) -> XYZ

pub fn colors(&self) -> &DMatrix<Vector3<f64>>

pub fn observer(&self) -> Observer