lb 0.6.0

A TUI library with ASCII/Unicode graphics.
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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

use std::io;

use crate::mat;

pub mod key;
pub use key::{Key, Keys, ReadKeys};

pub struct Raw {
    fd: libc::c_int,
    backup: libc::termios,
}

impl Raw {
    #[inline]
    fn new() -> io::Result<Self> {
        let fd = libc::STDOUT_FILENO;

        let mut termios = c::getattr(fd)?;
        let backup = termios;

        c::makeraw(&mut termios);

        c::setattr(fd, &termios)?;

        Ok(Raw { fd, backup })
    }
}

impl Drop for Raw {
    #[inline]
    fn drop(&mut self) {
        _ = c::setattr(self.fd, &self.backup);
    }
}

#[inline]
pub fn uncook() -> io::Result<Raw> {
    Raw::new()
}

#[inline]
pub fn size() -> io::Result<mat::Size> {
    let winsize = c::winsize()?;
    Ok((winsize.ws_col as usize, winsize.ws_row as usize).into())
}

#[inline]
pub fn size_in_pixels() -> io::Result<mat::Size> {
    let winsize = c::winsize()?;
    Ok((winsize.ws_xpixel as usize, winsize.ws_ypixel as usize).into())
}

#[inline]
pub fn glyph_aspect_ratio() -> io::Result<f32> {
    let size = size()?;
    let size_px = size_in_pixels()?;

    Ok((size.height as f32 / size.width as f32) * (size_px.width as f32 / size_px.height as f32))
}

mod c {
    use std::io;
    use std::mem;

    #[inline]
    pub fn getattr(fd: libc::c_int) -> io::Result<libc::termios> {
        unsafe {
            let mut termios = mem::zeroed();
            libc::tcgetattr(fd, &mut termios).to_result()?;
            Ok(termios)
        }
    }

    #[inline]
    pub fn setattr(fd: libc::c_int, termios: &libc::termios) -> io::Result<()> {
        unsafe {
            libc::tcsetattr(fd, libc::TCSANOW, termios).to_result()?;
            Ok(())
        }
    }

    #[inline]
    pub fn makeraw(termios: &mut libc::termios) {
        unsafe {
            libc::cfmakeraw(termios);
        }

        termios.c_cc[libc::VMIN] = 0;
        termios.c_cc[libc::VTIME] = 0;
    }

    #[inline]
    pub fn winsize() -> io::Result<libc::winsize> {
        unsafe {
            let mut winsize: libc::winsize = mem::zeroed();
            libc::ioctl(libc::STDOUT_FILENO, libc::TIOCGWINSZ, &mut winsize).to_result()?;
            Ok(winsize)
        }
    }

    trait ToResult: Sized {
        fn to_result(self) -> io::Result<Self>;
    }

    impl ToResult for libc::c_int {
        #[inline]
        fn to_result(self) -> io::Result<Self> {
            if self < 0 {
                Err(io::Error::last_os_error())
            } else {
                Ok(self)
            }
        }
    }
}