Struct ColorOrigin 

#[non_exhaustive]
pub struct ColorOrigin {
    pub icc: Option<Arc<[u8]>>,
    pub cicp: Option<Cicp>,
    pub provenance: ColorProvenance,
}

Immutable record of how the source file described its color.

Tracks the original color description from the decoded file so encoders can make provenance-aware decisions (e.g., re-embed the original ICC profile, or prefer CICP when re-encoding to AVIF).

ColorOrigin is immutable once set. It records how color was described, not what the pixels currently are. The encoder uses PixelDescriptor for the current state and can consult ColorOrigin for provenance decisions.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

icc: Option<Arc<[u8]>>

Raw ICC profile bytes from the source file, if any.

cicp: Option<Cicp>

CICP parameters from the source file, if any.

provenance: ColorProvenance

How the color information was originally described.

Implementations

impl ColorOrigin

pub fn from_icc(icc: impl Into<Arc<[u8]>>) -> ColorOrigin

Create from an ICC profile.

pub fn from_cicp(cicp: Cicp) -> ColorOrigin

Create from CICP parameters.

pub fn from_icc_and_cicp(icc: impl Into<Arc<[u8]>>, cicp: Cicp) -> ColorOrigin

Create from both ICC and CICP (e.g., AVIF with both).

pub fn from_gama_chrm() -> ColorOrigin

Create from gAMA/cHRM chunks (no ICC or CICP).

pub fn assumed() -> ColorOrigin

Create for assumed/default color (no explicit metadata).

Trait Implementations

impl Clone for ColorOrigin

fn clone(&self) -> ColorOrigin

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ColorOrigin

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

Formats the value using the given formatter.

impl PartialEq for ColorOrigin

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

impl StructuralPartialEq for ColorOrigin