🪟🫷Raw Window Handle Support

Cargo.toml

@@ -79,6 +79,12 @@ notan_text = { workspace = true, optional = true }
 notan_audio = { workspace = true, optional = true }
 notan_extra = { workspace = true, optional = true }
 notan_random = { workspace = true, optional = true }
+raw-window-handle = "0.5.2"
+
+[target.'cfg(target_os = "macos")'.dependencies]
+cocoa = "0.26.0"
+objc = "0.2.7"
+
 
 [features]
 default = ["backend", "log", "draw", "random", "glsl-to-spirv"]
@@ -330,6 +336,10 @@ required-features = ["draw"]
 name = "log_basic"
 required-features = ["log"]
 
+[[example]]
+name = "raw_window_handle"
+required-features = ["draw"]
+
 [[example]]
 name = "renderer_instancing_cubes"
 required-features = ["random"]

crates/notan_app/Cargo.toml

@@ -27,6 +27,7 @@ serde = { workspace = true, optional = true }
 downcast-rs = "1.2.0"
 indexmap = "2.0.2"
 futures = "0.3.28"
+raw-window-handle = "0.5.2"
 
 [target.'cfg(not(target_arch = "wasm32"))'.dependencies]
 platter2 = "0.1.6"

crates/notan_app/src/backend.rs

@@ -4,6 +4,7 @@ use downcast_rs::{impl_downcast, Downcast};
 use futures::prelude::*;
 use futures::Future;
 use notan_graphics::DeviceBackend;
+use raw_window_handle::RawWindowHandle;
 
 #[cfg(feature = "audio")]
 use notan_audio::AudioBackend;
@@ -213,4 +214,6 @@ pub trait WindowBackend {
 
     /// Returns if touch as mouse is enabled
     fn touch_as_mouse(&self) -> bool;
+
+    fn raw_window_handle(&self) -> Option<RawWindowHandle>;
 }

crates/notan_app/src/empty.rs

@@ -3,6 +3,7 @@ use crate::{
     App, Backend, BackendSystem, CursorIcon, EventIterator, FrameState, InitializeFn, WindowBackend,
 };
 use notan_graphics::prelude::*;
+use raw_window_handle::RawWindowHandle;
 use std::any::Any;
 
 #[cfg(feature = "audio")]
@@ -137,6 +138,10 @@ impl WindowBackend for EmptyWindowBackend {
     fn touch_as_mouse(&self) -> bool {
         self.touch_as_mouse
     }
+
+    fn raw_window_handle(&self) -> Option<RawWindowHandle> {
+        None
+    }
 }
 
 #[derive(Default)]

crates/notan_winit/src/window.rs

@@ -3,6 +3,7 @@ use std::path::PathBuf;
 use crate::gl_manager::GlManager;
 use notan_app::WindowConfig;
 use notan_app::{CursorIcon, WindowBackend};
+use raw_window_handle::{HasRawWindowHandle, RawWindowHandle};
 use winit::dpi::{LogicalPosition, LogicalSize, PhysicalPosition};
 use winit::event_loop::EventLoop;
 use winit::window::Fullscreen::Borderless;
@@ -26,6 +27,11 @@ pub struct WinitWindowBackend {
 }
 
 impl WindowBackend for WinitWindowBackend {
+
+    fn raw_window_handle(&self) -> Option<RawWindowHandle> {
+        Some(self.window().raw_window_handle())
+    }
+
     fn capture_cursor(&self) -> bool {
         self.captured
     }

examples/raw_window_handle.rs

@@ -0,0 +1,51 @@
+use notan::draw::*;
+use notan::prelude::*;
+use raw_window_handle::{AppKitWindowHandle, RawWindowHandle};
+
+#[notan_main]
+fn main() -> Result<(), String> {
+    let win = WindowConfig::default()
+        .set_transparent(true)
+        .set_decorations(false);
+    notan::init_with(setup)
+        .add_config(win)
+        .add_config(DrawConfig) // Simple way to add the draw extension
+        .draw(draw)
+        .build()
+}
+
+fn setup(app: &mut App) {
+    let raw_window_handle = app.window().raw_window_handle().unwrap();
+
+    match raw_window_handle {
+        RawWindowHandle::AppKit(AppKitWindowHandle { ns_view, .. }) => {
+            #[cfg(target_os = "macos")]
+            unsafe {
+                use cocoa::appkit::NSWindow;
+                use cocoa::base::NO;
+                use objc::runtime::Object;
+                use objc::{msg_send, sel, sel_impl};
+
+                // I told you it was unsafe.
+                let ns_view: *mut Object = ns_view as *mut Object;
+                let ns_window: *mut Object = msg_send![ns_view, window];
+
+                // NOTE: remove shadow to stop artifacts in transparent window
+                ns_window.setHasShadow_(NO);
+                ns_window.setLevel_(1001);
+                println!("{:?}", raw_window_handle)
+            }
+        }
+        _ => {
+            println!("{:?}", raw_window_handle)
+        }
+    }
+}
+
+fn draw(gfx: &mut Graphics) {
+    let mut draw = gfx.create_draw();
+    draw.clear(Color::TRANSPARENT);
+    draw.triangle((400.0, 100.0), (100.0, 500.0), (700.0, 500.0))
+        .color(Color::MAGENTA);
+    gfx.render(&draw);
+}