use crate::buffer::{Buffer, Cell};
use crate::layout::Rect;
use crate::theme::Theme;
use crate::widgets::selection::selection_colors;
pub struct Dial<'a> {
items: &'a [String],
selected: usize,
theme: Option<&'a Theme>,
}
impl<'a> Dial<'a> {
pub fn new(items: &'a [String], selected: usize) -> Self {
Dial {
items,
selected,
theme: None,
}
}
pub fn theme(mut self, theme: &'a Theme) -> Self {
self.theme = Some(theme);
self
}
pub fn render(&self, area: Rect, buf: &mut Buffer) {
let n = self.items.len();
if n == 0 || area.width == 0 || area.height == 0 {
return;
}
let cx = area.x as f32 + area.width as f32 / 2.0;
let cy = area.y as f32 + area.height as f32 / 2.0;
let radius_y = ((area.height as i32 / 2 - 1).max(1)) as f32;
let radius_x = (((radius_y as i32) * 2)
.min(area.width as i32 / 2 - 1)
.max(1)) as f32;
let angle_of = |i: usize| -> f32 {
i as f32 * std::f32::consts::TAU / n as f32 - std::f32::consts::FRAC_PI_2
};
let point_at = |angle: f32, rx: f32, ry: f32| -> (f32, f32) {
(cx + rx * angle.cos(), cy + ry * angle.sin())
};
for i in 0..n {
let a0 = angle_of(i);
let a1 = angle_of((i + 1) % n)
+ if i + 1 == n {
std::f32::consts::TAU
} else {
0.0
};
for step in 1..4 {
let t = step as f32 / 4.0;
let angle = a0 + (a1 - a0) * t;
let (x, y) = point_at(angle, radius_x, radius_y);
let (px, py) = (x.round() as i32, y.round() as i32);
if in_area(px, py, area) {
buf.set(
px as u16,
py as u16,
Cell {
symbol: '.',
alpha: 1.0,
..Default::default()
},
);
}
}
}
for (i, item) in self.items.iter().enumerate() {
let angle = angle_of(i);
let (x, y) = point_at(angle, radius_x, radius_y);
let (px, py) = (x.round() as i32, y.round() as i32);
let selected = i == self.selected;
let (fg, bg) = selection_colors(self.theme, selected);
let chars: Vec<char> = item.chars().collect();
if x >= cx {
for (offset, ch) in chars.iter().enumerate() {
let cell_x = px + offset as i32;
if in_area(cell_x, py, area) {
buf.set(
cell_x as u16,
py as u16,
Cell {
symbol: *ch,
fg,
bg,
alpha: 1.0,
..Default::default()
},
);
}
}
} else {
let len = chars.len() as i32;
for (offset, ch) in chars.iter().enumerate() {
let cell_x = px - (len - 1 - offset as i32);
if in_area(cell_x, py, area) {
buf.set(
cell_x as u16,
py as u16,
Cell {
symbol: *ch,
fg,
bg,
alpha: 1.0,
..Default::default()
},
);
}
}
}
if selected {
let (px2, py2) = point_at(angle, radius_x * 0.5, radius_y * 0.5);
let (ppx, ppy) = (px2.round() as i32, py2.round() as i32);
if in_area(ppx, ppy, area) {
buf.set(
ppx as u16,
ppy as u16,
Cell {
symbol: '*',
alpha: 1.0,
..Default::default()
},
);
}
}
}
}
}
fn in_area(x: i32, y: i32, area: Rect) -> bool {
x >= area.x as i32
&& x < area.x as i32 + area.width as i32
&& y >= area.y as i32
&& y < area.y as i32 + area.height as i32
}
#[cfg(test)]
mod tests {
use super::*;
use crate::buffer::Buffer;
use crate::widgets::test_support::test_theme;
use crossterm::style::Color;
#[test]
fn item_zero_lands_at_top_center_column() {
let items = vec!["A".to_string(), "B".to_string(), "C".to_string()];
let mut buf = Buffer::new(10, 8);
let area = Rect {
x: 0,
y: 0,
width: 10,
height: 8,
};
Dial::new(&items, 0).render(area, &mut buf);
assert_eq!(buf.get(5, 1).symbol, 'A');
}
#[test]
fn items_are_symmetric_left_and_right_for_odd_item_count() {
let items = vec!["A".to_string(), "B".to_string(), "C".to_string()];
let mut buf = Buffer::new(10, 8);
let area = Rect {
x: 0,
y: 0,
width: 10,
height: 8,
};
Dial::new(&items, 0).render(area, &mut buf);
assert_eq!(buf.get(8, 6).symbol, 'B');
assert_eq!(buf.get(2, 6).symbol, 'C');
}
#[test]
fn ring_dots_never_land_on_an_item_point() {
let items = vec!["A".to_string(), "B".to_string(), "C".to_string()];
let mut buf = Buffer::new(10, 8);
let area = Rect {
x: 0,
y: 0,
width: 10,
height: 8,
};
Dial::new(&items, 0).render(area, &mut buf);
assert_eq!(buf.get(7, 1).symbol, '.');
assert_eq!(buf.get(8, 3).symbol, '.');
assert_eq!(buf.get(9, 4).symbol, '.');
}
#[test]
fn selected_items_label_and_pointer_are_highlighted() {
let items = vec!["A".to_string(), "B".to_string(), "C".to_string()];
let mut buf = Buffer::new(10, 8);
let area = Rect {
x: 0,
y: 0,
width: 10,
height: 8,
};
Dial::new(&items, 0).render(area, &mut buf);
assert_eq!(buf.get(5, 1).fg, Color::Black);
assert_eq!(buf.get(5, 1).bg, Color::White);
assert_eq!(buf.get(5, 3).symbol, '*');
assert_eq!(buf.get(8, 6).bg, Color::Reset);
}
#[test]
fn labels_flow_outward_and_clip_at_area_edges() {
let items = vec![
"TOP".to_string(),
"RIGHT".to_string(),
"BOTTOM".to_string(),
"LEFT".to_string(),
];
let mut buf = Buffer::new(6, 4);
let area = Rect {
x: 0,
y: 0,
width: 6,
height: 4,
};
Dial::new(&items, 0).render(area, &mut buf);
assert_eq!(buf.get(5, 2).symbol, 'R');
assert_eq!(buf.get(0, 2).symbol, 'F');
assert_eq!(buf.get(1, 2).symbol, 'T');
}
#[test]
fn themed_dial_uses_accent_on_background_for_the_selected_item() {
let items = vec!["alpha".to_string(), "beta".to_string()];
let mut buf = Buffer::new(10, 8);
let area = Rect {
x: 0,
y: 0,
width: 10,
height: 8,
};
let theme = test_theme();
Dial::new(&items, 0).theme(&theme).render(area, &mut buf);
assert_eq!(buf.get(5, 1).fg, Color::Rgb { r: 255, g: 0, b: 0 });
assert_eq!(buf.get(5, 1).bg, Color::Rgb { r: 0, g: 0, b: 32 });
}
#[test]
fn unthemed_dial_keeps_the_pre_2_0_colours() {
let items = vec!["alpha".to_string(), "beta".to_string()];
let mut buf = Buffer::new(10, 8);
let area = Rect {
x: 0,
y: 0,
width: 10,
height: 8,
};
Dial::new(&items, 0).render(area, &mut buf);
assert_eq!(buf.get(5, 1).fg, Color::Black);
assert_eq!(buf.get(5, 1).bg, Color::White);
}
}