minui 0.2.1

A minimalist Rust framework for TUIs and terminal games.
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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198

//! Demonstrates the RGB color capabilities with beautiful gradients and color transitions.

use minui::{Color, ColorPair, Event, Result, TerminalWindow, Window, define_colors};

// Define some custom RGB color schemes
define_colors! {
    // Sunset theme
    pub const SUNSET_ORANGE = (Color::rgb(255, 165, 0), Color::Black);
    pub const SUNSET_RED = (Color::rgb(255, 69, 0), Color::Black);
    pub const SUNSET_PURPLE = (Color::rgb(148, 0, 211), Color::Black);

    // Ocean theme
    pub const OCEAN_DEEP = (Color::rgb(0, 105, 148), Color::Black);
    pub const OCEAN_MEDIUM = (Color::rgb(0, 191, 255), Color::Black);
    pub const OCEAN_LIGHT = (Color::rgb(173, 216, 230), Color::Black);

    // Forest theme
    pub const FOREST_DARK = (Color::rgb(34, 139, 34), Color::Black);
    pub const FOREST_BRIGHT = (Color::rgb(124, 252, 0), Color::Black);

    // Neon theme
    pub const NEON_PINK = (Color::rgb(255, 20, 147), Color::Black);
    pub const NEON_CYAN = (Color::rgb(0, 255, 255), Color::Black);
    pub const NEON_GREEN = (Color::rgb(57, 255, 20), Color::Black);
}

/// Example showing RGB colors, gradients, and custom color schemes.
///
/// This example demonstrates:
/// 1. Creating RGB colors with custom values
/// 2. Generating smooth color gradients
/// 3. Using predefined color schemes
/// 4. Creating visual effects with colors
fn main() -> Result<()> {
    let mut window = TerminalWindow::new()?;
    window.set_auto_flush(false);
    window.clear_screen()?;

    let (width, height) = window.get_size();

    // Title
    window.write_str(0, 0, "RGB Color & Gradient Demo (press 'q' to quit)")?;

    // --- All drawing calls happen here ---
    draw_rainbow_gradient(&mut window, 2, width)?;
    draw_color_themes(&mut window, 6)?;
    draw_vertical_gradient(&mut window, 12, width, height)?;
    draw_color_blocks(&mut window, height)?;

    window.flush()?;

    // Wait for 'q' to be pressed before exiting
    loop {
        if let Ok(event) = window.get_input() {
            if let Event::Character('q') = event {
                break;
            }
        }
    }

    Ok(())
}

fn draw_rainbow_gradient(window: &mut TerminalWindow, start_y: u16, width: u16) -> Result<()> {
    window.write_str(start_y, 0, "Rainbow Gradient:")?;

    let gradient_y = start_y + 1;
    let gradient_width = (width - 2).min(60); // Limit width for better display

    for x in 0..gradient_width {
        // Create a rainbow effect by cycling through hue
        let hue = (x as f32 / gradient_width as f32) * 360.0;
        let (r, g, b) = hsl_to_rgb(hue, 1.0, 0.5);

        let color = ColorPair::new(Color::rgb(r, g, b), Color::Black);
        window.write_str_colored(gradient_y, x + 1, "█", color)?;
    }

    Ok(())
}

fn draw_color_themes(window: &mut TerminalWindow, start_y: u16) -> Result<()> {
    window.write_str(start_y, 0, "Color Themes:")?;

    // Sunset theme
    window.write_str(start_y + 1, 0, "Sunset: ")?;
    window.write_str_colored(start_y + 1, 8, "█████", SUNSET_ORANGE)?;
    window.write_str_colored(start_y + 1, 13, "█████", SUNSET_RED)?;
    window.write_str_colored(start_y + 1, 18, "█████", SUNSET_PURPLE)?;

    // Ocean theme
    window.write_str(start_y + 2, 0, "Ocean:  ")?;
    window.write_str_colored(start_y + 2, 8, "█████", OCEAN_DEEP)?;
    window.write_str_colored(start_y + 2, 13, "█████", OCEAN_MEDIUM)?;
    window.write_str_colored(start_y + 2, 18, "█████", OCEAN_LIGHT)?;

    // Forest theme
    window.write_str(start_y + 3, 0, "Forest: ")?;
    window.write_str_colored(start_y + 3, 8, "█████", FOREST_DARK)?;
    window.write_str_colored(start_y + 3, 13, "█████", FOREST_BRIGHT)?;

    // Neon theme
    window.write_str(start_y + 4, 0, "Neon:   ")?;
    window.write_str_colored(start_y + 4, 8, "█████", NEON_PINK)?;
    window.write_str_colored(start_y + 4, 13, "█████", NEON_CYAN)?;
    window.write_str_colored(start_y + 4, 18, "█████", NEON_GREEN)?;

    Ok(())
}

fn draw_vertical_gradient(
    window: &mut TerminalWindow,
    start_y: u16,
    width: u16,
    height: u16,
) -> Result<()> {
    if start_y + 10 > height {
        return Ok(()); // Not enough space
    }

    window.write_str(start_y, 0, "Vertical Blue-to-Red Gradient:")?;

    let gradient_height = (height - start_y - 2).min(8);
    let gradient_width = (width - 2).min(30);

    for y in 0..gradient_height {
        let ratio = y as f32 / gradient_height as f32;

        // Interpolate from blue to red
        let r = (ratio * 255.0) as u8;
        let g = 0;
        let b = ((1.0 - ratio) * 255.0) as u8;

        let color = ColorPair::new(Color::rgb(r, g, b), Color::Black);

        for x in 0..gradient_width {
            window.write_str_colored(start_y + 1 + y, x + 1, "█", color)?;
        }
    }

    Ok(())
}

fn draw_color_blocks(window: &mut TerminalWindow, height: u16) -> Result<()> {
    let start_y = height.saturating_sub(6);

    window.write_str(start_y, 0, "RGB Color Examples:")?;

    // Show some specific RGB values with labels
    let colors = [
        (Color::rgb(255, 0, 0), "Pure Red (255,0,0)"),
        (Color::rgb(0, 255, 0), "Pure Green (0,255,0)"),
        (Color::rgb(0, 0, 255), "Pure Blue (0,0,255)"),
        (Color::rgb(255, 255, 0), "Yellow (255,255,0)"),
        (Color::rgb(255, 0, 255), "Magenta (255,0,255)"),
        (Color::rgb(0, 255, 255), "Cyan (0,255,255)"),
    ];

    for (i, (color, label)) in colors.iter().enumerate() {
        let y = start_y + 1 + (i as u16 / 3);
        let x = (i % 3) * 25;

        let color_pair = ColorPair::new(*color, Color::Black);
        window.write_str_colored(y, x as u16, "███", color_pair)?;
        window.write_str(y, x as u16 + 4, label)?;
    }

    Ok(())
}

/// Convert HSL (Hue, Saturation, Lightness) to RGB
/// This helps create smooth color gradients
fn hsl_to_rgb(h: f32, s: f32, l: f32) -> (u8, u8, u8) {
    let h = h / 60.0;
    let c = (1.0 - (2.0 * l - 1.0).abs()) * s;
    let x = c * (1.0 - (h % 2.0 - 1.0).abs());
    let m = l - c / 2.0;

    let (r_prime, g_prime, b_prime) = if h < 1.0 {
        (c, x, 0.0)
    } else if h < 2.0 {
        (x, c, 0.0)
    } else if h < 3.0 {
        (0.0, c, x)
    } else if h < 4.0 {
        (0.0, x, c)
    } else if h < 5.0 {
        (x, 0.0, c)
    } else {
        (c, 0.0, x)
    };

    let r = ((r_prime + m) * 255.0) as u8;
    let g = ((g_prime + m) * 255.0) as u8;
    let b = ((b_prime + m) * 255.0) as u8;

    (r, g, b)
}