Struct DeviceColor 

pub struct DeviceColor {
    pub r: f64,
    pub g: f64,
    pub b: f64,
    pub native_cmyk: Option<(f64, f64, f64, f64)>,
    pub process_cmyk: Option<(f64, f64, f64, f64)>,
}

Device color in RGB (internal representation) with optional native CMYK.

Fields

r: f64

g: f64

b: f64

native_cmyk: Option<(f64, f64, f64, f64)>

Native CMYK components for lossless roundtrip when color space is CMYK. For DeviceN/Separation paints this is the full alt-CMYK tint transform (process + spot contributions combined).

process_cmyk: Option<(f64, f64, f64, f64)>

Process-colorant-only CMYK contribution. Populated by DeviceN/Separation paints so the overprint tracker can record only what actually lands on process plates (C/M/Y/K), leaving any spot colorant’s alt-CMYK out of the process buffer. None means “use native_cmyk as the process contribution” (pure DeviceCMYK / DeviceGray / DeviceRGB).

Implementations

impl DeviceColor

pub fn from_gray(gray: f64) -> Self

pub fn from_rgb(r: f64, g: f64, b: f64) -> Self

pub fn from_cmyk(c: f64, m: f64, y: f64, k: f64) -> Self

pub fn from_cmyk_icc(c: f64, m: f64, y: f64, k: f64, icc: &mut IccCache) -> Self

Create from CMYK, converting through ICC profile if available. Falls back to PLRM formula when ICC is unavailable.

pub fn from_hsb(h: f64, s: f64, b: f64) -> Self

pub fn to_gray(&self) -> f64

Convert to gray using NTSC luma.

pub fn to_cmyk(&self) -> (f64, f64, f64, f64)

Convert to CMYK (uses native CMYK if available for lossless roundtrip).

pub fn to_hsb(&self) -> (f64, f64, f64)

Convert to HSB.

pub fn black() -> Self

Black (default color).

pub fn from_lab(l_star: f64, a_star: f64, b_star: f64, range: &[f64; 4]) -> Self

Convert CIE L*a*b* to sRGB.

PDF Lab color spaces specify a white point, but Lab is perceptually uniform — the same (L*, a*, b*) coordinates represent the same perceived color regardless of the declared white point. We convert directly through D65 (the sRGB reference illuminant), which makes the specified white point irrelevant and avoids Bradford adaptation errors for extreme/non-physical white points.

range is the a*/b* clamp range: [a_min, a_max, b_min, b_max].

pub fn from_cie_abc(a: f64, b: f64, c: f64, params: &CieAbcParams) -> Self

Convert CIEBasedABC color to sRGB.

pub fn from_cie_a(a: f64, params: &CieAParams) -> Self

Convert CIEBasedA color to sRGB.

pub fn from_cie_def(d: f64, e: f64, f: f64, params: &CieDefParams) -> Self

Convert CIEBasedDEF color to sRGB via pre-converted trilinear interpolation table.

pub fn from_cie_defg( d: f64, e: f64, f: f64, g: f64, params: &CieDefgParams, ) -> Self

Convert CIEBasedDEFG color to sRGB via pre-converted nearest-neighbor 4D table.

Trait Implementations

impl Clone for DeviceColor

fn clone(&self) -> DeviceColor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceColor

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

Formats the value using the given formatter.

impl Default for DeviceColor

fn default() -> Self

Returns the “default value” for a type.