Merge pull request #10728 from godotengine/classref/sync-15ff450

mhilbrunner · web-flow · commit 0c9c905c1a2a · 2025-03-01T09:20:49.000+01:00
classref: Sync with current master branch (15ff450)
diff --git a/classes/class_@globalscope.rst b/classes/class_@globalscope.rst
@@ -4219,6 +4219,14 @@ Flag for a static method.
 
 Used internally. Allows to not dump core virtual methods (such as :ref:`Object._notification()<class_Object_private_method__notification>`) to the JSON API.
 
+.. _class_@GlobalScope_constant_METHOD_FLAG_VIRTUAL_REQUIRED:
+
+.. rst-class:: classref-enumeration-constant
+
+:ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_VIRTUAL_REQUIRED** = ``128``
+
+Flag for a virtual method that is required.
+
 .. _class_@GlobalScope_constant_METHOD_FLAGS_DEFAULT:
 
 .. rst-class:: classref-enumeration-constant
diff --git a/classes/class_cubemap.rst b/classes/class_cubemap.rst
@@ -23,7 +23,9 @@ A cubemap is made of 6 textures organized in layers. They are typically used for
 
 This resource is typically used as a uniform in custom shaders. Few core Godot methods make use of **Cubemap** resources.
 
-To create such a texture file yourself, reimport your image files using the Godot Editor import presets. The expected image order is X+, X-, Y+, Y-, Z+, Z- (in Godot's coordinate system, so Y+ is "up" and Z- is "forward"). You can use one of the following templates as a base:
+To create such a texture file yourself, reimport your image files using the Godot Editor import presets. To create a Cubemap from code, use :ref:`ImageTextureLayered.create_from_images()<class_ImageTextureLayered_method_create_from_images>` on an instance of the Cubemap class.
+
+The expected image order is X+, X-, Y+, Y-, Z+, Z- (in Godot's coordinate system, so Y+ is "up" and Z- is "forward"). You can use one of the following templates as a base:
 
 - `2×3 cubemap template (default layout option) <https://raw.githubusercontent.com/godotengine/godot-docs/master/tutorials/assets_pipeline/img/cubemap_template_2x3.webp>`__\ 
 
diff --git a/classes/class_cubemaparray.rst b/classes/class_cubemaparray.rst
@@ -23,9 +23,23 @@ Description
 
 The primary benefit of **CubemapArray**\ s is that they can be accessed in shader code using a single texture reference. In other words, you can pass multiple :ref:`Cubemap<class_Cubemap>`\ s into a shader using a single **CubemapArray**. :ref:`Cubemap<class_Cubemap>`\ s are allocated in adjacent cache regions on the GPU, which makes **CubemapArray**\ s the most efficient way to store multiple :ref:`Cubemap<class_Cubemap>`\ s.
 
-\ **Note:** Godot uses **CubemapArray**\ s internally for many effects, including the :ref:`Sky<class_Sky>` if you set :ref:`ProjectSettings.rendering/reflections/sky_reflections/texture_array_reflections<class_ProjectSettings_property_rendering/reflections/sky_reflections/texture_array_reflections>` to ``true``. To create such a texture file yourself, reimport your image files using the import presets of the File System dock.
+Godot uses **CubemapArray**\ s internally for many effects, including the :ref:`Sky<class_Sky>` if you set :ref:`ProjectSettings.rendering/reflections/sky_reflections/texture_array_reflections<class_ProjectSettings_property_rendering/reflections/sky_reflections/texture_array_reflections>` to ``true``.
 
-\ **Note:** **CubemapArray** is not supported in the Compatibility renderer.
+To create such a texture file yourself, reimport your image files using the Godot Editor import presets. To create a CubemapArray from code, use :ref:`ImageTextureLayered.create_from_images()<class_ImageTextureLayered_method_create_from_images>` on an instance of the CubemapArray class.
+
+The expected image order is X+, X-, Y+, Y-, Z+, Z- (in Godot's coordinate system, so Y+ is "up" and Z- is "forward"). You can use one of the following templates as a base:
+
+- `2×3 cubemap template (default layout option) <https://raw.githubusercontent.com/godotengine/godot-docs/master/tutorials/assets_pipeline/img/cubemap_template_2x3.webp>`__\ 
+
+- `3×2 cubemap template <https://raw.githubusercontent.com/godotengine/godot-docs/master/tutorials/assets_pipeline/img/cubemap_template_3x2.webp>`__\ 
+
+- `1×6 cubemap template <https://raw.githubusercontent.com/godotengine/godot-docs/master/tutorials/assets_pipeline/img/cubemap_template_1x6.webp>`__\ 
+
+- `6×1 cubemap template <https://raw.githubusercontent.com/godotengine/godot-docs/master/tutorials/assets_pipeline/img/cubemap_template_6x1.webp>`__\ 
+
+Multiple layers are stacked on top of each other when using the default vertical import option (with the first layer at the top). Alternatively, you can choose an horizontal layout in the import options (with the first layer at the left).
+
+\ **Note:** **CubemapArray** is not supported in the Compatibility renderer due to graphics API limitations.
 
 .. rst-class:: classref-reftable-group
 
diff --git a/classes/class_editorsettings.rst b/classes/class_editorsettings.rst
@@ -603,6 +603,8 @@ Properties
    +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | :ref:`String<class_String>`                       | :ref:`network/tls/editor_tls_certificates<class_EditorSettings_property_network/tls/editor_tls_certificates>`                                                                                                     |
    +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+   | :ref:`bool<class_bool>`                           | :ref:`network/tls/enable_tls_v1.3<class_EditorSettings_property_network/tls/enable_tls_v1.3>`                                                                                                                     |
+   +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | :ref:`String<class_String>`                       | :ref:`project_manager/default_renderer<class_EditorSettings_property_project_manager/default_renderer>`                                                                                                           |
    +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | :ref:`int<class_int>`                             | :ref:`project_manager/directory_naming_convention<class_EditorSettings_property_project_manager/directory_naming_convention>`                                                                                     |
@@ -4460,6 +4462,20 @@ The TLS certificate bundle to use for HTTP requests made within the editor (e.g.
 
 ----
 
+.. _class_EditorSettings_property_network/tls/enable_tls_v1.3:
+
+.. rst-class:: classref-property
+
+:ref:`bool<class_bool>` **network/tls/enable_tls_v1.3** :ref:`🔗<class_EditorSettings_property_network/tls/enable_tls_v1.3>`
+
+If ``true``, enable TLSv1.3 negotiation.
+
+\ **Note:** Only supported when using Mbed TLS 3.0 or later (Linux distribution packages may be compiled against older system Mbed TLS packages), otherwise the maximum supported TLS version is always TLSv1.2.
+
+.. rst-class:: classref-item-separator
+
+----
+
 .. _class_EditorSettings_property_project_manager/default_renderer:
 
 .. rst-class:: classref-property
diff --git a/classes/class_editortranslationparserplugin.rst b/classes/class_editortranslationparserplugin.rst
@@ -41,7 +41,7 @@ Below shows an example of a custom parser that extracts strings from a CSV file
         var text = file.get_as_text()
         var split_strs = text.split(",", false)
         for s in split_strs:
-            msgids.append(PackedStringArray([s]))
+            ret.append(PackedStringArray([s]))
             #print("Extracted string: " + s)
     
         return ret
diff --git a/classes/class_imagetexturelayered.rst b/classes/class_imagetexturelayered.rst
@@ -56,6 +56,40 @@ Creates an **ImageTextureLayered** from an array of :ref:`Image<class_Image>`\ s
 
 Each :ref:`Image<class_Image>` represents one ``layer``.
 
+::
+
+    # Fill in an array of Images with different colors.
+    var images = []
+    const LAYERS = 6
+    for i in LAYERS:
+        var image = Image.create_empty(128, 128, false, Image.FORMAT_RGB8)
+        if i % 3 == 0:
+            image.fill(Color.RED)
+        elif i % 3 == 1:
+            image.fill(Color.GREEN)
+        else:
+            image.fill(Color.BLUE)
+        images.push_back(image)
+    
+    # Create and save a 2D texture array. The array of images must have at least 1 Image.
+    var texture_2d_array = Texture2DArray.new()
+    texture_2d_array.create_from_images(images)
+    ResourceSaver.save(texture_2d_array, "res://texture_2d_array.res", ResourceSaver.FLAG_COMPRESS)
+    
+    # Create and save a cubemap. The array of images must have exactly 6 Images.
+    # The cubemap's images are specified in this order: X+, X-, Y+, Y-, Z+, Z-
+    # (in Godot's coordinate system, so Y+ is "up" and Z- is "forward").
+    var cubemap = Cubemap.new()
+    cubemap.create_from_images(images)
+    ResourceSaver.save(cubemap, "res://cubemap.res", ResourceSaver.FLAG_COMPRESS)
+    
+    # Create and save a cubemap array. The array of images must have a multiple of 6 Images.
+    # Each cubemap's images are specified in this order: X+, X-, Y+, Y-, Z+, Z-
+    # (in Godot's coordinate system, so Y+ is "up" and Z- is "forward").
+    var cubemap_array = CubemapArray.new()
+    cubemap_array.create_from_images(images)
+    ResourceSaver.save(cubemap_array, "res://cubemap_array.res", ResourceSaver.FLAG_COMPRESS)
+
 .. rst-class:: classref-item-separator
 
 ----
diff --git a/classes/class_input.rst b/classes/class_input.rst
@@ -536,6 +536,8 @@ Note this method returns an empty :ref:`Vector3<class_Vector3>` when running fro
 
 \ **Note:** This method only works on Android and iOS. On other platforms, it always returns :ref:`Vector3.ZERO<class_Vector3_constant_ZERO>`.
 
+\ **Note:** For Android, :ref:`ProjectSettings.input_devices/sensors/enable_accelerometer<class_ProjectSettings_property_input_devices/sensors/enable_accelerometer>` must be enabled.
+
 .. rst-class:: classref-item-separator
 
 ----
@@ -616,6 +618,8 @@ Returns the gravity in m/s² of the device's accelerometer sensor, if the device
 
 \ **Note:** This method only works on Android and iOS. On other platforms, it always returns :ref:`Vector3.ZERO<class_Vector3_constant_ZERO>`.
 
+\ **Note:** For Android, :ref:`ProjectSettings.input_devices/sensors/enable_gravity<class_ProjectSettings_property_input_devices/sensors/enable_gravity>` must be enabled.
+
 .. rst-class:: classref-item-separator
 
 ----
@@ -630,6 +634,8 @@ Returns the rotation rate in rad/s around a device's X, Y, and Z axes of the gyr
 
 \ **Note:** This method only works on Android and iOS. On other platforms, it always returns :ref:`Vector3.ZERO<class_Vector3_constant_ZERO>`.
 
+\ **Note:** For Android, :ref:`ProjectSettings.input_devices/sensors/enable_gyroscope<class_ProjectSettings_property_input_devices/sensors/enable_gyroscope>` must be enabled.
+
 .. rst-class:: classref-item-separator
 
 ----
@@ -762,6 +768,8 @@ Returns the magnetic field strength in micro-Tesla for all axes of the device's
 
 \ **Note:** This method only works on Android and iOS. On other platforms, it always returns :ref:`Vector3.ZERO<class_Vector3_constant_ZERO>`.
 
+\ **Note:** For Android, :ref:`ProjectSettings.input_devices/sensors/enable_magnetometer<class_ProjectSettings_property_input_devices/sensors/enable_magnetometer>` must be enabled.
+
 .. rst-class:: classref-item-separator
 
 ----
diff --git a/classes/class_mobilevrinterface.rst b/classes/class_mobilevrinterface.rst
@@ -31,6 +31,8 @@ You can initialize this interface as follows:
     if interface and interface.initialize():
         get_viewport().use_xr = true
 
+\ **Note:** For Android, :ref:`ProjectSettings.input_devices/sensors/enable_accelerometer<class_ProjectSettings_property_input_devices/sensors/enable_accelerometer>`, :ref:`ProjectSettings.input_devices/sensors/enable_gravity<class_ProjectSettings_property_input_devices/sensors/enable_gravity>`, :ref:`ProjectSettings.input_devices/sensors/enable_gyroscope<class_ProjectSettings_property_input_devices/sensors/enable_gyroscope>` and :ref:`ProjectSettings.input_devices/sensors/enable_magnetometer<class_ProjectSettings_property_input_devices/sensors/enable_magnetometer>` must be enabled.
+
 .. rst-class:: classref-reftable-group
 
 Properties
diff --git a/classes/class_parallax2d.rst b/classes/class_parallax2d.rst
@@ -10,8 +10,6 @@
 Parallax2D
 ==========
 
-**Experimental:** This node is meant to replace :ref:`ParallaxBackground<class_ParallaxBackground>` and :ref:`ParallaxLayer<class_ParallaxLayer>`. The implementation may change in the future.
-
 **Inherits:** :ref:`Node2D<class_Node2D>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
 
 A node used to create a parallax scrolling background.
diff --git a/classes/class_projectsettings.rst b/classes/class_projectsettings.rst
diff --git a/classes/class_renderingserver.rst b/classes/class_renderingserver.rst
diff --git a/classes/class_texture2darray.rst b/classes/class_texture2darray.rst
