Expose blur to the user

runtime/src/window.rs

@@ -159,6 +159,12 @@ pub enum Action {
     /// This enables mouse events for the window and stops mouse events
     /// from being passed to whatever is underneath.
     DisableMousePassthrough(Id),
+
+    /// Enable window blur.
+    EnableBlur(Id),
+
+    /// Disable window blur.
+    DisableBlur(Id),
 }
 
 /// Subscribes to the frames of the window of the running application.
@@ -456,3 +462,17 @@ pub fn enable_mouse_passthrough<Message>(id: Id) -> Task<Message> {
 pub fn disable_mouse_passthrough<Message>(id: Id) -> Task<Message> {
     task::effect(crate::Action::Window(Action::DisableMousePassthrough(id)))
 }
+
+/// Enable the blur effect for a window.
+///
+/// This is only supported on platforms that support window blur.
+pub fn enable_blur<Message>(id: Id) -> Task<Message> {
+    task::effect(crate::Action::Window(Action::EnableBlur(id)))
+}
+
+/// Disable the blur effect for a window.
+///
+/// This is only supported on platforms that support window blur.
+pub fn disable_blur<Message>(id: Id) -> Task<Message> {
+    task::effect(crate::Action::Window(Action::DisableBlur(id)))
+}

winit/src/program.rs

@@ -26,7 +26,7 @@
 use crate::futures::{Executor, Runtime};
 use crate::graphics;
 use crate::graphics::{compositor, Compositor};
 use crate::platform_specific;
 use crate::runtime::user_interface::{self, UserInterface};
 use crate::runtime::Debug;
 use crate::runtime::{self, Action, Task};
@@ -378,8 +378,8 @@
 
             #[cfg(target_arch = "wasm32")]
             {
                 use winit::platform::web::WindowExtWebSys;
                 self.canvas = window.canvas();
             }
 
             let finish_boot = async move {
@@ -495,14 +495,14 @@
 
                                 #[cfg(target_arch = "wasm32")]
                                 let window_attributes = {
                                     use winit::platform::web::WindowAttributesExtWebSys;
                                     window_attributes
                                         .with_canvas(self.canvas.take())
                                 };
 
                                 log::info!("Window attributes for id `{id:#?}`: {window_attributes:#?}");
 
                                 let window = Arc::from(
                                     event_loop
                                         .create_window(window_attributes)
                                         .expect("Create window"),
@@ -510,7 +510,7 @@
 
                                 #[cfg(target_arch = "wasm32")]
                                 {
                                     use winit::platform::web::WindowExtWebSys;
 
                                     let canvas = window
                                         .canvas()
@@ -630,8 +630,8 @@
 
     #[cfg(target_arch = "wasm32")]
     {
         use winit::platform::web::EventLoopExtWebSys;
         let _ = event_loop.spawn_app(runner);
 
         Ok(())
     }
@@ -693,7 +693,7 @@
     boot: oneshot::Receiver<Boot<C>>,
     mut event_receiver: mpsc::UnboundedReceiver<Event<P::Message>>,
     mut control_sender: mpsc::UnboundedSender<Control>,
     display_handle: OwnedDisplayHandle,
     is_daemon: bool,
 ) where
     P: Program + 'static,
@@ -705,7 +705,7 @@
 
     let Boot {
         mut compositor,
         is_wayland,
     } = boot.await.expect("Receive boot");
 
     let mut platform_specific_handler =
@@ -1231,7 +1231,7 @@
                         {
                             let logical_size = window.state.logical_size();
                             debug.layout_started();
                             let mut ui = user_interfaces
                                 .remove(&id)
                                 .expect("Remove user interface")
                                 .relayout(logical_size, &mut window.renderer);
@@ -1501,7 +1501,7 @@
                             }
                         }
                     }
                     _ => {}
                 }
             }
             Event::AboutToWait => {
@@ -2202,6 +2202,16 @@
                     let _ = window.raw.set_cursor_hittest(true);
                 }
             }
+            window::Action::EnableBlur(id) => {
+                if let Some(window) = window_manager.get_mut(id) {
+                    window.raw.set_blur(true);
+                }
+            }
+            window::Action::DisableBlur(id) => {
+                if let Some(window) = window_manager.get_mut(id) {
+                    window.raw.set_blur(false);
+                }
+            }
         },
         Action::System(action) => match action {
             system::Action::QueryInformation(_channel) => {