Struct Xyz

#[repr(C)]
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)

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

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

impl Xyz

pub fn sqrt(&self) -> Xyz

pub fn cbrt(&self) -> Xyz

Trait Implementations

impl Add<f32> for Xyz

type Output = Xyz

The resulting type after applying the + operator.

fn add(self, rhs: f32) -> Xyz

Performs the + operation.

impl Add for Xyz

type Output = Xyz

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Xyz

Performs the + operation.

impl AddAssign<f32> for Xyz

fn add_assign(&mut self, rhs: f32)

Performs the += operation.

impl AddAssign for Xyz

fn add_assign(&mut self, rhs: Xyz)

Performs the += operation.

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 Div<f32> for Xyz

type Output = Xyz

The resulting type after applying the / operator.

fn div(self, rhs: f32) -> Self::Output

Performs the / operation.

impl Div for Xyz

type Output = Xyz

The resulting type after applying the / operator.

fn div(self, rhs: Xyz) -> Self::Output

Performs the / operation.

impl DivAssign<f32> for Xyz

fn div_assign(&mut self, rhs: f32)

Performs the /= operation.

impl DivAssign for Xyz

fn div_assign(&mut self, rhs: Xyz)

Performs the /= operation.

impl EuclideanDistance for Xyz

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

impl Index<usize> for Xyz

type Output = f32

The returned type after indexing.

fn index(&self, index: usize) -> &f32

Performs the indexing (container[index]) operation.

impl IndexMut<usize> for Xyz

fn index_mut(&mut self, index: usize) -> &mut f32

Performs the mutable indexing (container[index]) operation.

impl Mul<f32> for Xyz

type Output = Xyz

The resulting type after applying the * operator.

fn mul(self, rhs: f32) -> Self::Output

Performs the * operation.

impl Mul for Xyz

type Output = Xyz

The resulting type after applying the * operator.

fn mul(self, rhs: Xyz) -> Self::Output

Performs the * operation.

impl MulAssign<f32> for Xyz

fn mul_assign(&mut self, rhs: f32)

Performs the *= operation.

impl MulAssign for Xyz

fn mul_assign(&mut self, rhs: Xyz)

Performs the *= operation.

impl Neg for Xyz

type Output = Xyz

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl Pow<Xyz> for Xyz

type Output = Xyz

The result after applying the operator.

fn pow(self, rhs: Xyz) -> Self::Output

Returns self to the power rhs.

impl Pow<f32> for Xyz

type Output = Xyz

The result after applying the operator.

fn pow(self, rhs: f32) -> Self::Output

Returns self to the power rhs.

impl Sub<f32> for Xyz

type Output = Xyz

The resulting type after applying the - operator.

fn sub(self, rhs: f32) -> Self::Output

Performs the - operation.

impl Sub for Xyz

type Output = Xyz

The resulting type after applying the - operator.

fn sub(self, rhs: Xyz) -> Self::Output

Performs the - operation.

impl SubAssign<f32> for Xyz

fn sub_assign(&mut self, rhs: f32)

Performs the -= operation.

impl SubAssign for Xyz

fn sub_assign(&mut self, rhs: Xyz)

Performs the -= operation.

impl Copy for Xyz