tui-big-text is a rust crate that renders large pixel text as a Ratatui widget using the glyphs from the font8x8 crate.
cargo add ratatui tui-big-text
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.
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(())
}
Copyright (c) 2023 Josh McKinney
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.
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.
See CONTRIBUTING.md.