Struct colorutils_rs::Xyz

pub struct Xyz {
    pub x: f32,
    pub y: f32,
    pub z: f32,
}

A CIE 1931 XYZ color.

Fields

x: f32

y: f32

z: f32

Implementations

impl Xyz

pub fn new(x: f32, y: f32, z: f32) -> Self

pub fn saturate_x(x: f32) -> f32

pub fn saturate_y(y: f32) -> f32

pub fn saturate_z(z: f32) -> f32

pub fn scale(&self, by: f32) -> Xyz

pub fn to_absolute_luminance(&self, display_nits: f32) -> Xyz

Scales XYZ to absolute luminance against display

pub fn to_relative_luminance(&self, display_nits: f32) -> Xyz

Scales XYZ to absolute luminance against display

impl Xyz

This class avoid to scale by 100 for a reason: in common there are no need to scale by 100 in digital image processing, Normalized values are speeding up computing. if you need this multiply by yourself or use scaled

pub fn to_jzazbz(&self) -> Jzazbz

Converts into Xyz

pub fn from_srgb(rgb: Rgb<u8>) -> Self

This functions always use sRGB transfer function and Rec.601 primaries with D65 White point

pub fn from_rgb( rgb: Rgb<u8>, matrix: &[[f32; 3]; 3], transfer_function: TransferFunction, ) -> Self

This function converts from non-linear RGB components to XYZ

Arguments

• matrix - Transformation matrix from RGB to XYZ, for example SRGB_TO_XYZ_D65
• transfer_function - Transfer functions for current colorspace

pub fn from_linear_rgb(rgb: &Rgb<f32>, matrix: &[[f32; 3]; 3]) -> Self

This function converts from non-linear RGB components to XYZ

Arguments

• matrix - Transformation matrix from RGB to XYZ, for example SRGB_TO_XYZ_D65
• transfer_function - Transfer functions for current colorspace

pub fn scaled(&self) -> (f32, f32, f32)

impl Xyz

pub fn to_srgb(&self) -> Rgb<u8>

This functions always use sRGB transfer function and Rec.601 primaries with D65 White point

pub fn to_rgb( &self, matrix: &[[f32; 3]; 3], transfer_function: TransferFunction, ) -> Rgb<u8>

This functions always use sRGB transfer function and Rec.601 primaries with D65 White point

Arguments

• matrix - Transformation matrix from RGB to XYZ, for example SRGB_TO_XYZ_D65
• transfer_function - Transfer functions for current colorspace

pub fn to_linear_rgb(&self, matrix: &[[f32; 3]; 3]) -> Rgb<f32>

This function converts XYZ to linear RGB

Arguments

• matrix - Transformation matrix from RGB to XYZ, for example SRGB_TO_XYZ_D65

Trait Implementations

impl Clone for Xyz

fn clone(&self) -> Xyz

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Xyz

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

Formats the value using the given formatter.

impl Default for Xyz

fn default() -> Xyz

Returns the “default value” for a type.

impl EuclideanDistance for Xyz

fn euclidean_distance(&self, other: Xyz) -> f32

impl Copy for Xyz