Blur-Behind / Glassy Windows implementation

examples/blur.rs

@@ -0,0 +1,39 @@
+extern crate winit;
+
+fn main() {
+    let mut events_loop = winit::EventsLoop::new();
+
+    let window = winit::WindowBuilder::new()
+        .with_title("A blurry window!")
+        .with_blur(true)
+        .build(&events_loop)
+        .unwrap();
+
+    #[cfg(target_os = "macos")]
+    {
+        // On macOS the blur material is 'light' by default.
+        // Let's change it to a dark theme!
+        use winit::os::macos::{BlurMaterial, WindowExt};
+        window.set_blur_material(BlurMaterial::Dark);
+    }
+
+    events_loop.run_forever(|event| {
+        match event {
+            winit::Event::WindowEvent {
+                event: winit::WindowEvent::CloseRequested,
+                ..
+            } => winit::ControlFlow::Break,
+            winit::Event::WindowEvent {
+                event: winit::WindowEvent::KeyboardInput {
+                    input: winit::KeyboardInput {
+                        virtual_keycode: Some(winit::VirtualKeyCode::Escape),
+                        ..
+                    },
+                    ..
+                },
+                ..
+            } => winit::ControlFlow::Break,
+            _ => winit::ControlFlow::Continue,
+        }
+    });
+}

src/lib.rs

@@ -482,6 +482,11 @@ pub struct WindowAttributes {
     /// [iOS only] Enable multitouch,
     /// see [multipleTouchEnabled](https://developer.apple.com/documentation/uikit/uiview/1622519-multipletouchenabled)
     pub multitouch: bool,
+
+    /// Whether the window should be blurry. This is similar to transparency.
+    ///
+    /// The default is `false`.
+    pub blur: bool,
 }
 
 impl Default for WindowAttributes {
@@ -501,6 +506,7 @@ impl Default for WindowAttributes {
             always_on_top: false,
             window_icon: None,
             multitouch: false,
+            blur: false,
         }
     }
 }

src/os/macos.rs

@@ -16,6 +16,9 @@ pub trait WindowExt {
     ///
     /// The pointer will become invalid when the `Window` is destroyed.
     fn get_nsview(&self) -> *mut c_void;
+
+    /// Just for testing purposes.
+    fn set_blur_material(&self, material: BlurMaterial);
 }
 
 impl WindowExt for Window {
@@ -28,6 +31,11 @@ impl WindowExt for Window {
     fn get_nsview(&self) -> *mut c_void {
         self.window.get_nsview()
     }
+
+    #[inline]
+    fn set_blur_material(&self, material: BlurMaterial) {
+        self.window.set_blur_material(material);
+    }
 }
 
 /// Corresponds to `NSApplicationActivationPolicy`.
@@ -157,3 +165,27 @@ impl MonitorIdExt for MonitorId {
         self.inner.get_nsscreen().map(|s| s as *mut c_void)
     }
 }
+
+#[repr(i64)]
+// Applies to MacOS Mojave.
+pub enum BlurMaterial {
+    AppearanceBased = 0, // Deperecated
+    Light = 1, // Deperecated
+    Dark = 2, // Deprecated
+    Titlebar = 3,
+    Selection = 4,
+    Menu = 5,
+    Popover = 6,
+    Sidebar = 7,
+    MediumLight = 8, // Deprecated
+    UltraDark = 9, // Deprecated
+    HeaderView = 10,
+    Sheet = 11,
+    WindowBackground = 12,
+    HudWindow = 13,
+    FullScreenUi = 15,
+    ToolTip = 17,
+    ContentBackground = 18,
+    UnderWindowBackground = 21,
+    UnderPageBackground = 22,
+}

src/platform/macos/view.rs

@@ -13,11 +13,12 @@ use cocoa::foundation::{NSPoint, NSRect, NSSize, NSString, NSUInteger};
 use objc::declare::ClassDecl;
 use objc::runtime::{Class, Object, Protocol, Sel, BOOL};
 
-use {ElementState, Event, KeyboardInput, MouseButton, WindowEvent, WindowId};
+use {ElementState, Event, KeyboardInput, MouseButton, WindowEvent, WindowId, WindowAttributes};
 use platform::platform::events_loop::{DEVICE_ID, event_mods, Shared, to_virtual_key_code};
 use platform::platform::util;
 use platform::platform::ffi::*;
 use platform::platform::window::{get_window_id, IdRef};
+use os::macos::BlurMaterial;
 
 struct ViewState {
     window: id,
@@ -27,7 +28,7 @@ struct ViewState {
     last_insert: Option<String>,
 }
 
-pub fn new_view(window: id, shared: Weak<Shared>) -> IdRef {
+pub fn new_view(window: id, shared: Weak<Shared>, win_attribs: &WindowAttributes) -> IdRef {
     let state = ViewState {
         window,
         shared,
@@ -38,8 +39,14 @@ pub fn new_view(window: id, shared: Weak<Shared>) -> IdRef {
     unsafe {
         // This is free'd in `dealloc`
         let state_ptr = Box::into_raw(Box::new(state)) as *mut c_void;
-        let view: id = msg_send![VIEW_CLASS.0, alloc];
-        IdRef::new(msg_send![view, initWithWinit:state_ptr])
+        let view_class = if win_attribs.blur { VISUAL_EFFECT_VIEW_CLASS.0 } else { VIEW_CLASS.0 };
+        let view: id = msg_send![view_class, alloc];
+        msg_send![view, initWithWinit:state_ptr];
+        if win_attribs.blur {
+            msg_send![view, setMaterial: BlurMaterial::Light as i64];
+            msg_send![view, setBlendingMode: 0i64];
+        }
+        IdRef::new(view)
     }
 }
 
@@ -65,6 +72,18 @@ unsafe impl Sync for ViewClass {}
 lazy_static! {
     static ref VIEW_CLASS: ViewClass = unsafe {
         let superclass = Class::get("NSView").unwrap();
+        let decl = common_view_decl(superclass);
+        ViewClass(decl.register())
+    };
+
+    static ref VISUAL_EFFECT_VIEW_CLASS: ViewClass = unsafe {
+        let superclass = Class::get("NSVisualEffectView").unwrap();
+        let decl = common_view_decl(superclass);
+        ViewClass(decl.register())
+    };
+}
+
+unsafe fn common_view_decl(superclass: &'static Class) -> ClassDecl {
         let mut decl = ClassDecl::new("WinitView", superclass).unwrap();
         decl.add_method(sel!(dealloc), dealloc as extern fn(&Object, Sel));
         decl.add_method(
@@ -126,8 +145,7 @@ lazy_static! {
         decl.add_ivar::<id>("markedText");
         let protocol = Protocol::get("NSTextInputClient").unwrap();
         decl.add_protocol(&protocol);
-        ViewClass(decl.register())
-    };
+        decl
 }
 
 extern fn dealloc(this: &Object, _sel: Sel) {

src/platform/macos/window.rs

@@ -3,6 +3,7 @@ use std::ops::Deref;
 use std::os::raw::c_void;
 use std::sync::Weak;
 use std::cell::{Cell, RefCell};
+use os::macos::BlurMaterial;
 
 use cocoa;
 use cocoa::appkit::{
@@ -582,6 +583,12 @@ impl WindowExt for Window2 {
     fn get_nsview(&self) -> *mut c_void {
         *self.view as *mut c_void
     }
+
+    #[inline]
+    fn set_blur_material(&self, material: BlurMaterial) {
+        let view = self.get_nsview() as *mut objc::runtime::Object;
+        unsafe { msg_send![view, setMaterial: material as i64]; }
+    }
 }
 
 impl Window2 {
@@ -618,7 +625,7 @@ impl Window2 {
                 return Err(OsError(format!("Couldn't create NSWindow")));
             },
         };
-        let view = match Window2::create_view(*window, Weak::clone(&shared)) {
+        let view = match Window2::create_view(*window, Weak::clone(&shared), &win_attribs) {
             Some(view) => view,
             None => {
                 let _: () = unsafe { msg_send![autoreleasepool, drain] };
@@ -843,9 +850,9 @@ impl Window2 {
         }
     }
 
-    fn create_view(window: id, shared: Weak<Shared>) -> Option<IdRef> {
+    fn create_view(window: id, shared: Weak<Shared>, win_attribs: &WindowAttributes) -> Option<IdRef> {
         unsafe {
-            let view = new_view(window, shared);
+            let view = new_view(window, shared, win_attribs);
             view.non_nil().map(|view| {
                 view.setWantsBestResolutionOpenGLSurface_(YES);
                 window.setContentView_(*view);

src/window.rs

@@ -96,6 +96,15 @@ impl WindowBuilder {
     #[inline]
     pub fn with_transparency(mut self, transparent: bool) -> WindowBuilder {
         self.window.transparent = transparent;
+        self.window.blur = !transparent;
+        self
+    }
+
+    /// Sets whether the background of the window should be blurred.
+    #[inline]
+    pub fn with_blur(mut self, blur: bool) -> WindowBuilder {
+        self.window.blur = blur;
+        self.window.transparent = !blur;
         self
     }