simpleterm 0.2.5

A bespoke fake terminal written in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

use piston_window::{*, types::{Color, FontSize}};
use crate::{text::*, TEXT_OFFSET};

/// Displays a box around the text of the terminal, using the terminal's current colors and size.
/// Also draws scanlines on the terminal background.
pub fn draw_background(win_size: Size, bgc: Color, fgc: Color, lines: bool, context: Context, graphics: &mut G2d) {
    rectangle(fgc, [10.0, 10.0, win_size.width - 20.0, win_size.height - 20.0], context.transform, graphics);
    rectangle(bgc, [15.0, 15.0, win_size.width - 30.0, win_size.height - 30.0], context.transform, graphics);

    if lines {
        let line_color: Color = if fgc.brighter_than(bgc) {
            [bgc[0] - 0.2, bgc[1] - 0.2, bgc[2] - 0.2, 0.5]
        } else {
            [bgc[0] + 0.15, bgc[1] + 0.15, bgc[2] + 0.15, 0.4]
        };
        
        for i in 0..((win_size.height - 30.0) as i32 / 3) {
            rectangle(line_color, [15.0, (i * 3) as f64 + 15.0, win_size.width - 30.0, 0.5], context.transform, graphics);
        }
    }
}

/// Draws art centered on the terminal. If the art is bigger than the terminal can display, you'll only see the center portion of it.
pub fn draw_art(win_size: Size, art: &[String], glyphs: &mut Glyphs, font_size: FontSize, fgc: Color, context: Context, graphics: &mut G2d) {
    let (x, y): (f64, f64) = place_art(win_size, art, font_size);

    let mut y_offset: f64 = 0.0;
    for line in art.iter() {
        text::Text::new_color(fgc, font_size).draw(
            line,
            glyphs,
            &context.draw_state,
            context.transform.trans(x, y + y_offset),
            graphics,
        ).unwrap();

        y_offset += (font_size as f64) * 0.8;
    }
}

/// Draws text starting at the top of the terminal, using the terminal's current foreground color, font, and font size.
pub fn draw_message(message: &[String], glyphs: &mut Glyphs, font_size: FontSize, fgc: Color, context: Context, graphics: &mut G2d)  {
    let x = TEXT_OFFSET.0;
    let y = TEXT_OFFSET.1;

    let mut y_offset: f64 = 0.0;
    for line in message.iter() {
        text::Text::new_color(fgc, font_size).draw(
            line,
            glyphs,
            &context.draw_state,
            context.transform.trans(x, y + y_offset),
            graphics,
        ).unwrap();

        y_offset += (font_size as f64) * 0.8;
    }
}

/// Displays a marker before the input string at the bottom fo the terminal, using the terminal's current foreground color, font, and font size.
pub fn draw_input_marker(win_size: Size, glyphs: &mut Glyphs, font_size: FontSize, fgc: Color, context: Context, graphics: &mut G2d) {
    let x = TEXT_OFFSET.0;
    let y = (win_size.height - TEXT_OFFSET.1) + 20.0;

    text::Text::new_color(fgc, font_size).draw(
        "> ",
        glyphs,
        &context.draw_state,
        context.transform.trans(x, y),
        graphics,
    ).unwrap();
}

/// Displays the current input string at the bottom of the terminal, using the terminal's current foreground color, font, and font size.
pub fn draw_input(win_size: Size, message: &str, glyphs: &mut Glyphs, font_size: FontSize, fgc: Color, context: Context, graphics: &mut G2d)  {
    let x = TEXT_OFFSET.0 + 20.0;
    let y = (win_size.height - TEXT_OFFSET.1) + 20.0;

    text::Text::new_color(fgc, font_size).draw(
        message,
        glyphs,
        &context.draw_state,
        context.transform.trans(x, y),
        graphics,
    ).unwrap();
}

/// Displays scanlines over the terminal text and a border around the terminal box, using the terminal's current size and background color.
pub fn draw_foreground(win_size: Size, bgc: Color, lines: bool, context: Context, graphics: &mut G2d) {
    if lines {
        let line_color: Color = [bgc[0], bgc[1], bgc[2], 0.4];
        
        for i in 0..((win_size.height - 30.0) as i32 / 3) {
            rectangle(line_color, [15.0, (i * 3) as f64 + 15.0, win_size.width - 30.0, 0.5], context.transform, graphics);
        }
    }

    rectangle(bgc, [0.0, 0.0, win_size.width, 10.0], context.transform, graphics);
    rectangle(bgc, [0.0, 0.0, 10.0, win_size.height], context.transform, graphics);
    rectangle(bgc, [win_size.width - 10.0, 0.0, 10.0, win_size.height], context.transform, graphics);
    rectangle(bgc, [0.0, win_size.height - 10.0, win_size.width, 10.0], context.transform, graphics);
}