rustty-oxide 0.1.0

An easy-to-use and extensible GUI library for Rust terminal applications using rustty
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

use rustty::{Pos, Size, HasSize, HasPosition};
use rustty::{CellAccessor, Cell};
use core::alignable::{Alignable};

/// The `Frame` struct is the building block for all future
/// widgets inside of Oxide. Objects of `Frame` abstract away
/// the actual creation and drawing of areas of a terminal,
/// because this process is the same for all widgets. Every
/// widget should contain one `Frame` type to be used to render
/// text to the screen
pub struct Frame {
    origin: Pos,
    size: Size,
    buf: Vec<Cell>,
}

impl Frame {
    /// Constructs a new Frame object with a width of `cols`
    /// and height of `rows`
    pub fn new(cols: usize, rows: usize) -> Frame {
        Frame {
            origin: (0, 0),
            size: (cols, rows),
            buf: vec![Cell::default(); cols * rows],
        }
    }

    /// Draw the buffer contained inside of the base object to 
    /// a valid object that implements CellAccessor.
    pub fn draw_into(&self, cells: &mut CellAccessor) {
        let (cols, rows) = self.size();
        let (x, y) = self.origin();
        for ix in 0..cols {
            let offset_x = x + ix;
            for iy in 0..rows {
                let offset_y = y + iy;
                match cells.get_mut(offset_x, offset_y) {
                    Some(cell) => { *cell = *self.get(ix, iy).unwrap(); },
                    None => (),
                }
            }
        }
    }

    pub fn resize(&mut self, new_size: Size) {
        let difference = (new_size.0 * self.size.0) - (new_size.1 * self.size.1);
        self.buf.extend(vec![Cell::default(); difference]);
        self.size = new_size;
    }
}

impl HasSize for Frame {
    fn size(&self) -> Size {
        self.size
    }
}

impl CellAccessor for Frame {
    fn cellvec(&self) -> &Vec<Cell> {
        &self.buf
    }

    fn cellvec_mut(&mut self) -> &mut Vec<Cell> {
        &mut self.buf
    }

}

impl HasPosition for Frame {
    fn origin(&self) -> Pos {
        self.origin
    }

    fn set_origin(&mut self, new_origin: Pos) {
        self.origin = new_origin;
    }
}

impl Alignable for Frame {}