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
//! # Example: special characters
//!
//! This example demonstrates support for carriage return, non-breaking space and zero-width space
//! characters to modify text layout behaviour.
use embedded_graphics::{
mono_font::{ascii::FONT_6X10, MonoTextStyleBuilder},
pixelcolor::BinaryColor,
prelude::*,
primitives::Rectangle,
};
use embedded_graphics_simulator::{
BinaryColorTheme, OutputSettingsBuilder, SimulatorDisplay, Window,
};
use embedded_text::{
alignment::HorizontalAlignment,
style::{HeightMode, TextBoxStyleBuilder},
TextBox,
};
fn main() {
// Example text sprinkled with special characters. Note that the first "supports" word will not
// be displayed because it will be overdrawn by the carriage return.
let text = "Hello, World!\n\
embedded-text supports\rcarriage return.\n\
Non-breaking spaces\u{A0}are also supported.\n\
Also\u{200B}supports\u{200B}Zero\u{200B}Width\u{200B}Spaces \
as well as so\u{AD}ft hy\u{AD}phens";
// Specify the styling options:
// * Use the 6x10 MonoFont from embedded-graphics.
// * Draw the text fully justified.
// * Use `FitToText` height mode to stretch the text box to the exact height of the text.
// * Draw the text with `BinaryColor::On`, which will be displayed as light blue.
// * Draw the text with `BinaryColor::Off` background color, which will be rendered as dark
// blue. This is used to overwrite parts of the text in this example.
let character_style = MonoTextStyleBuilder::new()
.font(&FONT_6X10)
.text_color(BinaryColor::On)
.background_color(BinaryColor::Off)
.build();
let textbox_style = TextBoxStyleBuilder::new()
.alignment(HorizontalAlignment::Justified)
.height_mode(HeightMode::FitToText)
.build();
// Specify the bounding box. Note the 0px height. The `FitToText` height mode will
// measure and adjust the height of the text box in `into_styled()`.
let bounds = Rectangle::new(Point::zero(), Size::new(129, 0));
// Create the text box and apply styling options.
let text_box = TextBox::with_textbox_style(text, bounds, character_style, textbox_style);
// Create a simulated display with the dimensions of the text box.
let mut display = SimulatorDisplay::new(text_box.bounding_box().size);
// Draw the text box.
text_box.draw(&mut display).unwrap();
// Set up the window and show the display's contents.
let output_settings = OutputSettingsBuilder::new()
.theme(BinaryColorTheme::OledBlue)
.scale(2)
.build();
Window::new("Special characters demonstration", &output_settings).show_static(&display);
}