libshimmer 1.0.1

Animated status lines for terminal UIs, paced by the host's work
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

//! Relay: an eight-bit shift register walks a local bus across the caption.

use super::DEEPSEEK;
use crate::kit::{AZURE, CYAN, ICE, STEEL, SUN, WHITE};
use crate::paint::{Ink, Palette};
use crate::recipe::{Glyphs, Recipe};
use crate::stage::{Canvas, Shader, Stage};

pub(super) const RECIPE: Recipe = Recipe {
    name: "Relay",
    blurb: "a relay register walks the bus",
    credit: DEEPSEEK,
    needs: Glyphs::BASE,
    summon: |_| Box::<Relay>::default(),
};

const SHIFT: u64 = 12;
const BUS_HALF_WIDTH: usize = 4;
const ARC: f64 = 0.36;

struct Relay {
    bits: u8,
    seen: u64,
    pulse: f64,
}

impl Default for Relay {
    fn default() -> Self {
        Self {
            bits: 1,
            seen: 0,
            pulse: -ARC,
        }
    }
}

impl Shader for Relay {
    fn tick(&mut self, stage: &Stage) {
        let target = stage.quanta / SHIFT;
        if !stage.busy() {
            self.seen = target;
            return;
        }
        while self.seen < target {
            self.seen += 1;
            let feedback = ((self.bits >> 7) ^ (self.bits >> 2)) & 1;
            let next = self.bits.wrapping_shl(1) | feedback;
            if next != self.bits {
                self.pulse = stage.t;
            }
            self.bits = next;
        }
    }

    fn status(&self, stage: &Stage, palette: Palette, canvas: &mut Canvas) {
        let busy = stage.busy();
        let grey = palette.grey(/*alpha*/ 0.6);
        let width = stage.caption.len();
        let head = if width == 0 {
            0
        } else {
            usize::try_from(stage.quanta / SHIFT).unwrap_or_default() % width
        };
        let arc = busy && stage.t - self.pulse < ARC;
        canvas.letters = stage.letters(|i, _| {
            let bit = (self.bits >> (i % 8)) & 1 == 1;
            let here = i == head;
            let near = i.abs_diff(head) <= BUS_HALF_WIDTH;
            let mut ink = Ink::default()
                .fg(if !busy {
                    grey
                } else if here {
                    WHITE
                } else if near && bit {
                    ICE
                } else {
                    grey
                })
                .bold(busy && (here || bit));
            if busy {
                if here {
                    ink = ink.bg(if arc { SUN } else { AZURE }.blend(palette.bg, /*alpha*/ 0.42));
                } else if near && bit {
                    ink = ink.bg(AZURE.blend(palette.bg, /*alpha*/ 0.13));
                }
            }
            ink
        });
        canvas.mark = (0..3)
            .map(|bit| {
                let on = (self.bits >> bit) & 1 == 1;
                Ink::of(if on { '●' } else { '○' })
                    .fg(if on { CYAN } else { STEEL })
                    .bold(busy && on)
            })
            .collect();
    }

    fn bullet(&self, stage: &Stage, palette: Palette) -> Ink {
        let busy = stage.busy();
        let arc = busy && stage.t - self.pulse < ARC;
        Ink::of(if arc { 'ϟ' } else { '⌁' })
            .fg(if busy {
                if arc { SUN } else { CYAN }
            } else {
                palette.grey(/*alpha*/ 0.6)
            })
            .bold(busy)
    }
}