From 7a231eab7518f9821cbe8418fae12de7ee651142 Mon Sep 17 00:00:00 2001 From: Godot Organization Date: Sat, 19 Jul 2025 03:38:08 +0000 Subject: [PATCH] classref: Sync with current master branch (71a9948) --- classes/class_animationmixer.rst | 2 + classes/class_displayserver.rst | 6 +- classes/class_editorsettings.rst | 182 +++++++++++++++++++++++++++++- classes/class_projectsettings.rst | 4 +- classes/class_renderingserver.rst | 2 +- classes/class_spinbox.rst | 4 +- classes/class_splitcontainer.rst | 84 ++++++++++---- classes/class_translation.rst | 6 + classes/class_viewport.rst | 2 +- 9 files changed, 264 insertions(+), 28 deletions(-) diff --git a/classes/class_animationmixer.rst b/classes/class_animationmixer.rst index 1d2d7e393..d33265e7c 100644 --- a/classes/class_animationmixer.rst +++ b/classes/class_animationmixer.rst @@ -169,6 +169,8 @@ Notifies when an animation list is changed. Notifies when an animation starts playing. +\ **Note:** This signal is not emitted if an animation is looping. + .. rst-class:: classref-item-separator ---- diff --git a/classes/class_displayserver.rst b/classes/class_displayserver.rst index 37500ce14..b97cd1104 100644 --- a/classes/class_displayserver.rst +++ b/classes/class_displayserver.rst @@ -2128,7 +2128,9 @@ The window background can be transparent. \ **Note:** This flag has no effect if :ref:`is_window_transparency_available()` returns ``false``. -\ **Note:** Transparency support is implemented on Android, Linux (X11/Wayland), macOS, and Windows, but availability might vary depending on GPU driver, display manager, and compositor capabilities. +\ **Note:** Transparency support is implemented on Linux (X11/Wayland), macOS, and Windows, but availability might vary depending on GPU driver, display manager, and compositor capabilities. + +\ **Note:** Transparency support is implemented on Android, but can only be enabled via :ref:`ProjectSettings.display/window/per_pixel_transparency/allowed`. This flag has no effect on Android. .. _class_DisplayServer_constant_WINDOW_FLAG_NO_FOCUS: @@ -5987,6 +5989,8 @@ Unregisters an :ref:`Object` representing an additional output, th Returns the on-screen keyboard's height in pixels. Returns 0 if there is no keyboard or if it is currently hidden. +\ **Note:** On Android 7 and 8, the keyboard height may return 0 the first time the keyboard is opened in non-immersive mode. This behavior does not occur in immersive mode. + .. rst-class:: classref-item-separator ---- diff --git a/classes/class_editorsettings.rst b/classes/class_editorsettings.rst index 036da48a3..6dabd076f 100644 --- a/classes/class_editorsettings.rst +++ b/classes/class_editorsettings.rst @@ -833,6 +833,18 @@ Properties +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`text_editor/theme/highlighting/comment_color` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Color` | :ref:`text_editor/theme/highlighting/comment_markers/critical_color` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`text_editor/theme/highlighting/comment_markers/critical_list` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Color` | :ref:`text_editor/theme/highlighting/comment_markers/notice_color` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`text_editor/theme/highlighting/comment_markers/notice_list` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Color` | :ref:`text_editor/theme/highlighting/comment_markers/warning_color` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`text_editor/theme/highlighting/comment_markers/warning_list` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`text_editor/theme/highlighting/completion_background_color` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`text_editor/theme/highlighting/completion_existing_color` | @@ -859,6 +871,18 @@ Properties +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`text_editor/theme/highlighting/function_color` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Color` | :ref:`text_editor/theme/highlighting/gdscript/annotation_color` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Color` | :ref:`text_editor/theme/highlighting/gdscript/function_definition_color` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Color` | :ref:`text_editor/theme/highlighting/gdscript/global_function_color` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Color` | :ref:`text_editor/theme/highlighting/gdscript/node_path_color` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Color` | :ref:`text_editor/theme/highlighting/gdscript/node_reference_color` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Color` | :ref:`text_editor/theme/highlighting/gdscript/string_name_color` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`text_editor/theme/highlighting/keyword_color` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`text_editor/theme/highlighting/line_length_guideline_color` | @@ -4010,7 +4034,9 @@ If ``true``, the Scene dock will display buttons to quickly add a root node to a :ref:`bool` **interface/inspector/auto_unfold_foreign_scenes** :ref:`🔗` -If ``true``, automatically expands property groups in the Inspector dock when opening a scene that hasn't been opened previously. If ``false``, all groups remain collapsed by default. +If ``true``, automatically unfolds Inspector property groups containing modified values when opening a scene for the first time. Only affects scenes without saved folding preferences and only unfolds groups with properties that have been changed from their default values. + +\ **Note:** This setting only works in specific scenarios: when opening a scene brought in from another project, or when opening a new scene that already has modified properties (e.g., from version control). Duplicated scenes are not considered foreign, so this setting will not affect them. .. rst-class:: classref-item-separator @@ -4622,6 +4648,8 @@ All update modes will ignore builds with different major versions (e.g. Godot 4 Determines whether online features are enabled in the editor, such as the Asset Library or update checks. Disabling these online features helps alleviate privacy concerns by preventing the editor from making HTTP requests to the Godot website or third-party platforms hosting assets from the Asset Library. +Editor plugins and tool scripts are recommended to follow this setting. However, Godot can't prevent them from violating this rule. + .. rst-class:: classref-item-separator ---- @@ -5948,6 +5976,84 @@ The script editor's comment color. ---- +.. _class_EditorSettings_property_text_editor/theme/highlighting/comment_markers/critical_color: + +.. rst-class:: classref-property + +:ref:`Color` **text_editor/theme/highlighting/comment_markers/critical_color** :ref:`🔗` + +The script editor's critical comment marker text color. These markers are determined by :ref:`text_editor/theme/highlighting/comment_markers/critical_list`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_property_text_editor/theme/highlighting/comment_markers/critical_list: + +.. rst-class:: classref-property + +:ref:`String` **text_editor/theme/highlighting/comment_markers/critical_list** :ref:`🔗` + +A comma-separated list of case-sensitive words to highlight in comments. The text will be highlighted in the script editor with the :ref:`text_editor/theme/highlighting/comment_markers/critical_color` color. These must not include spaces or symbols or they will not be highlighted. + +\ **Note:** This is only implemented in the GDScript syntax highlighter. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_property_text_editor/theme/highlighting/comment_markers/notice_color: + +.. rst-class:: classref-property + +:ref:`Color` **text_editor/theme/highlighting/comment_markers/notice_color** :ref:`🔗` + +The script editor's notice comment marker text color. These markers are determined by :ref:`text_editor/theme/highlighting/comment_markers/notice_list`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_property_text_editor/theme/highlighting/comment_markers/notice_list: + +.. rst-class:: classref-property + +:ref:`String` **text_editor/theme/highlighting/comment_markers/notice_list** :ref:`🔗` + +A comma-separated list of case-sensitive words to highlight in comments. The text will be highlighted in the script editor with the :ref:`text_editor/theme/highlighting/comment_markers/notice_color` color. These must not include spaces or symbols or they will not be highlighted. + +\ **Note:** This is only implemented in the GDScript syntax highlighter. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_property_text_editor/theme/highlighting/comment_markers/warning_color: + +.. rst-class:: classref-property + +:ref:`Color` **text_editor/theme/highlighting/comment_markers/warning_color** :ref:`🔗` + +The script editor's warning comment marker text color. These markers are determined by :ref:`text_editor/theme/highlighting/comment_markers/warning_list`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_property_text_editor/theme/highlighting/comment_markers/warning_list: + +.. rst-class:: classref-property + +:ref:`String` **text_editor/theme/highlighting/comment_markers/warning_list** :ref:`🔗` + +A comma-separated list of case-sensitive words to highlight in comments. The text will be highlighted in the script editor with the :ref:`text_editor/theme/highlighting/comment_markers/warning_color` color. These must not include spaces or symbols or they will not be highlighted. + +\ **Note:** This is only implemented in the GDScript syntax highlighter. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_property_text_editor/theme/highlighting/completion_background_color: .. rst-class:: classref-property @@ -6100,7 +6206,79 @@ The script editor's background line highlighting color for folded code region. The script editor's function call color. -\ **Note:** When using the GDScript syntax highlighter, this is replaced by the function definition color configured in the syntax theme for function definitions (e.g. ``func _ready():``). +\ **Note:** When using the GDScript syntax highlighter, this is only used when calling some functions since function definitions and global functions have their own colors :ref:`text_editor/theme/highlighting/gdscript/function_definition_color` and :ref:`text_editor/theme/highlighting/gdscript/global_function_color`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_property_text_editor/theme/highlighting/gdscript/annotation_color: + +.. rst-class:: classref-property + +:ref:`Color` **text_editor/theme/highlighting/gdscript/annotation_color** :ref:`🔗` + +The GDScript syntax highlighter text color for annotations (e.g. ``@export``). + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_property_text_editor/theme/highlighting/gdscript/function_definition_color: + +.. rst-class:: classref-property + +:ref:`Color` **text_editor/theme/highlighting/gdscript/function_definition_color** :ref:`🔗` + +The GDScript syntax highlighter text color for function definitions (e.g. the ``_ready`` in ``func _ready():``). + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_property_text_editor/theme/highlighting/gdscript/global_function_color: + +.. rst-class:: classref-property + +:ref:`Color` **text_editor/theme/highlighting/gdscript/global_function_color** :ref:`🔗` + +The GDScript syntax highlighter text color for global functions, such as the ones in :ref:`@GlobalScope` (e.g. ``preload()``). + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_property_text_editor/theme/highlighting/gdscript/node_path_color: + +.. rst-class:: classref-property + +:ref:`Color` **text_editor/theme/highlighting/gdscript/node_path_color** :ref:`🔗` + +The GDScript syntax highlighter text color for :ref:`NodePath` literals (e.g. ``^"position:x"``). + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_property_text_editor/theme/highlighting/gdscript/node_reference_color: + +.. rst-class:: classref-property + +:ref:`Color` **text_editor/theme/highlighting/gdscript/node_reference_color** :ref:`🔗` + +The GDScript syntax highlighter text color for node reference literals (e.g. ``$"Sprite"`` and ``%"Sprite"``]). + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_property_text_editor/theme/highlighting/gdscript/string_name_color: + +.. rst-class:: classref-property + +:ref:`Color` **text_editor/theme/highlighting/gdscript/string_name_color** :ref:`🔗` + +The GDScript syntax highlighter text color for :ref:`StringName` literals (e.g. ``>"example"``). .. rst-class:: classref-item-separator diff --git a/classes/class_projectsettings.rst b/classes/class_projectsettings.rst index 754336000..25def1217 100644 --- a/classes/class_projectsettings.rst +++ b/classes/class_projectsettings.rst @@ -4794,6 +4794,8 @@ If ``true``, enables a window manager hint that the main window background *can* \ **Note:** This setting has no effect if :ref:`display/window/per_pixel_transparency/allowed` is set to ``false``. +\ **Note:** This setting has no effect on Android as transparency is controlled only via :ref:`display/window/per_pixel_transparency/allowed`. + .. rst-class:: classref-item-separator ---- @@ -11174,7 +11176,7 @@ Sets the sensitivity to edges when using SMAA for antialiasing. Lower values wil :ref:`bool` **rendering/anti_aliasing/quality/use_debanding** = ``false`` :ref:`🔗` -If ``true``, uses a fast post-processing filter to make banding significantly less visible in 3D. 2D rendering is *not* affected by debanding unless the :ref:`Environment.background_mode` is :ref:`Environment.BG_CANVAS`. +If ``true``, uses a fast post-processing filter to make banding significantly less visible. If :ref:`rendering/viewport/hdr_2d` is ``false``, 2D rendering is *not* affected by debanding unless the :ref:`Environment.background_mode` is :ref:`Environment.BG_CANVAS`. If :ref:`rendering/viewport/hdr_2d` is ``true``, debanding will affect all 2D and 3D rendering, including canvas items. In some cases, debanding may introduce a slightly noticeable dithering pattern. It's recommended to enable debanding only when actually needed since the dithering pattern will make lossless-compressed screenshots larger. diff --git a/classes/class_renderingserver.rst b/classes/class_renderingserver.rst index c25d74758..77177403e 100644 --- a/classes/class_renderingserver.rst +++ b/classes/class_renderingserver.rst @@ -12475,7 +12475,7 @@ Sets when the viewport should be updated. |void| **viewport_set_use_debanding**\ (\ viewport\: :ref:`RID`, enable\: :ref:`bool`\ ) :ref:`🔗` -If ``true``, enables debanding on the specified viewport. Equivalent to :ref:`ProjectSettings.rendering/anti_aliasing/quality/use_debanding` or :ref:`Viewport.use_debanding`. +Equivalent to :ref:`Viewport.use_debanding`. See also :ref:`ProjectSettings.rendering/anti_aliasing/quality/use_debanding`. .. rst-class:: classref-item-separator diff --git a/classes/class_spinbox.rst b/classes/class_spinbox.rst index 89d4988ed..932bc4c3c 100644 --- a/classes/class_spinbox.rst +++ b/classes/class_spinbox.rst @@ -208,7 +208,9 @@ Changes the alignment of the underlying :ref:`LineEdit`. - |void| **set_custom_arrow_step**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_custom_arrow_step**\ (\ ) -If not ``0``, :ref:`Range.value` will always be rounded to a multiple of :ref:`custom_arrow_step` when interacting with the arrow buttons of the **SpinBox**. +If not ``0``, sets the step when interacting with the arrow buttons of the **SpinBox**. + +\ **Note:** :ref:`Range.value` will still be rounded to a multiple of :ref:`step`. .. rst-class:: classref-item-separator diff --git a/classes/class_splitcontainer.rst b/classes/class_splitcontainer.rst index 81986cb28..ffba1a597 100644 --- a/classes/class_splitcontainer.rst +++ b/classes/class_splitcontainer.rst @@ -82,27 +82,33 @@ Theme Properties .. table:: :widths: auto - +-----------------------------------+-------------------------------------------------------------------------------------------+--------+ - | :ref:`int` | :ref:`autohide` | ``1`` | - +-----------------------------------+-------------------------------------------------------------------------------------------+--------+ - | :ref:`int` | :ref:`minimum_grab_thickness` | ``6`` | - +-----------------------------------+-------------------------------------------------------------------------------------------+--------+ - | :ref:`int` | :ref:`separation` | ``12`` | - +-----------------------------------+-------------------------------------------------------------------------------------------+--------+ - | :ref:`Texture2D` | :ref:`grabber` | | - +-----------------------------------+-------------------------------------------------------------------------------------------+--------+ - | :ref:`Texture2D` | :ref:`h_grabber` | | - +-----------------------------------+-------------------------------------------------------------------------------------------+--------+ - | :ref:`Texture2D` | :ref:`h_touch_dragger` | | - +-----------------------------------+-------------------------------------------------------------------------------------------+--------+ - | :ref:`Texture2D` | :ref:`touch_dragger` | | - +-----------------------------------+-------------------------------------------------------------------------------------------+--------+ - | :ref:`Texture2D` | :ref:`v_grabber` | | - +-----------------------------------+-------------------------------------------------------------------------------------------+--------+ - | :ref:`Texture2D` | :ref:`v_touch_dragger` | | - +-----------------------------------+-------------------------------------------------------------------------------------------+--------+ - | :ref:`StyleBox` | :ref:`split_bar_background` | | - +-----------------------------------+-------------------------------------------------------------------------------------------+--------+ + +-----------------------------------+--------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`Color` | :ref:`touch_dragger_color` | ``Color(1, 1, 1, 0.3)`` | + +-----------------------------------+--------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`Color` | :ref:`touch_dragger_hover_color` | ``Color(1, 1, 1, 0.6)`` | + +-----------------------------------+--------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`Color` | :ref:`touch_dragger_pressed_color` | ``Color(1, 1, 1, 1)`` | + +-----------------------------------+--------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`int` | :ref:`autohide` | ``1`` | + +-----------------------------------+--------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`int` | :ref:`minimum_grab_thickness` | ``6`` | + +-----------------------------------+--------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`int` | :ref:`separation` | ``12`` | + +-----------------------------------+--------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`Texture2D` | :ref:`grabber` | | + +-----------------------------------+--------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`Texture2D` | :ref:`h_grabber` | | + +-----------------------------------+--------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`Texture2D` | :ref:`h_touch_dragger` | | + +-----------------------------------+--------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`Texture2D` | :ref:`touch_dragger` | | + +-----------------------------------+--------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`Texture2D` | :ref:`v_grabber` | | + +-----------------------------------+--------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`Texture2D` | :ref:`v_touch_dragger` | | + +-----------------------------------+--------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`StyleBox` | :ref:`split_bar_background` | | + +-----------------------------------+--------------------------------------------------------------------------------------------------+-------------------------+ .. rst-class:: classref-section-separator @@ -413,6 +419,42 @@ Returns the drag area :ref:`Control`. For example, you can move a Theme Property Descriptions --------------------------- +.. _class_SplitContainer_theme_color_touch_dragger_color: + +.. rst-class:: classref-themeproperty + +:ref:`Color` **touch_dragger_color** = ``Color(1, 1, 1, 0.3)`` :ref:`🔗` + +The color of the touch dragger. + +.. rst-class:: classref-item-separator + +---- + +.. _class_SplitContainer_theme_color_touch_dragger_hover_color: + +.. rst-class:: classref-themeproperty + +:ref:`Color` **touch_dragger_hover_color** = ``Color(1, 1, 1, 0.6)`` :ref:`🔗` + +The color of the touch dragger when hovered. + +.. rst-class:: classref-item-separator + +---- + +.. _class_SplitContainer_theme_color_touch_dragger_pressed_color: + +.. rst-class:: classref-themeproperty + +:ref:`Color` **touch_dragger_pressed_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` + +The color of the touch dragger when pressed. + +.. rst-class:: classref-item-separator + +---- + .. _class_SplitContainer_theme_constant_autohide: .. rst-class:: classref-themeproperty diff --git a/classes/class_translation.rst b/classes/class_translation.rst index bf0d37ef2..9c8b725ca 100644 --- a/classes/class_translation.rst +++ b/classes/class_translation.rst @@ -30,6 +30,8 @@ Tutorials - :doc:`Internationalizing games <../tutorials/i18n/internationalizing_games>` +- :doc:`Localization using gettext <../tutorials/i18n/localization_using_gettext>` + - :doc:`Locales <../tutorials/i18n/locales>` .. rst-class:: classref-reftable-group @@ -153,6 +155,8 @@ Adds a message involving plural translation if nonexistent, followed by its tran An additional context could be used to specify the translation context or differentiate polysemic words. +\ **Note:** Plurals are only supported in :doc:`gettext-based translations (PO) <../tutorials/i18n/localization_using_gettext>`, not CSV. + .. rst-class:: classref-item-separator ---- @@ -215,6 +219,8 @@ Returns a message's translation involving plurals. The number ``n`` is the number or quantity of the plural object. It will be used to guide the translation system to fetch the correct plural form for the selected language. +\ **Note:** Plurals are only supported in :doc:`gettext-based translations (PO) <../tutorials/i18n/localization_using_gettext>`, not CSV. + .. rst-class:: classref-item-separator ---- diff --git a/classes/class_viewport.rst b/classes/class_viewport.rst index 8d6d8e4eb..134fe70d3 100644 --- a/classes/class_viewport.rst +++ b/classes/class_viewport.rst @@ -1945,7 +1945,7 @@ If ``true``, the viewport should render its background as transparent. - |void| **set_use_debanding**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_using_debanding**\ (\ ) -If ``true``, uses a fast post-processing filter to make banding significantly less visible in 3D. 2D rendering is *not* affected by debanding unless the :ref:`Environment.background_mode` is :ref:`Environment.BG_CANVAS`. +If ``true``, uses a fast post-processing filter to make banding significantly less visible. If :ref:`use_hdr_2d` is ``false``, 2D rendering is *not* affected by debanding unless the :ref:`Environment.background_mode` is :ref:`Environment.BG_CANVAS`. If :ref:`use_hdr_2d` is ``true``, debanding will only be applied if this is the root **Viewport** and will affect all 2D and 3D rendering, including canvas items. In some cases, debanding may introduce a slightly noticeable dithering pattern. It's recommended to enable debanding only when actually needed since the dithering pattern will make lossless-compressed screenshots larger.