#![cfg(free_unix)] #[cfg(all(not(x11_platform), not(wayland_platform)))] compile_error!("Please select a feature to build for unix: `x11`, `wayland`"); use std::env; use std::os::unix::io::{AsFd, AsRawFd, BorrowedFd, RawFd}; use std::time::Duration; #[cfg(x11_platform)] use dpi::Size; use winit_core::application::ApplicationHandler; use winit_core::error::{EventLoopError, NotSupportedError}; use winit_core::event_loop::pump_events::PumpStatus; use winit_core::event_loop::ActiveEventLoop; use winit_core::window::ActivationToken; pub(crate) use self::common::xkb::{physicalkey_to_scancode, scancode_to_physicalkey}; #[cfg(x11_platform)] use crate::platform::x11::WindowType as XWindowType; pub(crate) mod common; #[cfg(wayland_platform)] pub(crate) mod wayland; #[cfg(x11_platform)] pub(crate) mod x11; #[derive(Debug, Copy, Clone, PartialEq, Eq, Hash)] pub(crate) enum Backend { #[cfg(x11_platform)] X, #[cfg(wayland_platform)] Wayland, } #[derive(Debug, Default, Copy, Clone, PartialEq, Eq, Hash)] pub(crate) struct PlatformSpecificEventLoopAttributes { pub(crate) forced_backend: Option, pub(crate) any_thread: bool, } #[derive(Debug, Clone, PartialEq, Eq)] pub struct ApplicationName { pub general: String, pub instance: String, } impl ApplicationName { pub fn new(general: String, instance: String) -> Self { Self { general, instance } } } #[derive(Clone, Debug, PartialEq)] pub struct PlatformSpecificWindowAttributes { pub name: Option, pub activation_token: Option, #[cfg(x11_platform)] pub x11: X11WindowAttributes, } #[derive(Clone, Debug, PartialEq)] #[cfg(x11_platform)] pub struct X11WindowAttributes { pub visual_id: Option, pub screen_id: Option, pub base_size: Option, pub override_redirect: bool, pub x11_window_types: Vec, /// The parent window to embed this window into. pub embed_window: Option, } #[cfg_attr(not(x11_platform), allow(clippy::derivable_impls))] impl Default for PlatformSpecificWindowAttributes { fn default() -> Self { Self { name: None, activation_token: None, #[cfg(x11_platform)] x11: X11WindowAttributes { visual_id: None, screen_id: None, base_size: None, override_redirect: false, x11_window_types: vec![XWindowType::Normal], embed_window: None, }, } } } /// `x11_or_wayland!(match expr; Enum(foo) => foo.something())` /// expands to the equivalent of /// ```ignore /// match self { /// Enum::X(foo) => foo.something(), /// Enum::Wayland(foo) => foo.something(), /// } /// ``` /// The result can be converted to another enum by adding `; as AnotherEnum` macro_rules! x11_or_wayland { (match $what:expr; $enum:ident ( $($c1:tt)* ) => $x:expr; as $enum2:ident ) => { match $what { #[cfg(x11_platform)] $enum::X($($c1)*) => $enum2::X($x), #[cfg(wayland_platform)] $enum::Wayland($($c1)*) => $enum2::Wayland($x), } }; (match $what:expr; $enum:ident ( $($c1:tt)* ) => $x:expr) => { match $what { #[cfg(x11_platform)] $enum::X($($c1)*) => $x, #[cfg(wayland_platform)] $enum::Wayland($($c1)*) => $x, } }; } #[derive(Debug)] #[allow(clippy::large_enum_variant)] pub enum EventLoop { #[cfg(wayland_platform)] Wayland(Box), #[cfg(x11_platform)] X(x11::EventLoop), } impl EventLoop { pub(crate) fn new( attributes: &PlatformSpecificEventLoopAttributes, ) -> Result { if !attributes.any_thread && !is_main_thread() { panic!( "Initializing the event loop outside of the main thread is a significant \ cross-platform compatibility hazard. If you absolutely need to create an \ EventLoop on a different thread, you can use the \ `EventLoopBuilderExtX11::with_any_thread` or \ `EventLoopBuilderExtWayland::with_any_thread` functions." ); } // NOTE: Wayland first because of X11 could be present under Wayland as well. Empty // variables are also treated as not set. let backend = match ( attributes.forced_backend, env::var("WAYLAND_DISPLAY") .ok() .filter(|var| !var.is_empty()) .or_else(|| env::var("WAYLAND_SOCKET").ok()) .filter(|var| !var.is_empty()) .is_some(), env::var("DISPLAY").map(|var| !var.is_empty()).unwrap_or(false), ) { // User is forcing a backend. (Some(backend), ..) => backend, // Wayland is present. #[cfg(wayland_platform)] (None, true, _) => Backend::Wayland, // X11 is present. #[cfg(x11_platform)] (None, _, true) => Backend::X, // No backend is present. (_, wayland_display, x11_display) => { let msg = if wayland_display && !cfg!(wayland_platform) { "DISPLAY is not set; note: enable the `winit/wayland` feature to support \ Wayland" } else if x11_display && !cfg!(x11_platform) { "neither WAYLAND_DISPLAY nor WAYLAND_SOCKET is set; note: enable the \ `winit/x11` feature to support X11" } else { "neither WAYLAND_DISPLAY nor WAYLAND_SOCKET nor DISPLAY is set." }; return Err(NotSupportedError::new(msg).into()); }, }; // Create the display based on the backend. match backend { #[cfg(wayland_platform)] Backend::Wayland => EventLoop::new_wayland_any_thread(), #[cfg(x11_platform)] Backend::X => EventLoop::new_x11_any_thread(), } } #[cfg(wayland_platform)] fn new_wayland_any_thread() -> Result { wayland::EventLoop::new().map(|evlp| EventLoop::Wayland(Box::new(evlp))) } #[cfg(x11_platform)] fn new_x11_any_thread() -> Result { x11::EventLoop::new().map(EventLoop::X) } #[inline] pub fn is_wayland(&self) -> bool { match *self { #[cfg(wayland_platform)] EventLoop::Wayland(_) => true, #[cfg(x11_platform)] _ => false, } } pub fn run_app(self, app: A) -> Result<(), EventLoopError> { x11_or_wayland!(match self; EventLoop(evlp) => evlp.run_app(app)) } pub fn run_app_on_demand( &mut self, app: A, ) -> Result<(), EventLoopError> { x11_or_wayland!(match self; EventLoop(evlp) => evlp.run_app_on_demand(app)) } pub fn pump_app_events( &mut self, timeout: Option, app: A, ) -> PumpStatus { x11_or_wayland!(match self; EventLoop(evlp) => evlp.pump_app_events(timeout, app)) } pub fn window_target(&self) -> &dyn ActiveEventLoop { x11_or_wayland!(match self; EventLoop(evlp) => evlp.window_target()) } } impl AsFd for EventLoop { fn as_fd(&self) -> BorrowedFd<'_> { x11_or_wayland!(match self; EventLoop(evlp) => evlp.as_fd()) } } impl AsRawFd for EventLoop { fn as_raw_fd(&self) -> RawFd { x11_or_wayland!(match self; EventLoop(evlp) => evlp.as_raw_fd()) } } /// Returns the minimum `Option`, taking into account that `None` /// equates to an infinite timeout, not a zero timeout (so can't just use /// `Option::min`) fn min_timeout(a: Option, b: Option) -> Option { a.map_or(b, |a_timeout| b.map_or(Some(a_timeout), |b_timeout| Some(a_timeout.min(b_timeout)))) } #[cfg(target_os = "linux")] fn is_main_thread() -> bool { rustix::thread::gettid() == rustix::process::getpid() } #[cfg(any(target_os = "dragonfly", target_os = "freebsd", target_os = "openbsd"))] fn is_main_thread() -> bool { use libc::pthread_main_np; unsafe { pthread_main_np() == 1 } } #[cfg(target_os = "netbsd")] fn is_main_thread() -> bool { std::thread::current().name() == Some("main") }