diff --git a/classes/class_animationplayer.rst b/classes/class_animationplayer.rst index ffa39105dba..b11956e6de9 100644 --- a/classes/class_animationplayer.rst +++ b/classes/class_animationplayer.rst @@ -661,7 +661,7 @@ If ``duration`` is a negative value, the duration is set to the interval between |void| **queue**\ (\ name\: :ref:`StringName`\ ) :ref:`🔗` -Queues an animation for playback once the current one is done. +Queues an animation for playback once the current animation and all previously queued animations are done. \ **Note:** If a looped animation is currently playing, the queued animation will never play unless the looped animation is stopped somehow. diff --git a/classes/class_arraymesh.rst b/classes/class_arraymesh.rst index 629392dde74..a1769807e4f 100644 --- a/classes/class_arraymesh.rst +++ b/classes/class_arraymesh.rst @@ -197,7 +197,9 @@ Overrides the :ref:`AABB` with one defined by user for use with frus - |void| **set_shadow_mesh**\ (\ value\: :ref:`ArrayMesh`\ ) - :ref:`ArrayMesh` **get_shadow_mesh**\ (\ ) -An optional mesh which is used for rendering shadows and can be used for the depth prepass. Can be used to increase performance of shadow rendering by using a mesh that only contains vertex position data (without normals, UVs, colors, etc.). +An optional mesh which can be used for rendering shadows and the depth prepass. Can be used to increase performance by supplying a mesh with fused vertices and only vertex position data (without normals, UVs, colors, etc.). + +\ **Note:** This mesh must have exactly the same vertex positions as the source mesh (including the source mesh's LODs, if present). If vertex positions differ, then the mesh will not draw correctly. .. rst-class:: classref-section-separator diff --git a/classes/class_editorsettings.rst b/classes/class_editorsettings.rst index 7f5acd3e040..7825f46e3f8 100644 --- a/classes/class_editorsettings.rst +++ b/classes/class_editorsettings.rst @@ -2795,6 +2795,8 @@ The default **Auto** value will only enable this if the editor was compiled with \ **Note:** If :ref:`interface/editor/update_continuously` is ``true``, the spinner icon displays in red. +\ **Note:** If the editor was started with the ``--debug-canvas-item-redraw`` :doc:`command line argument <../tutorials/editor/command_line_tutorial>`, the update spinner will *never* display regardless of this setting's value. This is to avoid confusion with what would cause redrawing in real world scenarios. + .. rst-class:: classref-item-separator ---- diff --git a/classes/class_filedialog.rst b/classes/class_filedialog.rst index 29bc9d9638e..b61b1c59457 100644 --- a/classes/class_filedialog.rst +++ b/classes/class_filedialog.rst @@ -279,7 +279,7 @@ Property Descriptions The file system access scope. See :ref:`Access` constants. -\ **Warning:** Currently, in sandboxed environments such as Web builds or sandboxed macOS apps, FileDialog cannot access the host file system. See `godot-proposals#1123 `__. +\ **Warning:** In Web builds, FileDialog cannot access the host file system. In sandboxed Linux and macOS environments, :ref:`use_native_dialog` is automatically used to allow limited access to host file system. .. rst-class:: classref-item-separator @@ -298,6 +298,8 @@ The file system access scope. See :ref:`Access` constant The current working directory of the file dialog. +\ **Note:** For native file dialogs, this property is only treated as a hint and may not be respected by specific OS implementations. + .. rst-class:: classref-item-separator ---- @@ -419,6 +421,8 @@ The number of additional :ref:`OptionButton`\ s and :ref:`Ch If non-empty, the given sub-folder will be "root" of this **FileDialog**, i.e. user won't be able to go to its parent directory. +\ **Note:** This property is ignored by native file dialogs. + .. rst-class:: classref-item-separator ---- @@ -436,6 +440,8 @@ If non-empty, the given sub-folder will be "root" of this **FileDialog**, i.e. u If ``true``, the dialog will show hidden files. +\ **Note:** This property is ignored by native file dialogs on Linux. + .. rst-class:: classref-item-separator ---- @@ -453,7 +459,11 @@ If ``true``, the dialog will show hidden files. If ``true``, :ref:`access` is set to :ref:`ACCESS_FILESYSTEM`, and it is supported by the current :ref:`DisplayServer`, OS native dialog will be used instead of custom one. -\ **Note:** On macOS, sandboxed apps always use native dialogs to access host filesystem. +\ **Note:** On Linux and macOS, sandboxed apps always use native dialogs to access the host file system. + +\ **Note:** On macOS, sandboxed apps will save security-scoped bookmarks to retain access to the opened folders across multiple sessions. Use :ref:`OS.get_granted_permissions` to get a list of saved bookmarks. + +\ **Note:** Native dialogs are isolated from the base process, file dialog properties can't be modified once the dialog is shown. .. rst-class:: classref-section-separator @@ -590,6 +600,8 @@ Returns the vertical box container of the dialog, custom controls can be added t \ **Warning:** This is a required internal node, removing and freeing it may cause a crash. If you wish to hide it or any of its children, use their :ref:`CanvasItem.visible` property. +\ **Note:** Changes to this node are ignored by native file dialogs, use :ref:`add_option` to add custom elements to the dialog instead. + .. rst-class:: classref-item-separator ---- @@ -602,6 +614,8 @@ Returns the vertical box container of the dialog, custom controls can be added t Invalidate and update the current dialog content list. +\ **Note:** This method does nothing on native file dialogs. + .. rst-class:: classref-item-separator ---- diff --git a/classes/class_physicsserver2d.rst b/classes/class_physicsserver2d.rst index 8a58d30b956..500395ab270 100644 --- a/classes/class_physicsserver2d.rst +++ b/classes/class_physicsserver2d.rst @@ -208,6 +208,8 @@ Methods +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`body_set_state`\ (\ body\: :ref:`RID`, state\: :ref:`BodyState`, value\: :ref:`Variant`\ ) | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`body_set_state_sync_callback`\ (\ body\: :ref:`RID`, callable\: :ref:`Callable`\ ) | + +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`body_test_motion`\ (\ body\: :ref:`RID`, parameters\: :ref:`PhysicsTestMotionParameters2D`, result\: :ref:`PhysicsTestMotionResult2D` = null\ ) | +-------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`capsule_shape_create`\ (\ ) | @@ -2151,6 +2153,24 @@ Sets the value of a body's state. See :ref:`BodyState`, callable\: :ref:`Callable`\ ) :ref:`🔗` + +Sets the body's state synchronization callback function to ``callable``. Use an empty :ref:`Callable` (``Callable()``) to clear the callback. + +The function ``callable`` will be called every physics frame, assuming that the body was active during the previous physics tick, and can be used to fetch the latest state from the physics server. + +The function ``callable`` must take the following parameters: + +1. ``state``: a :ref:`PhysicsDirectBodyState2D`, used to retrieve the body's state. + +.. rst-class:: classref-item-separator + +---- + .. _class_PhysicsServer2D_method_body_test_motion: .. rst-class:: classref-method diff --git a/classes/class_physicsserver2dextension.rst b/classes/class_physicsserver2dextension.rst index c93a466d3c2..c0bb62666d8 100644 --- a/classes/class_physicsserver2dextension.rst +++ b/classes/class_physicsserver2dextension.rst @@ -1386,7 +1386,7 @@ Overridable version of :ref:`PhysicsServer2D.body_set_state` is called. See also :ref:`_sync`. -Overridable version of :ref:`PhysicsServer2D`'s internal ``body_set_state_sync_callback`` method. +Overridable version of :ref:`PhysicsServer2D.body_set_state_sync_callback`. .. rst-class:: classref-item-separator diff --git a/classes/class_physicsserver3d.rst b/classes/class_physicsserver3d.rst index bb6015042b8..cd8e76c55ed 100644 --- a/classes/class_physicsserver3d.rst +++ b/classes/class_physicsserver3d.rst @@ -206,6 +206,8 @@ Methods +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`body_set_state`\ (\ body\: :ref:`RID`, state\: :ref:`BodyState`, value\: :ref:`Variant`\ ) | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`body_set_state_sync_callback`\ (\ body\: :ref:`RID`, callable\: :ref:`Callable`\ ) | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`body_test_motion`\ (\ body\: :ref:`RID`, parameters\: :ref:`PhysicsTestMotionParameters3D`, result\: :ref:`PhysicsTestMotionResult3D` = null\ ) | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`box_shape_create`\ (\ ) | @@ -2887,6 +2889,24 @@ Sets a body state (see :ref:`BodyState` constant ---- +.. _class_PhysicsServer3D_method_body_set_state_sync_callback: + +.. rst-class:: classref-method + +|void| **body_set_state_sync_callback**\ (\ body\: :ref:`RID`, callable\: :ref:`Callable`\ ) :ref:`🔗` + +Sets the body's state synchronization callback function to ``callable``. Use an empty :ref:`Callable` (``Callable()``) to clear the callback. + +The function ``callable`` will be called every physics frame, assuming that the body was active during the previous physics tick, and can be used to fetch the latest state from the physics server. + +The function ``callable`` must take the following parameters: + +1. ``state``: a :ref:`PhysicsDirectBodyState3D`, used to retrieve the body's state. + +.. rst-class:: classref-item-separator + +---- + .. _class_PhysicsServer3D_method_body_test_motion: .. rst-class:: classref-method diff --git a/classes/class_scenetree.rst b/classes/class_scenetree.rst index 82e2d63d69c..3b3562a856e 100644 --- a/classes/class_scenetree.rst +++ b/classes/class_scenetree.rst @@ -730,7 +730,7 @@ Returns ``true`` if a node added to the given group ``name`` exists in the tree. |void| **notify_group**\ (\ group\: :ref:`StringName`, notification\: :ref:`int`\ ) :ref:`🔗` -Calls :ref:`Object.notification` with the given ``notification`` to all nodes inside this tree added to the ``group``. See also :ref:`call_group` and :ref:`set_group`. +Calls :ref:`Object.notification` with the given ``notification`` to all nodes inside this tree added to the ``group``. See also :doc:`Godot notifications <../tutorials/best_practices/godot_notifications>` and :ref:`call_group` and :ref:`set_group`. \ **Note:** This method acts immediately on all selected nodes at once, which may cause stuttering in some performance-intensive situations. diff --git a/classes/class_textparagraph.rst b/classes/class_textparagraph.rst index 2309a3997fd..f9d6088f07b 100644 --- a/classes/class_textparagraph.rst +++ b/classes/class_textparagraph.rst @@ -593,7 +593,7 @@ Returns TextServer line buffer RID. :ref:`Vector2` **get_line_size**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` -Returns size of the bounding box of the line of text. +Returns size of the bounding box of the line of text. Returned size is rounded up. .. rst-class:: classref-item-separator diff --git a/classes/class_websocketpeer.rst b/classes/class_websocketpeer.rst index c7d7d73de46..b2104534c39 100644 --- a/classes/class_websocketpeer.rst +++ b/classes/class_websocketpeer.rst @@ -482,7 +482,7 @@ Sends the given ``message`` using WebSocket text mode. Prefer this method over : |void| **set_no_delay**\ (\ enabled\: :ref:`bool`\ ) :ref:`🔗` -Disable Nagle's algorithm on the underling TCP socket (default). See :ref:`StreamPeerTCP.set_no_delay` for more information. +Disable Nagle's algorithm on the underlying TCP socket (default). See :ref:`StreamPeerTCP.set_no_delay` for more information. \ **Note:** Not available in the Web export.