guillotine 0.0.1

A no_std graphical user interface framework in Rust for embedded devices prioritizing resource efficiency and ergonomics.
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

extern crate alloc;

use core::convert::Infallible;

use alloc::vec::Vec;
use embedded_graphics::{
    pixelcolor::Rgb565,
    prelude::{DrawTarget, PixelColor},
};

use crate::{
    Style,
    element::{Element, IntoElement, ParentElement, draw_box},
    layout::BoxLayout,
    style::StyledElement,
};

/// Style for this column.
#[derive(Default, PartialEq, Eq)]
pub struct ColumnStyle {}

/// A vertical container declaration.
///
/// `Vec` is useful while exploring the public API, but it is not intended to be the final
/// storage strategy. An allocation-free implementation will reconcile children directly into
/// caller-provided arena storage through [`crate::Context`].
#[derive(Default, PartialEq, Eq)]
pub struct Column<'a, C = Rgb565, CE = Infallible>
where
    C: PixelColor,
{
    pub(crate) children: Vec<Element<'a, C, CE>>,
    pub(crate) style: Style<ColumnStyle, C>,
}

impl<C> Column<'_, C>
where
    C: PixelColor,
{
    /// Creates an empty column.
    pub fn new() -> Self {
        Self { children: Vec::new(), style: Style::default() }
    }

    /// Sets the style of this column.
    pub const fn with_style(mut self, style: Style<ColumnStyle, C>) -> Self {
        self.style = style;
        self
    }

    /// Returns a reference to this column's style.
    pub const fn style(&self) -> &Style<ColumnStyle, C> {
        &self.style
    }

    /// Draws this column onto the given target, using the provided layout. Does NOT draw children,
    /// that responsibility is delegated to the children themselves.
    pub(crate) fn draw<D>(&self, layout: &BoxLayout, target: &mut D) -> Result<(), D::Error>
    where
        D: DrawTarget<Color = C>,
    {
        draw_box(&self.style, layout, target)
    }
}

impl<'a, C> IntoElement for Column<'a, C>
where
    C: PixelColor,
{
    type Element = Element<'a, C>;

    fn into_element(self) -> Element<'a, C> {
        Element::Column(self)
    }
}

impl<'a, C> ParentElement<'a, C> for Column<'a, C>
where
    C: PixelColor,
{
    fn extend(&mut self, elements: impl IntoIterator<Item = Element<'a, C>>) {
        self.children.extend(elements);
    }
}

impl<C> StyledElement for Column<'_, C>
where
    C: PixelColor,
{
    type Color = C;
    type Specific = ColumnStyle;

    fn style_mut(&mut self) -> &mut Style<Self::Specific, Self::Color> {
        &mut self.style
    }
}

/// Creates an empty vertical container.
pub fn column<'a, C>() -> Column<'a, C>
where
    C: PixelColor,
{
    Column::new()
}