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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

use core::{
    marker::PhantomData,
    ops::{Add, Mul},
};
use num_traits::FromPrimitive;

/// Iterator for grid points with support for serpentine (zigzag) patterns.
#[derive(Debug)]
pub struct GridStepIterator<Item, Scalar> {
    start: Item,
    vertical_step: Item,
    horizontal_step: Item,
    horizontal_pixel_count: usize,
    vertical_pixel_count: usize,
    serpentine: bool,
    horizontal_index: usize,
    vertical_index: usize,
    scalar: PhantomData<Scalar>,
}

impl<Item, Scalar> GridStepIterator<Item, Scalar> {
    /// Creates a new grid iterator.
    ///
    /// # Arguments
    ///
    /// - `start` - The starting point (origin) of the grid
    /// - `vertical_step` - The vertical step between horizontal rows
    /// - `horizontal_step` - The horizontal step between vertical columns
    /// - `horizontal_pixel_count` - Number of pixels in a horizontal row
    /// - `vertical_pixel_count` - Number of pixels in a vertical column
    /// - `serpentine` - Whether to use zigzag pattern
    pub fn new(
        start: Item,
        vertical_step: Item,
        horizontal_step: Item,
        horizontal_pixel_count: usize,
        vertical_pixel_count: usize,
        serpentine: bool,
    ) -> Self {
        Self {
            start,
            vertical_step,
            horizontal_step,
            horizontal_pixel_count,
            vertical_pixel_count,
            serpentine,
            horizontal_index: 0,
            vertical_index: 0,
            scalar: PhantomData,
        }
    }
}

impl<Item, Scalar> Iterator for GridStepIterator<Item, Scalar>
where
    Item: Add<Output = Item> + Copy,
    Scalar: FromPrimitive + Mul<Item, Output = Item>,
{
    type Item = Item;

    fn next(&mut self) -> Option<Self::Item> {
        if self.vertical_index >= self.vertical_pixel_count {
            return None;
        }
        let vertical_index = Scalar::from_usize(self.vertical_index)?;
        let horizontal_index = if self.serpentine && (self.vertical_index % 2 == 1) {
            self.horizontal_pixel_count - 1 - self.horizontal_index
        } else {
            self.horizontal_index
        };
        let horizontal_index = Scalar::from_usize(horizontal_index)?;
        let point = self.start
            + vertical_index * self.vertical_step
            + horizontal_index * self.horizontal_step;
        self.horizontal_index += 1;
        if self.horizontal_index >= self.horizontal_pixel_count {
            self.horizontal_index = 0;
            self.vertical_index += 1;
        }
        Some(point)
    }
}