use backend; use chan; use direction; use event::{Callback, Event, EventResult}; use printer::Printer; use std::any::Any; use std::collections::HashMap; use std::path::Path; use theme; use vec::Vec2; use view::{self, Finder, IntoBoxedView, Position, View}; use views::{self, LayerPosition}; /// Central part of the cursive library. /// /// It initializes ncurses on creation and cleans up on drop. /// To use it, you should populate it with views, layouts and callbacks, /// then start the event loop with run(). /// /// It uses a list of screen, with one screen active at a time. pub struct Cursive { theme: theme::Theme, screens: Vec, global_callbacks: HashMap>, menubar: views::Menubar, // Last layer sizes of the stack view. // If it changed, clear the screen. last_sizes: Vec, fps: u32, active_screen: ScreenId, running: bool, backend: Box, cb_source: chan::Receiver>, cb_sink: chan::Sender>, event_source: chan::Receiver, } /// Describes one of the possible interruptions we should handle. enum Interruption { /// An input event was received Event(Event), /// A callback was received Callback(Box), /// A timeout ran out Timeout, } /// Identifies a screen in the cursive root. pub type ScreenId = usize; /// Asynchronous callback function trait. /// /// Every `FnOnce(&mut Cursive) -> () + Send` automatically /// implements this. /// /// This is a workaround only because `Box` is not /// working and `FnBox` is unstable. pub trait CbFunc: Send { /// Calls the function. fn call_box(self: Box, &mut Cursive); } impl () + Send> CbFunc for F { fn call_box(self: Box, siv: &mut Cursive) { (*self)(siv) } } #[cfg(feature = "termion")] impl Default for Cursive { fn default() -> Self { Self::termion() } } #[cfg(all(not(feature = "termion"), feature = "pancurses"))] impl Default for Cursive { fn default() -> Self { Self::pancurses() } } #[cfg( all( not(feature = "termion"), not(feature = "pancurses"), feature = "bear-lib-terminal" ) )] impl Default for Cursive { fn default() -> Self { Self::blt() } } #[cfg( all( not(feature = "termion"), not(feature = "pancurses"), not(feature = "bear-lib-terminal"), feature = "ncurses" ) )] impl Default for Cursive { fn default() -> Self { Self::ncurses() } } impl Cursive { /// Creates a new Cursive root, and initialize the back-end. pub fn new(mut backend: Box) -> Self { let theme = theme::load_default(); let (cb_sink, cb_source) = chan::async(); let (event_sink, event_source) = chan::async(); backend.start_input_thread(event_sink); Cursive { fps: 0, theme: theme, screens: vec![views::StackView::new()], last_sizes: Vec::new(), global_callbacks: HashMap::new(), menubar: views::Menubar::new(), active_screen: 0, running: true, cb_source, cb_sink, event_source, backend: backend, } } /// Creates a new Cursive root using a ncurses backend. #[cfg(feature = "ncurses")] pub fn ncurses() -> Self { Self::new(backend::curses::n::Backend::init()) } /// Creates a new Cursive root using a pancurses backend. #[cfg(feature = "pancurses")] pub fn pancurses() -> Self { Self::new(backend::curses::pan::Backend::init()) } /// Creates a new Cursive root using a termion backend. #[cfg(feature = "termion")] pub fn termion() -> Self { Self::new(backend::termion::Backend::init()) } /// Creates a new Cursive root using a bear-lib-terminal backend. #[cfg(feature = "bear-lib-terminal")] pub fn blt() -> Self { Self::new(backend::blt::Backend::init()) } /// Creates a new Cursive root using a dummy backend. /// /// Nothing will be output. This is mostly here for tests. pub fn dummy() -> Self { Self::new(backend::dummy::Backend::init()) } /// Returns a sink for asynchronous callbacks. /// /// Returns the sender part of a channel, that allows to send /// callbacks to `self` from other threads. /// /// Callbacks will be executed in the order /// of arrival on the next event cycle. /// /// Note that you currently need to call [`set_fps`] to force cursive to /// regularly check for messages. /// /// # Examples /// /// ```rust /// # extern crate cursive; /// # use cursive::*; /// # fn main() { /// let mut siv = Cursive::dummy(); /// siv.set_fps(10); /// /// // quit() will be called during the next event cycle /// siv.cb_sink().send(Box::new(|s: &mut Cursive| s.quit())); /// # } /// ``` /// /// [`set_fps`]: #method.set_fps pub fn cb_sink(&self) -> &chan::Sender> { &self.cb_sink } /// Selects the menubar. pub fn select_menubar(&mut self) { self.menubar.take_focus(direction::Direction::none()); } /// Sets the menubar autohide feature. /// /// * When enabled (default), the menu is only visible when selected. /// * When disabled, the menu is always visible and reserves the top row. pub fn set_autohide_menu(&mut self, autohide: bool) { self.menubar.autohide = autohide; } /// Access the menu tree used by the menubar. /// /// This allows to add menu items to the menubar. /// /// # Examples /// /// ```rust /// # extern crate cursive; /// # /// # use cursive::{Cursive, event}; /// # use cursive::views::{Dialog}; /// # use cursive::traits::*; /// # use cursive::menu::*; /// # /// # fn main() { /// let mut siv = Cursive::dummy(); /// /// siv.menubar() /// .add_subtree("File", /// MenuTree::new() /// .leaf("New", |s| s.add_layer(Dialog::info("New file!"))) /// .subtree("Recent", MenuTree::new().with(|tree| { /// for i in 1..100 { /// tree.add_leaf(format!("Item {}", i), |_| ()) /// } /// })) /// .delimiter() /// .with(|tree| { /// for i in 1..10 { /// tree.add_leaf(format!("Option {}", i), |_| ()); /// } /// }) /// .delimiter() /// .leaf("Quit", |s| s.quit())) /// .add_subtree("Help", /// MenuTree::new() /// .subtree("Help", /// MenuTree::new() /// .leaf("General", |s| { /// s.add_layer(Dialog::info("Help message!")) /// }) /// .leaf("Online", |s| { /// s.add_layer(Dialog::info("Online help?")) /// })) /// .leaf("About", /// |s| s.add_layer(Dialog::info("Cursive v0.0.0")))); /// /// siv.add_global_callback(event::Key::Esc, |s| s.select_menubar()); /// # } /// ``` pub fn menubar(&mut self) -> &mut views::Menubar { &mut self.menubar } /// Returns the currently used theme. pub fn current_theme(&self) -> &theme::Theme { &self.theme } /// Sets the current theme. pub fn set_theme(&mut self, theme: theme::Theme) { self.theme = theme; self.clear(); } /// Clears the screen. /// /// Users rarely have to call this directly. pub fn clear(&self) { self.backend .clear(self.theme.palette[theme::PaletteColor::Background]); } /// Loads a theme from the given file. /// /// `filename` must point to a valid toml file. pub fn load_theme_file>( &mut self, filename: P, ) -> Result<(), theme::Error> { self.set_theme(try!(theme::load_theme_file(filename))); Ok(()) } /// Loads a theme from the given string content. /// /// Content must be valid toml. pub fn load_theme(&mut self, content: &str) -> Result<(), theme::Error> { self.set_theme(try!(theme::load_theme(content))); Ok(()) } /// Sets the refresh rate, in frames per second. /// /// Regularly redraws everything, even when no input is given. /// /// You currently need this to regularly check /// for events sent using [`cb_sink`]. /// /// Between 0 and 1000. Call with `fps = 0` to disable (default value). /// /// [`cb_sink`]: #method.cb_sink pub fn set_fps(&mut self, fps: u32) { // self.backend.set_refresh_rate(fps) self.fps = fps; } /// Returns a reference to the currently active screen. pub fn screen(&self) -> &views::StackView { let id = self.active_screen; &self.screens[id] } /// Returns a mutable reference to the currently active screen. pub fn screen_mut(&mut self) -> &mut views::StackView { let id = self.active_screen; &mut self.screens[id] } /// Returns the id of the currently active screen. pub fn active_screen(&self) -> ScreenId { self.active_screen } /// Adds a new screen, and returns its ID. pub fn add_screen(&mut self) -> ScreenId { let res = self.screens.len(); self.screens.push(views::StackView::new()); res } /// Convenient method to create a new screen, and set it as active. pub fn add_active_screen(&mut self) -> ScreenId { let res = self.add_screen(); self.set_screen(res); res } /// Sets the active screen. Panics if no such screen exist. pub fn set_screen(&mut self, screen_id: ScreenId) { if screen_id >= self.screens.len() { panic!( "Tried to set an invalid screen ID: {}, but only {} \ screens present.", screen_id, self.screens.len() ); } self.active_screen = screen_id; } /// Tries to find the view pointed to by the given selector. /// /// Runs a closure on the view once it's found, and return the /// result. /// /// If the view is not found, or if it is not of the asked type, /// returns None. /// /// # Examples /// /// ```rust /// # extern crate cursive; /// # use cursive::{Cursive, views, view}; /// # use cursive::traits::*; /// # fn main() { /// fn main() { /// let mut siv = Cursive::dummy(); /// /// siv.add_layer(views::TextView::new("Text #1").with_id("text")); /// /// siv.add_global_callback('p', |s| { /// s.call_on( /// &view::Selector::Id("text"), /// |view: &mut views::TextView| { /// view.set_content("Text #2"); /// }, /// ); /// }); /// /// } /// # } /// ``` pub fn call_on( &mut self, sel: &view::Selector, callback: F, ) -> Option where V: View + Any, F: FnOnce(&mut V) -> R, { self.screen_mut().call_on(sel, callback) } /// Tries to find the view identified by the given id. /// /// Convenient method to use `call_on` with a `view::Selector::Id`. /// /// # Examples /// /// ```rust /// # extern crate cursive; /// # use cursive::{Cursive, views}; /// # use cursive::traits::*; /// # fn main() { /// let mut siv = Cursive::dummy(); /// /// siv.add_layer(views::TextView::new("Text #1") /// .with_id("text")); /// /// siv.add_global_callback('p', |s| { /// s.call_on_id("text", |view: &mut views::TextView| { /// view.set_content("Text #2"); /// }); /// }); /// # } /// ``` pub fn call_on_id(&mut self, id: &str, callback: F) -> Option where V: View + Any, F: FnOnce(&mut V) -> R, { self.call_on(&view::Selector::Id(id), callback) } /// Convenient method to find a view wrapped in [`IdView`]. /// /// This looks for a `IdView` with the given ID, and return /// a [`ViewRef`] to the wrapped view. The `ViewRef` implements /// `DerefMut`, so you can treat it just like a `&mut T`. /// /// # Examples /// /// ```rust /// # use cursive::Cursive; /// # use cursive::views::{TextView, ViewRef}; /// # let mut siv = Cursive::dummy(); /// use cursive::traits::Identifiable; /// /// siv.add_layer(TextView::new("foo").with_id("id")); /// /// // Could be called in a callback /// let mut view: ViewRef = siv.find_id("id").unwrap(); /// view.set_content("bar"); /// ``` /// /// [`IdView`]: views/struct.IdView.html /// [`ViewRef`]: views/type.ViewRef.html pub fn find_id(&mut self, id: &str) -> Option> where V: View + Any, { self.call_on_id(id, views::IdView::::get_mut) } /// Moves the focus to the view identified by `id`. /// /// Convenient method to call `focus` with a `view::Selector::Id`. pub fn focus_id(&mut self, id: &str) -> Result<(), ()> { self.focus(&view::Selector::Id(id)) } /// Moves the focus to the view identified by `sel`. pub fn focus(&mut self, sel: &view::Selector) -> Result<(), ()> { self.screen_mut().focus_view(sel) } /// Adds a global callback. /// /// Will be triggered on the given key press when no view catches it. /// /// # Examples /// /// ```rust /// # extern crate cursive; /// # use cursive::*; /// # fn main() { /// let mut siv = Cursive::dummy(); /// /// siv.add_global_callback('q', |s| s.quit()); /// # } /// ``` pub fn add_global_callback>(&mut self, event: E, cb: F) where F: Fn(&mut Cursive) + 'static, { self.global_callbacks .entry(event.into()) .or_insert_with(Vec::new) .push(Callback::from_fn(cb)); } /// Removes any callback tied to the given event. /// /// # Examples /// /// ```rust /// # extern crate cursive; /// # use cursive::*; /// # fn main() { /// let mut siv = Cursive::dummy(); /// /// siv.add_global_callback('q', |s| s.quit()); /// siv.clear_global_callbacks('q'); /// # } /// ``` pub fn clear_global_callbacks(&mut self, event: E) where E: Into, { let event = event.into(); self.global_callbacks.remove(&event); } /// Add a layer to the current screen. /// /// # Examples /// /// ```rust /// # extern crate cursive; /// # use cursive::*; /// # fn main() { /// let mut siv = Cursive::dummy(); /// /// siv.add_layer(views::TextView::new("Hello world!")); /// # } /// ``` pub fn add_layer(&mut self, view: T) where T: IntoBoxedView, { self.screen_mut().add_layer(view); } /// Adds a new full-screen layer to the current screen. /// /// Fullscreen layers have no shadow. pub fn add_fullscreen_layer(&mut self, view: T) where T: IntoBoxedView, { self.screen_mut().add_fullscreen_layer(view); } /// Convenient method to remove a layer from the current screen. pub fn pop_layer(&mut self) -> Option> { self.screen_mut().pop_layer() } /// Convenient stub forwarding layer repositioning. pub fn reposition_layer( &mut self, layer: LayerPosition, position: Position, ) { self.screen_mut().reposition_layer(layer, position); } // Wait until something happens. fn poll(&mut self) -> Interruption { let input_channel = &self.event_source; let cb_channel = &self.cb_source; if self.fps > 0 { let timeout = 1000 / self.fps; let timeout = chan::after_ms(timeout); chan_select! { input_channel.recv() -> input => { return Interruption::Event(input.unwrap()) }, cb_channel.recv() -> cb => { return Interruption::Callback(cb.unwrap()) }, timeout.recv() => { return Interruption::Timeout; }, } } else { chan_select! { input_channel.recv() -> input => { return Interruption::Event(input.unwrap()) }, cb_channel.recv() -> cb => { return Interruption::Callback(cb.unwrap()) }, } } } // Handles a key event when it was ignored by the current view fn on_event(&mut self, event: Event) { let cb_list = match self.global_callbacks.get(&event) { None => return, Some(cb_list) => cb_list.clone(), }; // Not from a view, so no viewpath here for cb in cb_list { cb(self); } } /// Returns the size of the screen, in characters. pub fn screen_size(&self) -> Vec2 { self.backend.screen_size() } fn layout(&mut self) { let size = self.screen_size(); let offset = if self.menubar.autohide { 0 } else { 1 }; let size = size.saturating_sub((0, offset)); self.screen_mut().layout(size); } fn draw(&mut self) { let sizes = self.screen().layer_sizes(); if self.last_sizes != sizes { self.clear(); self.last_sizes = sizes; } let printer = Printer::new(self.screen_size(), &self.theme, &*self.backend); let selected = self.menubar.receive_events(); // Print the stackview background before the menubar let offset = if self.menubar.autohide { 0 } else { 1 }; let id = self.active_screen; let sv_printer = printer.offset((0, offset), !selected); self.screens[id].draw_bg(&sv_printer); // Draw the currently active screen // If the menubar is active, nothing else can be. // Draw the menubar? if self.menubar.visible() { let printer = printer.sub_printer( Vec2::zero(), printer.size, self.menubar.receive_events(), ); self.menubar.draw(&printer); } // finally draw stackview layers // using variables from above self.screens[id].draw_fg(&sv_printer); } /// Returns `true` until [`quit(&mut self)`] is called. /// /// [`quit(&mut self)`]: #method.quit pub fn is_running(&self) -> bool { self.running } /// Runs the event loop. /// /// It will wait for user input (key presses) /// and trigger callbacks accordingly. /// /// Calls [`step(&mut self)`] until [`quit(&mut self)`] is called. /// /// After this function returns, you can call /// it again and it will start a new loop. /// /// [`step(&mut self)`]: #method.step /// [`quit(&mut self)`]: #method.quit pub fn run(&mut self) { self.running = true; // And the big event loop begins! while self.running { self.step(); } } /// Performs a single step from the event loop. /// /// Useful if you need tighter control on the event loop. /// Otherwise, [`run(&mut self)`] might be more convenient. /// /// [`run(&mut self)`]: #method.run pub fn step(&mut self) { // Do we need to redraw everytime? // Probably, actually. // TODO: Do we need to re-layout everytime? self.layout(); // TODO: Do we need to redraw every view every time? // (Is this getting repetitive? :p) self.draw(); self.backend.refresh(); // Wait for next event. match self.poll() { Interruption::Event(event) => { if event == Event::Exit { self.quit(); } if event == Event::WindowResize { self.clear(); } if let Event::Mouse { event, position, .. } = event { if event.grabs_focus() && !self.menubar.autohide && !self.menubar.has_submenu() && position.y == 0 { self.select_menubar(); } } // Event dispatch order: // * Focused element: // * Menubar (if active) // * Current screen (top layer) // * Global callbacks if self.menubar.receive_events() { self.menubar.on_event(event).process(self); } else { let offset = if self.menubar.autohide { 0 } else { 1 }; match self.screen_mut() .on_event(event.relativized((0, offset))) { // If the event was ignored, // it is our turn to play with it. EventResult::Ignored => self.on_event(event), EventResult::Consumed(None) => (), EventResult::Consumed(Some(cb)) => cb(self), } } }, Interruption::Callback(cb) => { cb.call_box(self); }, Interruption::Timeout => { } } } /// Stops the event loop. pub fn quit(&mut self) { self.running = false; } } impl Drop for Cursive { fn drop(&mut self) { self.backend.finish(); } }