tui-big-text 0.8.8

A Ratatui widget for displaying big text in the terminal
Documentation
//! Demonstrates left, center, and right alignment for `BigText`.
//!
//! Run with `cargo run -p tui-big-text --example alignment`.
//!
//! Each widget receives the full row width for its section. The alignment methods change where the
//! rendered glyphs sit inside that area; they do not change the area Ratatui gives to the widget.
//!
//! Press `q` or `Esc` to quit.

use color_eyre::Result;
use crossterm::event::{self, KeyCode};
use ratatui::layout::{Constraint, Layout, Offset};
use ratatui::prelude::{Frame, Stylize};
use ratatui::text::Line;
use tui_big_text::{BigText, PixelSize};

fn main() -> Result<()> {
    color_eyre::install()?;
    ratatui::run(run)
}

fn run(terminal: &mut ratatui::DefaultTerminal) -> Result<()> {
    loop {
        terminal.draw(render)?;
        if let Some(key) = event::read()?.as_key_press_event()
            && matches!(key.code, KeyCode::Char('q') | KeyCode::Esc)
        {
            break Ok(());
        }
    }
}

fn render(frame: &mut Frame) {
    let title = Line::from("tui-big-text alignment demo. <q> quit")
        .cyan()
        .centered();

    let left = BigText::builder()
        .pixel_size(PixelSize::Quadrant)
        .left_aligned()
        .lines(vec!["Left".white().into()])
        .build();

    let right = BigText::builder()
        .pixel_size(PixelSize::Quadrant)
        .right_aligned()
        .lines(vec!["Right".green().into()])
        .build();

    let centered = BigText::builder()
        .pixel_size(PixelSize::Quadrant)
        .centered()
        .lines(vec!["Centered".red().into()])
        .build();

    let area = frame.area();
    frame.render_widget(title, area);

    let area = area.offset(Offset { x: 0, y: 2 }).intersection(area);
    let [top, middle, bottom] = Layout::vertical([Constraint::Length(4); 3]).areas(area);
    frame.render_widget(left, top);
    frame.render_widget(centered, middle);
    frame.render_widget(right, bottom);
}