//! Terminal window context. use std::error::Error; use std::fs::File; use std::io::Write; use std::mem; #[cfg(not(windows))] use std::os::unix::io::{AsRawFd, RawFd}; use std::rc::Rc; use std::sync::Arc; use crossfont::Size; use glutin::config::GetGlConfig; use glutin::context::NotCurrentContext; use glutin::display::GetGlDisplay; #[cfg(all(feature = "x11", not(any(target_os = "macos", windows))))] use glutin::platform::x11::X11GlConfigExt; use log::{error, info}; use raw_window_handle::HasRawDisplayHandle; use serde_json as json; use winit::event::{Event as WinitEvent, Modifiers, WindowEvent}; use winit::event_loop::{EventLoopProxy, EventLoopWindowTarget}; use winit::window::WindowId; use alacritty_config::SerdeReplace; use alacritty_terminal::event::Event as TerminalEvent; use alacritty_terminal::event_loop::{EventLoop as PtyEventLoop, Msg, Notifier}; use alacritty_terminal::grid::{Dimensions, Scroll}; use alacritty_terminal::index::Direction; use alacritty_terminal::sync::FairMutex; use alacritty_terminal::term::test::TermSize; use alacritty_terminal::term::{Term, TermMode}; use alacritty_terminal::tty; #[cfg(unix)] use crate::cli::IpcConfig; use crate::cli::WindowOptions; use crate::clipboard::Clipboard; use crate::config::UiConfig; use crate::display::window::Window; use crate::display::Display; use crate::event::{ ActionContext, Event, EventProxy, InlineSearchState, Mouse, SearchState, TouchPurpose, }; use crate::logging::LOG_TARGET_IPC_CONFIG; use crate::message_bar::MessageBuffer; use crate::scheduler::Scheduler; use crate::{input, renderer}; /// Event context for one individual Alacritty window. pub struct WindowContext { pub message_buffer: MessageBuffer, pub display: Display, pub dirty: bool, event_queue: Vec>, terminal: Arc>>, cursor_blink_timed_out: bool, modifiers: Modifiers, inline_search_state: InlineSearchState, search_state: SearchState, notifier: Notifier, font_size: Size, mouse: Mouse, touch: TouchPurpose, occluded: bool, preserve_title: bool, #[cfg(not(windows))] master_fd: RawFd, #[cfg(not(windows))] shell_pid: u32, ipc_config: Vec, config: Rc, } impl WindowContext { /// Create initial window context that dous bootstrapping the graphics Api we're going to use. pub fn initial( event_loop: &EventLoopWindowTarget, proxy: EventLoopProxy, config: Rc, options: WindowOptions, ) -> Result> { let raw_display_handle = event_loop.raw_display_handle(); let mut identity = config.window.identity.clone(); options.window_identity.override_identity_config(&mut identity); // Windows has different order of GL platform initialization compared to any other platform; // it requires the window first. #[cfg(windows)] let window = Window::new(event_loop, &config, &identity)?; #[cfg(windows)] let raw_window_handle = Some(window.raw_window_handle()); #[cfg(not(windows))] let raw_window_handle = None; let gl_display = renderer::platform::create_gl_display( raw_display_handle, raw_window_handle, config.debug.prefer_egl, )?; let gl_config = renderer::platform::pick_gl_config(&gl_display, raw_window_handle)?; #[cfg(not(windows))] let window = Window::new( event_loop, &config, &identity, #[cfg(all(feature = "x11", not(any(target_os = "macos", windows))))] gl_config.x11_visual(), #[cfg(target_os = "macos")] &options.window_tabbing_id, )?; // Create context. let gl_context = renderer::platform::create_gl_context(&gl_display, &gl_config, raw_window_handle)?; Self::new(window, gl_context, config, options, proxy) } /// Create additional context with the graphics platform other windows are using. pub fn additional( &self, event_loop: &EventLoopWindowTarget, proxy: EventLoopProxy, config: Rc, options: WindowOptions, ) -> Result> { // Get any window and take its GL config and display to build a new context. let (gl_display, gl_config) = { let gl_context = self.display.gl_context(); (gl_context.display(), gl_context.config()) }; let mut identity = config.window.identity.clone(); options.window_identity.override_identity_config(&mut identity); let window = Window::new( event_loop, &config, &identity, #[cfg(all(feature = "x11", not(any(target_os = "macos", windows))))] gl_config.x11_visual(), #[cfg(target_os = "macos")] &options.window_tabbing_id, )?; // Create context. let raw_window_handle = window.raw_window_handle(); let gl_context = renderer::platform::create_gl_context( &gl_display, &gl_config, Some(raw_window_handle), )?; Self::new(window, gl_context, config, options, proxy) } /// Create a new terminal window context. fn new( window: Window, context: NotCurrentContext, config: Rc, options: WindowOptions, proxy: EventLoopProxy, ) -> Result> { let mut pty_config = config.terminal_config.pty_config.clone(); options.terminal_options.override_pty_config(&mut pty_config); let preserve_title = options.window_identity.title.is_some(); // Create a display. // // The display manages a window and can draw the terminal. let display = Display::new(window, context, &config)?; info!( "PTY dimensions: {:?} x {:?}", display.size_info.screen_lines(), display.size_info.columns() ); let event_proxy = EventProxy::new(proxy, display.window.id()); // Create the terminal. // // This object contains all of the state about what's being displayed. It's // wrapped in a clonable mutex since both the I/O loop and display need to // access it. let terminal = Term::new(&config.terminal_config, &display.size_info, event_proxy.clone()); let terminal = Arc::new(FairMutex::new(terminal)); // Create the PTY. // // The PTY forks a process to run the shell on the slave side of the // pseudoterminal. A file descriptor for the master side is retained for // reading/writing to the shell. let pty = tty::new(&pty_config, display.size_info.into(), display.window.id().into())?; #[cfg(not(windows))] let master_fd = pty.file().as_raw_fd(); #[cfg(not(windows))] let shell_pid = pty.child().id(); // Create the pseudoterminal I/O loop. // // PTY I/O is ran on another thread as to not occupy cycles used by the // renderer and input processing. Note that access to the terminal state is // synchronized since the I/O loop updates the state, and the display // consumes it periodically. let event_loop = PtyEventLoop::new( Arc::clone(&terminal), event_proxy.clone(), pty, pty_config.hold, config.debug.ref_test, ); // The event loop channel allows write requests from the event processor // to be sent to the pty loop and ultimately written to the pty. let loop_tx = event_loop.channel(); // Kick off the I/O thread. let _io_thread = event_loop.spawn(); // Start cursor blinking, in case `Focused` isn't sent on startup. if config.terminal_config.cursor.style().blinking { event_proxy.send_event(TerminalEvent::CursorBlinkingChange.into()); } let font_size = config.font.size(); // Create context for the Alacritty window. Ok(WindowContext { preserve_title, font_size, terminal, display, #[cfg(not(windows))] master_fd, #[cfg(not(windows))] shell_pid, config, notifier: Notifier(loop_tx), cursor_blink_timed_out: Default::default(), inline_search_state: Default::default(), message_buffer: Default::default(), search_state: Default::default(), event_queue: Default::default(), ipc_config: Default::default(), modifiers: Default::default(), occluded: Default::default(), mouse: Default::default(), touch: Default::default(), dirty: Default::default(), }) } /// Update the terminal window to the latest config. pub fn update_config(&mut self, new_config: Rc) { let old_config = mem::replace(&mut self.config, new_config); // Apply ipc config if there are overrides. if !self.ipc_config.is_empty() { let mut config = (*self.config).clone(); // Apply each option, removing broken ones. let mut i = 0; while i < self.ipc_config.len() { let option = &self.ipc_config[i]; match config.replace(option.clone()) { Err(err) => { error!( target: LOG_TARGET_IPC_CONFIG, "Unable to override option '{}': {}", option, err ); self.ipc_config.swap_remove(i); }, Ok(_) => i += 1, } } self.config = Rc::new(config); } self.display.update_config(&self.config); self.terminal.lock().update_config(&self.config.terminal_config); // Reload cursor if its thickness has changed. if (old_config.terminal_config.cursor.thickness() - self.config.terminal_config.cursor.thickness()) .abs() > f32::EPSILON { self.display.pending_update.set_cursor_dirty(); } if old_config.font != self.config.font { // Do not update font size if it has been changed at runtime. if self.font_size == old_config.font.size() { self.font_size = self.config.font.size(); } let font = self.config.font.clone().with_size(self.font_size); self.display.pending_update.set_font(font); } // Always reload the theme to account for auto-theme switching. self.display.window.set_theme(self.config.window.decorations_theme_variant); // Update display if either padding options or resize increments were changed. let window_config = &old_config.window; if window_config.padding(1.) != self.config.window.padding(1.) || window_config.dynamic_padding != self.config.window.dynamic_padding || window_config.resize_increments != self.config.window.resize_increments { self.display.pending_update.dirty = true; } // Update title on config reload according to the following table. // // │cli │ dynamic_title │ current_title == old_config ││ set_title │ // │ Y │ _ │ _ ││ N │ // │ N │ Y │ Y ││ Y │ // │ N │ Y │ N ││ N │ // │ N │ N │ _ ││ Y │ if !self.preserve_title && (!self.config.window.dynamic_title || self.display.window.title() == old_config.window.identity.title) { self.display.window.set_title(self.config.window.identity.title.clone()); } let opaque = self.config.window_opacity() >= 1.; // Disable shadows for transparent windows on macOS. #[cfg(target_os = "macos")] self.display.window.set_has_shadow(opaque); #[cfg(target_os = "macos")] self.display.window.set_option_as_alt(self.config.window.option_as_alt()); // Change opacity state. self.display.window.set_transparent(!opaque); // Update hint keys. self.display.hint_state.update_alphabet(self.config.hints.alphabet()); // Update cursor blinking. let event = Event::new(TerminalEvent::CursorBlinkingChange.into(), None); self.event_queue.push(event.into()); self.dirty = true; } /// Update the IPC config overrides. #[cfg(unix)] pub fn update_ipc_config(&mut self, config: Rc, ipc_config: IpcConfig) { // Clear previous IPC errors. self.message_buffer.remove_target(LOG_TARGET_IPC_CONFIG); if ipc_config.reset { self.ipc_config.clear(); } else { for option in &ipc_config.options { // Try and parse option as toml. match toml::from_str(option) { Ok(value) => self.ipc_config.push(value), Err(err) => error!( target: LOG_TARGET_IPC_CONFIG, "'{}': Invalid IPC config value: {:?}", option, err ), } } } // Reload current config to pull new IPC config. self.update_config(config); } /// Draw the window. pub fn draw(&mut self, scheduler: &mut Scheduler) { self.display.window.requested_redraw = false; if self.occluded { return; } self.dirty = false; // Force the display to process any pending display update. self.display.process_renderer_update(); // Request immediate re-draw if visual bell animation is not finished yet. if !self.display.visual_bell.completed() { self.display.window.request_redraw(); } // Redraw the window. let terminal = self.terminal.lock(); self.display.draw( terminal, scheduler, &self.message_buffer, &self.config, &mut self.search_state, ); } /// Process events for this terminal window. pub fn handle_event( &mut self, event_loop: &EventLoopWindowTarget, event_proxy: &EventLoopProxy, clipboard: &mut Clipboard, scheduler: &mut Scheduler, event: WinitEvent, ) { match event { WinitEvent::AboutToWait | WinitEvent::WindowEvent { event: WindowEvent::RedrawRequested, .. } => { // Skip further event handling with no staged updates. if self.event_queue.is_empty() { return; } // Continue to process all pending events. }, event => { self.event_queue.push(event); return; }, } let mut terminal = self.terminal.lock(); let old_is_searching = self.search_state.history_index.is_some(); let context = ActionContext { cursor_blink_timed_out: &mut self.cursor_blink_timed_out, message_buffer: &mut self.message_buffer, inline_search_state: &mut self.inline_search_state, search_state: &mut self.search_state, modifiers: &mut self.modifiers, font_size: &mut self.font_size, notifier: &mut self.notifier, display: &mut self.display, mouse: &mut self.mouse, touch: &mut self.touch, dirty: &mut self.dirty, occluded: &mut self.occluded, terminal: &mut terminal, #[cfg(not(windows))] master_fd: self.master_fd, #[cfg(not(windows))] shell_pid: self.shell_pid, preserve_title: self.preserve_title, config: &self.config, event_proxy, event_loop, clipboard, scheduler, }; let mut processor = input::Processor::new(context); for event in self.event_queue.drain(..) { processor.handle_event(event); } // Process DisplayUpdate events. if self.display.pending_update.dirty { Self::submit_display_update( &mut terminal, &mut self.display, &mut self.notifier, &self.message_buffer, &self.search_state, old_is_searching, &self.config, ); self.dirty = true; } if self.dirty || self.mouse.hint_highlight_dirty { self.dirty |= self.display.update_highlighted_hints( &terminal, &self.config, &self.mouse, self.modifiers.state(), ); self.mouse.hint_highlight_dirty = false; } // Don't call `request_redraw` when event is `RedrawRequested` since the `dirty` flag // represents the current frame, but redraw is for the next frame. if self.dirty && !self.occluded && !matches!(event, WinitEvent::WindowEvent { event: WindowEvent::RedrawRequested, .. }) { self.display.window.request_redraw(); } } /// ID of this terminal context. pub fn id(&self) -> WindowId { self.display.window.id() } /// Write the ref test results to the disk. pub fn write_ref_test_results(&self) { // Dump grid state. let mut grid = self.terminal.lock().grid().clone(); grid.initialize_all(); grid.truncate(); let serialized_grid = json::to_string(&grid).expect("serialize grid"); let size_info = &self.display.size_info; let size = TermSize::new(size_info.columns(), size_info.screen_lines()); let serialized_size = json::to_string(&size).expect("serialize size"); let serialized_config = format!("{{\"history_size\":{}}}", grid.history_size()); File::create("./grid.json") .and_then(|mut f| f.write_all(serialized_grid.as_bytes())) .expect("write grid.json"); File::create("./size.json") .and_then(|mut f| f.write_all(serialized_size.as_bytes())) .expect("write size.json"); File::create("./config.json") .and_then(|mut f| f.write_all(serialized_config.as_bytes())) .expect("write config.json"); } /// Submit the pending changes to the `Display`. fn submit_display_update( terminal: &mut Term, display: &mut Display, notifier: &mut Notifier, message_buffer: &MessageBuffer, search_state: &SearchState, old_is_searching: bool, config: &UiConfig, ) { // Compute cursor positions before resize. let num_lines = terminal.screen_lines(); let cursor_at_bottom = terminal.grid().cursor.point.line + 1 == num_lines; let origin_at_bottom = if terminal.mode().contains(TermMode::VI) { terminal.vi_mode_cursor.point.line == num_lines - 1 } else { search_state.direction == Direction::Left }; display.handle_update( terminal, notifier, message_buffer, search_state.history_index.is_some(), config, ); let new_is_searching = search_state.history_index.is_some(); if !old_is_searching && new_is_searching { // Scroll on search start to make sure origin is visible with minimal viewport motion. let display_offset = terminal.grid().display_offset(); if display_offset == 0 && cursor_at_bottom && !origin_at_bottom { terminal.scroll_display(Scroll::Delta(1)); } else if display_offset != 0 && origin_at_bottom { terminal.scroll_display(Scroll::Delta(-1)); } } } } impl Drop for WindowContext { fn drop(&mut self) { // Shutdown the terminal's PTY. self.notifier.0.send(Msg::Shutdown); } }