Console Engine

This library provides simple features for handling user's input and display for terminal applications.
Besides the user input and display, this library also provides some tools to build standalone "screens" that can be used as simply as printing it.

It uses Crossterm as main tool for handling the screen and inputs. You don't have to worry about initalizing anything because the lib will handle this for you.

Features

Build custom terminal display using shapes or text
Terminal handling with a target frame per seconds
Keyboard and mouse support
Terminal resizing support
You are not interested by keyboard/mouse handling, even terminal handling ? You can still build "screens" that will just print its content.
Embedding screens to one another

Platforms

Since it uses crossterm, it should work on Windows, Linux and possibly Mac (see Tested Terminals on Crossterm's page).

example usage

ConsoleEngine (managing input & output)

use console_engine::pixel;
use console_engine::Color;
use console_engine::KeyCode;

fn main() {
    // initializes a screen of 20x10 characters with a target of 3 frames per second
    // coordinates will range from [0,0] to [19,9]
    let mut engine = console_engine::ConsoleEngine::init(20, 10, 3).unwrap();
    let value = 14;
    // main loop, be aware that you'll have to break it because ctrl+C is captured
    loop {
        engine.wait_frame(); // wait for next frame + capture inputs
        engine.clear_screen(); // reset the screen
    
        engine.line(0, 0, 19, 9, pixel::pxl('#')); // draw a line of '#' from [0,0] to [19,9]
        engine.print(0, 4, format!("Result: {}", value).as_str()); // prints some value at [0,4]
    
        engine.set_pxl(4, 0, pixel::pxl_fg('O', Color::Cyan)); // write a majestic cyan 'O' at [4,0]

        if engine.is_key_pressed(KeyCode::Char('q')) { // if the user presses 'q' :
            break; // exits app
        }
    
        engine.draw(); // draw the screen
    }
}

Screens (generating output)

use console_engine::screen::Screen;
use console_engine::pixel;

fn main() {
    // create a screen of 20x11 characters
    let mut scr = Screen::new(20,11);

    // draw some shapes and prints some text
    scr.rect(0,0, 19,10,pixel::pxl('#'));
    scr.fill_circle(5,5, 3, pixel::pxl('*'));
    scr.print(11,4, "Hello,");
    scr.print(11,5, "World!");

    // print the screen to the terminal
    scr.draw();
}

Documentation

Take a look at the generated documentation.

Examples

See examples :

drag-and-drop : Move a rectangle with your mouse
emojis : Display an emoji on the terminal
events : Example usage of the event polling method.
graph : Display a graph being generated with some values.
lines : Draw random lines of random colors on the screen.
lines-fps : Same example as lines, but with a FPS counter.
mouse : Simple mouse clicking test
screen-embed : Example usage of Screen's print_screen function to embed one screen into another
screen-extract : Example usage of Screen's extract function to extract part of a screen
screen-simple : Example usage of Screen struct instead of ConsoleEngine
screen-swap : Swap between several Screen structures
scroll : Example for the scroll function
shapes : Shape's functions testing tool
snake : A simple game of snake.
styled-rect : Example of the rect_border function
tetris : A game of Tetris

console_engine 2.1.0