Skip to main content

chromashift/
oklch.rs

1use crate::{Alpha, Number, Oklab, ToAlpha};
2use core::fmt;
3
4/// A more adequate expression of LCH, in the CIE colour space.
5/// The components are:
6/// - Lightness / Luminance - a number between 0.0 and 100.0
7/// - Chroma - a number between 0.0 and 150.0
8/// - Hue - a number between 0.0 and 360.0
9/// - Alpha - a number between 0.0 and 100.0
10#[derive(Debug, Clone, Copy, PartialEq)]
11pub struct Oklch {
12	pub lightness: f64,
13	pub chroma: f64,
14	pub hue: f64,
15	pub alpha: f32,
16}
17
18impl Oklch {
19	pub fn new(lightness: f64, chroma: f64, hue: f64, alpha: f32) -> Self {
20		Self { lightness, chroma, hue: hue.rem_euclid(360.0), alpha: alpha.clamp(0.0, 100.0) }
21	}
22}
23
24impl ToAlpha for Oklch {
25	fn to_alpha(&self) -> f32 {
26		self.alpha
27	}
28}
29
30impl fmt::Display for Oklch {
31	fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
32		let Self { lightness, chroma, hue, alpha } = *self;
33		write!(f, "oklch({} {} {}{})", Number(lightness), Number(chroma), Number(hue), Alpha(alpha))
34	}
35}
36
37impl From<Oklab> for Oklch {
38	fn from(value: Oklab) -> Self {
39		let Oklab { lightness, a, b, alpha } = value;
40		let chroma = (a * a + b * b).sqrt();
41		let hue = b.atan2(a).to_degrees();
42		let hue = if chroma <= 0.000004 {
43			0.0
44		} else if hue < 0.0 {
45			hue + 360.0
46		} else {
47			hue
48		};
49		Oklch::new(lightness, chroma, hue, alpha)
50	}
51}
52
53impl From<Oklch> for Oklab {
54	fn from(value: Oklch) -> Self {
55		let Oklch { lightness, chroma, hue, alpha } = value;
56		let hue_rad = hue.to_radians();
57		let a = chroma * hue_rad.cos();
58		let b = chroma * hue_rad.sin();
59		Oklab::new(lightness, a, b, alpha)
60	}
61}