embedded-text

TextBox for embedded-graphics.

This crate provides a configurable TextBox to render multiline text inside a bounding Rectangle using [embedded-graphics].

TextBox supports the common text alignments: - Horizontal: - LeftAligned - RightAligned - CenterAligned - Justified - Vertical: - TopAligned - CenterAligned - BottomAligned

TextBox also supports some special characters not handled by embedded-graphics' Text: - non-breaking space (\u{200b}) - zero-width space (\u{a0}) - soft hyphen (\u{ad}) - carriage return (\r)

Example

The examples are based on [the embedded-graphics simulator]. The simulator is built on top of SDL2. See the [simulator README] for more information.

```rust use embeddedgraphics::{fonts::Font6x8, pixelcolor::BinaryColor, prelude::*}; use embeddedgraphicssimulator::{ BinaryColorTheme, OutputSettingsBuilder, SimulatorDisplay, Window, }; use embeddedtext::prelude::*;

fn main() -> Result<(), core::convert::Infallible> { let text = "Hello, World!\nLorem Ipsum is simply dummy text of the printing and typesetting \ industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when \ an unknown printer took a galley of type and scrambled it to make a type specimen book.";

let textbox_style = TextBoxStyleBuilder::new(Font6x8)
    .alignment(CenterAligned)
    .height_mode(FitToText)
    .text_color(BinaryColor::On)
    .build();

let text_box = TextBox::new(text, Rectangle::new(Point::zero(), Point::new(128, 0)))
    .into_styled(textbox_style);

// Create a window just tall enough to fit the text.
let mut display: SimulatorDisplay<BinaryColor> = SimulatorDisplay::new(text_box.size());
text_box.draw(&mut display).unwrap();

let output_settings = OutputSettingsBuilder::new()
    .theme(BinaryColorTheme::OledBlue)
    .build();
Window::new("Hello center aligned TextBox", &output_settings).show_static(&display);
Ok(())

} ```

Development setup

Minimum supported Rust version

The minimum supported Rust version for embedded-text is 1.40.0 or greater. Ensure you have the latest stable version of Rust installed, preferably through https://rustup.rs.

Installation

For setup in general, follow the installation instructions for [embedded-graphics].

To install SDL2 on Windows, see https://github.com/Rust-SDL2/rust-sdl2#windows-msvc

Attribution

The example text is copied from https://www.lipsum.com