TERMINAL GRAPHICS

> PLAY SNAKE

Everything on this screen is drawn by the library: each frame a Rust program fills a Display with Container, Rect, Text and Graphics, and this page only paints the cells. Click the screen, then use the arrow keys or WASD. ENTER starts.

< ^ v > ENTER

> WHAT IT IS GOOD AT

+--------------------------------------------------------------+
| A Display is a grid of Pixels: a char, a fg and a bg colour. |
| Draw into it, then print it. Output is plain ANSI codes.     |
+--------------------------------------------------------------+

• No dependencies. The crate and its tests are 100% Rust, nothing else is pulled in.
• Small API. Display, Graphic, Graphics, Container, Text, Rect and Ball. Implement Graphic to draw your own shapes.
• Flicker free animation. Each frame is redrawn in place. Graphics keeps named graphics and draws them in order.
• Colour. The 16 ANSI colours, plus Colour::from_rgb to pick the nearest one for gradients.
• Safe by design. Anything off screen is clipped, and nothing panics or hangs on bad coordinates.
• Easy to test. Display::render and write_to give you the output as a string or on any writer.

> HELLO, TERMINAL

use terminal_graphics::{Colour, Container, Display, Graphic, Text};

fn main() -> std::io::Result<()> {
    // A 40 column by 10 row display.
    let mut display = Display::new(40, 10);
    display.reserve_space()?;

    // A bordered box holding some text.
    let container = Container::new(5, 2, 24, 5, Colour::BrightGreen, Colour::Blue)
        .with_content(Text::new(1, 1, "Hello, terminal!", Colour::BrightYellow, Colour::Blue));

    container.draw(&mut display);
    display.print()
}

Run the full animated tour yourself with cargo run --example demo.

> THE PALETTE

> LINKS

• GitHub repository - source, issues, changelog
• crates.io/crates/terminal_graphics
• docs.rs/terminal_graphics - API documentation