tui-banner 0.2.0

Colorful ASCII art banner renderer for Rust CLI/TUI
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

// Copyright (c) 2025 Lei Zhang
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

use crate::color::Color;
use crate::grid::Grid;

/// Shadow configuration.
#[derive(Clone, Copy, Debug)]
pub struct Shadow {
    /// Shadow offset (dx, dy).
    pub offset: (i32, i32),
    /// Darken factor (0.0..1.0).
    pub alpha: f32,
}

/// Apply a drop shadow (darkened copy at offset).
pub fn apply_shadow(grid: &Grid, shadow: Shadow) -> Grid {
    let (dx, dy) = shadow.offset;
    if dx == 0 && dy == 0 {
        return grid.clone();
    }

    let extra_x = dx.max(0) as usize;
    let extra_y = dy.max(0) as usize;
    let mut out = Grid::new(grid.height() + extra_y, grid.width() + extra_x);
    out.blit(grid, 0, 0);

    for r in 0..grid.height() {
        for c in 0..grid.width() {
            let Some(cell) = grid.cell(r, c) else {
                continue;
            };
            if !cell.visible {
                continue;
            }
            let target_r = r as i32 + dy;
            let target_c = c as i32 + dx;
            if target_r < 0 || target_c < 0 {
                continue;
            }
            let target_r = target_r as usize;
            let target_c = target_c as usize;
            let Some(target) = out.cell_mut(target_r, target_c) else {
                continue;
            };
            if target.visible {
                continue;
            }

            target.visible = true;
            target.ch = cell.ch;
            target.fg = cell.fg.map(|color| darken(color, shadow.alpha));
        }
    }

    out
}

fn darken(color: Color, alpha: f32) -> Color {
    let factor = (1.0 - alpha.clamp(0.0, 1.0)).clamp(0.0, 1.0);
    match color {
        Color::Rgb(r, g, b) => Color::Rgb(
            (r as f32 * factor).round() as u8,
            (g as f32 * factor).round() as u8,
            (b as f32 * factor).round() as u8,
        ),
        other => other,
    }
}