rocketsplash-rt

rocketsplash-rt is the runtime library for loading, managing, and rendering Rocketsplash assets. It enables Rust applications to easily display rich, colorful splash screens and banners in the terminal using the .rst and .rsf file formats. It supports splash-screen and large text font art.

Features

Zero-config Loading: Load splash screens and fonts with a single line of code.
Safe & Secure: Strict validation of input files to prevent allocation attacks or malformed data.
ANSI Rendering: High-performance rendering to standard ANSI escape sequences (TrueColor).
No Heavy Dependencies: Designed to be lightweight and embeddable.

Installation

cargo add rocketsplash-rt

Usage

Displaying a Splash Screen

use rocketsplash_rt::Splash;
use std::error::Error;

fn main() -> Result<(), Box<dyn Error>> {
    // Load a splash screen from a file
    let splash = Splash::load("assets/logo.rst")?;

    // Print it directly to stdout
    splash.print();

    Ok(())
}

Rendering to a String

If you need to embed the output into another TUI framework or log message:

let output = splash.to_string();
println!("{}", output);

Using Custom Fonts

use rocketsplash_rt::Font;

let font = Font::load("assets/custom-font.rsf")?;
let text = font.render("Hello World").to_string();
println!("{}", text);

rocketsplash-rt 0.2.1