godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2026-01-04 14:11:02 +03:00
Code Issues Packages Projects Releases Wiki Activity

Add note about behavioral changes

Browse Source 
Add note about necessary changes for `SubViewportContainer`
input-event-propagation.
This commit is contained in:
Markus Sauermann
2023-07-10 21:23:21 +02:00
committed by Max Hilbrunner
parent b861b68237
commit d8de53d4d8
1 changed files with 17 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
tutorials/migrating/upgrading_to_godot_4.1.rst
View File

@@ -191,10 +191,25 @@ Method ``create_action`` adds a new ``backward_undo_ops`` optional parameter
======================================================================================================================== =================== ==================== ==================== ===========
Behavior changes
----------------
In 4.1 some behavior changes have been introduced, which might require you to adjust your project.
================================================================================================================================================================================================== ===========
Change Introduced
================================================================================================================================================================================================== ===========
**SubViewportContainer**
When input events should reach SubViewports and their children, ``SubViewportContainer.mouse_filter`` now needs to be ``MOUSE_FILTER_STOP`` or ``MOUSE_FILTER_PASS``. See `GH-79271`_ for details. `GH-57894`_
Multiple layered ``SubViewportContainer`` nodes, that should all receive mouse input events, now need to be replaced by ``Area2D`` nodes. See `GH-79128`_ for details. `GH-57894`_
================================================================================================================================================================================================== ===========
.. |❌| replace:: :abbr:`❌ (This API breaks compatibility.)`
.. |✔️| replace:: :abbr:`✔️ (This API does not break compatibility.)`
.. |✔️ with compat| replace:: :abbr:`✔️ (This API does not break compatibility. A compatibility method was added.)`
.. _GH-57894: https://github.com/godotengine/godot/pull/57894
.. _GH-64628: https://github.com/godotengine/godot/pull/64628
.. _GH-69988: https://github.com/godotengine/godot/pull/69988
.. _GH-72152: https://github.com/godotengine/godot/pull/72152
@@ -214,6 +229,8 @@ Method ``create_action`` adds a new ``backward_undo_ops`` optional parameter
.. _GH-76794: https://github.com/godotengine/godot/pull/76794
.. _GH-77143: https://github.com/godotengine/godot/pull/77143
.. _GH-78237: https://github.com/godotengine/godot/pull/78237
.. _GH-79128: https://github.com/godotengine/godot/issues/79128
.. _GH-79271: https://github.com/godotengine/godot/issues/79271
.. _updating_your_gdextension_for_godot_4_1: