Trait EuclideanDistance

pub trait EuclideanDistance: Sized {
    type Scalar;

    // Required method
    fn distance_squared(self, other: Self) -> Self::Scalar;

    // Provided method
    fn distance(self, other: Self) -> Self::Scalar
       where Self::Scalar: Sqrt { ... }
}

Calculate the distance between two colors as if they were coordinates in Euclidean space.

Euclidean distance is not always a good measurement of visual color difference, depending on the color space. Some spaces, like Lab and Oklab, will give a fairly uniform result, while other spaces, such as Rgb, will give much less uniform results. Despite that, it’s still appropriate for some applications.

Required Associated Types

type Scalar

The type for the distance value.

Required Methods

fn distance_squared(self, other: Self) -> Self::Scalar

Calculate the squared Euclidean distance from self to other.

This is typically a faster option than Self::distance for some cases, such as when comparing two distances.

Provided Methods

fn distance(self, other: Self) -> Self::Scalar

where Self::Scalar: Sqrt,

Calculate the Euclidean distance from self to other.

Object Safety

This trait is not object safe.

Implementors

impl<S, T> EuclideanDistance for Luma<S, T>

where T: Sub<Output = T> + Add<Output = T> + Mul<Output = T> + Real + Clone,

type Scalar = T

impl<S, T> EuclideanDistance for Rgb<S, T>

where T: Sub<Output = T> + Add<Output = T> + Mul<Output = T> + Real + Clone,

type Scalar = T

impl<T> EuclideanDistance for Cam16UcsJab<T>

where T: Add<Output = T> + Real + Mul<Output = T> + Sub<Output = T> + Clone,

type Scalar = T

impl<T> EuclideanDistance for Oklab<T>

where T: Add<Output = T> + Real + Mul<Output = T> + Sub<Output = T> + Clone,

type Scalar = T

impl<Wp, T> EuclideanDistance for Lab<Wp, T>

where T: Sub<Output = T> + Add<Output = T> + Mul<Output = T> + Real + Clone,

type Scalar = T

impl<Wp, T> EuclideanDistance for Luv<Wp, T>

where T: Sub<Output = T> + Add<Output = T> + Mul<Output = T> + Real + Clone,

type Scalar = T

impl<Wp, T> EuclideanDistance for Xyz<Wp, T>

where T: Sub<Output = T> + Add<Output = T> + Mul<Output = T> + Real + Clone,

type Scalar = T

impl<Wp, T> EuclideanDistance for Yxy<Wp, T>

where T: Sub<Output = T> + Add<Output = T> + Mul<Output = T> + Real + Clone,

type Scalar = T