Added SDL_SetWindowMousePassthrough

Author: AQtun81

include/SDL3/SDL_video.h

@@ -2703,6 +2703,18 @@ extern SDL_DECLSPEC bool SDLCALL SDL_SetWindowOpacity(SDL_Window *window, float
  */
 extern SDL_DECLSPEC float SDLCALL SDL_GetWindowOpacity(SDL_Window *window);
 
+/**
+ * Enable or disable mouse passthrough for a window.
+ *
+ * \param window the window to set mouse passthrough for.
+ * \param passthrough true to make the window transparent to mouse input, false to capture mouse input.
+ *
+ * \threadsafety This function should only be called on the main thread.
+ *
+ * \since This function is available since SDL 3.6.0.
+ */
+extern SDL_DECLSPEC void SDLCALL SDL_SetWindowMousePassthrough(SDL_Window *window, bool passthrough);
+
 /**
  * Set the window as a child of a parent window.
  *

src/dynapi/SDL_dynapi.sym

@@ -1270,6 +1270,7 @@ SDL3_0.0.0 {
     SDL_RotateSurface;
     SDL_LoadSurface_IO;
     SDL_LoadSurface;
+    SDL_SetWindowMousePassthrough;
     # extra symbols go here (don't modify this line)
   local: *;
 };

src/dynapi/SDL_dynapi_overrides.h

@@ -1296,3 +1296,4 @@
 #define SDL_RotateSurface SDL_RotateSurface_REAL
 #define SDL_LoadSurface_IO SDL_LoadSurface_IO_REAL
 #define SDL_LoadSurface SDL_LoadSurface_REAL
+#define SDL_SetWindowMousePassthrough SDL_SetWindowMousePassthrough_REAL

src/dynapi/SDL_dynapi_procs.h

@@ -1304,3 +1304,4 @@ SDL_DYNAPI_PROC(SDL_Cursor*,SDL_CreateAnimatedCursor,(SDL_CursorFrameInfo *a,int
 SDL_DYNAPI_PROC(SDL_Surface*,SDL_RotateSurface,(SDL_Surface *a,float b),(a,b),return)
 SDL_DYNAPI_PROC(SDL_Surface*,SDL_LoadSurface_IO,(SDL_IOStream *a,bool b),(a,b),return)
 SDL_DYNAPI_PROC(SDL_Surface*,SDL_LoadSurface,(const char *a),(a),return)
+SDL_DYNAPI_PROC(void,SDL_SetWindowMousePassthrough,(SDL_Window *a,bool b),(a,b),)

src/video/SDL_sysvideo.h

@@ -284,6 +284,7 @@ struct SDL_VideoDevice
     float (*GetWindowContentScale)(SDL_VideoDevice *_this, SDL_Window *window);
     void (*GetWindowSizeInPixels)(SDL_VideoDevice *_this, SDL_Window *window, int *w, int *h);
     bool (*SetWindowOpacity)(SDL_VideoDevice *_this, SDL_Window *window, float opacity);
+    void (*SetWindowMousePassthrough)(SDL_VideoDevice *_this, SDL_Window *window, bool passthrough);
     bool (*SetWindowParent)(SDL_VideoDevice *_this, SDL_Window *window, SDL_Window *parent);
     bool (*SetWindowModal)(SDL_VideoDevice *_this, SDL_Window *window, bool modal);
     void (*ShowWindow)(SDL_VideoDevice *_this, SDL_Window *window);

src/video/SDL_video.c

@@ -3793,6 +3793,16 @@ float SDL_GetWindowOpacity(SDL_Window *window)
     return window->opacity;
 }
 
+void SDL_SetWindowMousePassthrough(SDL_Window *window, bool passthrough)
+{
+    if (!_this->SetWindowMousePassthrough) {
+        SDL_Unsupported();
+        return;
+    }
+
+    _this->SetWindowMousePassthrough(_this, window, passthrough);
+}
+
 bool SDL_SetWindowParent(SDL_Window *window, SDL_Window *parent)
 {
     CHECK_WINDOW_MAGIC(window, false);

src/video/cocoa/SDL_cocoavideo.m

@@ -101,6 +101,7 @@ static void Cocoa_DeleteDevice(SDL_VideoDevice *device)
         device->SetWindowMaximumSize = Cocoa_SetWindowMaximumSize;
         device->SetWindowAspectRatio = Cocoa_SetWindowAspectRatio;
         device->SetWindowOpacity = Cocoa_SetWindowOpacity;
+        device->SetWindowMousePassthrough = Cocoa_SetWindowMousePassthrough;
         device->GetWindowSizeInPixels = Cocoa_GetWindowSizeInPixels;
         device->ShowWindow = Cocoa_ShowWindow;
         device->HideWindow = Cocoa_HideWindow;

src/video/cocoa/SDL_cocoawindow.h

@@ -173,6 +173,7 @@ extern void Cocoa_SetWindowMaximumSize(SDL_VideoDevice *_this, SDL_Window *windo
 extern void Cocoa_SetWindowAspectRatio(SDL_VideoDevice *_this, SDL_Window *window);
 extern void Cocoa_GetWindowSizeInPixels(SDL_VideoDevice *_this, SDL_Window *window, int *w, int *h);
 extern bool Cocoa_SetWindowOpacity(SDL_VideoDevice *_this, SDL_Window *window, float opacity);
+extern void Cocoa_SetWindowMousePassthrough(SDL_VideoDevice *_this, SDL_Window *window, bool passthrough);
 extern void Cocoa_ShowWindow(SDL_VideoDevice *_this, SDL_Window *window);
 extern void Cocoa_HideWindow(SDL_VideoDevice *_this, SDL_Window *window);
 extern void Cocoa_RaiseWindow(SDL_VideoDevice *_this, SDL_Window *window);

src/video/cocoa/SDL_cocoawindow.m

@@ -3416,6 +3416,13 @@ bool Cocoa_SetWindowOpacity(SDL_VideoDevice *_this, SDL_Window *window, float op
     }
 }
 
+void Cocoa_SetWindowMousePassthrough(SDL_VideoDevice *_this, SDL_Window *window, bool passthrough) {
+    @autoreleasepool {
+        SDL_CocoaWindowData *data = (__bridge SDL_CocoaWindowData *)window->internal;
+        [data.nswindow setIgnoresMouseEvents:passthrough];
+    }
+}
+
 bool Cocoa_SyncWindow(SDL_VideoDevice *_this, SDL_Window *window)
 {
     bool result = false;

src/video/wayland/SDL_waylandvideo.c

@@ -656,6 +656,7 @@ static SDL_VideoDevice *Wayland_CreateDevice(bool require_preferred_protocols)
     device->SetWindowParent = Wayland_SetWindowParent;
     device->SetWindowModal = Wayland_SetWindowModal;
     device->SetWindowOpacity = Wayland_SetWindowOpacity;
+    device->SetWindowMousePassthrough = Wayland_SetWindowMousePassthrough;
     device->SetWindowTitle = Wayland_SetWindowTitle;
     device->SetWindowIcon = Wayland_SetWindowIcon;
     device->GetWindowSizeInPixels = Wayland_GetWindowSizeInPixels;