diff --git a/doc/classes/Viewport.xml b/doc/classes/Viewport.xml index e4fb3ee9abe..a55c40d0187 100644 --- a/doc/classes/Viewport.xml +++ b/doc/classes/Viewport.xml @@ -188,6 +188,20 @@ If [member handle_input_locally] is set to [code]false[/code], this method will try finding the first parent viewport that is set to handle input locally, and return its value for [method is_input_handled] instead. + + + + Inform the Viewport that the mouse has entered its area. Use this function before sending an [InputEventMouseButton] or [InputEventMouseMotion] to the [Viewport] with [method Viewport.push_input]. See also [method notify_mouse_exited]. + [b]Note:[/b] In most cases, it is not necessary to call this function because [SubViewport] nodes that are children of [SubViewportContainer] are notified automatically. This is only necessary when interacting with viewports in non-default ways, for example as textures in [TextureRect] or with an [Area3D] that forwards input events. + + + + + + Inform the Viewport that the mouse has left its area. Use this function when the node that displays the viewport notices the mouse has left the area of the displayed viewport. See also [method notify_mouse_entered]. + [b]Note:[/b] In most cases, it is not necessary to call this function because [SubViewport] nodes that are children of [SubViewportContainer] are notified automatically. This is only necessary when interacting with viewports in non-default ways, for example as textures in [TextureRect] or with an [Area3D] that forwards input events. + + diff --git a/scene/main/viewport.cpp b/scene/main/viewport.cpp index 76b2502bade..d0054baeff2 100644 --- a/scene/main/viewport.cpp +++ b/scene/main/viewport.cpp @@ -3352,6 +3352,22 @@ void Viewport::_push_unhandled_input_internal(const Ref &p_event) { } } +void Viewport::notify_mouse_entered() { + if (gui.mouse_in_viewport) { + WARN_PRINT_ED("The Viewport was previously notified that the mouse is in its area. There is no need to notify it at this time."); + return; + } + notification(NOTIFICATION_VP_MOUSE_ENTER); +} + +void Viewport::notify_mouse_exited() { + if (!gui.mouse_in_viewport) { + WARN_PRINT_ED("The Viewport was previously notified that the mouse has left its area. There is no need to notify it at this time."); + return; + } + _mouse_leave_viewport(); +} + void Viewport::set_physics_object_picking(bool p_enable) { ERR_MAIN_THREAD_GUARD; physics_object_picking = p_enable; @@ -4799,6 +4815,8 @@ void Viewport::_bind_methods() { #ifndef DISABLE_DEPRECATED ClassDB::bind_method(D_METHOD("push_unhandled_input", "event", "in_local_coords"), &Viewport::push_unhandled_input, DEFVAL(false)); #endif // DISABLE_DEPRECATED + ClassDB::bind_method(D_METHOD("notify_mouse_entered"), &Viewport::notify_mouse_entered); + ClassDB::bind_method(D_METHOD("notify_mouse_exited"), &Viewport::notify_mouse_exited); ClassDB::bind_method(D_METHOD("get_mouse_position"), &Viewport::get_mouse_position); ClassDB::bind_method(D_METHOD("warp_mouse", "position"), &Viewport::warp_mouse); diff --git a/scene/main/viewport.h b/scene/main/viewport.h index 63bec5b01c3..5260b513a95 100644 --- a/scene/main/viewport.h +++ b/scene/main/viewport.h @@ -596,6 +596,8 @@ public: #ifndef DISABLE_DEPRECATED void push_unhandled_input(const Ref &p_event, bool p_local_coords = false); #endif // DISABLE_DEPRECATED + void notify_mouse_entered(); + void notify_mouse_exited(); void set_disable_input(bool p_disable); bool is_input_disabled() const;