blinksy 0.11.0

no-std, no-alloc LED control library designed for 1D, 2D, and 3D layouts
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

use super::{LinearSrgb, Oklab};

use num_traits::Euclid;
#[allow(unused_imports)]
use num_traits::Float;

/// # Okhsv Color Space
///
/// A color space based on Oklab that uses hue, saturation, and value (brightness) components.
/// This provides a perceptually uniform way to represent colors in the familiar HSV model.
///
/// - `h`: Hue component (0.0 to 1.0) representing the color's position on the color wheel
/// - `s`: Saturation component (0.0 to 1.0) representing the color's intensity/purity
/// - `v`: Value/brightness component (0.0 to 1.0) representing the color's luminosity
#[derive(Debug, Copy, Clone, PartialEq)]
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
pub struct Okhsv {
    /// Hue component [0.0, 1.0] where 0 and 1 both represent red
    pub h: f32,
    /// Saturation component [0.0, 1.0]
    pub s: f32,
    /// Value component [0.0, 1.0]
    pub v: f32,
}

impl Okhsv {
    /// Creates a new Okhsv color with the specified components.
    /// All parameters are clamped to their valid ranges.
    pub fn new(h: f32, s: f32, v: f32) -> Self {
        Okhsv {
            h: Euclid::rem_euclid(&h, &1.),
            s: s.clamp(0., 1.),
            v: v.clamp(0., 1.),
        }
    }

    /// Converts Okhsv to Oklab.
    pub fn to_oklab(&self) -> Oklab {
        let v = self.v;
        let max_c = 0.4 * v;
        let c = self.s * max_c;
        let angle = 2.0 * core::f32::consts::PI * self.h;
        let a = c * angle.cos();
        let b = c * angle.sin();

        Oklab { l: v, a, b }
    }

    /// Converts Okhsv to linear RGB.
    pub fn to_linear_srgb(&self) -> LinearSrgb {
        self.to_oklab().to_linear_srgb()
    }
}