andiskaz 0.2.0

A convenience library for writing games and other apps in 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
79
80
81
82
83
84
85
86

//! This module defines the screen (double) buffer and related items.

use crate::{coord, coord::Vec2, tile::Tile};
use std::collections::BTreeSet;

/// The (double) buffer of the buffer of a screen.
#[derive(Debug)]
pub struct ScreenBuffer {
    /// Width of the screen.
    width: usize,
    /// Whether this has a valid screen size.
    pub valid: bool,
    /// Old screen.
    pub old: Vec<Tile>,
    /// Currently editing screen.
    pub curr: Vec<Tile>,
    /// List of changed tiles.
    pub changed: BTreeSet<Vec2>,
}

impl ScreenBuffer {
    /// A blank screen.
    pub fn blank(size: Vec2) -> Self {
        let curr = vec![Tile::default(); coord::to_index(size.y * size.x)];
        let old = curr.clone();
        Self {
            width: coord::to_index(size.x),
            valid: true,
            curr,
            old,
            changed: BTreeSet::new(),
        }
    }

    /// Resizes the screen using the given size.
    pub fn resize(&mut self, size: Vec2) {
        let old_size = self.curr.len();
        let new_size = coord::to_index(size.y * size.x);
        let needs_clear = old_size.min(new_size);
        let default_tile = Tile::default();

        self.curr.resize(new_size, default_tile.clone());
        self.old.resize(new_size, default_tile.clone());

        for tile in &mut self.old[.. needs_clear] {
            *tile = default_tile.clone();
        }
        for tile in &mut self.curr[.. needs_clear] {
            *tile = default_tile.clone();
        }

        self.width = coord::to_index(size.x);
        self.changed.clear();
    }

    /// Advances the buffer in one tick. I.e., `old` is discarded, `curr`
    /// becomes both `curr` and `old`.
    pub fn next_tick(&mut self) {
        self.changed.clear();
        let (old, curr) = (&mut self.old, &self.curr);
        old.clone_from(curr);
    }

    /// Size of the buffer in coordinates.
    ///
    /// Must be in sync with [`Terminal::screen_size`].
    pub fn size(&self) -> Vec2 {
        Vec2 {
            y: coord::from_index(
                self.curr.len().checked_div(self.width).unwrap_or(0),
            ),
            x: coord::from_index(self.width),
        }
    }

    /// Makes an index from a coordinate.
    pub fn make_index(&self, point: Vec2) -> Option<usize> {
        let x = coord::to_index(point.x);
        let y = coord::to_index(point.y);
        if x >= self.width || self.curr.len() / self.width <= y {
            None
        } else {
            Some(y * self.width + x % self.width)
        }
    }
}