Struct Hsl

pub struct Hsl;

🌌 The HSL color space

The HSL color space is fairly widely used and convenient, but it is not based on sound color science. Among its flaws, colors with the same “lightness” value can have wildly varying perceptual lightness.

Its components are [H, S, L] with

• H - the hue angle in degrees, with red at 0, green at 120, and blue at 240.
• S - the saturation, where 0 is gray and 100 is maximally saturated.
• L - the lightness, where 0 is black and 100 is white.

This corresponds to the color space in CSS Color Module Level 4 § 7.

Trait Implementations

impl Clone for Hsl

fn clone(&self) -> Hsl

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ColorSpace for Hsl

const TAG: Option<ColorSpaceTag>

The tag corresponding to this color space, if a matching tag exists.

const LAYOUT: ColorSpaceLayout = ColorSpaceLayout::HueFirst

The layout of the color space.

const WHITE_COMPONENTS: [f32; 3]

The component values for the color white within this color space.

fn from_linear_srgb(src: [f32; 3]) -> [f32; 3]

Convert an opaque color from linear sRGB.

fn to_linear_srgb(src: [f32; 3]) -> [f32; 3]

Convert an opaque color to linear sRGB.

fn scale_chroma([h, s, l]: [f32; 3], scale: f32) -> [f32; 3]

Scale the chroma by the given amount.

fn convert<TargetCS: ColorSpace>(src: [f32; 3]) -> [f32; 3]

Convert to a different color space.

fn clip([h, s, l]: [f32; 3]) -> [f32; 3]

Clip the color’s components to fit within the natural gamut of the color space.

const IS_LINEAR: bool = false

Whether the color space is linear.

const WHITE_POINT: Chromaticity = Chromaticity::D65

The white point of the color space.

fn to_linear_srgb_absolute(src: [f32; 3]) -> [f32; 3]

Convert an opaque color to linear sRGB, without chromatic adaptation.

fn from_linear_srgb_absolute(src: [f32; 3]) -> [f32; 3]

Convert an opaque color from linear sRGB, without chromatic adaptation.

fn convert_absolute<TargetCS: ColorSpace>(src: [f32; 3]) -> [f32; 3]

Convert to a different color space, without chromatic adaptation.

fn chromatically_adapt( src: [f32; 3], from: Chromaticity, to: Chromaticity, ) -> [f32; 3]

Chromatically adapt the color between the given white point chromaticities.

impl Debug for Hsl

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

Formats the value using the given formatter.

impl From<Hsl> for ColorSpaceTag

fn from(_: Hsl) -> Self

Converts to this type from the input type.

impl Copy for Hsl