diff --git a/core/bind/core_bind.cpp b/core/bind/core_bind.cpp index 1d2c39ed6fa..6325a08187d 100644 --- a/core/bind/core_bind.cpp +++ b/core/bind/core_bind.cpp @@ -215,6 +215,11 @@ void _OS::set_window_title(const String &p_title) { OS::get_singleton()->set_window_title(p_title); } +void _OS::set_window_mouse_passthrough(const PoolVector2Array &p_region) { + + OS::get_singleton()->set_window_mouse_passthrough(p_region); +} + int _OS::get_mouse_button_state() const { return OS::get_singleton()->get_mouse_button_state(); @@ -1307,6 +1312,7 @@ void _OS::_bind_methods() { ClassDB::bind_method(D_METHOD("has_touchscreen_ui_hint"), &_OS::has_touchscreen_ui_hint); ClassDB::bind_method(D_METHOD("set_window_title", "title"), &_OS::set_window_title); + ClassDB::bind_method(D_METHOD("set_window_mouse_passthrough", "region"), &_OS::set_window_mouse_passthrough); ClassDB::bind_method(D_METHOD("set_low_processor_usage_mode", "enable"), &_OS::set_low_processor_usage_mode); ClassDB::bind_method(D_METHOD("is_in_low_processor_usage_mode"), &_OS::is_in_low_processor_usage_mode); diff --git a/core/bind/core_bind.h b/core/bind/core_bind.h index d880ac145a4..9d00e27a43f 100644 --- a/core/bind/core_bind.h +++ b/core/bind/core_bind.h @@ -150,6 +150,7 @@ public: Point2 get_mouse_position() const; void set_window_title(const String &p_title); + void set_window_mouse_passthrough(const PoolVector2Array &p_region); int get_mouse_button_state() const; void set_clipboard(const String &p_text); diff --git a/core/os/os.h b/core/os/os.h index 160282042cf..f97d89e7116 100644 --- a/core/os/os.h +++ b/core/os/os.h @@ -174,6 +174,7 @@ public: virtual Point2 get_mouse_position() const = 0; virtual int get_mouse_button_state() const = 0; virtual void set_window_title(const String &p_title) = 0; + virtual void set_window_mouse_passthrough(const PoolVector2Array &p_region){}; virtual void set_clipboard(const String &p_text); virtual String get_clipboard() const; diff --git a/doc/classes/OS.xml b/doc/classes/OS.xml index 72c1c55dbf0..93a01c845b0 100644 --- a/doc/classes/OS.xml +++ b/doc/classes/OS.xml @@ -966,6 +966,28 @@ [b]Note:[/b] This method is implemented on Linux, macOS and Windows. + + + + + + + Sets a polygonal region of the window which accepts mouse events. Mouse events outside the region will be passed through. + Passing an empty array will disable passthrough support (all mouse events will be intercepted by the window, which is the default behavior). + [codeblock] + # Set region, using Path2D node. + OS.set_window_mouse_passthrough($Path2D.curve.get_baked_points()) + + # Set region, using Polygon2D node. + OS.set_window_mouse_passthrough($Polygon2D.polygon) + + # Reset region to default. + OS.set_window_mouse_passthrough([]) + [/codeblock] + [b]Note:[/b] On Windows, the portion of a window that lies outside the region is not drawn, while on Linux and macOS it is. + [b]Note:[/b] This method is implemented on Linux, macOS and Windows. + + diff --git a/platform/osx/os_osx.h b/platform/osx/os_osx.h index 8187ca0b8e4..24fa3f977d6 100644 --- a/platform/osx/os_osx.h +++ b/platform/osx/os_osx.h @@ -114,6 +114,7 @@ public: NSOpenGLPixelFormat *pixelFormat; NSOpenGLContext *context; + Vector mpath; bool layered_window; CursorShape cursor_shape; @@ -208,6 +209,7 @@ public: virtual int get_mouse_button_state() const; void update_real_mouse_position(); virtual void set_window_title(const String &p_title); + virtual void set_window_mouse_passthrough(const PoolVector2Array &p_region); virtual Size2 get_window_size() const; virtual Size2 get_real_window_size() const; diff --git a/platform/osx/os_osx.mm b/platform/osx/os_osx.mm index 142a9ec3f62..fea9ee34393 100644 --- a/platform/osx/os_osx.mm +++ b/platform/osx/os_osx.mm @@ -30,6 +30,7 @@ #include "os_osx.h" +#include "core/math/geometry.h" #include "core/os/keyboard.h" #include "core/print_string.h" #include "core/version_generated.gen.h" @@ -2136,6 +2137,13 @@ void OS_OSX::set_window_title(const String &p_title) { [window_object setTitle:[NSString stringWithUTF8String:p_title.utf8().get_data()]]; } +void OS_OSX::set_window_mouse_passthrough(const PoolVector2Array &p_region) { + mpath.clear(); + for (int i = 0; i < p_region.size(); i++) { + mpath.push_back(p_region[i]); + } +} + void OS_OSX::set_native_icon(const String &p_filename) { FileAccess *f = FileAccess::open(p_filename, FileAccess::READ); @@ -3053,6 +3061,23 @@ void OS_OSX::process_events() { } process_key_events(); + if (mpath.size() > 0) { + const Vector2 mpos = get_mouse_pos([window_object mouseLocationOutsideOfEventStream]); + if (Geometry::is_point_in_polygon(mpos, mpath)) { + if ([window_object ignoresMouseEvents]) { + [window_object setIgnoresMouseEvents:NO]; + } + } else { + if (![window_object ignoresMouseEvents]) { + [window_object setIgnoresMouseEvents:YES]; + } + } + } else { + if ([window_object ignoresMouseEvents]) { + [window_object setIgnoresMouseEvents:NO]; + } + } + [autoreleasePool drain]; autoreleasePool = [[NSAutoreleasePool alloc] init]; diff --git a/platform/windows/os_windows.cpp b/platform/windows/os_windows.cpp index b7766dccb51..0007155e0ee 100755 --- a/platform/windows/os_windows.cpp +++ b/platform/windows/os_windows.cpp @@ -34,6 +34,7 @@ #include "os_windows.h" #include "core/io/marshalls.h" +#include "core/math/geometry.h" #include "core/version_generated.gen.h" #include "drivers/gles2/rasterizer_gles2.h" #include "drivers/gles3/rasterizer_gles3.h" @@ -1952,6 +1953,36 @@ void OS_Windows::set_window_title(const String &p_title) { SetWindowTextW(hWnd, p_title.c_str()); } +void OS_Windows::set_window_mouse_passthrough(const PoolVector2Array &p_region) { + mpath.clear(); + for (int i = 0; i < p_region.size(); i++) { + mpath.push_back(p_region[i]); + } + _update_window_mouse_passthrough(); +} + +void OS_Windows::_update_window_mouse_passthrough() { + if (mpath.size() == 0) { + SetWindowRgn(hWnd, NULL, TRUE); + } else { + POINT *points = (POINT *)memalloc(sizeof(POINT) * mpath.size()); + for (int i = 0; i < mpath.size(); i++) { + if (video_mode.borderless_window) { + points[i].x = mpath[i].x; + points[i].y = mpath[i].y; + } else { + points[i].x = mpath[i].x + GetSystemMetrics(SM_CXSIZEFRAME); + points[i].y = mpath[i].y + GetSystemMetrics(SM_CYSIZEFRAME) + GetSystemMetrics(SM_CYCAPTION); + } + } + + HRGN region = CreatePolygonRgn(points, mpath.size(), ALTERNATE); + SetWindowRgn(hWnd, region, TRUE); + DeleteObject(region); + memfree(points); + } +} + void OS_Windows::set_video_mode(const VideoMode &p_video_mode, int p_screen) { } @@ -2339,6 +2370,7 @@ void OS_Windows::set_borderless_window(bool p_borderless) { preserve_window_size = true; _update_window_style(); + _update_window_mouse_passthrough(); } bool OS_Windows::get_borderless_window() { diff --git a/platform/windows/os_windows.h b/platform/windows/os_windows.h index 69767b6764b..6ddb3c3ac6d 100644 --- a/platform/windows/os_windows.h +++ b/platform/windows/os_windows.h @@ -309,6 +309,8 @@ class OS_Windows : public OS { int pressrc; HINSTANCE hInstance; // Holds The Instance Of The Application HWND hWnd; + + Vector mpath; Point2 last_pos; bool layered_window; @@ -371,6 +373,7 @@ class OS_Windows : public OS { void _touch_event(bool p_pressed, float p_x, float p_y, int idx); void _update_window_style(bool p_repaint = true, bool p_maximized = false); + void _update_window_mouse_passthrough(); void _set_mouse_mode_impl(MouseMode p_mode); @@ -422,6 +425,7 @@ public: void update_real_mouse_position(); virtual int get_mouse_button_state() const; virtual void set_window_title(const String &p_title); + virtual void set_window_mouse_passthrough(const PoolVector2Array &p_region); virtual void set_video_mode(const VideoMode &p_video_mode, int p_screen = 0); virtual VideoMode get_video_mode(int p_screen = 0) const; diff --git a/platform/x11/detect.py b/platform/x11/detect.py index 716930db236..8087a08617d 100644 --- a/platform/x11/detect.py +++ b/platform/x11/detect.py @@ -36,6 +36,11 @@ def can_build(): print("xinerama not found.. x11 disabled.") return False + x11_error = os.system("pkg-config xext --modversion > /dev/null ") + if x11_error: + print("xext not found.. x11 disabled.") + return False + x11_error = os.system("pkg-config xrandr --modversion > /dev/null ") if x11_error: print("xrandr not found.. x11 disabled.") @@ -197,6 +202,7 @@ def configure(env): env.ParseConfig("pkg-config x11 --cflags --libs") env.ParseConfig("pkg-config xcursor --cflags --libs") env.ParseConfig("pkg-config xinerama --cflags --libs") + env.ParseConfig("pkg-config xext --cflags --libs") env.ParseConfig("pkg-config xrandr --cflags --libs") env.ParseConfig("pkg-config xrender --cflags --libs") env.ParseConfig("pkg-config xi --cflags --libs") diff --git a/platform/x11/os_x11.cpp b/platform/x11/os_x11.cpp index 5a71131d86d..a9d63bda45a 100644 --- a/platform/x11/os_x11.cpp +++ b/platform/x11/os_x11.cpp @@ -52,6 +52,7 @@ #include #include #include +#include // ICCCM #define WM_NormalState 1L // window normal state @@ -976,6 +977,33 @@ void OS_X11::set_window_title(const String &p_title) { XChangeProperty(x11_display, x11_window, _net_wm_name, utf8_string, 8, PropModeReplace, (unsigned char *)p_title.utf8().get_data(), p_title.utf8().length()); } +void OS_X11::set_window_mouse_passthrough(const PoolVector2Array &p_region) { + int event_base, error_base; + const Bool ext_okay = XShapeQueryExtension(x11_display, &event_base, &error_base); + if (ext_okay) { + Region region; + if (p_region.size() == 0) { + region = XCreateRegion(); + XRectangle rect; + rect.x = 0; + rect.y = 0; + rect.width = get_real_window_size().x; + rect.height = get_real_window_size().y; + XUnionRectWithRegion(&rect, region, region); + } else { + XPoint *points = (XPoint *)memalloc(sizeof(XPoint) * p_region.size()); + for (int i = 0; i < p_region.size(); i++) { + points[i].x = p_region[i].x; + points[i].y = p_region[i].y; + } + region = XPolygonRegion(points, p_region.size(), EvenOddRule); + memfree(points); + } + XShapeCombineRegion(x11_display, x11_window, ShapeInput, 0, 0, region, ShapeSet); + XDestroyRegion(region); + } +} + void OS_X11::set_video_mode(const VideoMode &p_video_mode, int p_screen) { } diff --git a/platform/x11/os_x11.h b/platform/x11/os_x11.h index 20d8e96b6d1..c1ff3b35417 100644 --- a/platform/x11/os_x11.h +++ b/platform/x11/os_x11.h @@ -238,6 +238,7 @@ public: virtual Point2 get_mouse_position() const; virtual int get_mouse_button_state() const; virtual void set_window_title(const String &p_title); + virtual void set_window_mouse_passthrough(const PoolVector2Array &p_region); virtual void set_icon(const Ref &p_icon);