// Copyright 2016 Joe Wilm, The Alacritty Project Contributors // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //! The display subsystem including window management, font rasterization, and //! GPU drawing. use std::sync::mpsc; use parking_lot::{MutexGuard}; use Rgb; use cli; use config::Config; use font::{self, Rasterize}; use meter::Meter; use renderer::{self, GlyphCache, QuadRenderer}; use selection::Selection; use term::{Term, SizeInfo}; use window::{self, Size, Pixels, Window, SetInnerSize}; #[derive(Debug)] pub enum Error { /// Error with window management Window(window::Error), /// Error dealing with fonts Font(font::Error), /// Error in renderer Render(renderer::Error), } impl ::std::error::Error for Error { fn cause(&self) -> Option<&::std::error::Error> { match *self { Error::Window(ref err) => Some(err), Error::Font(ref err) => Some(err), Error::Render(ref err) => Some(err), } } fn description(&self) -> &str { match *self { Error::Window(ref err) => err.description(), Error::Font(ref err) => err.description(), Error::Render(ref err) => err.description(), } } } impl ::std::fmt::Display for Error { fn fmt(&self, f: &mut ::std::fmt::Formatter) -> ::std::fmt::Result { match *self { Error::Window(ref err) => err.fmt(f), Error::Font(ref err) => err.fmt(f), Error::Render(ref err) => err.fmt(f), } } } impl From for Error { fn from(val: window::Error) -> Error { Error::Window(val) } } impl From for Error { fn from(val: font::Error) -> Error { Error::Font(val) } } impl From for Error { fn from(val: renderer::Error) -> Error { Error::Render(val) } } /// The display wraps a window, font rasterizer, and GPU renderer pub struct Display { window: Window, renderer: QuadRenderer, glyph_cache: GlyphCache, render_timer: bool, rx: mpsc::Receiver<(u32, u32)>, tx: mpsc::Sender<(u32, u32)>, meter: Meter, size_info: SizeInfo, } /// Can wakeup the render loop from other threads pub struct Notifier(window::Proxy); /// Types that are interested in when the display is resized pub trait OnResize { fn on_resize(&mut self, size: &SizeInfo); } impl Notifier { pub fn notify(&self) { self.0.wakeup_event_loop(); } } impl Display { pub fn notifier(&self) -> Notifier { Notifier(self.window.create_window_proxy()) } pub fn update_config(&mut self, config: &Config) { self.render_timer = config.render_timer(); } /// Get size info about the display pub fn size(&self) -> &SizeInfo { &self.size_info } pub fn new( config: &Config, options: &cli::Options, ) -> Result { // Extract some properties from config let font = config.font(); let dpi = config.dpi(); let render_timer = config.render_timer(); // Create the window where Alacritty will be displayed let mut window = Window::new(&options.title)?; // get window properties for initializing the other subsytems let size = window.inner_size_pixels() .expect("glutin returns window size"); let dpr = window.hidpi_factor(); info!("device_pixel_ratio: {}", dpr); let rasterizer = font::Rasterizer::new(dpi.x(), dpi.y(), dpr, config.use_thin_strokes())?; // Create renderer let mut renderer = QuadRenderer::new(&config, size)?; // Initialize glyph cache let glyph_cache = { info!("Initializing glyph cache"); let init_start = ::std::time::Instant::now(); let cache = renderer.with_loader(|mut api| { GlyphCache::new(rasterizer, config, &mut api) })?; let stop = init_start.elapsed(); let stop_f = stop.as_secs() as f64 + stop.subsec_nanos() as f64 / 1_000_000_000f64; info!("Finished initializing glyph cache in {}", stop_f); cache }; // Need font metrics to resize the window properly. This suggests to me the // font metrics should be computed before creating the window in the first // place so that a resize is not needed. let metrics = glyph_cache.font_metrics(); let cell_width = (metrics.average_advance + font.offset().x as f64) as u32; let cell_height = (metrics.line_height + font.offset().y as f64) as u32; // Resize window to specified dimensions let dimensions = options.dimensions() .unwrap_or_else(|| config.dimensions()); let width = cell_width * dimensions.columns_u32(); let height = cell_height * dimensions.lines_u32(); let size = Size { width: Pixels(width), height: Pixels(height) }; info!("set_inner_size: {}", size); let viewport_size = Size { width: Pixels(width + 2 * config.padding().x as u32), height: Pixels(width + 2 * config.padding().y as u32), }; window.set_inner_size(&viewport_size); renderer.resize(viewport_size.width.0 as _, viewport_size.height.0 as _); info!("Cell Size: ({} x {})", cell_width, cell_height); let size_info = SizeInfo { width: viewport_size.width.0 as f32, height: viewport_size.height.0 as f32, cell_width: cell_width as f32, cell_height: cell_height as f32, padding_x: config.padding().x.floor(), padding_y: config.padding().y.floor(), }; // Channel for resize events // // macOS has a callback for getting resize events, the channel is used // to queue resize events until the next draw call. Unfortunately, it // seems that the event loop is blocked until the window is done // resizing. If any drawing were to happen during a resize, it would // need to be in the callback. let (tx, rx) = mpsc::channel(); // Clear screen renderer.with_api(config, &size_info, 0. /* visual bell intensity */, |api| api.clear()); let mut display = Display { window: window, renderer: renderer, glyph_cache: glyph_cache, render_timer: render_timer, tx: tx, rx: rx, meter: Meter::new(), size_info: size_info, }; let resize_tx = display.resize_channel(); let proxy = display.window.create_window_proxy(); display.window.set_resize_callback(move |width, height| { let _ = resize_tx.send((width, height)); proxy.wakeup_event_loop(); }); Ok(display) } #[inline] pub fn resize_channel(&self) -> mpsc::Sender<(u32, u32)> { self.tx.clone() } pub fn window(&mut self) -> &mut Window { &mut self.window } /// Process pending resize events pub fn handle_resize( &mut self, terminal: &mut MutexGuard, items: &mut [&mut OnResize] ) { // Resize events new_size and are handled outside the poll_events // iterator. This has the effect of coalescing multiple resize // events into one. let mut new_size = None; // Take most recent resize event, if any while let Ok(sz) = self.rx.try_recv() { new_size = Some(sz); } // Receive any resize events; only call gl::Viewport on last // available if let Some((w, h)) = new_size.take() { terminal.resize(w as f32, h as f32); let size = terminal.size_info(); for mut item in items { item.on_resize(size) } self.renderer.resize(w as i32, h as i32); } } /// Draw the screen /// /// A reference to Term whose state is being drawn must be provided. /// /// This call may block if vsync is enabled pub fn draw(&mut self, mut terminal: MutexGuard, config: &Config, selection: &Selection) { // Clear dirty flag terminal.dirty = !terminal.visual_bell.completed(); if let Some(title) = terminal.get_next_title() { self.window.set_title(&title); } let size_info = *terminal.size_info(); let visual_bell_intensity = terminal.visual_bell.intensity(); { let glyph_cache = &mut self.glyph_cache; // Draw grid { let _sampler = self.meter.sampler(); // Make a copy of size_info since the closure passed here // borrows terminal mutably // // TODO I wonder if the renderable cells iter could avoid the // mutable borrow self.renderer.with_api(config, &size_info, visual_bell_intensity, |mut api| { // Draw the grid api.render_cells(terminal.renderable_cells(config, selection), glyph_cache); }); } // Draw render timer if self.render_timer { let timing = format!("{:.3} usec", self.meter.average()); let color = Rgb { r: 0xd5, g: 0x4e, b: 0x53 }; self.renderer.with_api(config, &size_info, visual_bell_intensity, |mut api| { api.render_string(&timing[..], glyph_cache, color); }); } } // Unlock the terminal mutex; following call to swap_buffers() may block drop(terminal); self.window .swap_buffers() .expect("swap buffers"); // Clear after swap_buffers when terminal mutex isn't held. Mesa for // some reason takes a long time to call glClear(). The driver descends // into xcb_connect_to_fd() which ends up calling __poll_nocancel() // which blocks for a while. // // By keeping this outside of the critical region, the Mesa bug is // worked around to some extent. Since this doesn't actually address the // issue of glClear being slow, less time is available for input // handling and rendering. self.renderer.with_api(config, &size_info, visual_bell_intensity, |api| { api.clear(); }); } }