termrs_core 0.3.0

The core library of termrs
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

use super::Color;
use std::io::Write;

use super::{Attributes, Position};

/// A context of drawing to some surface.
pub trait RenderContext {
    // methods for drawing to a two-dimensional
    // array of symbols.
    fn set_position(&mut self, position: Position) -> std::io::Result<()>;

    /// Render symbols to the current position.
    fn render_symbols(&mut self, symbols: &[u8]) -> std::io::Result<()>;

    fn set_background(&mut self, color: Color) -> std::io::Result<()>;
    fn set_foreground(&mut self, color: Color) -> std::io::Result<()>;
    fn set_attributes(&mut self, attributes: Attributes) -> std::io::Result<()>;
}

pub struct WriteContext<'a, W: Write> {
    write: &'a mut W,
}

impl<'a, W: Write> WriteContext<'a, W> {
    pub fn new(write: &'a mut W) -> Self {
        Self { write }
    }
}

impl<'a, W: Write> RenderContext for WriteContext<'a, W> {
    fn set_position(&mut self, position: Position) -> std::io::Result<()> {
        crossterm::queue!(
            self.write,
            crossterm::cursor::MoveTo(position.column, position.row)
        )
    }

    fn render_symbols(&mut self, symbols: &[u8]) -> std::io::Result<()> {
        self.write.write_all(symbols)
    }

    fn set_background(&mut self, color: Color) -> std::io::Result<()> {
        crossterm::queue!(self.write, crossterm::style::SetBackgroundColor(color))
    }

    fn set_foreground(&mut self, color: Color) -> std::io::Result<()> {
        crossterm::queue!(self.write, crossterm::style::SetForegroundColor(color))
    }

    fn set_attributes(&mut self, attributes: Attributes) -> std::io::Result<()> {
        crossterm::queue!(self.write, crossterm::style::SetAttributes(attributes))
    }
}