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

//! Common types, traits and utilities.

use embedded_graphics::geometry::Size;
pub(crate) type NodeIndex = usize;

pub(crate) trait SizeExt {
    /// Inflates the size by a horizontal and vertical amount.
    fn inflate(self, by: Size) -> Self;

    /// Deflates the size by a horizontal and vertical amount.
    fn deflate(self, by: Size) -> Self;
}

impl SizeExt for Size {
    fn inflate(self, by: Size) -> Self {
        Self::new(self.width.saturating_add(by.width), self.height.saturating_add(by.height))
    }

    fn deflate(self, by: Size) -> Self {
        self.saturating_sub(by)
    }
}

/// Converts a `u32` value to an `i32`, saturating at `i32::MAX` if the value is too large.
pub(crate) const fn to_i32(value: u32) -> i32 {
    if value > i32::MAX as u32 { i32::MAX } else { value as i32 }
}

#[derive(Clone, Copy)]
pub(crate) struct TextRange {
    pub offset: usize,
    pub len: usize,
}

/// Represents a gap between elements, stored as a `Size`.
/// Supports conversion from `u32` and `Size` values, as well
/// as a shorthand from `(u32, u32)` values (width, height).
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct Gap(pub(crate) Size);

impl From<u32> for Gap {
    fn from(value: u32) -> Self {
        Self(Size::new(value, value))
    }
}

impl From<Size> for Gap {
    fn from(value: Size) -> Self {
        Self(value)
    }
}

impl From<(u32, u32)> for Gap {
    fn from((horizontal, vertical): (u32, u32)) -> Self {
        Self(Size::new(horizontal, vertical))
    }
}