tachyonfx 0.25.0

A ratatui library for creating shader-like effects in TUIs.
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

use alloc::boxed::Box;

use ratatui_core::{
    buffer::Buffer,
    layout::{Position, Rect},
};

use crate::{default_shader_impl, shader::Shader, CellFilter, ColorCache, Duration};

#[derive(Clone, Default, Debug)]
pub(super) struct Ansi256 {
    area: Option<Rect>,
}

impl Shader for Ansi256 {
    default_shader_impl!(area, clone);

    fn name(&self) -> &'static str {
        "term256_colors"
    }

    fn process(&mut self, _duration: Duration, buf: &mut Buffer, area: Rect) -> Option<Duration> {
        let mut color_cache: ColorCache<(), 4> = ColorCache::new();

        let safe_area = area.intersection(buf.area);
        for y in area.top()..safe_area.bottom() {
            for x in area.left()..safe_area.right() {
                let cell = buf.cell_mut(Position::new(x, y))?;
                let fg = color_cache.memoize_fg(cell.fg, (), |c| {
                    #[allow(deprecated)]
                    crate::color_ext::AsIndexedColor::as_indexed_color(c)
                });
                let bg = color_cache.memoize_bg(cell.bg, (), |c| {
                    #[allow(deprecated)]
                    crate::color_ext::AsIndexedColor::as_indexed_color(c)
                });

                cell.set_fg(fg);
                cell.set_bg(bg);
            }
        }

        None
    }

    fn done(&self) -> bool {
        false
    }

    fn filter(&mut self, _strategy: CellFilter) {}

    fn reset(&mut self) {}

    #[cfg(feature = "dsl")]
    fn to_dsl(&self) -> Result<crate::dsl::EffectExpression, crate::dsl::DslError> {
        crate::dsl::EffectExpression::parse("fx::term256_colors()")
    }
}

#[cfg(test)]
#[cfg(feature = "dsl")]
mod tests {
    use crate::fx;

    #[test]
    #[allow(deprecated)]
    fn to_dsl() {
        let dsl = fx::term256_colors().to_dsl().unwrap().to_string();
        assert_eq!(dsl, "fx::term256_colors()");
    }
}