coretilus 0.7.0

A parody of GNU Coreutils — a playful collection of typo-triggered command-line tools written in Rust
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

use crate::engine_v2::coords::Coords;
use crate::engine_v2::size::Size;

#[derive(Clone, Copy, Debug)]
pub enum XTermPosition {
    Coord(i32),
    LeftOut,
    LeftIn,
    Middle,
    RightOut,
    RightIn,
}

#[derive(Clone, Copy, Debug)]
pub enum YTermPosition {
    Coord(i32),
    BottomOut,
    BottomIn,
    Middle,
    TopOut,
    TopIn,
}

/// A position in terminal space, which can be a coordinate or a relative position.
/// ```rust
/// use coretilus::engine_v2::size::Size;
/// use coretilus::engine_v2::coords::Coords;
/// use coretilus::engine_v2::position::Position;
/// use coretilus::engine_v2::position::XTermPosition;
/// use coretilus::engine_v2::position::YTermPosition;
///
/// let position = Position::new(XTermPosition::Middle, YTermPosition::Middle, 0);
/// let terminal_size = Size::new(80, 24);
/// let sprite_size = Size::new(10, 5);
/// let resolved_coord = position.resolve(terminal_size, sprite_size);
/// assert_eq!(resolved_coord.x(), 35);
/// assert_eq!(resolved_coord.y(), 9);
///
/// let position = Position::new(XTermPosition::LeftIn, YTermPosition::BottomIn, 0);
/// let resolved_coord = position.resolve(terminal_size, sprite_size);
/// assert_eq!(resolved_coord.x(), 0);
/// assert_eq!(resolved_coord.y(), 0);
///
/// let position = Position::new(XTermPosition::RightOut, YTermPosition::TopOut, 0);
/// let resolved_coord = position.resolve(terminal_size, sprite_size);
/// assert_eq!(resolved_coord.x(), 80);
/// assert_eq!(resolved_coord.y(), 24);
///
/// let position = Position::new(XTermPosition::LeftOut, YTermPosition::BottomOut, 0);
/// let resolved_coord = position.resolve(terminal_size, sprite_size);
/// assert_eq!(resolved_coord.x(), -11);
/// assert_eq!(resolved_coord.y(), -6);
///
/// let position = Position::new(XTermPosition::RightIn, YTermPosition::TopIn, 0);
/// let resolved_coord = position.resolve(terminal_size, sprite_size);
/// assert_eq!(resolved_coord.x(), 70);
/// assert_eq!(resolved_coord.y(), 19);
///
/// ```
#[derive(Clone, Copy, Debug)]
pub struct Position {
    x: XTermPosition,
    y: YTermPosition,
    z: i32,
}

impl Position {
    pub fn new(x: XTermPosition, y: YTermPosition, z: i32) -> Self {
        Self { x, y, z }
    }

    pub fn resolve(&self, terminal_size: Size, sprite_size: Size) -> Coords {
        let x = match self.x {
            XTermPosition::Coord(n) => n,
            XTermPosition::LeftIn => 0,
            XTermPosition::LeftOut => -1 - sprite_size.width() as i32,
            XTermPosition::Middle => (terminal_size.width() - sprite_size.width()) as i32 / 2,
            XTermPosition::RightIn => (terminal_size.width() - sprite_size.width()) as i32,
            XTermPosition::RightOut => (terminal_size.width()) as i32,
        };
        let y = match self.y {
            YTermPosition::Coord(n) => n,
            YTermPosition::BottomIn => 0,
            YTermPosition::BottomOut => -1 - sprite_size.height() as i32,
            YTermPosition::Middle => (terminal_size.height() - sprite_size.height()) as i32 / 2,
            YTermPosition::TopIn => (terminal_size.height() - sprite_size.height()) as i32,
            YTermPosition::TopOut => terminal_size.height() as i32,
        };
        Coords::new(x, y, self.z)
    }
}