Enum ColorProfileSource 

#[non_exhaustive]
pub enum ColorProfileSource<'a> {
    Icc(&'a [u8]),
    Cicp(Cicp),
    Named(NamedProfile),
    PrimariesTransferPair {
        primaries: ColorPrimaries,
        transfer: TransferFunction,
    },
}

A source color profile — either ICC bytes, CICP parameters, a named profile, or a primaries + transfer function pair.

This unified type lets consumers pass decoded image color info directly to a CMS backend without caring whether the source had an ICC profile, CICP codes, or a well-known named profile.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Icc(&'a [u8])

Raw ICC profile data.

Cicp(Cicp)

CICP parameters (a CMS can synthesize an equivalent profile).

Named(NamedProfile)

Well-known named profile.

PrimariesTransferPair

Color primaries + transfer function pair.

Covers the full ColorPrimaries × TransferFunction matrix, including combinations that don’t have a NamedProfile variant or a CICP mapping (e.g., Adobe RGB).

A CMS backend that handles this variant can avoid ICC profile parsing entirely for known primaries/transfer combinations.

Fields

primaries: ColorPrimaries

Color primaries (gamut + white point).

transfer: TransferFunction

Transfer function (EOTF encoding).

Implementations

impl<'a> ColorProfileSource<'a>

pub const fn from_primaries_transfer( primaries: ColorPrimaries, transfer: TransferFunction, ) -> ColorProfileSource<'a>

Create from primaries + transfer function.

pub const fn primaries_transfer( &self, ) -> Option<(ColorPrimaries, TransferFunction)>

Try to extract primaries + transfer, regardless of variant.

• PrimariesTransferPair — returns directly
• Named — decomposes via NamedProfile::to_primaries_transfer
• Cicp — maps via ColorPrimaries::from_cicp and TransferFunction::from_cicp
• Icc — returns None (requires profile parsing)

pub fn resolve(&self) -> Option<(ColorPrimaries, TransferFunction)>

Resolve to a (primaries, transfer) pair using all available methods, including ICC profile identification when the icc feature is enabled.

This is the most complete resolution path:

• PrimariesTransferPair — returns directly
• Named — decomposes via NamedProfile::to_primaries_transfer
• Cicp — maps via from_cicp, but returns None if matrix_coefficients is non-zero (YCbCr data requires matrix conversion first) or full_range is false (narrow-range data needs range expansion first)
• Icc — hash-based identification (~100ns, 135 known profiles) + CICP-in-ICC extraction. Returns None for unknown custom profiles.

Returns None when the profile is unknown or when reducing to (primaries, transfer) would discard significant information (YCbCr matrix coefficients, narrow signal range).

Trait Implementations

impl<'a> Clone for ColorProfileSource<'a>

fn clone(&self) -> ColorProfileSource<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for ColorProfileSource<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq for ColorProfileSource<'a>

fn eq(&self, other: &ColorProfileSource<'a>) -> 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<'a> Eq for ColorProfileSource<'a>

impl<'a> StructuralPartialEq for ColorProfileSource<'a>