//! Makes drawing on ncurses windows easier. use std::cmp::min; use backend::Backend; use B; use theme::{ColorPair, Theme, Effect}; use vec::{ToVec2, Vec2}; /// Convenient interface to draw on a subset of the screen. pub struct Printer { /// Offset into the window this printer should start drawing at. pub offset: Vec2, /// Size of the area we are allowed to draw on. pub size: Vec2, /// Whether the view to draw is currently focused or not. pub focused: bool, /// Currently used theme pub theme: Theme, } impl Printer { /// Creates a new printer on the given window. pub fn new(size: T, theme: Theme) -> Self { Printer { offset: Vec2::zero(), size: size.to_vec2(), focused: true, theme: theme, } } // TODO: use &mut self? We don't *need* it, but it may make sense. // We don't want people to start calling prints in parallel? /// Prints some text at the given position relative to the window. pub fn print(&self, pos: S, text: &str) { let p = pos.to_vec2(); if p.y >= self.size.y || p.x >= self.size.x { return; } // Do we have enough room for the entire line? let room = self.size.x - p.x; // We want the number of CHARACTERS, not bytes. // (Actually we want the "width" of the string, see unicode-width) let text = match text.char_indices().nth(room) { Some((i, _)) => &text[..i], _ => text, }; let p = p + self.offset; if text.contains('%') { B::print_at((p.x, p.y), &text.replace("%", "%%")); } else { B::print_at((p.x, p.y), text); } } /// Prints a vertical line using the given character. pub fn print_vline(&self, start: T, len: usize, c: &str) { let p = start.to_vec2(); if p.y > self.size.y || p.x > self.size.x { return; } let len = min(len, self.size.y - p.y); let p = p + self.offset; for y in 0..len { B::print_at((p.x, (p.y + y)), c); } } /// Prints a horizontal line using the given character. pub fn print_hline(&self, start: T, len: usize, c: &str) { let p = start.to_vec2(); if p.y > self.size.y || p.x > self.size.x { return; } let len = min(len, self.size.x - p.x); let p = p + self.offset; for x in 0..len { B::print_at((p.x + x, p.y), c); } } /// Call the given closure with a colored printer, /// that will apply the given color on prints. /// /// # Examples /// /// ``` /// # use cursive::printer::Printer; /// # use cursive::theme; /// # let printer = Printer::new((6,4), theme::load_default()); /// printer.with_color(theme::ColorPair::Highlight, |printer| { /// printer.print((0,0), "This text is highlighted!"); /// }); /// ``` pub fn with_color(&self, c: ColorPair, f: F) where F: FnOnce(&Printer) { B::with_color(c, || f(self)); } /// Same as `with_color`, but apply a ncurses style instead, /// like `ncurses::A_BOLD()` or `ncurses::A_REVERSE()`. /// /// Will probably use a cursive enum some day. pub fn with_effect(&self, effect: Effect, f: F) where F: FnOnce(&Printer) { B::with_effect(effect, || f(self)); } /// Prints a rectangular box. /// /// # Examples /// /// ``` /// # use cursive::printer::Printer; /// # use cursive::theme; /// # let printer = Printer::new((6,4), theme::load_default()); /// printer.print_box((0,0), (6,4)); /// ``` pub fn print_box(&self, start: T, size: T) { let start_v = start.to_vec2(); let size_v = size.to_vec2() - (1, 1); self.print(start_v, "┌"); self.print(start_v + size_v.keep_x(), "┐"); self.print(start_v + size_v.keep_y(), "└"); self.print(start_v + size_v, "┘"); self.print_hline(start_v + (1, 0), size_v.x - 1, "─"); self.print_vline(start_v + (0, 1), size_v.y - 1, "│"); self.print_hline(start_v + (1, 0) + size_v.keep_y(), size_v.x - 1, "─"); self.print_vline(start_v + (0, 1) + size_v.keep_x(), size_v.y - 1, "│"); } pub fn print_hdelim(&self, start: T, len: usize) { let start = start.to_vec2(); self.print(start, "├"); self.print_hline(start + (1, 0), len - 2, "─"); self.print(start + (len - 1, 0), "┤"); } /// Returns a printer on a subset of this one's area. pub fn sub_printer(&self, offset: S, size: S, focused: bool) -> Printer { let offset_v = offset.to_vec2(); Printer { offset: self.offset + offset_v, // We can't be larger than what remains size: Vec2::min(self.size - offset_v, size.to_vec2()), focused: self.focused && focused, theme: self.theme.clone(), } } }