tinybit 0.3.0

terminal drawing / game library
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

use crate::{Pixel, ScreenPos, ScreenSize};

/// Character buffer holds all the "pixels" to be drawn on the screen
#[derive(Debug)]
pub struct PixelBuffer {
    /// Pixels
    pub pixels: Vec<Option<Pixel>>,
    size: ScreenSize,
}

impl PixelBuffer {
    /// Create a new character buffer.
    /// Should be at least the same size as the viewport it's relative to
    pub fn new(size: ScreenSize) -> Self {
        let cap = (size.width * size.height) as usize;
        let pixels = vec![None; cap];
        Self { pixels, size }
    }

    /// Convert index to x y coordinates
    pub fn index_to_coords(&self, index: usize) -> ScreenPos {
        let x = index % self.size.width as usize;
        let y = index / self.size.width as usize;
        ScreenPos::new(x as u16, y as u16)
    }

    /// Get the pixel at the given screen position
    pub fn get_pixel(&self, pos: ScreenPos) -> Option<Pixel> {
        let index = (self.size.width * pos.y + pos.x) as usize;
        match self.pixels.get(index) {
            Some(c) => *c,
            None => None,
        }
    }

    pub(crate) fn set_pixel(&mut self, pixel: Pixel) {
        let index = (self.size.width * pixel.pos.y + pixel.pos.x) as usize;
        if let Some(Some(existing_pixel)) = self.pixels.get(index) {
            if existing_pixel.glyph == pixel.glyph
                && existing_pixel.fg_color == pixel.fg_color
                && existing_pixel.bg_color == pixel.bg_color
            {
                return;
            }
        }
        self.pixels[index] = Some(pixel);
    }
}