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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
//! Board cell.
use std::rc::Rc;
use unicode_segmentation::UnicodeSegmentation;
use termion::{style, cursor, color};
use crate::board::ResourceTable;
const RESOURCE_TABLE_ERR_MSG: &'static str =
"If you use Cell::ResourceId, you must add resource table to Board.";
/// Cell content.
#[derive(Clone)]
pub enum Cell {
/// Empty cell. It will be filled with spaces.
Empty,
/// Resource id. Content is stored in [`ResourceTable`](../board/type.ResourceTable.html).
/// If you use this cell type, you must add resource table to board.
ResourceId(u16),
/// Char (Unicode code point). If cell size is more than 1x1, the cell will be filled with
/// this character.
Char(char),
/// Arbitrary string. String will be written into cell by rows.
///
/// You can use [escape sequences]. Termion provides `termion::style` and `termion::color` for
/// this. You don't have to reset style at the end, it'll be done automatically.
///
/// # Implementation note
///
/// If you use [`Cursor`], do not use `termion::style::Reset` and `termion::color::Bg` inside
/// string. It will break cursor highlighting, because it uses `termion::color::Bg` as well
/// and they will overlap.
///
/// [escape sequences]: https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_(Select_Graphic_Rendition)_parameters
/// [`Cursor`]: ../cursor/struct.Cursor.html
///
/// # Examples
///
/// ```no_run
/// use termion::{style, color};
///
/// fn create_resources() -> ResourceTable {
/// let mut res = ResourceTable::new();
/// res.insert(0, String::from(" OO O O OO "));
/// res.insert(1, String::from(" X X XX X X "));
/// res
/// }
///
/// let cursor = Cursor::new(color::Rgb(0, 0, 200), Position(0, 0), true, None);
/// let mut board = Board::new(3, 3, 6, 3, true, Some(create_resources()));
/// board.init_from_vec(
/// &vec![
/// Cell::Empty,
/// Cell::ResourceId(0),
/// Cell::ResourceId(1),
/// Cell::Char('z'),
/// Cell::Char('▒'),
/// Cell::Content(
/// format!("{}aaaaaaaa{}aaaaaaaaaa",
/// color::Fg(color::Red),
/// color::Fg(color::Blue))
/// ),
/// // this cell breaks cursor highlighting
/// Cell::Content(
/// format!("{}bbb{}bbbbb{}bbbb{}bbb{}bbb",
/// color::Fg(color::Red),
/// style::Bold,
/// style::Reset,
/// color::Fg(color::Blue),
/// style::Reset)
/// ),
/// // this cell breaks cursor highlighting
/// Cell::Content(
/// format!("{}cccccccccccc{}cccccc",
/// color::Bg(color::Red),
/// style::Reset)
/// ),
/// Cell::Content(
/// format!("{}dddddddd{}dddddddddd",
/// color::Fg(color::Red),
/// style::Bold)
/// )],
/// Some(cursor));
/// ```
Content(String),
}
impl Cell {
// Add cell content to string.
pub(crate) fn add_value_to_str(&self, dst: &mut String,
resources: Rc<Option<ResourceTable>>) {
match self {
Cell::Empty => dst.push(' '),
Cell::Char(c) => dst.push(*c),
Cell::ResourceId(id) => {
if let Some(rt) = resources.as_ref() {
let content = &rt[id];
dst.push_str(&format!("{}{}", content, style::Reset));
} else {
panic!(RESOURCE_TABLE_ERR_MSG);
}
},
Cell::Content(content) => dst.push_str(&format!("{}{}", content, style::Reset))
};
}
// Get formatted cell content ready to display in terminal.
pub(crate) fn get_content(&self, width: usize, height: usize, x: u16, y: u16,
resources: Rc<Option<ResourceTable>>) -> String {
match self {
Cell::Empty => Cell::prepare_str_from_char(' ', width, height, x, y),
Cell::Char(c) => Cell::prepare_str_from_char(*c, width, height, x, y),
Cell::ResourceId(id) => {
if let Some(rt) = resources.as_ref() {
let content = &rt[id];
Cell::prepare_str(content, width, height, x, y)
} else {
panic!(RESOURCE_TABLE_ERR_MSG);
}
},
Cell::Content(content) => Cell::prepare_str(content, width, height, x, y)
}
}
// Create new cell from this one by adding background color. Used by Cursor.
pub(crate) fn with_bg_color(&self, width: usize, height: usize,
resources: Rc<Option<ResourceTable>>,
bg_color: color::Rgb) -> Cell {
match self {
Cell::Empty =>
Cell::Content(
format!("{}{}", color::Bg(bg_color), ' '.to_string().repeat(width * height))),
Cell::Char(c) =>
Cell::Content(
format!("{}{}", color::Bg(bg_color), (*c).to_string().repeat(width * height))),
Cell::ResourceId(id) => {
if let Some(rt) = resources.as_ref() {
let content = &rt[id];
Cell::Content(format!("{}{}", color::Bg(bg_color), content))
} else {
panic!(RESOURCE_TABLE_ERR_MSG);
}
},
Cell::Content(content) => Cell::Content(format!("{}{}", color::Bg(bg_color), content))
}
}
// Fill cell with char and add Goto sequences.
fn prepare_str_from_char(content: char, width: usize, height: usize,
x: u16, y: u16) -> String {
let mut y = y;
let mut res = String::with_capacity(width * height * 2);
for _ in 0..height {
res.push_str(
&format!("{}{}", cursor::Goto(x, y), content.to_string().repeat(width)));
y += 1;
}
res
}
// Split cell content string into lines and add Goto sequences. Add style reset at the end.
fn prepare_str(content: &str, width: usize, height: usize, x: u16, y: u16) -> String {
const CSI_SGR_START: char = '\x1b';
const CSI_SGR_END: char = 'm';
let mut res = String::with_capacity(content.len() * 2);
// Set cursor to cell top left corner
res.push_str(&cursor::Goto(x, y).to_string());
let mut line_start = 0;
let mut ch_count = 0;
let mut is_csi = false;
let mut y = y;
let mut height = height;
for (i, ch) in UnicodeSegmentation::grapheme_indices(content, true) {
if ch.as_bytes()[0] as char == CSI_SGR_START {
is_csi = true;
} else if is_csi && ch.as_bytes()[0] as char == CSI_SGR_END {
is_csi = false;
} else if !is_csi {
ch_count += 1;
if ch_count == width {
res.push_str(&content[line_start..i + ch.len()]);
ch_count = 0;
line_start = i + ch.len();
y += 1;
height -= 1;
if height > 0 {
res.push_str(&cursor::Goto(x, y).to_string());
} else {
break;
}
}
}
}
// Reset all styles at the end
res.push_str(&style::Reset.to_string());
res
}
}