tui-big-text

tui-big-text is a rust crate that renders large pixel text as a Ratatui widget using the glyphs from the font8x8 crate.

Hello World example

Installation

cargo add ratatui tui-big-text

Usage

Create a BigText widget using BigTextBuilder and pass it to Frame::render_widget to render be rendered. The builder allows you to customize the Style of the widget and the PixelSize of the glyphs. The PixelSize can be used to control how many character cells are used to represent a single pixel of the 8x8 font.

Example

use anyhow::Result;
use ratatui::prelude::*;
use tui_big_text::{BigTextBuilder, PixelSize};

fn render(frame: &mut Frame) -> Result<()> {
    let big_text = BigTextBuilder::default()
        .pixel_size(PixelSize::Full)
        .style(Style::new().blue())
        .lines(vec![
            "Hello".red().into(),
            "World".white().into(),
            "~~~~~".into(),
        ])
        .build()?;
    frame.render_widget(big_text, frame.size());
    Ok(())
}

License

This project is licensed under either of

Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.