Struct kolor_64::ColorSpace

pub struct ColorSpace { /* private fields */ }

A color space defined in data by its Primaries, white point, and an optional invertible transform function.

See spaces for defined color spaces.

ColorSpace assumes that a color space is one of

• the CIE XYZ color space
• an RGB color space
• a color space which may be defined as an invertible mapping from one the above (TransformFn)

An example of a TransformFn is the sRGB “opto-eletronic transfer function”, or “gamma compensation”.

kolor makes the distinction between “linear” and “non-linear” color spaces, where a linear color space can be defined as a linear transformation from the CIE XYZ color space.

ColorSpace contains a reference WhitePoint to represent a color space’s reference illuminant.

A linear RGB ColorSpace can be thought of as defining a relative coordinate system in the CIE XYZ color coordinate space, where three RGB primaries each define an axis pointing from the black point (0,0,0) in CIE XYZ.

Non-linear ColorSpaces - such as sRGB with gamma compensation applied - are defined as a non-linear mapping from a linear ColorSpace’s coordinate system.

Implementations

impl ColorSpace

pub const fn new( primaries: RGBPrimaries, white_point: WhitePoint, transform_fn: TransformFn ) -> Self

pub fn is_linear(&self) -> bool

Whether the color space has a non-linear transform applied

pub fn as_linear(&self) -> Self

pub fn primaries(&self) -> RGBPrimaries

pub fn white_point(&self) -> WhitePoint

pub fn transform_function(&self) -> TransformFn

pub fn with_transform(&self, new_transform: TransformFn) -> Self

Creates a new color space with the primaries and white point from this, but with the provided TransformFn.

pub fn with_whitepoint(&self, new_wp: WhitePoint) -> Self

Creates a new color space with the transform function and white point from this, but with the provided WhitePoint.

pub fn with_primaries(&self, primaries: RGBPrimaries) -> Self

Creates a new color space with the primaries and transform function from this, but with the provided RGBPrimaries.

pub fn to_cielab(&self) -> Self

Creates a CIE LAB color space using this space’s white point.

pub fn to_cie_xyY(&self) -> Self

Creates a CIE uvV color space using this space’s white point.

pub fn to_cielch(&self) -> Self

Creates a CIE LCh color space using this space’s white point.

Trait Implementations

impl Clone for ColorSpace

fn clone(&self) -> ColorSpace

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ColorSpace

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

Formats the value using the given formatter.

impl Hash for ColorSpace

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq<ColorSpace> for ColorSpace

fn eq(&self, other: &ColorSpace) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ColorSpace

impl Eq for ColorSpace

impl StructuralEq for ColorSpace

impl StructuralPartialEq for ColorSpace