Trait cosmic::cosmic_theme::palette::SaturateAssign
source · pub trait SaturateAssign {
type Scalar;
// Required methods
fn saturate_assign(&mut self, factor: Self::Scalar);
fn saturate_fixed_assign(&mut self, amount: Self::Scalar);
}
Expand description
Assigning operator for increasing the saturation (or chroma) of a color.
The trait’s functions are split into two groups of functions: relative and fixed/absolute.
The relative function, saturate_assign
,
scales the saturation towards the maximum saturation value. This means that
for a color with 50% saturation, if saturate_assign(0.5)
is applied to it,
the color will scale halfway to the maximum value of 100% resulting in a new
saturation value of 75%.
The fixed or absolute function,
saturate_fixed_assign
, increases
the saturation by an amount that is independent of the current saturation of
the color. So for a color with 50% saturation, if
saturate_fixed_assign(0.5)
is applied to it, the color will have 50%
saturation added to its saturation value resulting in a new value of 100%.
See also Saturate
, Desaturate
and DesaturateAssign
.
use approx::assert_relative_eq;
use palette::{Hsv, SaturateAssign};
let mut relative = Hsv::new_srgb(0.0, 0.5, 1.0);
relative.saturate_assign(0.5);
let mut fixed = Hsv::new_srgb(0.0, 0.5, 1.0);
fixed.saturate_fixed_assign(0.5);
assert_relative_eq!(relative.saturation, 0.75);
assert_relative_eq!(fixed.saturation, 1.0);
SaturateAssign
is also implemented for [T]
:
use palette::{Hsl, SaturateAssign};
let mut my_vec = vec![Hsl::new_srgb(104.0, 0.3, 0.8), Hsl::new_srgb(113.0, 0.5, 0.8)];
let mut my_array = [Hsl::new_srgb(104.0, 0.3, 0.8), Hsl::new_srgb(113.0, 0.5, 0.8)];
let mut my_slice = &mut [Hsl::new_srgb(104.0, 0.3, 0.8), Hsl::new_srgb(112.0, 0.5, 0.8)];
my_vec.saturate_assign(0.5);
my_array.saturate_assign(0.5);
my_slice.saturate_assign(0.5);
Required Associated Types§
Required Methods§
sourcefn saturate_assign(&mut self, factor: Self::Scalar)
fn saturate_assign(&mut self, factor: Self::Scalar)
Scale the color towards the maximum saturation by factor
, a value
ranging from 0.0
to 1.0
.
use approx::assert_relative_eq;
use palette::{Hsl, SaturateAssign};
let mut color = Hsl::new_srgb(0.0, 0.5, 0.5);
color.saturate_assign(0.5);
assert_relative_eq!(color.saturation, 0.75);
sourcefn saturate_fixed_assign(&mut self, amount: Self::Scalar)
fn saturate_fixed_assign(&mut self, amount: Self::Scalar)
Increase the saturation by amount
, a value ranging from 0.0
to
1.0
.
use approx::assert_relative_eq;
use palette::{Hsl, SaturateAssign};
let mut color = Hsl::new_srgb(0.0, 0.4, 0.5);
color.saturate_fixed_assign(0.2);
assert_relative_eq!(color.saturation, 0.6);