device-envoy-esp 0.1.4

Build ESP32 applications with composable device abstractions
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

//! Convenience text rendering for [`CydFrameEsp`].
//!
//! This mirrors the device-envoy `led2d` text helpers: the device owns a single
//! default style (background, foreground, font) and [`CydFrameEsp::write_text`]
//! drops a line of text into a frame using that default, without repeating the
//! [`Text`] / [`MonoTextStyle`] / [`Baseline`] boilerplate each time. Combined
//! with per-rectangle frames (see [`super::CydDisplay::frame_mut`]), this lets each status or time
//! message own its own area and be drawn in one call.
//!
//! There is intentionally exactly one convenience method. For a different font,
//! color, alignment, or baseline, draw with embedded-graphics directly against
//! the frame — that is the escape hatch.

use embedded_graphics::{
    Drawable,
    mono_font::{MonoFont, MonoTextStyle, ascii::FONT_9X15_BOLD},
    text::{Baseline, Text},
};
use embedded_hal::spi::SpiDevice;

use super::CydFrameEsp;

/// The default font accepted by [`CydDisplayEsp::new`](super::CydDisplayEsp::new).
/// See that method's compiled display-only constructor example.
pub const DEFAULT_FONT: MonoFont<'static> = FONT_9X15_BOLD;

impl<D: SpiDevice<u8>> CydFrameEsp<'_, D> {
    /// Draw `text` at the frame rectangle's top-left using the device default
    /// font and foreground color.
    ///
    /// For any other font, color, alignment, or baseline, draw with
    /// embedded-graphics directly against this frame.
    ///
    /// See the portable
    /// [`CydFrame::write_text`](https://docs.rs/device-envoy-core/latest/device_envoy_core/cyd/display/trait.CydFrame.html#tymethod.write_text)
    /// documentation.
    pub fn write_text(&mut self, text: &str) -> &mut Self {
        Text::with_baseline(
            text,
            self.rectangle.top_left,
            MonoTextStyle::new(self.font, self.foreground565),
            Baseline::Top,
        )
        .draw(self)
        .expect("drawing text to an Infallible CYD frame cannot fail");
        self
    }
}