guillotine 0.4.0

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

//! Custom element builder.

use embedded_graphics::pixelcolor::PixelColor;

use crate::{
    BuildError, Context, ElementBuilder, Style, StyledElement,
    common::NodeIndex,
    layout::Layout,
    tree::{Node, NodeKind},
};

impl<'frame, C, CE> Context<'frame, C, CE>
where
    C: PixelColor,
{
    /// Creates a builder for application-defined leaf content.
    pub fn custom<E>(&self, element: E) -> CustomBuilder<'_, 'frame, C, CE>
    where
        E: Into<CE>,
    {
        CustomBuilder::new(self, element.into())
    }
}

/// A builder that adds application-defined leaf content to a frame.
pub struct CustomBuilder<'cx, 'frame, C, CE>
where
    C: PixelColor,
{
    cx: &'cx Context<'frame, C, CE>,
    style: Style<(), C>,
    element: CE,
}

impl<'cx, 'frame, C, CE> CustomBuilder<'cx, 'frame, C, CE>
where
    C: PixelColor,
{
    /// Creates a custom element builder for the given context and element.
    pub fn new(cx: &'cx Context<'frame, C, CE>, element: CE) -> Self {
        Self { cx, style: Style::default(), element }
    }
}

impl<C, CE> StyledElement for CustomBuilder<'_, '_, C, CE>
where
    C: PixelColor,
{
    type Color = C;
    type Specific = ();

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

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

impl<C, CE> ElementBuilder for CustomBuilder<'_, '_, C, CE>
where
    C: PixelColor,
{
    fn try_build(self) -> Result<NodeIndex, BuildError> {
        self.cx.insert(Node {
            kind: NodeKind::Custom(self.style, self.element),
            layout: Layout::empty(),
            child: None,
            sibling: None,
        })
    }
}