devela 0.28.0

A development substrate of coherence.
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

// devela::sys::os::term::grid::impls::text
//
//! Text writing operations for [`TermGrid`].
//

use crate::{Position2, TermGrid, TermPen, Termel};

/// # Text drawing
#[rustfmt::skip]
impl<S: Copy, C: Copy, D> TermGrid<Termel<char, S, C>, D>
where D: AsRef<[Termel<char, S, C>]> + AsMut<[Termel<char, S, C>]> {
    /// Writes width-one Unicode scalars horizontally at `position`.
    ///
    /// Writing stops at the right grid edge. No wrapping, line-break handling,
    /// grapheme segmentation, or terminal-width calculation is performed.
    ///
    /// Returns the number of cells written.
    pub fn write_str_at(&mut self, position: Position2<usize>, text: &str, pen: TermPen<S, C>)
        -> usize {
        let [x, y] = position.dim;
        if x >= self.width() || y >= self.height() { return 0; }
        let row = self.row_mut(y).unwrap();
        let available = row.len() - x;
        let mut written = 0;
        for ch in text.chars().take(available) {
            if matches!(ch, '\r' | '\n') { break; }
            row[x + written] = pen.termel(ch);
            written += 1;
        }
        written
    }

    /// Writes width-one Unicode scalars horizontally at `(x, y)`.
    ///
    /// Returns the number of cells written.
    pub fn write_str_xy(&mut self, x: usize, y: usize, text: &str, pen: TermPen<S, C>) -> usize {
        self.write_str_at(Position2::new([x, y]), text, pen)
    }
}