diff --git a/classes/es/class_@gdscript.rst b/classes/es/class_@gdscript.rst index e6a5a7c7ae..d9cf8b8456 100644 --- a/classes/es/class_@gdscript.rst +++ b/classes/es/class_@gdscript.rst @@ -116,6 +116,8 @@ Infinito positivo de punto flotante. Este es el resultado de la división de pun ---- +.. rst-class:: classref-descriptions-group + Anotaciones ---------------------- @@ -624,16 +626,17 @@ Véase también :ref:`@GlobalScope.PROPERTY_USAGE_GROUP` +**@export_multiline**\ (\ hint\: :ref:`String` = "", ...\ ) |vararg| :ref:`🔗` -Exporta una propiedad :ref:`String`, :ref:`Array`\ \[:ref:`String`\ \], :ref:`PackedStringArray`, :ref:`Dictionary` o :ref:`Array`\ \[:ref:`Dictionary`\ \] con un widget grande de :ref:`TextEdit` en vez de un :ref:`LineEdit`. Esto añade soporte para contenido de múltiples líneas y facilita editar una gran cantidad de texto almacenado en la propiedad. +Export a :ref:`String`, :ref:`Array`\ \[:ref:`String`\ \], :ref:`PackedStringArray`, :ref:`Dictionary` or :ref:`Array`\ \[:ref:`Dictionary`\ \] property with a large :ref:`TextEdit` widget instead of a :ref:`LineEdit`. This adds support for multiline content and makes it easier to edit large amount of text stored in the property. -Véase también :ref:`@GlobalScope.PROPERTY_HINT_MULTILINE_TEXT`. +See also :ref:`@GlobalScope.PROPERTY_HINT_MULTILINE_TEXT`. :: @export_multiline var character_biography @export_multiline var npc_dialogs: Array[String] + @export_multiline("monospace", "no_wrap") var favorite_ascii_art: String .. rst-class:: classref-item-separator @@ -685,13 +688,13 @@ Véase también :ref:`@GlobalScope.PROPERTY_HINT_PLACEHOLDER_TEXT`, max\: :ref:`float`, step\: :ref:`float` = 1.0, extra_hints\: :ref:`String` = "", ...\ ) |vararg| :ref:`🔗` -Exporta una propiedad :ref:`int`, :ref:`float`, :ref:`Array`\ \[:ref:`int`\ \], :ref:`Array`\ \[:ref:`float`\ \], :ref:`PackedByteArray`, :ref:`PackedInt32Array`, :ref:`PackedInt64Array`, :ref:`PackedFloat32Array` o :ref:`PackedFloat64Array` como un valor de rango. El rango debe estar definido entre ``min`` y ``max``, así como un ``step`` opcional y una variedad de indicaciones extras. El valor de ``step`` por defecto es ``1`` para propiedades de tipo entero. Para los números de punto flotante, el valor depende de tu configuración en :ref:`EditorSettings.interface/inspector/default_float_step`. +Export an :ref:`int`, :ref:`float`, :ref:`Array`\ \[:ref:`int`\ \], :ref:`Array`\ \[:ref:`float`\ \], :ref:`PackedByteArray`, :ref:`PackedInt32Array`, :ref:`PackedInt64Array`, :ref:`PackedFloat32Array`, or :ref:`PackedFloat64Array` property as a range value. The range must be defined by ``min`` and ``max``, as well as an optional ``step`` and a variety of extra hints. The ``step`` defaults to ``1`` for integer properties. For floating-point numbers this value depends on your :ref:`EditorSettings.interface/inspector/default_float_step` setting. -Si se suministran las indicaciones ``"or_greater"`` y ``"or_less"``, el deslizador en el inspector no ajustará los valores a los límites establecidos. La indicación ``"exp"`` se puede usar para hacer que los valores del deslizador cambien de manera exponencial. ``"hide_slider"`` ocultará el control deslizante del control del inspector. +If hints ``"or_greater"`` and ``"or_less"`` are provided, the editor widget will not cap the value at range boundaries. The ``"exp"`` hint will make the edited values on range to change exponentially. The ``"prefer_slider"`` hint will make integer values use the slider instead of arrows for editing, while ``"hide_control"`` will hide the element controlling the value of the editor widget. -Las indicaciones también pueden usarse para especificar distintas unidades de medida para el parámetro editado. Usando ``"radians_as_degrees"``, puedes especificar el valor como radianes, sin embargo, en el inspector se mostrará como grados. ``"degrees"`` permitirá añadir el símbolo de grados al final del valor. Finalmente, se podrá especificar una indicación personalizada para añadir alguna clase de sufijo al valor usando ``"suffix:unit"``, donde "unit" podrá ser cualquier clase de string de texto. +Hints also allow to indicate the units for the edited value. Using ``"radians_as_degrees"`` you can specify that the actual value is in radians, but should be displayed in degrees in the Inspector dock (the range values are also in degrees). ``"degrees"`` allows to add a degree sign as a unit suffix (the value is unchanged). Finally, a custom suffix can be provided using ``"suffix:unit"``, where "unit" can be any string. -Véase también :ref:`@GlobalScope.PROPERTY_HINT_RANGE`. +See also :ref:`@GlobalScope.PROPERTY_HINT_RANGE`. :: diff --git a/classes/es/class_@globalscope.rst b/classes/es/class_@globalscope.rst index 0f1a51b04e..363245f62c 100644 --- a/classes/es/class_@globalscope.rst +++ b/classes/es/class_@globalscope.rst @@ -37,81 +37,85 @@ Propiedades .. table:: :widths: auto - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`AudioServer` | :ref:`AudioServer` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`CameraServer` | :ref:`CameraServer` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`ClassDB` | :ref:`ClassDB` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`DisplayServer` | :ref:`DisplayServer` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`EditorInterface` | :ref:`EditorInterface` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`Engine` | :ref:`Engine` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`EngineDebugger` | :ref:`EngineDebugger` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`GDExtensionManager` | :ref:`GDExtensionManager` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`Geometry2D` | :ref:`Geometry2D` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`Geometry3D` | :ref:`Geometry3D` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`IP` | :ref:`IP` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`Input` | :ref:`Input` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`InputMap` | :ref:`InputMap` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`JavaClassWrapper` | :ref:`JavaClassWrapper` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`JavaScriptBridge` | :ref:`JavaScriptBridge` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`Marshalls` | :ref:`Marshalls` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`NativeMenu` | :ref:`NativeMenu` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`NavigationMeshGenerator` | :ref:`NavigationMeshGenerator` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`NavigationServer2D` | :ref:`NavigationServer2D` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`NavigationServer3D` | :ref:`NavigationServer3D` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`OS` | :ref:`OS` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`Performance` | :ref:`Performance` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`PhysicsServer2D` | :ref:`PhysicsServer2D` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`PhysicsServer2DManager` | :ref:`PhysicsServer2DManager` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`PhysicsServer3D` | :ref:`PhysicsServer3D` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`PhysicsServer3DManager` | :ref:`PhysicsServer3DManager` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`ProjectSettings` | :ref:`ProjectSettings` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`RenderingServer` | :ref:`RenderingServer` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`ResourceLoader` | :ref:`ResourceLoader` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`ResourceSaver` | :ref:`ResourceSaver` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`ResourceUID` | :ref:`ResourceUID` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`TextServerManager` | :ref:`TextServerManager` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`ThemeDB` | :ref:`ThemeDB` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`Time` | :ref:`Time` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`TranslationServer` | :ref:`TranslationServer` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`WorkerThreadPool` | :ref:`WorkerThreadPool` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`XRServer` | :ref:`XRServer` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`AudioServer` | :ref:`AudioServer` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`CameraServer` | :ref:`CameraServer` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`ClassDB` | :ref:`ClassDB` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`DisplayServer` | :ref:`DisplayServer` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`EditorInterface` | :ref:`EditorInterface` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`Engine` | :ref:`Engine` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`EngineDebugger` | :ref:`EngineDebugger` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`GDExtensionManager` | :ref:`GDExtensionManager` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`Geometry2D` | :ref:`Geometry2D` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`Geometry3D` | :ref:`Geometry3D` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`IP` | :ref:`IP` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`Input` | :ref:`Input` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`InputMap` | :ref:`InputMap` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`JavaClassWrapper` | :ref:`JavaClassWrapper` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`JavaScriptBridge` | :ref:`JavaScriptBridge` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`Marshalls` | :ref:`Marshalls` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`NativeMenu` | :ref:`NativeMenu` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`NavigationMeshGenerator` | :ref:`NavigationMeshGenerator` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`NavigationServer2D` | :ref:`NavigationServer2D` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`NavigationServer2DManager` | :ref:`NavigationServer2DManager` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`NavigationServer3D` | :ref:`NavigationServer3D` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`NavigationServer3DManager` | :ref:`NavigationServer3DManager` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`OS` | :ref:`OS` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`Performance` | :ref:`Performance` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`PhysicsServer2D` | :ref:`PhysicsServer2D` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`PhysicsServer2DManager` | :ref:`PhysicsServer2DManager` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`PhysicsServer3D` | :ref:`PhysicsServer3D` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`PhysicsServer3DManager` | :ref:`PhysicsServer3DManager` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`ProjectSettings` | :ref:`ProjectSettings` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`RenderingServer` | :ref:`RenderingServer` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`ResourceLoader` | :ref:`ResourceLoader` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`ResourceSaver` | :ref:`ResourceSaver` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`ResourceUID` | :ref:`ResourceUID` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`TextServerManager` | :ref:`TextServerManager` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`ThemeDB` | :ref:`ThemeDB` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`Time` | :ref:`Time` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`TranslationServer` | :ref:`TranslationServer` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`WorkerThreadPool` | :ref:`WorkerThreadPool` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`XRServer` | :ref:`XRServer` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -3464,11 +3468,11 @@ La propiedad no tiene ninguna sugerencia para el editor. :ref:`PropertyHint` **PROPERTY_HINT_RANGE** = ``1`` -Indica que una propiedad :ref:`int` o :ref:`float` debe estar dentro de un rango especificado mediante la string de pista ``"min,max"`` o ``"min,max,step"``. La string de pista puede incluir opcionalmente ``"or_greater"`` y/o ``"or_less"`` para permitir la entrada manual que vaya, respectivamente, por encima del valor máximo o por debajo del valor mínimo. +Hints that an :ref:`int` or :ref:`float` property should be within a range specified via the hint string ``"min,max"`` or ``"min,max,step"``. The hint string can optionally include ``"or_greater"`` and/or ``"or_less"`` to allow manual input going respectively above the max or below the min values. -\ **Ejemplo:** ``"-360,360,1,or_greater,or_less"``. +\ **Example:** ``"-360,360,1,or_greater,or_less"``. -Además, se pueden incluir otras palabras clave: ``"exp"`` para la edición de rango exponencial, ``"radians_as_degrees"`` para editar ángulos en radianes en grados (los valores del rango también están en grados), ``"degrees"`` para sugerir un ángulo y ``"hide_slider"`` para ocultar el deslizador. +Additionally, other keywords can be included: ``"exp"`` for exponential range editing, ``"radians_as_degrees"`` for editing radian angles in degrees (the range values are also in degrees), ``"degrees"`` to hint at an angle, ``"prefer_slider"`` to show the slider for integers, ``"hide_control"`` to hide the slider or up-down arrows, and ``"suffix:px/s"`` to display a suffix indicating the value's unit (e.g. ``px/s`` for pixels per second). .. _class_@GlobalScope_constant_PROPERTY_HINT_ENUM: @@ -3476,9 +3480,9 @@ Además, se pueden incluir otras palabras clave: ``"exp"`` para la edición de r :ref:`PropertyHint` **PROPERTY_HINT_ENUM** = ``2`` -Indica que una propiedad :ref:`int` o :ref:`String` es un valor enumerado que se selecciona en una lista especificada mediante una string de referencia. +Hints that an :ref:`int`, :ref:`String`, or :ref:`StringName` property is an enumerated value to pick in a list specified via a hint string. -La string de referencia es una lista de nombres separados por comas, como ``"Hola,Algo,Otro"``. Los espacios en blanco **no** se eliminan al final del nombre. Para las propiedades enteras, el primer nombre de la lista tiene el valor 0, el siguiente 1, y así sucesivamente. También se pueden especificar valores explícitos añadiendo ``:integer`` al nombre, por ejemplo, ``"Cero,Uno,Tres:3,Cuatro,Seis:6"``. +The hint string is a comma separated list of names such as ``"Hello,Something,Else"``. Whitespace is **not** removed from either end of a name. For integer properties, the first name in the list has value 0, the next 1, and so on. Explicit values can also be specified by appending ``:integer`` to the name, e.g. ``"Zero,One,Three:3,Four,Six:6"``. .. _class_@GlobalScope_constant_PROPERTY_HINT_ENUM_SUGGESTION: @@ -3486,9 +3490,9 @@ La string de referencia es una lista de nombres separados por comas, como ``"Hol :ref:`PropertyHint` **PROPERTY_HINT_ENUM_SUGGESTION** = ``3`` -Sugiere que una propiedad :ref:`String` puede ser un valor enumerado para elegir en un lista especificada a través de una string de sugerencia, como por ejemplo ``"Hola,algo,más"``. +Hints that a :ref:`String` or :ref:`StringName` property can be an enumerated value to pick in a list specified via a hint string such as ``"Hello,Something,Else"``. See :ref:`PROPERTY_HINT_ENUM` for details. -A diferencia de :ref:`PROPERTY_HINT_ENUM`, una propiedad con esta sugerencia sigue aceptando valores arbitrarios y puede estar vacía. La lista de valores sirve para sugerir posibles valores. +Unlike :ref:`PROPERTY_HINT_ENUM`, a property with this hint still accepts arbitrary values and can be empty. The list of values serves to suggest possible values. .. _class_@GlobalScope_constant_PROPERTY_HINT_EXP_EASING: @@ -3512,13 +3516,13 @@ Sugiere que una propiedad vectorial debe permitir que sus componentes se enlacen :ref:`PropertyHint` **PROPERTY_HINT_FLAGS** = ``6`` -Indica que una propiedad :ref:`int` es una máscara de bits usando banderas de bit nombrados. +Hints that an :ref:`int` property is a bitmask with named bit flags. -El string de pistas es una lista de nombres separados por coma ejemplo ``"Bit0,Bit1,Bit2,Bit3"``. Los espacios en blanco **no** serán eliminados de ambos extremos del nombre. El primer nombre de la lista tiene el valor de 1, el siguiente tiene el valor 2, luego 4, 8, 16, etcétera. También se pueden especificar valores explícito agregando ``:integer`` al nombre, p. ej. ``"A:4,B:8,C:16"``. También puedes combinar múltiples banderas (``"A:4,B:8,AB:12,C:16"``). +The hint string is a comma separated list of names such as ``"Bit0,Bit1,Bit2,Bit3"``. Whitespace is **not** removed from either end of a name. The first name in the list has value 1, the next 2, then 4, 8, 16 and so on. Explicit values can also be specified by appending ``:integer`` to the name, e.g. ``"A:4,B:8,C:16"``. You can also combine several flags (``"A:4,B:8,AB:12,C:16"``). -\ **Nota:** El valor de una bandera debe ser como mínimo ``1`` y como máximo ``2 ** 32 - 1``. +\ **Note:** A flag value must be at least ``1`` and at most ``2 ** 32 - 1``. -\ **Nota:** A diferencia de :ref:`PROPERTY_HINT_ENUM`, el valor explicito previo no se toman en cuenta. Para la pista ``"A:16,B,C"``, A es igual a 16, B es igual a 2, C es igual a 4. +\ **Note:** Unlike :ref:`PROPERTY_HINT_ENUM`, the previous explicit value is not taken into account. For the hint ``"A:16,B,C"``, A is 16, B is 2, C is 4. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_2D_RENDER: @@ -3622,7 +3626,11 @@ Sugiere que una propiedad es una instancia de un tipo derivado de :ref:`Resource :ref:`PropertyHint` **PROPERTY_HINT_MULTILINE_TEXT** = ``18`` -Sugiere que una propiedad de tipo :ref:`String` es texto con saltos de línea. Al editarla, se mostrará un campo de entrada de texto donde se pueden escribir saltos de línea. +Hints that a :ref:`String` property is text with line breaks. Editing it will show a text input field where line breaks can be typed. + +The hint string can be set to ``"monospace"`` to force the input field to use a monospaced font. + +If the hint string ``"no_wrap"`` is set, the input field will not wrap lines at boundaries, instead resorting to making the area scrollable. .. _class_@GlobalScope_constant_PROPERTY_HINT_EXPRESSION: @@ -4076,7 +4084,23 @@ Si la propiedad tiene ``nil`` como valor predeterminado, su tipo será :ref:`Var :ref:`PropertyUsageFlags` **PROPERTY_USAGE_ARRAY** = ``262144`` -La propiedad es un array. +The property is the element count of a property array, i.e. a list of groups of related properties. Properties defined with this usage also need a specific ``class_name`` field in the form of ``label,prefix``. The field may also include additional comma-separated options: + +- ``page_size=N``: Overrides :ref:`EditorSettings.interface/inspector/max_array_dictionary_items_per_page` for this array. + +- ``add_button_text=text``: The text displayed by the "Add Element" button. + +- ``static``: The elements can't be re-arranged. + +- ``const``: New elements can't be added. + +- ``numbered``: An index will appear next to each element. + +- ``unfoldable``: The array can't be folded. + +- ``swap_method=method_name``: The method that will be called when two elements switch places. The method should take 2 :ref:`int` parameters, which will be indices of the elements being swapped. + +Note that making a full-fledged property array requires boilerplate code involving :ref:`Object._get_property_list()`. .. _class_@GlobalScope_constant_PROPERTY_USAGE_ALWAYS_DUPLICATE: @@ -5059,6 +5083,18 @@ El singleton :ref:`NavigationServer2D`. ---- +.. _class_@GlobalScope_property_NavigationServer2DManager: + +.. rst-class:: classref-property + +:ref:`NavigationServer2DManager` **NavigationServer2DManager** :ref:`🔗` + +The :ref:`NavigationServer2DManager` singleton. + +.. rst-class:: classref-item-separator + +---- + .. _class_@GlobalScope_property_NavigationServer3D: .. rst-class:: classref-property @@ -5071,6 +5107,18 @@ El singleton :ref:`NavigationServer3D`. ---- +.. _class_@GlobalScope_property_NavigationServer3DManager: + +.. rst-class:: classref-property + +:ref:`NavigationServer3DManager` **NavigationServer3DManager** :ref:`🔗` + +The :ref:`NavigationServer3DManager` singleton. + +.. rst-class:: classref-item-separator + +---- + .. _class_@GlobalScope_property_OS: .. rst-class:: classref-property @@ -5966,7 +6014,7 @@ Devuelve el hash de tipo integer de la variable ``variable`` pasada. :ref:`Object` **instance_from_id**\ (\ instance_id\: :ref:`int`\ ) :ref:`🔗` -Devuelve el :ref:`Object` que corresponde a ``instance_id``. Todos los Objetos tienen un ID de instancia único. Véase también ::ref:`Object.get_instance_id()`. +Returns the :ref:`Object` that corresponds to ``instance_id``. All Objects have a unique instance ID. See also :ref:`Object.get_instance_id()`. .. tabs:: @@ -5978,7 +6026,7 @@ Devuelve el :ref:`Object` que corresponde a ``instance_id``. Todos func _ready(): var id = get_instance_id() var instance = instance_from_id(id) - print(instance.foo) # Imprime "water" + print(instance.drink) # Prints "water" .. code-tab:: csharp @@ -5990,7 +6038,7 @@ Devuelve el :ref:`Object` que corresponde a ``instance_id``. Todos { ulong id = GetInstanceId(); var instance = (MyNode)InstanceFromId(Id); - GD.Print(instance.Drink); // Imprime "water" + GD.Print(instance.Drink); // Prints "water" } } @@ -7390,17 +7438,17 @@ Véase también :ref:`typeof()`. :ref:`int` **typeof**\ (\ variable\: :ref:`Variant`\ ) :ref:`🔗` -Devuelve el tipo interno del ``variable`` dado, usando los valores de :ref:`Variant.Type`. +Returns the internal type of the given ``variable``, using the :ref:`Variant.Type` values. :: var json = JSON.new() json.parse('["a", "b", "c"]') var result = json.get_data() - if result is Array: - print(result[0]) # Imprime "a" + if typeof(result) == TYPE_ARRAY: + print(result[0]) # Prints "a" else: - print("¡Resultado inesperado!") + print("Unexpected result!") See also :ref:`type_string()`. diff --git a/classes/es/class_acceptdialog.rst b/classes/es/class_acceptdialog.rst index d4352708c5..94a031d1e0 100644 --- a/classes/es/class_acceptdialog.rst +++ b/classes/es/class_acceptdialog.rst @@ -16,7 +16,9 @@ Un diálogo base utilizado para la notificación al usuario. Descripción ---------------------- -El uso predeterminado de **AcceptDialog** es permitir que solo se acepte o se cierre, con el mismo resultado. Sin embargo, las señales :ref:`confirmed` y :ref:`canceled` permiten diferenciar ambas acciones, y el método :ref:`add_button()` permite agregar botones y acciones personalizadas. +The default use of **AcceptDialog** is to allow it to only be accepted or closed, with the same result. However, the :ref:`confirmed` and :ref:`canceled` signals allow to make the two actions different, and the :ref:`add_button()` method allows to add custom buttons and actions. + +\ **Note:** **AcceptDialog** is invisible by default. To make it visible, call one of the ``popup_*`` methods from :ref:`Window` on the node, such as :ref:`Window.popup_centered_clamped()`. .. rst-class:: classref-reftable-group @@ -172,7 +174,7 @@ El texto se expande automáticamente en el diálogo. - |void| **set_close_on_escape**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **get_close_on_escape**\ (\ ) -Si es ``true``, el diálogo se ocultará cuando se pulse la acción ``ui_cancel`` (por defecto, esta acción está vinculada a :ref:`@GlobalScope.KEY_ESCAPE`). +If ``true``, the dialog will be hidden when the ``ui_close_dialog`` action is pressed (by default, this action is bound to :kbd:`Escape`, or :kbd:`Cmd + W` on macOS). .. rst-class:: classref-item-separator diff --git a/classes/es/class_aescontext.rst b/classes/es/class_aescontext.rst index f3c9432c2e..7103e2e7d3 100644 --- a/classes/es/class_aescontext.rst +++ b/classes/es/class_aescontext.rst @@ -146,7 +146,7 @@ Modo de desencripción AES electronic codebook(ECB). :ref:`Mode` **MODE_CBC_ENCRYPT** = ``2`` -Modo de encripción AES cipher blocker chaining (CBC). +AES cipher block chaining encryption mode. .. _class_AESContext_constant_MODE_CBC_DECRYPT: @@ -154,7 +154,7 @@ Modo de encripción AES cipher blocker chaining (CBC). :ref:`Mode` **MODE_CBC_DECRYPT** = ``3`` -Modo de desencripción AES cipher blocker chaining (CBC). +AES cipher block chaining decryption mode. .. _class_AESContext_constant_MODE_MAX: diff --git a/classes/es/class_aimmodifier3d.rst b/classes/es/class_aimmodifier3d.rst index bf38f46c76..ba49fd6ccc 100644 --- a/classes/es/class_aimmodifier3d.rst +++ b/classes/es/class_aimmodifier3d.rst @@ -43,6 +43,8 @@ Métodos +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Axis` | :ref:`get_primary_rotation_axis`\ (\ index\: :ref:`int`\ ) |const| | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_relative`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_using_euler`\ (\ index\: :ref:`int`\ ) |const| | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_using_secondary_rotation`\ (\ index\: :ref:`int`\ ) |const| | @@ -51,6 +53,8 @@ Métodos +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_primary_rotation_axis`\ (\ index\: :ref:`int`, axis\: :ref:`Axis`\ ) | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_relative`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | + +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_use_euler`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_use_secondary_rotation`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | @@ -111,6 +115,18 @@ Devuelve el eje de la primera rotación. Solo se habilita si :ref:`is_using_eule ---- +.. _class_AimModifier3D_method_is_relative: + +.. rst-class:: classref-method + +:ref:`bool` **is_relative**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve ``true`` si la opción relativa está habilitada en la configuración en ``index``. + +.. rst-class:: classref-item-separator + +---- + .. _class_AimModifier3D_method_is_using_euler: .. rst-class:: classref-method @@ -159,6 +175,22 @@ Establece el eje de la primera rotación. Solo se habilita si :ref:`is_using_eul ---- +.. _class_AimModifier3D_method_set_relative: + +.. rst-class:: classref-method + +|void| **set_relative**\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) :ref:`🔗` + +Sets relative option in the setting at ``index`` to ``enabled``. + +If sets ``enabled`` to ``true``, the rotation is applied relative to the pose. + +If sets ``enabled`` to ``false``, the rotation is applied relative to the rest. It means to replace the current pose with the **AimModifier3D**'s result. + +.. rst-class:: classref-item-separator + +---- + .. _class_AimModifier3D_method_set_use_euler: .. rst-class:: classref-method diff --git a/classes/es/class_animationnodeoneshot.rst b/classes/es/class_animationnodeoneshot.rst index 56d4e66c2e..8c97d62aef 100644 --- a/classes/es/class_animationnodeoneshot.rst +++ b/classes/es/class_animationnodeoneshot.rst @@ -84,6 +84,8 @@ Propiedades .. table:: :widths: auto + +---------------------------------------------------+-----------------------------------------------------------------------------------------------+-----------+ + | :ref:`bool` | :ref:`abort_on_reset` | ``false`` | +---------------------------------------------------+-----------------------------------------------------------------------------------------------+-----------+ | :ref:`bool` | :ref:`autorestart` | ``false`` | +---------------------------------------------------+-----------------------------------------------------------------------------------------------+-----------+ @@ -186,6 +188,23 @@ Combina dos animaciones de forma aditiva. Véase también :ref:`AnimationNodeAdd Descripciones de Propiedades -------------------------------------------------------- +.. _class_AnimationNodeOneShot_property_abort_on_reset: + +.. rst-class:: classref-property + +:ref:`bool` **abort_on_reset** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_abort_on_reset**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_aborted_on_reset**\ (\ ) + +If ``true``, the sub-animation will abort if resumed with a reset after a prior interruption. + +.. rst-class:: classref-item-separator + +---- + .. _class_AnimationNodeOneShot_property_autorestart: .. rst-class:: classref-property diff --git a/classes/es/class_animationnodestatemachineplayback.rst b/classes/es/class_animationnodestatemachineplayback.rst index 1d1f2f0f00..33ea53fdfd 100644 --- a/classes/es/class_animationnodestatemachineplayback.rst +++ b/classes/es/class_animationnodestatemachineplayback.rst @@ -65,8 +65,16 @@ Métodos +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_current_play_position`\ (\ ) |const| | +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_fading_from_length`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`StringName` | :ref:`get_fading_from_node`\ (\ ) |const| | +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_fading_from_play_position`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_fading_length`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_fading_position`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Array`\[:ref:`StringName`\] | :ref:`get_travel_path`\ (\ ) |const| | +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_playing`\ (\ ) |const| | @@ -160,6 +168,18 @@ Devuelve la posición de reproducción dentro del estado de animación actual. ---- +.. _class_AnimationNodeStateMachinePlayback_method_get_fading_from_length: + +.. rst-class:: classref-method + +:ref:`float` **get_fading_from_length**\ (\ ) |const| :ref:`🔗` + +Returns the playback state length of the node from :ref:`get_fading_from_node()`. Returns ``0`` if no animation fade is occurring. + +.. rst-class:: classref-item-separator + +---- + .. _class_AnimationNodeStateMachinePlayback_method_get_fading_from_node: .. rst-class:: classref-method @@ -172,6 +192,42 @@ Devuelve el estado inicial de la animación que se está desvaneciendo actualmen ---- +.. _class_AnimationNodeStateMachinePlayback_method_get_fading_from_play_position: + +.. rst-class:: classref-method + +:ref:`float` **get_fading_from_play_position**\ (\ ) |const| :ref:`🔗` + +Returns the playback position of the node from :ref:`get_fading_from_node()`. Returns ``0`` if no animation fade is occurring. + +.. rst-class:: classref-item-separator + +---- + +.. _class_AnimationNodeStateMachinePlayback_method_get_fading_length: + +.. rst-class:: classref-method + +:ref:`float` **get_fading_length**\ (\ ) |const| :ref:`🔗` + +Returns the length of the current fade animation. Returns ``0`` if no animation fade is occurring. + +.. rst-class:: classref-item-separator + +---- + +.. _class_AnimationNodeStateMachinePlayback_method_get_fading_position: + +.. rst-class:: classref-method + +:ref:`float` **get_fading_position**\ (\ ) |const| :ref:`🔗` + +Returns the playback position of the current fade animation. Returns ``0`` if no animation fade is occurring. + +.. rst-class:: classref-item-separator + +---- + .. _class_AnimationNodeStateMachinePlayback_method_get_travel_path: .. rst-class:: classref-method diff --git a/classes/es/class_animationplayer.rst b/classes/es/class_animationplayer.rst index a3cc2a5180..1c13853c65 100644 --- a/classes/es/class_animationplayer.rst +++ b/classes/es/class_animationplayer.rst @@ -42,11 +42,11 @@ Propiedades :widths: auto +--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------+-----------+ - | :ref:`String` | :ref:`assigned_animation` | | + | :ref:`StringName` | :ref:`assigned_animation` | | +--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------+-----------+ - | :ref:`String` | :ref:`autoplay` | ``""`` | + | :ref:`StringName` | :ref:`autoplay` | ``&""`` | +--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------+-----------+ - | :ref:`String` | :ref:`current_animation` | ``""`` | + | :ref:`StringName` | :ref:`current_animation` | ``&""`` | +--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------+-----------+ | :ref:`float` | :ref:`current_animation_length` | | +--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------+-----------+ @@ -90,7 +90,7 @@ Métodos +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`AnimationProcessCallback` | :ref:`get_process_callback`\ (\ ) |const| | +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`get_queue`\ (\ ) | + | :ref:`Array`\[:ref:`StringName`\] | :ref:`get_queue`\ (\ ) | +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`NodePath` | :ref:`get_root`\ (\ ) |const| | +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -100,6 +100,8 @@ Métodos +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_section`\ (\ ) |const| | +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_animation_active`\ (\ ) |const| | + +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_playing`\ (\ ) |const| | +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`pause`\ (\ ) | @@ -166,7 +168,7 @@ Emitted when a queued animation plays after the previous animation finished. See .. rst-class:: classref-signal -**current_animation_changed**\ (\ name\: :ref:`String`\ ) :ref:`🔗` +**current_animation_changed**\ (\ name\: :ref:`StringName`\ ) :ref:`🔗` Emitida cuando :ref:`current_animation` cambia. @@ -258,12 +260,12 @@ Descripciones de Propiedades .. rst-class:: classref-property -:ref:`String` **assigned_animation** :ref:`🔗` +:ref:`StringName` **assigned_animation** :ref:`🔗` .. rst-class:: classref-property-setget -- |void| **set_assigned_animation**\ (\ value\: :ref:`String`\ ) -- :ref:`String` **get_assigned_animation**\ (\ ) +- |void| **set_assigned_animation**\ (\ value\: :ref:`StringName`\ ) +- :ref:`StringName` **get_assigned_animation**\ (\ ) Si se está reproduciendo, la clave de la animación actual; en caso contrario, la de la última animación reproducida. Cuando se establece, esto cambia la animación, pero no la reproducirá a menos que ya se esté reproduciendo. Véase también :ref:`current_animation`. @@ -275,12 +277,12 @@ Si se está reproduciendo, la clave de la animación actual; en caso contrario, .. rst-class:: classref-property -:ref:`String` **autoplay** = ``""`` :ref:`🔗` +:ref:`StringName` **autoplay** = ``&""`` :ref:`🔗` .. rst-class:: classref-property-setget -- |void| **set_autoplay**\ (\ value\: :ref:`String`\ ) -- :ref:`String` **get_autoplay**\ (\ ) +- |void| **set_autoplay**\ (\ value\: :ref:`StringName`\ ) +- :ref:`StringName` **get_autoplay**\ (\ ) La clave de la animación que se reproducirá cuando se cargue la escena. @@ -292,12 +294,12 @@ La clave de la animación que se reproducirá cuando se cargue la escena. .. rst-class:: classref-property -:ref:`String` **current_animation** = ``""`` :ref:`🔗` +:ref:`StringName` **current_animation** = ``&""`` :ref:`🔗` .. rst-class:: classref-property-setget -- |void| **set_current_animation**\ (\ value\: :ref:`String`\ ) -- :ref:`String` **get_current_animation**\ (\ ) +- |void| **set_current_animation**\ (\ value\: :ref:`StringName`\ ) +- :ref:`StringName` **get_current_animation**\ (\ ) La clave de la animación que se está reproduciendo actualmente. Si no se está reproduciendo ninguna animación, el valor de la propiedad es una string vacía. Cambiar este valor no reinicia la animación. Véase :ref:`play()` para más información sobre la reproducción de animaciones. @@ -565,7 +567,7 @@ Devuelve la notificación del proceso en el que se actualizarán las animaciones .. rst-class:: classref-method -:ref:`PackedStringArray` **get_queue**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`StringName`\] **get_queue**\ (\ ) :ref:`🔗` Devuelve una lista de las claves de animación que están actualmente en cola para reproducirse. @@ -623,6 +625,25 @@ Devuelve ``true`` si una animación se está reproduciendo actualmente con una s ---- +.. _class_AnimationPlayer_method_is_animation_active: + +.. rst-class:: classref-method + +:ref:`bool` **is_animation_active**\ (\ ) |const| :ref:`🔗` + +Returns ``true`` if the an animation is currently active. An animation is active if it was played by calling :ref:`play()` and was not finished yet, or was stopped by calling :ref:`stop()`. + +This can be used to check whether an animation is currently paused or stopped. + +:: + + var is_paused = not is_playing() and is_animation_active() + var is_stopped = not is_playing() and not is_animation_active() + +.. rst-class:: classref-item-separator + +---- + .. _class_AnimationPlayer_method_is_playing: .. rst-class:: classref-method diff --git a/classes/es/class_array.rst b/classes/es/class_array.rst index 23f90650df..091aa23966 100644 --- a/classes/es/class_array.rst +++ b/classes/es/class_array.rst @@ -680,9 +680,9 @@ Si ``deep`` es ``true``, se devuelve una copia **profunda**: Todos los arrays y :ref:`Array` **duplicate_deep**\ (\ deep_subresources_mode\: :ref:`int` = 1\ ) |const| :ref:`🔗` -Duplica este array profundamente, como :ref:`duplicate()`\ ``(true)``, con mas control sobre como se gestionan los subrecursos. +Duplicates this array, deeply, like :ref:`duplicate()` when passing ``true``, with extra control over how subresources are handled. -\ ``deep_subresources_mode`` debe ser uno de los valores de :ref:`DeepDuplicateMode`. Por defecto, solo recursos internos serán duplicados (recursivamente). +\ ``deep_subresources_mode`` must be one of the values from :ref:`DeepDuplicateMode`. By default, only internal resources will be duplicated (recursively). .. rst-class:: classref-item-separator @@ -831,9 +831,9 @@ Returns the first element of the array. If the array is empty, fails and returns :ref:`Variant` **get**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve el elemento en el ``index`` dado del array. Si ``index`` está fuera de los límites o es negativo, este método falla y devuelve ``null``. +Returns the element at the given ``index`` in the array. If ``index`` is out-of-bounds or negative, this method fails and returns ``null``. -Este método es similar (pero no idéntico) al operador ``[]``. Notablemente, cuando este método falla, no pausa la ejecución del proyecto si se ejecuta desde el editor. +This method is similar (but not identical) to the ``[]`` operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor. .. rst-class:: classref-item-separator @@ -923,9 +923,9 @@ In GDScript, this is equivalent to the ``in`` operator: :ref:`int` **hash**\ (\ ) |const| :ref:`🔗` -Devuelve un valor entero de 32 bits con hash que representa el array y su contenido. +Returns a hashed 32-bit integer value representing the array and its contents. -\ **Nota:** *No* se garantiza que los arrays con valores hash iguales sean iguales, como resultado de las colisiones hash. Por el contrario, se garantiza que los arrays con diferentes valores hash sean diferentes. +\ **Note:** Arrays with equal hash values are *not* guaranteed to be the same, as a result of hash collisions. On the contrary, arrays with different hash values are guaranteed to be different. .. rst-class:: classref-item-separator @@ -1232,8 +1232,6 @@ If you need to return the removed element, use :ref:`pop_at()`. Út - |void| **set_region**\ (\ value\: :ref:`Rect2`\ ) - :ref:`Rect2` **get_region**\ (\ ) -La región utilizada para dibujar el :ref:`atlas`. Si alguna de las dimensiones del tamaño de la región es ``0``, se utilizará el valor del tamaño de :ref:`atlas` para ese eje en su lugar. +The region used to draw the :ref:`atlas`. If either dimension of the region's size is ``0``, the value from :ref:`atlas` size will be used for that axis instead. + +\ **Note:** The image size is always an integer, so the actual region size is rounded down. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_audioserver.rst b/classes/es/class_audioserver.rst index 85a03119e6..940536cb40 100644 --- a/classes/es/class_audioserver.rst +++ b/classes/es/class_audioserver.rst @@ -86,8 +86,14 @@ Métodos +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_driver_name`\ (\ ) |const| | +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_input_buffer_length_frames`\ (\ ) | + +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedStringArray` | :ref:`get_input_device_list`\ (\ ) | +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedVector2Array` | :ref:`get_input_frames`\ (\ frames\: :ref:`int`\ ) | + +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_input_frames_available`\ (\ ) | + +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_input_mix_rate`\ (\ ) |const| | +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_mix_rate`\ (\ ) |const| | @@ -142,6 +148,8 @@ Métodos +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_enable_tagging_used_audio_streams`\ (\ enable\: :ref:`bool`\ ) | +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`set_input_device_active`\ (\ active\: :ref:`bool`\ ) | + +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`swap_bus_effects`\ (\ bus_idx\: :ref:`int`, effect_idx\: :ref:`int`, by_effect_idx\: :ref:`int`\ ) | +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`unlock`\ (\ ) | @@ -543,6 +551,20 @@ Devuelve el nombre del controlador de audio actual. El valor predeterminado suel ---- +.. _class_AudioServer_method_get_input_buffer_length_frames: + +.. rst-class:: classref-method + +:ref:`int` **get_input_buffer_length_frames**\ (\ ) :ref:`🔗` + +**Experimental:** Este método podría ser modificado o eliminado en versiones futuras. + +Returns the absolute size of the microphone input buffer. This is set to a multiple of the audio latency and can be used to estimate the minimum rate at which the frames need to be fetched. + +.. rst-class:: classref-item-separator + +---- + .. _class_AudioServer_method_get_input_device_list: .. rst-class:: classref-method @@ -557,6 +579,38 @@ Devuelve los nombres de todos los dispositivos de entrada de audio detectados en ---- +.. _class_AudioServer_method_get_input_frames: + +.. rst-class:: classref-method + +:ref:`PackedVector2Array` **get_input_frames**\ (\ frames\: :ref:`int`\ ) :ref:`🔗` + +**Experimental:** Este método podría ser modificado o eliminado en versiones futuras. + +Returns a :ref:`PackedVector2Array` containing exactly ``frames`` audio samples from the internal microphone buffer if available, otherwise returns an empty :ref:`PackedVector2Array`. + +The buffer is filled at the rate of :ref:`get_input_mix_rate()` frames per second when :ref:`set_input_device_active()` has successfully been set to ``true``. + +The samples are signed floating-point PCM values between ``-1`` and ``1``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_AudioServer_method_get_input_frames_available: + +.. rst-class:: classref-method + +:ref:`int` **get_input_frames_available**\ (\ ) :ref:`🔗` + +**Experimental:** Este método podría ser modificado o eliminado en versiones futuras. + +Returns the number of frames available to read using :ref:`get_input_frames()`. + +.. rst-class:: classref-item-separator + +---- + .. _class_AudioServer_method_get_input_mix_rate: .. rst-class:: classref-method @@ -897,6 +951,22 @@ Si se establece como ``true``, todas las instancias de :ref:`AudioStreamPlayback ---- +.. _class_AudioServer_method_set_input_device_active: + +.. rst-class:: classref-method + +:ref:`Error` **set_input_device_active**\ (\ active\: :ref:`bool`\ ) :ref:`🔗` + +**Experimental:** Este método podría ser modificado o eliminado en versiones futuras. + +If ``active`` is ``true``, starts the microphone input stream specified by :ref:`input_device` or returns an error if it failed. + +If ``active`` is ``false``, stops the input stream if it is running. + +.. rst-class:: classref-item-separator + +---- + .. _class_AudioServer_method_swap_bus_effects: .. rst-class:: classref-method diff --git a/classes/es/class_audiostream.rst b/classes/es/class_audiostream.rst index 3b42eedb73..ffce31c5d8 100644 --- a/classes/es/class_audiostream.rst +++ b/classes/es/class_audiostream.rst @@ -39,39 +39,39 @@ Métodos .. table:: :widths: auto - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`_get_bar_beats`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`_get_beat_count`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`_get_bpm`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`_get_length`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`Dictionary`\] | :ref:`_get_parameter_list`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`_get_stream_name`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`Dictionary` | :ref:`_get_tags`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_has_loop`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`AudioStreamPlayback` | :ref:`_instantiate_playback`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_is_monophonic`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`can_be_sampled`\ (\ ) |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`AudioSample` | :ref:`generate_sample`\ (\ ) |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get_length`\ (\ ) |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`AudioStreamPlayback` | :ref:`instantiate_playback`\ (\ ) | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_meta_stream`\ (\ ) |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_monophonic`\ (\ ) |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`_get_bar_beats`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`_get_beat_count`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`_get_bpm`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`_get_length`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Array`\[:ref:`Dictionary`\] | :ref:`_get_parameter_list`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`_get_stream_name`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dictionary` | :ref:`_get_tags`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`_has_loop`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`AudioStreamPlayback` | :ref:`_instantiate_playback`\ (\ ) |virtual| |required| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`_is_monophonic`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`can_be_sampled`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`AudioSample` | :ref:`generate_sample`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_length`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`AudioStreamPlayback` | :ref:`instantiate_playback`\ (\ ) | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_meta_stream`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_monophonic`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -205,7 +205,7 @@ Sobrescribe este método para devolver ``true`` si esta secuencia tiene un bucle .. rst-class:: classref-method -:ref:`AudioStreamPlayback` **_instantiate_playback**\ (\ ) |virtual| |const| :ref:`🔗` +:ref:`AudioStreamPlayback` **_instantiate_playback**\ (\ ) |virtual| |required| |const| :ref:`🔗` Override this method to customize the returned value of :ref:`instantiate_playback()`. Should return a new :ref:`AudioStreamPlayback` created when the stream is played (such as by an :ref:`AudioStreamPlayer`). diff --git a/classes/es/class_audiostreamplayback.rst b/classes/es/class_audiostreamplayback.rst index a8d270b265..fa9ccecc95 100644 --- a/classes/es/class_audiostreamplayback.rst +++ b/classes/es/class_audiostreamplayback.rst @@ -38,9 +38,9 @@ Métodos +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Variant` | :ref:`_get_parameter`\ (\ name\: :ref:`StringName`\ ) |virtual| |const| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`_get_playback_position`\ (\ ) |virtual| |const| | + | :ref:`float` | :ref:`_get_playback_position`\ (\ ) |virtual| |required| |const| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_is_playing`\ (\ ) |virtual| |const| | + | :ref:`bool` | :ref:`_is_playing`\ (\ ) |virtual| |required| |const| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`_mix`\ (\ buffer\: ``AudioFrame*``, rate_scale\: :ref:`float`, frames\: :ref:`int`\ ) |virtual| |required| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -48,9 +48,9 @@ Métodos +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_set_parameter`\ (\ name\: :ref:`StringName`, value\: :ref:`Variant`\ ) |virtual| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`_start`\ (\ from_pos\: :ref:`float`\ ) |virtual| | + | |void| | :ref:`_start`\ (\ from_pos\: :ref:`float`\ ) |virtual| |required| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`_stop`\ (\ ) |virtual| | + | |void| | :ref:`_stop`\ (\ ) |virtual| |required| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_tag_used_streams`\ (\ ) |virtual| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -110,7 +110,7 @@ Devuelve el valor actual de un parámetro de reproducción por nombre (véase :r .. rst-class:: classref-method -:ref:`float` **_get_playback_position**\ (\ ) |virtual| |const| :ref:`🔗` +:ref:`float` **_get_playback_position**\ (\ ) |virtual| |required| |const| :ref:`🔗` Overridable method. Should return the current progress along the audio stream, in seconds. @@ -122,7 +122,7 @@ Overridable method. Should return the current progress along the audio stream, i .. rst-class:: classref-method -:ref:`bool` **_is_playing**\ (\ ) |virtual| |const| :ref:`🔗` +:ref:`bool` **_is_playing**\ (\ ) |virtual| |required| |const| :ref:`🔗` Overridable method. Should return ``true`` if this playback is active and playing its audio stream. @@ -172,7 +172,7 @@ Set the current value of a playback parameter by name (see :ref:`AudioStream._ge .. rst-class:: classref-method -|void| **_start**\ (\ from_pos\: :ref:`float`\ ) |virtual| :ref:`🔗` +|void| **_start**\ (\ from_pos\: :ref:`float`\ ) |virtual| |required| :ref:`🔗` Override this method to customize what happens when the playback starts at the given position, such as by calling :ref:`AudioStreamPlayer.play()`. @@ -184,7 +184,7 @@ Override this method to customize what happens when the playback starts at the g .. rst-class:: classref-method -|void| **_stop**\ (\ ) |virtual| :ref:`🔗` +|void| **_stop**\ (\ ) |virtual| |required| :ref:`🔗` Override this method to customize what happens when the playback is stopped, such as by calling :ref:`AudioStreamPlayer.stop()`. diff --git a/classes/es/class_audiostreamrandomizer.rst b/classes/es/class_audiostreamrandomizer.rst index 2c20044b7e..8690886654 100644 --- a/classes/es/class_audiostreamrandomizer.rst +++ b/classes/es/class_audiostreamrandomizer.rst @@ -29,6 +29,8 @@ Propiedades +--------------------------------------------------------------+----------------------------------------------------------------------------------------------+---------+ | :ref:`float` | :ref:`random_pitch` | ``1.0`` | +--------------------------------------------------------------+----------------------------------------------------------------------------------------------+---------+ + | :ref:`float` | :ref:`random_pitch_semitones` | ``0.0`` | + +--------------------------------------------------------------+----------------------------------------------------------------------------------------------+---------+ | :ref:`float` | :ref:`random_volume_offset_db` | ``0.0`` | +--------------------------------------------------------------+----------------------------------------------------------------------------------------------+---------+ | :ref:`int` | :ref:`streams_count` | ``0`` | @@ -134,7 +136,28 @@ Controla cómo este AudioStreamRandomizer elige qué AudioStream reproducir a co - |void| **set_random_pitch**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_random_pitch**\ (\ ) -La intensidad de la variación de tono aleatoria. Un valor de 1 significa que no hay variación. +The largest possible frequency multiplier of the random pitch variation. Pitch will be randomly chosen within a range of ``1.0 / random_pitch`` and ``random_pitch``. A value of ``1.0`` means no variation. A value of ``2.0`` means pitch will be randomized between double and half. + +\ **Note:** Setting this property also sets :ref:`random_pitch_semitones`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_AudioStreamRandomizer_property_random_pitch_semitones: + +.. rst-class:: classref-property + +:ref:`float` **random_pitch_semitones** = ``0.0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_random_pitch_semitones**\ (\ value\: :ref:`float`\ ) +- :ref:`float` **get_random_pitch_semitones**\ (\ ) + +The largest possible distance, in semitones, of the random pitch variation. A value of ``0.0`` means no variation. + +\ **Note:** Setting this property also sets :ref:`random_pitch`. .. rst-class:: classref-item-separator @@ -151,7 +174,7 @@ La intensidad de la variación de tono aleatoria. Un valor de 1 significa que no - |void| **set_random_volume_offset_db**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_random_volume_offset_db**\ (\ ) -La intensidad de la variación de volumen aleatoria. Un valor de 0 significa que no hay variación. +The intensity of random volume variation. Volume will be increased or decreased by a random value up to ``random_volume_offset_db``. A value of ``0.0`` means no variation. A value of ``3.0`` means volume will be randomized between ``-3.0 dB`` and ``+3.0 dB``. .. rst-class:: classref-item-separator diff --git a/classes/es/class_basematerial3d.rst b/classes/es/class_basematerial3d.rst index 87cdf5b51d..4b2513c771 100644 --- a/classes/es/class_basematerial3d.rst +++ b/classes/es/class_basematerial3d.rst @@ -1020,7 +1020,7 @@ Ponga ``ALBEDO`` en el color por vértice especificado en la malla. :ref:`Flags` **FLAG_SRGB_VERTEX_COLOR** = ``2`` -Vertex colors are considered to be stored in sRGB color space and are converted to linear color space during rendering. See also :ref:`vertex_color_is_srgb`. +Vertex colors are considered to be stored in nonlinear sRGB encoding and are converted to linear encoding during rendering. See also :ref:`vertex_color_is_srgb`. \ **Note:** Only effective when using the Forward+ and Mobile rendering methods. @@ -1102,7 +1102,7 @@ Utiliza las coordenadas ``UV2`` para mirar hacia arriba desde la :ref:`emission_ :ref:`Flags` **FLAG_ALBEDO_TEXTURE_FORCE_SRGB** = ``12`` -Forces the shader to convert albedo from sRGB space to linear space. See also :ref:`albedo_texture_force_srgb`. +Forces the shader to convert albedo from nonlinear sRGB encoding to linear encoding. See also :ref:`albedo_texture_force_srgb`. .. _class_BaseMaterial3D_constant_FLAG_DONT_RECEIVE_SHADOWS: @@ -1512,7 +1512,7 @@ enum **StencilFlags**: :ref:`🔗` :ref:`StencilFlags` **STENCIL_FLAG_READ** = ``1`` -The material will only be rendered where it passes a stencil comparison with existing stencil buffer values. See :ref:`StencilCompare`. +The material will only be rendered where it passes a stencil comparison with existing stencil buffer values. .. _class_BaseMaterial3D_constant_STENCIL_FLAG_WRITE: @@ -1654,7 +1654,7 @@ If the texture appears unexpectedly too dark or too bright, check :ref:`albedo_t - |void| **set_flag**\ (\ flag\: :ref:`Flags`, enable\: :ref:`bool`\ ) - :ref:`bool` **get_flag**\ (\ flag\: :ref:`Flags`\ ) |const| -If ``true``, forces a conversion of the :ref:`albedo_texture` from sRGB color space to linear color space. See also :ref:`vertex_color_is_srgb`. +If ``true``, forces a conversion of the :ref:`albedo_texture` from nonlinear sRGB encoding to linear encoding. See also :ref:`vertex_color_is_srgb`. This should only be enabled when needed (typically when using a :ref:`ViewportTexture` as :ref:`albedo_texture`). If :ref:`albedo_texture_force_srgb` is ``true`` when it shouldn't be, the texture will appear to be too dark. If :ref:`albedo_texture_force_srgb` is ``false`` when it shouldn't be, the texture will appear to be too bright. @@ -2152,7 +2152,7 @@ Determina cuándo el renderizado de profundidad se lleva a cabo. Véase también **Experimental:** May be affected by future rendering pipeline changes. -Determines which comparison operator is used when testing depth. See :ref:`DepthTest`. +Determines which comparison operator is used when testing depth. \ **Note:** Changing :ref:`depth_test` to a non-default value only has a visible effect when used on a transparent material, or a material that has :ref:`depth_draw_mode` set to :ref:`DEPTH_DRAW_DISABLED`. @@ -3337,7 +3337,7 @@ The primary color of the stencil effect. **Experimental:** May be affected by future rendering pipeline changes. -The comparison operator to use for stencil masking operations. See :ref:`StencilCompare`. +The comparison operator to use for stencil masking operations. .. rst-class:: classref-item-separator @@ -3356,7 +3356,7 @@ The comparison operator to use for stencil masking operations. See :ref:`Stencil **Experimental:** May be affected by future rendering pipeline changes. -The flags dictating how the stencil operation behaves. See :ref:`StencilFlags`. +The flags dictating how the stencil operation behaves. .. rst-class:: classref-item-separator @@ -3375,7 +3375,7 @@ The flags dictating how the stencil operation behaves. See :ref:`StencilFlags`. +The stencil effect mode. .. rst-class:: classref-item-separator @@ -3882,7 +3882,7 @@ If ``true``, triplanar mapping for ``UV2`` is calculated in world space rather t - |void| **set_flag**\ (\ flag\: :ref:`Flags`, enable\: :ref:`bool`\ ) - :ref:`bool` **get_flag**\ (\ flag\: :ref:`Flags`\ ) |const| -If ``true``, vertex colors are considered to be stored in sRGB color space and are converted to linear color space during rendering. If ``false``, vertex colors are considered to be stored in linear color space and are rendered as-is. See also :ref:`albedo_texture_force_srgb`. +If ``true``, vertex colors are considered to be stored in nonlinear sRGB encoding and are converted to linear encoding during rendering. If ``false``, vertex colors are considered to be stored in linear encoding and are rendered as-is. See also :ref:`albedo_texture_force_srgb`. \ **Note:** Only effective when using the Forward+ and Mobile rendering methods, not Compatibility. @@ -3935,7 +3935,7 @@ Descripciones de Métodos :ref:`bool` **get_feature**\ (\ feature\: :ref:`Feature`\ ) |const| :ref:`🔗` -Devuelve ``true``, si el :ref:`Feature` especificado está activado. +Returns ``true`` if the specified ``feature`` is enabled. .. rst-class:: classref-item-separator @@ -3947,7 +3947,7 @@ Devuelve ``true``, si el :ref:`Feature` especificad :ref:`bool` **get_flag**\ (\ flag\: :ref:`Flags`\ ) |const| :ref:`🔗` -Devuelve ``true`` si la bandera especificada está habilitada. +Returns ``true`` if the specified ``flag`` is enabled. .. rst-class:: classref-item-separator @@ -3959,7 +3959,7 @@ Devuelve ``true`` si la bandera especificada está habilitada. :ref:`Texture2D` **get_texture**\ (\ param\: :ref:`TextureParam`\ ) |const| :ref:`🔗` -Returns the :ref:`Texture2D` associated with the specified :ref:`TextureParam`. +Returns the :ref:`Texture2D` associated with the specified texture ``param``. .. rst-class:: classref-item-separator @@ -3971,7 +3971,7 @@ Returns the :ref:`Texture2D` associated with the specified :ref |void| **set_feature**\ (\ feature\: :ref:`Feature`, enable\: :ref:`bool`\ ) :ref:`🔗` -If ``true``, enables the specified :ref:`Feature`. Many features that are available in **BaseMaterial3D**\ s need to be enabled before use. This way the cost for using the feature is only incurred when specified. Features can also be enabled by setting the corresponding member to ``true``. +If ``enable`` is ``true``, enables the specified ``feature``. Many features that are available in **BaseMaterial3D** need to be enabled before use. This way, the cost for using the feature is only incurred when specified. Features can also be enabled by setting their corresponding property to ``true``. .. rst-class:: classref-item-separator @@ -3983,7 +3983,7 @@ If ``true``, enables the specified :ref:`Feature`. |void| **set_flag**\ (\ flag\: :ref:`Flags`, enable\: :ref:`bool`\ ) :ref:`🔗` -If ``true``, enables the specified flag. Flags are optional behavior that can be turned on and off. Only one flag can be enabled at a time with this function, the flag enumerators cannot be bit-masked together to enable or disable multiple flags at once. Flags can also be enabled by setting the corresponding member to ``true``. +If ``enable`` is ``true``, enables the specified ``flag``. Flags are optional behavior that can be turned on and off. Only one flag can be enabled at a time with this function, the flag enumerators cannot be bit-masked together to enable or disable multiple flags at once. Flags can also be enabled by setting their corresponding property to ``true``. .. rst-class:: classref-item-separator diff --git a/classes/es/class_boneconstraint3d.rst b/classes/es/class_boneconstraint3d.rst index c20da7bc8b..623b7aafb9 100644 --- a/classes/es/class_boneconstraint3d.rst +++ b/classes/es/class_boneconstraint3d.rst @@ -26,33 +26,74 @@ Métodos .. table:: :widths: auto - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear_setting`\ (\ ) | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get_amount`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_apply_bone`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_apply_bone_name`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_reference_bone`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_reference_bone_name`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_setting_count`\ (\ ) |const| | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_amount`\ (\ index\: :ref:`int`, amount\: :ref:`float`\ ) | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_apply_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_apply_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_reference_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_reference_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_setting_count`\ (\ count\: :ref:`int`\ ) | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear_setting`\ (\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_amount`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_apply_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_apply_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_reference_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_reference_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`NodePath` | :ref:`get_reference_node`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`ReferenceType` | :ref:`get_reference_type`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_setting_count`\ (\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_amount`\ (\ index\: :ref:`int`, amount\: :ref:`float`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_apply_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_apply_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_reference_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_reference_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_reference_node`\ (\ index\: :ref:`int`, node\: :ref:`NodePath`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_reference_type`\ (\ index\: :ref:`int`, type\: :ref:`ReferenceType`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_setting_count`\ (\ count\: :ref:`int`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Enumeraciones +-------------------------- + +.. _enum_BoneConstraint3D_ReferenceType: + +.. rst-class:: classref-enumeration + +enum **ReferenceType**: :ref:`🔗` + +.. _class_BoneConstraint3D_constant_REFERENCE_TYPE_BONE: + +.. rst-class:: classref-enumeration-constant + +:ref:`ReferenceType` **REFERENCE_TYPE_BONE** = ``0`` + +The reference target is a bone. In this case, the reference target spaces is local space. + +.. _class_BoneConstraint3D_constant_REFERENCE_TYPE_NODE: + +.. rst-class:: classref-enumeration-constant + +:ref:`ReferenceType` **REFERENCE_TYPE_NODE** = ``1`` + +The reference target is a :ref:`Node3D`. In this case, the reference target spaces is model space. + +In other words, the reference target's coordinates are treated as if it were placed directly under :ref:`Skeleton3D` which parent of the **BoneConstraint3D**. .. rst-class:: classref-section-separator @@ -139,6 +180,32 @@ Este hueso solo será referenciado y no modificado por este modificador. ---- +.. _class_BoneConstraint3D_method_get_reference_node: + +.. rst-class:: classref-method + +:ref:`NodePath` **get_reference_node**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the reference node path of the setting at ``index``. + +This node will be only referenced and not modified by this modifier. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneConstraint3D_method_get_reference_type: + +.. rst-class:: classref-method + +:ref:`ReferenceType` **get_reference_type**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the reference target type of the setting at ``index``. See also :ref:`ReferenceType`. + +.. rst-class:: classref-item-separator + +---- + .. _class_BoneConstraint3D_method_get_setting_count: .. rst-class:: classref-method @@ -215,6 +282,32 @@ Este hueso solo será referenciado y no modificado por este modificador. ---- +.. _class_BoneConstraint3D_method_set_reference_node: + +.. rst-class:: classref-method + +|void| **set_reference_node**\ (\ index\: :ref:`int`, node\: :ref:`NodePath`\ ) :ref:`🔗` + +Sets the reference node path of the setting at ``index`` to ``node``. + +This node will be only referenced and not modified by this modifier. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneConstraint3D_method_set_reference_type: + +.. rst-class:: classref-method + +|void| **set_reference_type**\ (\ index\: :ref:`int`, type\: :ref:`ReferenceType`\ ) :ref:`🔗` + +Sets the reference target type of the setting at ``index`` to ``type``. See also :ref:`ReferenceType`. + +.. rst-class:: classref-item-separator + +---- + .. _class_BoneConstraint3D_method_set_setting_count: .. rst-class:: classref-method diff --git a/classes/es/class_bonetwistdisperser3d.rst b/classes/es/class_bonetwistdisperser3d.rst new file mode 100644 index 0000000000..c99642fd97 --- /dev/null +++ b/classes/es/class_bonetwistdisperser3d.rst @@ -0,0 +1,576 @@ +:github_url: hide + +.. _class_BoneTwistDisperser3D: + +BoneTwistDisperser3D +==================== + +**Hereda:** :ref:`SkeletonModifier3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` + +A node that propagates and disperses the child bone's twist to the parent bones. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +This **BoneTwistDisperser3D** allows for smooth twist interpolation between multiple bones by dispersing the end bone's twist to the parents. This only changes the twist without changing the global position of each joint. + +This is useful for smoothly twisting bones in combination with :ref:`CopyTransformModifier3D` and IK. + +\ **Note:** If an extracted twist is greater than 180 degrees, flipping occurs. This is similar to :ref:`ConvertTransformModifier3D`. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +-------------------------+---------------------------------------------------------------------------------+----------+ + | :ref:`bool` | :ref:`mutable_bone_axes` | ``true`` | + +-------------------------+---------------------------------------------------------------------------------+----------+ + | :ref:`int` | :ref:`setting_count` | ``0`` | + +-------------------------+---------------------------------------------------------------------------------+----------+ + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear_settings`\ (\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`get_damping_curve`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`DisperseMode` | :ref:`get_disperse_mode`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_end_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`BoneDirection` | :ref:`get_end_bone_direction`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_end_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_joint_bone`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_joint_bone_name`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_joint_count`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_joint_twist_amount`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_reference_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_reference_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_root_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_root_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Quaternion` | :ref:`get_twist_from`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_weight_position`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_end_bone_extended`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_twist_from_rest`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_damping_curve`\ (\ index\: :ref:`int`, curve\: :ref:`Curve`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_disperse_mode`\ (\ index\: :ref:`int`, disperse_mode\: :ref:`DisperseMode`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_direction`\ (\ index\: :ref:`int`, bone_direction\: :ref:`BoneDirection`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_extend_end_bone`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_twist_amount`\ (\ index\: :ref:`int`, joint\: :ref:`int`, twist_amount\: :ref:`float`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_root_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_root_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_twist_from`\ (\ index\: :ref:`int`, from\: :ref:`Quaternion`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_twist_from_rest`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_weight_position`\ (\ index\: :ref:`int`, weight_position\: :ref:`float`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Enumeraciones +-------------------------- + +.. _enum_BoneTwistDisperser3D_DisperseMode: + +.. rst-class:: classref-enumeration + +enum **DisperseMode**: :ref:`🔗` + +.. _class_BoneTwistDisperser3D_constant_DISPERSE_MODE_EVEN: + +.. rst-class:: classref-enumeration-constant + +:ref:`DisperseMode` **DISPERSE_MODE_EVEN** = ``0`` + +Assign amounts so that they monotonically increase from ``0.0`` to ``1.0``, ensuring all weights are equal. For example, with five joints, the amounts would be ``0.2``, ``0.4``, ``0.6``, ``0.8``, and ``1.0`` starting from the root bone. + +.. _class_BoneTwistDisperser3D_constant_DISPERSE_MODE_WEIGHTED: + +.. rst-class:: classref-enumeration-constant + +:ref:`DisperseMode` **DISPERSE_MODE_WEIGHTED** = ``1`` + +Assign amounts so that they monotonically increase from ``0.0`` to ``1.0``, based on the length of the bones between joint segments. See also :ref:`set_weight_position()`. + +.. _class_BoneTwistDisperser3D_constant_DISPERSE_MODE_CUSTOM: + +.. rst-class:: classref-enumeration-constant + +:ref:`DisperseMode` **DISPERSE_MODE_CUSTOM** = ``2`` + +You can assign arbitrary amounts to the joint list. See also :ref:`set_joint_twist_amount()`. + +When :ref:`is_end_bone_extended()` is ``false``, a child of the reference bone exists solely to determine the twist axis, so its custom amount has absolutely no effect at all. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_BoneTwistDisperser3D_property_mutable_bone_axes: + +.. rst-class:: classref-property + +:ref:`bool` **mutable_bone_axes** = ``true`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_mutable_bone_axes**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **are_bone_axes_mutable**\ (\ ) + +If ``true``, the solver retrieves the bone axis from the bone pose every frame. + +If ``false``, the solver retrieves the bone axis from the bone rest and caches it. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_property_setting_count: + +.. rst-class:: classref-property + +:ref:`int` **setting_count** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_setting_count**\ (\ value\: :ref:`int`\ ) +- :ref:`int` **get_setting_count**\ (\ ) + +El número de configuraciones. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_BoneTwistDisperser3D_method_clear_settings: + +.. rst-class:: classref-method + +|void| **clear_settings**\ (\ ) :ref:`🔗` + +Limpia todos los ajustes. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_damping_curve: + +.. rst-class:: classref-method + +:ref:`Curve` **get_damping_curve**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the damping curve when :ref:`get_disperse_mode()` is :ref:`DISPERSE_MODE_CUSTOM`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_disperse_mode: + +.. rst-class:: classref-method + +:ref:`DisperseMode` **get_disperse_mode**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns whether to use automatic amount assignment or to allow manual assignment. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_end_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_end_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el índice del hueso final de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_end_bone_direction: + +.. rst-class:: classref-method + +:ref:`BoneDirection` **get_end_bone_direction**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the tail direction of the end bone of the bone chain when :ref:`is_end_bone_extended()` is ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_end_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_end_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el nombre del hueso final de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_joint_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_joint_bone**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el índice del hueso en la articulación ``joint`` de la lista de articulaciones de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_joint_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_joint_bone_name**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el nombre del hueso en la articulación ``joint`` de la lista de articulaciones de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_joint_count: + +.. rst-class:: classref-method + +:ref:`int` **get_joint_count**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el número de articulaciones de la lista de articulaciones de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_joint_twist_amount: + +.. rst-class:: classref-method + +:ref:`float` **get_joint_twist_amount**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the twist amount at ``joint`` in the bone chain's joint list when :ref:`get_disperse_mode()` is :ref:`DISPERSE_MODE_CUSTOM`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_reference_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_reference_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the reference bone to extract twist of the setting at ``index``. + +This bone is either the end of the chain or its parent, depending on :ref:`is_end_bone_extended()`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_reference_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_reference_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the reference bone name to extract twist of the setting at ``index``. + +This bone is either the end of the chain or its parent, depending on :ref:`is_end_bone_extended()`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_root_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_root_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el índice del hueso raíz de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_root_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_root_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el nombre del hueso raíz de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_twist_from: + +.. rst-class:: classref-method + +:ref:`Quaternion` **get_twist_from**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the rotation to an arbitrary state before twisting for the current bone pose to extract the twist when :ref:`is_twist_from_rest()` is ``false``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_weight_position: + +.. rst-class:: classref-method + +:ref:`float` **get_weight_position**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the position at which to divide the segment between joints for weight assignment when :ref:`get_disperse_mode()` is :ref:`DISPERSE_MODE_WEIGHTED`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_is_end_bone_extended: + +.. rst-class:: classref-method + +:ref:`bool` **is_end_bone_extended**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns ``true`` if the end bone is extended to have a tail. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_is_twist_from_rest: + +.. rst-class:: classref-method + +:ref:`bool` **is_twist_from_rest**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns ``true`` if extracting the twist amount from the difference between the bone rest and the current bone pose. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_damping_curve: + +.. rst-class:: classref-method + +|void| **set_damping_curve**\ (\ index\: :ref:`int`, curve\: :ref:`Curve`\ ) :ref:`🔗` + +Sets the damping curve when :ref:`get_disperse_mode()` is :ref:`DISPERSE_MODE_CUSTOM`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_disperse_mode: + +.. rst-class:: classref-method + +|void| **set_disperse_mode**\ (\ index\: :ref:`int`, disperse_mode\: :ref:`DisperseMode`\ ) :ref:`🔗` + +Sets whether to use automatic amount assignment or to allow manual assignment. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_end_bone: + +.. rst-class:: classref-method + +|void| **set_end_bone**\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) :ref:`🔗` + +Establece el índice del hueso final de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_end_bone_direction: + +.. rst-class:: classref-method + +|void| **set_end_bone_direction**\ (\ index\: :ref:`int`, bone_direction\: :ref:`BoneDirection`\ ) :ref:`🔗` + +Establece la dirección de la cola del hueso final de la cadena de huesos cuando :ref:`is_end_bone_extended()` es ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_end_bone_name: + +.. rst-class:: classref-method + +|void| **set_end_bone_name**\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) :ref:`🔗` + +Sets the end bone name of the bone chain. + +\ **Note:** The end bone must be a child of the root bone. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_extend_end_bone: + +.. rst-class:: classref-method + +|void| **set_extend_end_bone**\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) :ref:`🔗` + +If ``enabled`` is ``true``, the end bone is extended to have a tail. + +If ``enabled`` is ``false``, :ref:`get_reference_bone()` becomes a parent of the end bone and it uses the vector to the end bone as a twist axis. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_joint_twist_amount: + +.. rst-class:: classref-method + +|void| **set_joint_twist_amount**\ (\ index\: :ref:`int`, joint\: :ref:`int`, twist_amount\: :ref:`float`\ ) :ref:`🔗` + +Sets the twist amount at ``joint`` in the bone chain's joint list when :ref:`get_disperse_mode()` is :ref:`DISPERSE_MODE_CUSTOM`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_root_bone: + +.. rst-class:: classref-method + +|void| **set_root_bone**\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) :ref:`🔗` + +Establece el índice del hueso raíz de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_root_bone_name: + +.. rst-class:: classref-method + +|void| **set_root_bone_name**\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) :ref:`🔗` + +Establece el nombre del hueso raíz de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_twist_from: + +.. rst-class:: classref-method + +|void| **set_twist_from**\ (\ index\: :ref:`int`, from\: :ref:`Quaternion`\ ) :ref:`🔗` + +Sets the rotation to an arbitrary state before twisting for the current bone pose to extract the twist when :ref:`is_twist_from_rest()` is ``false``. + +In other words, by calling :ref:`set_twist_from()` by :ref:`SkeletonModifier3D.modification_processed` of a specific :ref:`SkeletonModifier3D`, you can extract only the twists generated by modifiers processed after that but before this **BoneTwistDisperser3D**. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_twist_from_rest: + +.. rst-class:: classref-method + +|void| **set_twist_from_rest**\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) :ref:`🔗` + +If ``enabled`` is ``true``, it extracts the twist amount from the difference between the bone rest and the current bone pose. + +If ``enabled`` is ``false``, it extracts the twist amount from the difference between :ref:`get_twist_from()` and the current bone pose. See also :ref:`set_twist_from()`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_weight_position: + +.. rst-class:: classref-method + +|void| **set_weight_position**\ (\ index\: :ref:`int`, weight_position\: :ref:`float`\ ) :ref:`🔗` + +Sets the position at which to divide the segment between joints for weight assignment when :ref:`get_disperse_mode()` is :ref:`DISPERSE_MODE_WEIGHTED`. + +For example, when ``weight_position`` is ``0.5``, if two bone segments with a length of ``1.0`` exist between three joints, weights are assigned to each joint from root to end at ratios of ``0.5``, ``1.0``, and ``0.5``. Then amounts become ``0.25``, ``0.75``, and ``1.0`` respectively. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_button.rst b/classes/es/class_button.rst index d4d7223aa4..1456a11624 100644 --- a/classes/es/class_button.rst +++ b/classes/es/class_button.rst @@ -332,7 +332,7 @@ Especifica si el icono debe estar alineado horizontalmente a la izquierda, a la - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_language**\ (\ ) -Código de idioma utilizado para los algoritmos de salto de línea y forma del texto, si se deja vacío se utiliza la configuración regional actual. +Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead. .. rst-class:: classref-item-separator diff --git a/classes/es/class_camerafeed.rst b/classes/es/class_camerafeed.rst index 0db28ac646..244ef34d7c 100644 --- a/classes/es/class_camerafeed.rst +++ b/classes/es/class_camerafeed.rst @@ -44,33 +44,35 @@ Métodos .. table:: :widths: auto - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_activate_feed`\ (\ ) |virtual| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`_deactivate_feed`\ (\ ) |virtual| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`FeedDataType` | :ref:`get_datatype`\ (\ ) |const| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_id`\ (\ ) |const| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_name`\ (\ ) |const| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`FeedPosition` | :ref:`get_position`\ (\ ) |const| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_texture_tex_id`\ (\ feed_image_type\: :ref:`FeedImage`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_external`\ (\ width\: :ref:`int`, height\: :ref:`int`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`set_format`\ (\ index\: :ref:`int`, parameters\: :ref:`Dictionary`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_name`\ (\ name\: :ref:`String`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_position`\ (\ position\: :ref:`FeedPosition`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_rgb_image`\ (\ rgb_image\: :ref:`Image`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_ycbcr_image`\ (\ ycbcr_image\: :ref:`Image`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`_activate_feed`\ (\ ) |virtual| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`_deactivate_feed`\ (\ ) |virtual| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`FeedDataType` | :ref:`get_datatype`\ (\ ) |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_id`\ (\ ) |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_name`\ (\ ) |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`FeedPosition` | :ref:`get_position`\ (\ ) |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_texture_tex_id`\ (\ feed_image_type\: :ref:`FeedImage`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_external`\ (\ width\: :ref:`int`, height\: :ref:`int`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`set_format`\ (\ index\: :ref:`int`, parameters\: :ref:`Dictionary`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_name`\ (\ name\: :ref:`String`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_position`\ (\ position\: :ref:`FeedPosition`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_rgb_image`\ (\ rgb_image\: :ref:`Image`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_ycbcr_image`\ (\ ycbcr_image\: :ref:`Image`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_ycbcr_images`\ (\ y_image\: :ref:`Image`, cbcr_image\: :ref:`Image`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -412,6 +414,18 @@ Sets RGB image for this feed. Sets YCbCr image for this feed. +.. rst-class:: classref-item-separator + +---- + +.. _class_CameraFeed_method_set_ycbcr_images: + +.. rst-class:: classref-method + +|void| **set_ycbcr_images**\ (\ y_image\: :ref:`Image`, cbcr_image\: :ref:`Image`\ ) :ref:`🔗` + +Sets Y and CbCr images for this feed. + .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` diff --git a/classes/es/class_canvasgroup.rst b/classes/es/class_canvasgroup.rst index 30d0ed49ed..f84ab9a39d 100644 --- a/classes/es/class_canvasgroup.rst +++ b/classes/es/class_canvasgroup.rst @@ -14,9 +14,9 @@ Merges several 2D nodes into a single draw operation. Descripción ---------------------- -Child :ref:`CanvasItem` nodes of a **CanvasGroup** are drawn as a single object. It allows to e.g. draw overlapping translucent 2D nodes without blending (set :ref:`CanvasItem.self_modulate` property of **CanvasGroup** to achieve this effect). +Child :ref:`CanvasItem` nodes of a **CanvasGroup** are drawn as a single object. It allows to e.g. draw overlapping translucent 2D nodes without causing the overlapping sections to be more opaque than intended (set the :ref:`CanvasItem.self_modulate` property on the **CanvasGroup** to achieve this effect). -\ **Note:** The **CanvasGroup** uses a custom shader to read from the backbuffer to draw its children. Assigning a :ref:`Material` to the **CanvasGroup** overrides the builtin shader. To duplicate the behavior of the builtin shader in a custom :ref:`Shader` use the following: +\ **Note:** The **CanvasGroup** uses a custom shader to read from the backbuffer to draw its children. Assigning a :ref:`Material` to the **CanvasGroup** overrides the built-in shader. To duplicate the behavior of the built-in shader in a custom :ref:`Shader`, use the following: :: diff --git a/classes/es/class_canvasitem.rst b/classes/es/class_canvasitem.rst index 893e047203..5882e3a7ee 100644 --- a/classes/es/class_canvasitem.rst +++ b/classes/es/class_canvasitem.rst @@ -102,6 +102,10 @@ Métodos +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_dashed_line`\ (\ from\: :ref:`Vector2`, to\: :ref:`Vector2`, color\: :ref:`Color`, width\: :ref:`float` = -1.0, dash\: :ref:`float` = 2.0, aligned\: :ref:`bool` = true, antialiased\: :ref:`bool` = false\ ) | +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`draw_ellipse`\ (\ position\: :ref:`Vector2`, major\: :ref:`float`, minor\: :ref:`float`, color\: :ref:`Color`, filled\: :ref:`bool` = true, width\: :ref:`float` = -1.0, antialiased\: :ref:`bool` = false\ ) | + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`draw_ellipse_arc`\ (\ center\: :ref:`Vector2`, major\: :ref:`float`, minor\: :ref:`float`, start_angle\: :ref:`float`, end_angle\: :ref:`float`, point_count\: :ref:`int`, color\: :ref:`Color`, width\: :ref:`float` = -1.0, antialiased\: :ref:`bool` = false\ ) | + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_end_animation`\ (\ ) | +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_lcd_texture_rect_region`\ (\ texture\: :ref:`Texture2D`, rect\: :ref:`Rect2`, src_rect\: :ref:`Rect2`, modulate\: :ref:`Color` = Color(1, 1, 1, 1)\ ) | @@ -504,7 +508,9 @@ El **CanvasItem** ha entrado en el canvas. **NOTIFICATION_EXIT_CANVAS** = ``33`` :ref:`🔗` -El **CanvasItem** ha salido del canvas. +The **CanvasItem** has exited the canvas. + +This notification is sent in reversed order. .. _class_CanvasItem_constant_NOTIFICATION_WORLD_2D_CHANGED: @@ -712,6 +718,8 @@ Si es ``true``, el :ref:`material` del eleme The rendering layer in which this **CanvasItem** is rendered by :ref:`Viewport` nodes. A :ref:`Viewport` will render a **CanvasItem** if it and all its parents share a layer with the :ref:`Viewport`'s canvas cull mask. +\ **Note:** A **CanvasItem** does not inherit its parents' visibility layers. This means that if a parent **CanvasItem** does not have all the same layers as its child, the child may not be visible even if both the parent and child have :ref:`visible` set to ``true``. For example, if a parent has layer 1 and a child has layer 2, the child will not be visible in a :ref:`Viewport` with the canvas cull mask set to layer 1 or 2 (see :ref:`Viewport.canvas_cull_mask`). To ensure that both the parent and child are visible, the parent must have both layers 1 and 2, or the child must have :ref:`top_level` set to ``true``. + .. rst-class:: classref-item-separator ---- @@ -831,7 +839,7 @@ Subsequent drawing commands will be ignored unless they fall within the specifie |void| **draw_arc**\ (\ center\: :ref:`Vector2`, radius\: :ref:`float`, start_angle\: :ref:`float`, end_angle\: :ref:`float`, point_count\: :ref:`int`, color\: :ref:`Color`, width\: :ref:`float` = -1.0, antialiased\: :ref:`bool` = false\ ) :ref:`🔗` -Draws an unfilled arc between the given angles with a uniform ``color`` and ``width`` and optional antialiasing (supported only for positive ``width``). The larger the value of ``point_count``, the smoother the curve. ``center`` is defined in local space. See also :ref:`draw_circle()`. +Draws an unfilled arc between the given angles with a uniform ``color`` and ``width`` and optional antialiasing (supported only for positive ``width``). The larger the value of ``point_count``, the smoother the curve. ``center`` is defined in local space. For elliptical arcs, see :ref:`draw_ellipse_arc()`. See also :ref:`draw_circle()`. If ``width`` is negative, it will be ignored and the arc will be drawn using :ref:`RenderingServer.PRIMITIVE_LINE_STRIP`. This means that when the CanvasItem is scaled, the arc will remain thin. If this behavior is not desired, then pass a positive ``width`` like ``1.0``. @@ -871,7 +879,7 @@ Draws a string first character outline using a custom font. If ``oversampling`` |void| **draw_circle**\ (\ position\: :ref:`Vector2`, radius\: :ref:`float`, color\: :ref:`Color`, filled\: :ref:`bool` = true, width\: :ref:`float` = -1.0, antialiased\: :ref:`bool` = false\ ) :ref:`🔗` -Draws a circle, with ``position`` defined in local space. See also :ref:`draw_arc()`, :ref:`draw_polyline()`, and :ref:`draw_polygon()`. +Draws a circle, with ``position`` defined in local space. See also :ref:`draw_ellipse()`, :ref:`draw_arc()`, :ref:`draw_polyline()`, and :ref:`draw_polygon()`. If ``filled`` is ``true``, the circle will be filled with the ``color`` specified. If ``filled`` is ``false``, the circle will be drawn as a stroke with the ``color`` and ``width`` specified. @@ -919,6 +927,42 @@ If ``antialiased`` is ``true``, half transparent "feathers" will be attached to ---- +.. _class_CanvasItem_method_draw_ellipse: + +.. rst-class:: classref-method + +|void| **draw_ellipse**\ (\ position\: :ref:`Vector2`, major\: :ref:`float`, minor\: :ref:`float`, color\: :ref:`Color`, filled\: :ref:`bool` = true, width\: :ref:`float` = -1.0, antialiased\: :ref:`bool` = false\ ) :ref:`🔗` + +Draws an ellipse with semi-major axis ``major`` and semi-minor axis ``minor``. See also :ref:`draw_circle()`, :ref:`draw_ellipse_arc()`, :ref:`draw_polyline()`, and :ref:`draw_polygon()`. + +If ``filled`` is ``true``, the ellipse will be filled with the ``color`` specified. If ``filled`` is ``false``, the ellipse will be drawn as a stroke with the ``color`` and ``width`` specified. + +If ``width`` is negative, then two-point primitives will be drawn instead of four-point ones. This means that when the CanvasItem is scaled, the lines will remain thin. If this behavior is not desired, then pass a positive ``width`` like ``1.0``. + +If ``antialiased`` is ``true``, half transparent "feathers" will be attached to the boundary, making outlines smooth. + +\ **Note:** ``width`` is only effective if ``filled`` is ``false``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_CanvasItem_method_draw_ellipse_arc: + +.. rst-class:: classref-method + +|void| **draw_ellipse_arc**\ (\ center\: :ref:`Vector2`, major\: :ref:`float`, minor\: :ref:`float`, start_angle\: :ref:`float`, end_angle\: :ref:`float`, point_count\: :ref:`int`, color\: :ref:`Color`, width\: :ref:`float` = -1.0, antialiased\: :ref:`bool` = false\ ) :ref:`🔗` + +Draws an unfilled elliptical arc between the given angles with a uniform ``color`` and ``width`` and optional antialiasing (supported only for positive ``width``). The larger the value of ``point_count``, the smoother the curve. For circular arcs, see :ref:`draw_arc()`. See also :ref:`draw_ellipse()`. + +If ``width`` is negative, it will be ignored and the arc will be drawn using :ref:`RenderingServer.PRIMITIVE_LINE_STRIP`. This means that when the CanvasItem is scaled, the arc will remain thin. If this behavior is not desired, then pass a positive ``width`` like ``1.0``. + +The arc is drawn from ``start_angle`` towards the value of ``end_angle`` so in clockwise direction if ``start_angle < end_angle`` and counter-clockwise otherwise. Passing the same angles but in reversed order will produce the same arc. If absolute difference of ``start_angle`` and ``end_angle`` is greater than :ref:`@GDScript.TAU` radians, then a full ellipse is drawn (i.e. arc will not overlap itself). + +.. rst-class:: classref-item-separator + +---- + .. _class_CanvasItem_method_draw_end_animation: .. rst-class:: classref-method @@ -1393,7 +1437,7 @@ Returns the mouse's position in this **CanvasItem** using the local coordinate s Returns the transform of this **CanvasItem** in global screen coordinates (i.e. taking window position into account). Mostly useful for editor plugins. -Equals to :ref:`get_global_transform()` if the window is embedded (see :ref:`Viewport.gui_embed_subwindows`). +Equivalent to :ref:`get_global_transform_with_canvas()` if the window is embedded (see :ref:`Viewport.gui_embed_subwindows`). .. rst-class:: classref-item-separator @@ -1603,7 +1647,7 @@ If ``true``, the node will receive :ref:`NOTIFICATION_LOCAL_TRANSFORM_CHANGED`\ ) :ref:`🔗` -If ``true``, the node will receive :ref:`NOTIFICATION_TRANSFORM_CHANGED` whenever global transform changes. +If ``true``, the node will receive :ref:`NOTIFICATION_TRANSFORM_CHANGED` whenever its global transform changes. \ **Note:** Many canvas items such as :ref:`Camera2D` or :ref:`Light2D` automatically enable this in order to function correctly. diff --git a/classes/es/class_ccdik3d.rst b/classes/es/class_ccdik3d.rst new file mode 100644 index 0000000000..4032a9c234 --- /dev/null +++ b/classes/es/class_ccdik3d.rst @@ -0,0 +1,31 @@ +:github_url: hide + +.. _class_CCDIK3D: + +CCDIK3D +======= + +**Hereda:** :ref:`IterateIK3D` **<** :ref:`ChainIK3D` **<** :ref:`IKModifier3D` **<** :ref:`SkeletonModifier3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` + +Rotation based cyclic coordinate descent inverse kinematics solver. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +**CCDIK3D** is rotation based IK, enabling fast and effective tracking even with large joint rotations. It's especially suitable for chains with limitations, providing smoother and more stable target tracking compared to :ref:`FABRIK3D`. + +The resulting twist around the forward vector will always be kept from the previous pose. + +\ **Note:** When the target is close to the root, it can cause unnatural movement, including joint flips and oscillations. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_chainik3d.rst b/classes/es/class_chainik3d.rst new file mode 100644 index 0000000000..ab5e8abcd0 --- /dev/null +++ b/classes/es/class_chainik3d.rst @@ -0,0 +1,286 @@ +:github_url: hide + +.. _class_ChainIK3D: + +ChainIK3D +========= + +**Hereda:** :ref:`IKModifier3D` **<** :ref:`SkeletonModifier3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` + +**Heredado por:** :ref:`IterateIK3D`, :ref:`SplineIK3D` + +A :ref:`SkeletonModifier3D` to apply inverse kinematics to bone chains containing an arbitrary number of bones. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Base class of :ref:`SkeletonModifier3D` that automatically generates a joint list from the bones between the root bone and the end bone. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_end_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`BoneDirection` | :ref:`get_end_bone_direction`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_end_bone_length`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_end_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_joint_bone`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_joint_bone_name`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_joint_count`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_root_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_root_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_end_bone_extended`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_direction`\ (\ index\: :ref:`int`, bone_direction\: :ref:`BoneDirection`\ ) | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_length`\ (\ index\: :ref:`int`, length\: :ref:`float`\ ) | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_extend_end_bone`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_root_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_root_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_ChainIK3D_method_get_end_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_end_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el índice del hueso final de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_end_bone_direction: + +.. rst-class:: classref-method + +:ref:`BoneDirection` **get_end_bone_direction**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the tail direction of the end bone of the bone chain when :ref:`is_end_bone_extended()` is ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_end_bone_length: + +.. rst-class:: classref-method + +:ref:`float` **get_end_bone_length**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the end bone tail length of the bone chain when :ref:`is_end_bone_extended()` is ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_end_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_end_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el nombre del hueso final de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_joint_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_joint_bone**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el índice del hueso en la articulación ``joint`` de la lista de articulaciones de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_joint_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_joint_bone_name**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el nombre del hueso en la articulación ``joint`` de la lista de articulaciones de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_joint_count: + +.. rst-class:: classref-method + +:ref:`int` **get_joint_count**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el número de articulaciones de la lista de articulaciones de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_root_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_root_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el índice del hueso raíz de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_root_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_root_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el nombre del hueso raíz de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_is_end_bone_extended: + +.. rst-class:: classref-method + +:ref:`bool` **is_end_bone_extended**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns ``true`` if the end bone is extended to have a tail. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_set_end_bone: + +.. rst-class:: classref-method + +|void| **set_end_bone**\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) :ref:`🔗` + +Establece el índice del hueso final de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_set_end_bone_direction: + +.. rst-class:: classref-method + +|void| **set_end_bone_direction**\ (\ index\: :ref:`int`, bone_direction\: :ref:`BoneDirection`\ ) :ref:`🔗` + +Establece la dirección de la cola del hueso final de la cadena de huesos cuando :ref:`is_end_bone_extended()` es ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_set_end_bone_length: + +.. rst-class:: classref-method + +|void| **set_end_bone_length**\ (\ index\: :ref:`int`, length\: :ref:`float`\ ) :ref:`🔗` + +Establece la longitud de la cola del hueso final de la cadena de huesos cuando :ref:`is_end_bone_extended()` es ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_set_end_bone_name: + +.. rst-class:: classref-method + +|void| **set_end_bone_name**\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) :ref:`🔗` + +Sets the end bone name of the bone chain. + +\ **Note:** The end bone must be the root bone or a child of the root bone. If they are the same, the tail must be extended by :ref:`set_extend_end_bone()` to modify the bone. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_set_extend_end_bone: + +.. rst-class:: classref-method + +|void| **set_extend_end_bone**\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) :ref:`🔗` + +If ``enabled`` is ``true``, the end bone is extended to have a tail. + +The extended tail config is allocated to the last element in the joint list. In other words, if you set ``enabled`` to ``false``, the config of the last element in the joint list has no effect in the simulated result. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_set_root_bone: + +.. rst-class:: classref-method + +|void| **set_root_bone**\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) :ref:`🔗` + +Establece el índice del hueso raíz de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_set_root_bone_name: + +.. rst-class:: classref-method + +|void| **set_root_bone_name**\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) :ref:`🔗` + +Establece el nombre del hueso raíz de la cadena de huesos. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_characterbody2d.rst b/classes/es/class_characterbody2d.rst index 910e43611b..4bd239d667 100644 --- a/classes/es/class_characterbody2d.rst +++ b/classes/es/class_characterbody2d.rst @@ -441,7 +441,7 @@ Vector pointing upwards, used to determine what is a wall and what is a floor (o Current velocity vector in pixels per second, used and modified during calls to :ref:`move_and_slide()`. -This property should not be set to a value multiplied by ``delta``, because this happens internally in :ref:`move_and_slide()`. Otherwise, the simulation will run at an incorrect speed. +\ **Note:** A common mistake is setting this property to the desired velocity multiplied by ``delta``, which produces a motion vector in pixels. .. rst-class:: classref-item-separator @@ -525,7 +525,7 @@ Devuelve el último movimiento aplicado al **CharacterBody2D** durante la últim :ref:`KinematicCollision2D` **get_last_slide_collision**\ (\ ) :ref:`🔗` -Devuelve una :ref:`KinematicCollision2D`, que contiene información sobre la última colisión que ocurrió durante la última llamada a :ref:`move_and_slide()`. +Returns a :ref:`KinematicCollision2D` if a collision occurred. The returned value contains information about the latest collision that occurred during the last call to :ref:`move_and_slide()`. Returns ``null`` if no collision occurred. See also :ref:`get_slide_collision()`. .. rst-class:: classref-item-separator @@ -573,9 +573,9 @@ Devuelve la velocidad real actual desde la última llamada a :ref:`move_and_slid :ref:`KinematicCollision2D` **get_slide_collision**\ (\ slide_idx\: :ref:`int`\ ) :ref:`🔗` -Devuelve un :ref:`KinematicCollision2D`, que contiene información sobre una colisión que ocurrió durante la última llamada a :ref:`move_and_slide()`. Dado que el cuerpo puede colisionar varias veces en una sola llamada a :ref:`move_and_slide()`, debes especificar el índice de la colisión en el rango 0 a (:ref:`get_slide_collision_count()` - 1). +Returns a :ref:`KinematicCollision2D`, which contains information about a collision that occurred during the last call to :ref:`move_and_slide()`. Since the body can collide several times in a single call to :ref:`move_and_slide()`, you must specify the index of the collision in the range 0 to (:ref:`get_slide_collision_count()` - 1). See also :ref:`get_last_slide_collision()`. -\ **Ejemplo:** Iterar a través de las colisiones con un bucle ``for``: +\ **Example:** Iterate through the collisions with a ``for`` loop: .. tabs:: @@ -584,14 +584,14 @@ Devuelve un :ref:`KinematicCollision2D`, que contien for i in get_slide_collision_count(): var collision = get_slide_collision(i) - print("Colisionó con: ", collision.get_collider().name) + print("Collided with: ", collision.get_collider().name) .. code-tab:: csharp for (int i = 0; i < GetSlideCollisionCount(); i++) { KinematicCollision2D collision = GetSlideCollision(i); - GD.Print("Colisionó con: ", (collision.GetCollider() as Node).Name); + GD.Print("Collided with: ", (collision.GetCollider() as Node).Name); } diff --git a/classes/es/class_characterbody3d.rst b/classes/es/class_characterbody3d.rst index 823217bf8f..6979a1e825 100644 --- a/classes/es/class_characterbody3d.rst +++ b/classes/es/class_characterbody3d.rst @@ -445,7 +445,7 @@ Vector pointing upwards, used to determine what is a wall and what is a floor (o Current velocity vector (typically meters per second), used and modified during calls to :ref:`move_and_slide()`. -This property should not be set to a value multiplied by ``delta``, because this happens internally in :ref:`move_and_slide()`. Otherwise, the simulation will run at an incorrect speed. +\ **Note:** A common mistake is setting this property to the desired velocity multiplied by ``delta``, which produces a motion vector (typically in meters). .. rst-class:: classref-item-separator @@ -529,7 +529,7 @@ Returns the last motion applied to the **CharacterBody3D** during the last call :ref:`KinematicCollision3D` **get_last_slide_collision**\ (\ ) :ref:`🔗` -Returns a :ref:`KinematicCollision3D`, which contains information about the latest collision that occurred during the last call to :ref:`move_and_slide()`. +Returns a :ref:`KinematicCollision3D` if a collision occurred. The returned value contains information about the latest collision that occurred during the last call to :ref:`move_and_slide()`. Returns ``null`` if no collision occurred. See also :ref:`get_slide_collision()`. .. rst-class:: classref-item-separator @@ -589,7 +589,7 @@ Devuelve la velocidad real actual desde la última llamada a :ref:`move_and_slid :ref:`KinematicCollision3D` **get_slide_collision**\ (\ slide_idx\: :ref:`int`\ ) :ref:`🔗` -Returns a :ref:`KinematicCollision3D`, which contains information about a collision that occurred during the last call to :ref:`move_and_slide()`. Since the body can collide several times in a single call to :ref:`move_and_slide()`, you must specify the index of the collision in the range 0 to (:ref:`get_slide_collision_count()` - 1). +Returns a :ref:`KinematicCollision3D`, which contains information about a collision that occurred during the last call to :ref:`move_and_slide()`. Since the body can collide several times in a single call to :ref:`move_and_slide()`, you must specify the index of the collision in the range 0 to (:ref:`get_slide_collision_count()` - 1). See also :ref:`get_last_slide_collision()`. .. rst-class:: classref-item-separator diff --git a/classes/es/class_codeedit.rst b/classes/es/class_codeedit.rst index 926ef7bd51..479b1486b4 100644 --- a/classes/es/class_codeedit.rst +++ b/classes/es/class_codeedit.rst @@ -51,6 +51,8 @@ Propiedades +----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ | :ref:`bool` | :ref:`gutters_draw_line_numbers` | ``false`` | +----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`int` | :ref:`gutters_line_numbers_min_digits` | ``3`` | + +----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ | :ref:`bool` | :ref:`gutters_zero_pad_line_numbers` | ``false`` | +----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ | :ref:`bool` | :ref:`indent_automatic` | ``false`` | @@ -709,6 +711,23 @@ If ``true``, the line number gutter is drawn. Line numbers start at ``1`` and ar ---- +.. _class_CodeEdit_property_gutters_line_numbers_min_digits: + +.. rst-class:: classref-property + +:ref:`int` **gutters_line_numbers_min_digits** = ``3`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_line_numbers_min_digits**\ (\ value\: :ref:`int`\ ) +- :ref:`int` **get_line_numbers_min_digits**\ (\ ) + +The minimum width in digits reserved for the line number gutter. + +.. rst-class:: classref-item-separator + +---- + .. _class_CodeEdit_property_gutters_zero_pad_line_numbers: .. rst-class:: classref-property diff --git a/classes/es/class_collisionpolygon2d.rst b/classes/es/class_collisionpolygon2d.rst index ab87e36654..46bb96bfc4 100644 --- a/classes/es/class_collisionpolygon2d.rst +++ b/classes/es/class_collisionpolygon2d.rst @@ -14,7 +14,7 @@ Un nodo que proporciona una forma de polígono a un padre :ref:`CollisionObject2 Descripción ---------------------- -A node that provides a polygon shape to a :ref:`CollisionObject2D` parent and allows to edit it. The polygon can be concave or convex. This can give a detection shape to an :ref:`Area2D`, turn :ref:`PhysicsBody2D` into a solid object, or give a hollow shape to a :ref:`StaticBody2D`. +A node that provides a polygon shape to a :ref:`CollisionObject2D` parent and allows it to be edited. The polygon can be concave or convex. This can give a detection shape to an :ref:`Area2D`, turn a :ref:`PhysicsBody2D` into a solid object, or give a hollow shape to a :ref:`StaticBody2D`. \ **Warning:** A non-uniformly scaled **CollisionPolygon2D** will likely not behave as expected. Make sure to keep its scale the same on all axes and adjust its polygon instead. diff --git a/classes/es/class_collisionpolygon3d.rst b/classes/es/class_collisionpolygon3d.rst index 5630fa6d6d..fb49496a7a 100644 --- a/classes/es/class_collisionpolygon3d.rst +++ b/classes/es/class_collisionpolygon3d.rst @@ -14,7 +14,7 @@ Un nodo que proporciona una forma de polígono engrosada (un prisma) a un padre Descripción ---------------------- -A node that provides a thickened polygon shape (a prism) to a :ref:`CollisionObject3D` parent and allows to edit it. The polygon can be concave or convex. This can give a detection shape to an :ref:`Area3D` or turn :ref:`PhysicsBody3D` into a solid object. +A node that provides a thickened polygon shape (a prism) to a :ref:`CollisionObject3D` parent and allows it to be edited. The polygon can be concave or convex. This can give a detection shape to an :ref:`Area3D` or turn a :ref:`PhysicsBody3D` into a solid object. \ **Warning:** A non-uniformly scaled :ref:`CollisionShape3D` will likely not behave as expected. Make sure to keep its scale the same on all axes and adjust its shape resource instead. diff --git a/classes/es/class_collisionshape2d.rst b/classes/es/class_collisionshape2d.rst index 0366445076..b098458cb9 100644 --- a/classes/es/class_collisionshape2d.rst +++ b/classes/es/class_collisionshape2d.rst @@ -14,7 +14,7 @@ Un nodo que proporciona una :ref:`Shape2D` a un padre :ref:`Colli Descripción ---------------------- -Un nodo que proporciona una :ref:`Shape2D` a un padre :ref:`CollisionObject2D` y permite editarlo. Esto puede dar una forma de detección a un :ref:`Area2D` o convertir un :ref:`PhysicsBody2D` en un objeto sólido. +A node that provides a :ref:`Shape2D` to a :ref:`CollisionObject2D` parent and allows it to be edited. This can give a detection shape to an :ref:`Area2D` or turn a :ref:`PhysicsBody2D` into a solid object. .. rst-class:: classref-introduction-group diff --git a/classes/es/class_collisionshape3d.rst b/classes/es/class_collisionshape3d.rst index 79d28d24ae..bfc9e968f6 100644 --- a/classes/es/class_collisionshape3d.rst +++ b/classes/es/class_collisionshape3d.rst @@ -14,7 +14,7 @@ Un nodo que proporciona una :ref:`Shape3D` a un padre :ref:`Colli Descripción ---------------------- -A node that provides a :ref:`Shape3D` to a :ref:`CollisionObject3D` parent and allows to edit it. This can give a detection shape to an :ref:`Area3D` or turn a :ref:`PhysicsBody3D` into a solid object. +A node that provides a :ref:`Shape3D` to a :ref:`CollisionObject3D` parent and allows it to be edited. This can give a detection shape to an :ref:`Area3D` or turn a :ref:`PhysicsBody3D` into a solid object. \ **Warning:** A non-uniformly scaled **CollisionShape3D** will likely not behave as expected. Make sure to keep its scale the same on all axes and adjust its :ref:`shape` resource instead. diff --git a/classes/es/class_color.rst b/classes/es/class_color.rst index 212ab0fa76..0a8888ce86 100644 --- a/classes/es/class_color.rst +++ b/classes/es/class_color.rst @@ -14,14 +14,16 @@ Descripción A color represented in RGBA format by a red (:ref:`r`), green (:ref:`g`), blue (:ref:`b`), and alpha (:ref:`a`) component. Each component is a 32-bit floating-point value, usually ranging from ``0.0`` to ``1.0``. Some properties (such as :ref:`CanvasItem.modulate`) may support values greater than ``1.0``, for overbright or HDR (High Dynamic Range) colors. -Colors can be created in various ways: By the various **Color** constructors, by static methods such as :ref:`from_hsv()`, and by using a name from the set of standardized colors based on `X11 color names `__ with the addition of :ref:`TRANSPARENT`. GDScript also provides :ref:`@GDScript.Color8()`, which uses integers from ``0`` to ``255`` and doesn't support overbright colors. +Colors can be created in a number of ways: By the various **Color** constructors, by static methods such as :ref:`from_hsv()`, and by using a name from the set of standardized colors based on `X11 color names `__ with the addition of :ref:`TRANSPARENT`. -Color data may be stored in many color spaces and encodings. The :ref:`srgb_to_linear()` and :ref:`linear_to_srgb()` methods can convert between nonlinear sRGB encoding and linear RGB encoding. +\ `Color constants cheatsheet `__\ + +Although **Color** may be used to store values of any encoding, the red (:ref:`r`), green (:ref:`g`), and blue (:ref:`b`) properties of **Color** are expected by Godot to be encoded using the `nonlinear sRGB transfer function `__ unless otherwise stated. This color encoding is used by many traditional art and web tools, making it easy to match colors between Godot and these tools. Godot uses `Rec. ITU-R BT.709 `__ color primaries, which are used by the sRGB standard. + +All physical simulation, such as lighting calculations, and colorimetry transformations, such as :ref:`get_luminance()`, must be performed on linearly encoded values to produce correct results. When performing these calculations, convert **Color** to and from linear encoding using :ref:`srgb_to_linear()` and :ref:`linear_to_srgb()`. \ **Note:** In a boolean context, a Color will evaluate to ``false`` if it is equal to ``Color(0, 0, 0, 1)`` (opaque black). Otherwise, a Color will always evaluate to ``true``. -\ `Color constants cheatsheet `__ - .. note:: Hay diferencias notables cuando usa esta API con C#. Véase :ref:`doc_c_sharp_differences` para más información. @@ -1389,9 +1391,9 @@ Descripciones de Propiedades :ref:`float` **a** = ``1.0`` :ref:`🔗` -El componente alfa del color, normalmente en el rango de 0 a 1. Un valor de 0 significa que el color es totalmente transparente. Un valor de 1 significa que el color es totalmente opaco. +The color's alpha component, typically on the range of 0 to 1. A value of 0 means that the color is fully transparent. A value of 1 means that the color is fully opaque. -\ **Nota:** El canal alfa siempre se almacena con codificación lineal, independientemente del espacio de color de los otros canales de color. Los métodos :ref:`linear_to_srgb()` y :ref:`srgb_to_linear()` no afectan al canal alfa. +\ **Note:** The alpha channel is always stored with linear encoding, regardless of the encoding of the other color channels. The :ref:`linear_to_srgb()` and :ref:`srgb_to_linear()` methods do not affect the alpha channel. .. rst-class:: classref-item-separator @@ -1629,18 +1631,18 @@ Construye un **Color** ya sea desde un código de color HTML o desde un nombre d :ref:`Color` **Color**\ (\ r\: :ref:`float`, g\: :ref:`float`, b\: :ref:`float`\ ) -Construye un **Color** a partir de valores RGB, normalmente entre 0.0 y 1.0. :ref:`a` se establece en 1.0. +Constructs a **Color** from RGB values, typically between 0.0 and 1.0. :ref:`a` is set to 1.0. .. tabs:: .. code-tab:: gdscript - var color = Color(0.2, 1.0, 0.7) # Similar a `Color8(51, 255, 178, 255)` + var color = Color(0.2, 1.0, 0.7) # Similar to `Color.from_rgba8(51, 255, 178, 255)` .. code-tab:: csharp - var color = new Color(0.2f, 1.0f, 0.7f); // Similar a `Color.Color8(51, 255, 178, 255)` + var color = new Color(0.2f, 1.0f, 0.7f); // Similar to `Color.Color8(51, 255, 178, 255)` @@ -1652,18 +1654,18 @@ Construye un **Color** a partir de valores RGB, normalmente entre 0.0 y 1.0. :re :ref:`Color` **Color**\ (\ r\: :ref:`float`, g\: :ref:`float`, b\: :ref:`float`, a\: :ref:`float`\ ) -Construye un **Color** a partir de valores RGBA, normalmente entre 0.0 y 1.0. +Constructs a **Color** from RGBA values, typically between 0.0 and 1.0. .. tabs:: .. code-tab:: gdscript - var color = Color(0.2, 1.0, 0.7, 0.8) # Similar a `Color8(51, 255, 178, 204)` + var color = Color(0.2, 1.0, 0.7, 0.8) # Similar to `Color.from_rgba8(51, 255, 178, 204)` .. code-tab:: csharp - var color = new Color(0.2f, 1.0f, 0.7f, 0.8f); // Similar a `Color.Color8(51, 255, 178, 255, 204)` + var color = new Color(0.2f, 1.0f, 0.7f, 0.8f); // Similar to `Color.Color8(51, 255, 178, 255, 204)` @@ -1846,9 +1848,9 @@ Si quieres crear un color desde una String en una expresión constante, usa el c :ref:`float` **get_luminance**\ (\ ) |const| :ref:`🔗` -Devuelve la intensidad de la luz del color, como un valor entre 0.0 y 1.0 (inclusivo). Esto es útil para determinar el color claro u oscuro. Los colores con una luminancia inferior a 0.5 pueden considerarse generalmente oscuros. +Returns the light intensity of the color, as a value between 0.0 and 1.0 (inclusive). This is useful when determining light or dark color. Colors with a luminance smaller than 0.5 can be generally considered dark. -\ **Nota:** :ref:`get_luminance()` se basa en que el color esté en el espacio de color lineal para devolver un valor de luminancia relativa preciso. Si el color está en el espacio de color sRGB, usa :ref:`srgb_to_linear()` para convertirlo primero al espacio de color lineal. +\ **Note:** :ref:`get_luminance()` relies on the color using linear encoding to return an accurate relative luminance value. If the color uses the default nonlinear sRGB encoding, use :ref:`srgb_to_linear()` to convert it to linear encoding first. .. rst-class:: classref-item-separator @@ -2078,9 +2080,9 @@ Devuelve un nuevo color resultante de hacer este color más claro según la ``am :ref:`Color` **linear_to_srgb**\ (\ ) |const| :ref:`🔗` -Devuelve el color convertido al espacio de color `sRGB `__. Este método asume que el color original está en el espacio de color lineal. Véase también :ref:`srgb_to_linear()`, que realiza la operación opuesta. +Returns a copy of the color that is encoded using the `nonlinear sRGB transfer function `__. This method requires the original color to use linear encoding. See also :ref:`srgb_to_linear()` which performs the opposite operation. -\ **Nota:** El canal alfa :ref:`a` del color no se ve afectado. El canal alfa siempre se almacena con codificación lineal, independientemente del espacio de color de los otros canales de color. +\ **Note:** The color's alpha channel (:ref:`a`) is not affected. The alpha channel is always stored with linear encoding, regardless of the color space of the other color channels. .. rst-class:: classref-item-separator @@ -2092,9 +2094,9 @@ Devuelve el color convertido al espacio de color `sRGB ` **srgb_to_linear**\ (\ ) |const| :ref:`🔗` -Devuelve el color convertido al espacio de color lineal. Este método asume que el color original ya está en el espacio de color sRGB. Véase también :ref:`linear_to_srgb()`, que realiza la operación opuesta. +Returns a copy of the color that uses linear encoding. This method requires the original color to be encoded using the `nonlinear sRGB transfer function `__. See also :ref:`linear_to_srgb()` which performs the opposite operation. -\ **Nota:** El canal alfa :ref:`a` del color no se ve afectado. El canal alfa siempre se almacena con codificación lineal, independientemente del espacio de color de los otros canales de color. +\ **Note:** The color's alpha channel (:ref:`a`) is not affected. The alpha channel is always stored with linear encoding, regardless of the color space of the other color channels. .. rst-class:: classref-item-separator diff --git a/classes/es/class_colorpicker.rst b/classes/es/class_colorpicker.rst index 1cb3488aa8..f9e3cd5a00 100644 --- a/classes/es/class_colorpicker.rst +++ b/classes/es/class_colorpicker.rst @@ -433,7 +433,7 @@ Si es ``true``, muestra un deslizador de canal alfa (opacidad). - |void| **set_edit_intensity**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_editing_intensity**\ (\ ) -Si es ``true``, muestra un deslizador de intensidad. La intensidad se aplica de la siguiente manera: multiplica el color por ``2 ** intensity`` en espacio RGB lineal, y luego lo convierte de nuevo a sRGB. +If ``true``, shows an intensity slider. The intensity is applied as follows: convert the color to linear encoding, multiply it by ``2 ** intensity``, and then convert it back to nonlinear sRGB encoding. .. rst-class:: classref-item-separator diff --git a/classes/es/class_confirmationdialog.rst b/classes/es/class_confirmationdialog.rst index 5edf769dcf..1abf6a6f51 100644 --- a/classes/es/class_confirmationdialog.rst +++ b/classes/es/class_confirmationdialog.rst @@ -7,7 +7,7 @@ ConfirmationDialog **Hereda:** :ref:`AcceptDialog` **<** :ref:`Window` **<** :ref:`Viewport` **<** :ref:`Node` **<** :ref:`Object` -**Heredado por:** :ref:`EditorCommandPalette`, :ref:`EditorFileDialog`, :ref:`FileDialog`, :ref:`ScriptCreateDialog` +**Heredado por:** :ref:`EditorCommandPalette`, :ref:`FileDialog`, :ref:`ScriptCreateDialog` A dialog used for confirmation of actions. @@ -33,6 +33,8 @@ To get cancel action, you can use: +\ **Note:** :ref:`AcceptDialog` is invisible by default. To make it visible, call one of the ``popup_*`` methods from :ref:`Window` on the node, such as :ref:`Window.popup_centered_clamped()`. + .. rst-class:: classref-reftable-group Propiedades diff --git a/classes/es/class_control.rst b/classes/es/class_control.rst index c79c1f2ef4..4194f8ceff 100644 --- a/classes/es/class_control.rst +++ b/classes/es/class_control.rst @@ -30,9 +30,9 @@ Input events are propagated through the :ref:`SceneTree` from t Call :ref:`accept_event()` so no other node receives the event. Once you accept an input, it becomes handled so :ref:`Node._unhandled_input()` will not process it. -Only one **Control** node can be in focus. Only the node in focus will receive events. To get the focus, call :ref:`grab_focus()`. **Control** nodes lose focus when another node grabs it, or if you hide the node in focus. +Only one **Control** node can be in focus. Only the node in focus will receive events. To get the focus, call :ref:`grab_focus()`. **Control** nodes lose focus when another node grabs it, or if you hide the node in focus. Focus will not be represented visually if gained via mouse/touch input, only appearing with keyboard/gamepad input (for accessibility), or via :ref:`grab_focus()`. -Sets :ref:`mouse_filter` to :ref:`MOUSE_FILTER_IGNORE` to tell a **Control** node to ignore mouse or touch events. You'll need it if you place an icon on top of a button. +Set :ref:`mouse_filter` to :ref:`MOUSE_FILTER_IGNORE` to tell a **Control** node to ignore mouse or touch events. You'll need it if you place an icon on top of a button. \ :ref:`Theme` resources change the control's appearance. The :ref:`theme` of a **Control** node affects all of its direct and indirect children (as long as a chain of controls is uninterrupted). To override some of the theme items, call one of the ``add_theme_*_override`` methods, like :ref:`add_theme_font_override()`. You can also override theme items in the Inspector. @@ -136,6 +136,8 @@ Propiedades +------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`pivot_offset` | ``Vector2(0, 0)`` | +------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Vector2` | :ref:`pivot_offset_ratio` | ``Vector2(0, 0)`` | + +------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`position` | ``Vector2(0, 0)`` | +------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ | :ref:`float` | :ref:`rotation` | ``0.0`` | @@ -230,6 +232,8 @@ Métodos +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`get_combined_minimum_size`\ (\ ) |const| | +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Vector2` | :ref:`get_combined_pivot_offset`\ (\ ) |const| | + +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`CursorShape` | :ref:`get_cursor_shape`\ (\ position\: :ref:`Vector2` = Vector2(0, 0)\ ) |const| | +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`get_end`\ (\ ) |const| | @@ -276,9 +280,9 @@ Métodos +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`grab_click_focus`\ (\ ) | +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`grab_focus`\ (\ ) | + | |void| | :ref:`grab_focus`\ (\ hide_focus\: :ref:`bool` = false\ ) | +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has_focus`\ (\ ) |const| | + | :ref:`bool` | :ref:`has_focus`\ (\ ignore_hidden_focus\: :ref:`bool` = false\ ) |const| | +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_theme_color`\ (\ name\: :ref:`StringName`, theme_type\: :ref:`StringName` = &""\ ) |const| | +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -595,7 +599,7 @@ Evita que el control reciba entradas del ratón. :ref:`get_mouse_filter_with_ove :ref:`MouseBehaviorRecursive` **MOUSE_BEHAVIOR_ENABLED** = ``2`` -Permite que el control reciba entradas del ratón, dependiendo del :ref:`mouse_filter`. Esto puede usarse para ignorar el :ref:`mouse_behavior_recursive` del padre. :ref:`get_mouse_filter_with_override()` devolverá el :ref:`mouse_filter`. +Allows the control to receive mouse input, depending on the :ref:`mouse_filter`. This can be used to ignore the parent's :ref:`mouse_behavior_recursive`. :ref:`get_mouse_filter_with_override()` will return the :ref:`mouse_filter`. .. rst-class:: classref-item-separator @@ -1274,7 +1278,9 @@ Enviado cuando el nodo agarra el foco. **NOTIFICATION_FOCUS_EXIT** = ``44`` :ref:`🔗` -Enviado cuando el nodo pierde el enfoque. +Sent when the node loses focus. + +This notification is sent in reversed order. .. _class_Control_constant_NOTIFICATION_THEME_CHANGED: @@ -1964,7 +1970,28 @@ Los márgenes a menudo están controlados por uno o varios nodos padre :ref:`Con - |void| **set_pivot_offset**\ (\ value\: :ref:`Vector2`\ ) - :ref:`Vector2` **get_pivot_offset**\ (\ ) -Por defecto, el pivote del nodo es su esquina superior izquierda. Cuando cambias su :ref:`rotation` o :ref:`scale`, rotará o escalará alrededor de este pivote. Establece esta propiedad a :ref:`size` / 2 para pivotar alrededor del centro del Control. +By default, the node's pivot is its top-left corner. When you change its :ref:`rotation` or :ref:`scale`, it will rotate or scale around this pivot. + +The actual offset is the combined value of this property and :ref:`pivot_offset_ratio`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_Control_property_pivot_offset_ratio: + +.. rst-class:: classref-property + +:ref:`Vector2` **pivot_offset_ratio** = ``Vector2(0, 0)`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_pivot_offset_ratio**\ (\ value\: :ref:`Vector2`\ ) +- :ref:`Vector2` **get_pivot_offset_ratio**\ (\ ) + +Same as :ref:`pivot_offset`, but expressed as uniform vector, where ``Vector2(0, 0)`` is the top-left corner of this control, and ``Vector2(1, 1)`` is its bottom-right corner. Set this property to ``Vector2(0.5, 0.5)`` to pivot around this control's center. + +The actual offset is the combined value of this property and :ref:`pivot_offset`. .. rst-class:: classref-item-separator @@ -2516,7 +2543,7 @@ The returned node will be added as child to a :ref:`PopupPanel -\ **Example:** Usa a scene instance as a tooltip: +\ **Example:** Use a scene instance as a tooltip: .. tabs:: @@ -2847,6 +2874,18 @@ Returns combined minimum size from :ref:`custom_minimum_size` **get_combined_pivot_offset**\ (\ ) |const| :ref:`🔗` + +Returns the combined value of :ref:`pivot_offset` and :ref:`pivot_offset_ratio`, in pixels. The ratio is multiplied by the control's size. + +.. rst-class:: classref-item-separator + +---- + .. _class_Control_method_get_cursor_shape: .. rst-class:: classref-method @@ -2997,13 +3036,17 @@ Devuelve la posición y el tamaño del control en el sistema de coordenadas del Returns the position of this **Control** in global screen coordinates (i.e. taking window position into account). Mostly useful for editor plugins. -Equals to :ref:`global_position` if the window is embedded (see :ref:`Viewport.gui_embed_subwindows`). +Equivalent to ``get_screen_transform().origin`` (see :ref:`CanvasItem.get_screen_transform()`). \ **Example:** Show a popup at the mouse position: :: - popup_menu.position = get_screen_position() + get_local_mouse_position() + popup_menu.position = get_screen_position() + get_screen_transform().basis_xform(get_local_mouse_position()) + + # The above code is equivalent to: + popup_menu.position = get_screen_transform() * get_local_mouse_position() + popup_menu.reset_size() popup_menu.popup() @@ -3209,10 +3252,12 @@ Creates an :ref:`InputEventMouseButton` that attemp .. rst-class:: classref-method -|void| **grab_focus**\ (\ ) :ref:`🔗` +|void| **grab_focus**\ (\ hide_focus\: :ref:`bool` = false\ ) :ref:`🔗` Steal the focus from another control and become the focused control (see :ref:`focus_mode`). +If ``hide_focus`` is ``true``, the control will not visually show its focused state. Has no effect for :ref:`LineEdit` and :ref:`TextEdit` when :ref:`ProjectSettings.gui/common/show_focus_state_on_pointer_event` is set to ``Control Supports Keyboard Input``, or for any control when it is set to ``Always``. + \ **Note:** Using this method together with :ref:`Callable.call_deferred()` makes it more reliable, especially when called inside :ref:`Node._ready()`. .. rst-class:: classref-item-separator @@ -3223,9 +3268,11 @@ Steal the focus from another control and become the focused control (see :ref:`f .. rst-class:: classref-method -:ref:`bool` **has_focus**\ (\ ) |const| :ref:`🔗` +:ref:`bool` **has_focus**\ (\ ignore_hidden_focus\: :ref:`bool` = false\ ) |const| :ref:`🔗` -Devuelve ``true`` si este es el control enfocado actual. Ver :ref:`focus_mode`. +Returns ``true`` if this is the current focused control. See :ref:`focus_mode`. + +If ``ignore_hidden_focus`` is ``true``, controls that have their focus hidden will always return ``false``. Hidden focus happens automatically when controls gain focus via mouse input, or manually using :ref:`grab_focus()` with ``hide_focus`` set to ``true``. .. rst-class:: classref-item-separator diff --git a/classes/es/class_converttransformmodifier3d.rst b/classes/es/class_converttransformmodifier3d.rst index 0530674075..f312a8bf28 100644 --- a/classes/es/class_converttransformmodifier3d.rst +++ b/classes/es/class_converttransformmodifier3d.rst @@ -14,25 +14,29 @@ Un :ref:`SkeletonModifier3D` que aplica transformació Descripción ---------------------- -Aplica la transformación copiada del hueso establecido por :ref:`BoneConstraint3D.set_reference_bone()` al hueso establecido por :ref:`BoneConstraint3D.set_apply_bone()` sobre el eje específico, remapeándolo con algunas opciones. +Apply the copied transform of the bone set by :ref:`BoneConstraint3D.set_reference_bone()` to the bone set by :ref:`BoneConstraint3D.set_apply_bone()` about the specific axis with remapping it with some options. -Hay 4 maneras de aplicar la transformación, dependiendo de la combinación de :ref:`set_relative()` y :ref:`set_additive()`. +There are 4 ways to apply the transform, depending on the combination of :ref:`set_relative()` and :ref:`set_additive()`. -\ **Relativo + Aditivo:**\ +\ **Relative + Additive:**\ -- Extrae la pose de referencia relativa al resto y la añade a la pose del hueso de aplicación. +- Extract reference pose relative to the rest and add it to the apply bone's pose. -\ **Relativo + No Aditivo:**\ +\ **Relative + Not Additive:**\ -- Extrae la pose de referencia relativa al resto y la añade al reposo del hueso de aplicación. +- Extract reference pose relative to the rest and add it to the apply bone's rest. -\ **No Relativo + Aditivo:**\ +\ **Not Relative + Additive:**\ -- Extrae la pose de referencia absolutamente y la añade a la pose del hueso de aplicación. +- Extract reference pose absolutely and add it to the apply bone's pose. -\ **No Relativo + No Aditivo:**\ +\ **Not Relative + Not Additive:**\ -- Extrae la pose de referencia absolutamente y la pose del hueso de aplicación se reemplaza con ella. +- Extract reference pose absolutely and the apply bone's pose is replaced with it. + +\ **Note:** Relative option is available only in the case :ref:`BoneConstraint3D.get_reference_type()` is :ref:`BoneConstraint3D.REFERENCE_TYPE_BONE`. See also :ref:`ReferenceType`. + +\ **Note:** If there is a rotation greater than ``180`` degrees with constrained axes, flipping may occur. .. rst-class:: classref-reftable-group diff --git a/classes/es/class_copytransformmodifier3d.rst b/classes/es/class_copytransformmodifier3d.rst index 3a69ded830..36dec4461c 100644 --- a/classes/es/class_copytransformmodifier3d.rst +++ b/classes/es/class_copytransformmodifier3d.rst @@ -14,25 +14,27 @@ Un :ref:`SkeletonModifier3D` que aplica transformació Descripción ---------------------- -Aplica la transformación copiada del hueso establecido por :ref:`BoneConstraint3D.set_reference_bone()` al hueso establecido por :ref:`BoneConstraint3D.set_apply_bone()` procesándola con algunas máscaras y opciones. +Apply the copied transform of the bone set by :ref:`BoneConstraint3D.set_reference_bone()` to the bone set by :ref:`BoneConstraint3D.set_apply_bone()` with processing it with some masks and options. -Hay 4 maneras de aplicar la transformación, dependiendo de la combinación de :ref:`set_relative()` y :ref:`set_additive()`. +There are 4 ways to apply the transform, depending on the combination of :ref:`set_relative()` and :ref:`set_additive()`. -\ **Relativo + Aditivo:**\ +\ **Relative + Additive:**\ -- Extrae la pose de referencia relativa al resto y la añade a la pose del hueso de aplicación. +- Extract reference pose relative to the rest and add it to the apply bone's pose. -\ **Relativo + No Aditivo:**\ +\ **Relative + Not Additive:**\ -- Extrae la pose de referencia relativa al resto y la añade al reposo del hueso de aplicación. +- Extract reference pose relative to the rest and add it to the apply bone's rest. -\ **No Relativo + Aditivo:**\ +\ **Not Relative + Additive:**\ -- Extrae la pose de referencia absolutamente y la añade a la pose del hueso de aplicación. +- Extract reference pose absolutely and add it to the apply bone's pose. -\ **No Relativo + No Aditivo:**\ +\ **Not Relative + Not Additive:**\ -- Extrae la pose de referencia absolutamente y la pose del hueso de aplicación se reemplaza con ella. +- Extract reference pose absolutely and the apply bone's pose is replaced with it. + +\ **Note:** Relative option is available only in the case :ref:`BoneConstraint3D.get_reference_type()` is :ref:`BoneConstraint3D.REFERENCE_TYPE_BONE`. See also :ref:`ReferenceType`. .. rst-class:: classref-reftable-group diff --git a/classes/es/class_cpuparticles2d.rst b/classes/es/class_cpuparticles2d.rst index 695d805e58..95293c87e9 100644 --- a/classes/es/class_cpuparticles2d.rst +++ b/classes/es/class_cpuparticles2d.rst @@ -33,143 +33,147 @@ Propiedades .. table:: :widths: auto - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`amount` | ``8`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`angle_curve` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`angle_max` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`angle_min` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`angular_velocity_curve` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`angular_velocity_max` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`angular_velocity_min` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`anim_offset_curve` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`anim_offset_max` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`anim_offset_min` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`anim_speed_curve` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`anim_speed_max` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`anim_speed_min` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Color` | :ref:`color` | ``Color(1, 1, 1, 1)`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Gradient` | :ref:`color_initial_ramp` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Gradient` | :ref:`color_ramp` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`damping_curve` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`damping_max` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`damping_min` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Vector2` | :ref:`direction` | ``Vector2(1, 0)`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`DrawOrder` | :ref:`draw_order` | ``0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`PackedColorArray` | :ref:`emission_colors` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`PackedVector2Array` | :ref:`emission_normals` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`PackedVector2Array` | :ref:`emission_points` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Vector2` | :ref:`emission_rect_extents` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`EmissionShape` | :ref:`emission_shape` | ``0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`emission_sphere_radius` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`emitting` | ``true`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`explosiveness` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`fixed_fps` | ``0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`fract_delta` | ``true`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Vector2` | :ref:`gravity` | ``Vector2(0, 980)`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`hue_variation_curve` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`hue_variation_max` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`hue_variation_min` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`initial_velocity_max` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`initial_velocity_min` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`lifetime` | ``1.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`lifetime_randomness` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`linear_accel_curve` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`linear_accel_max` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`linear_accel_min` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`local_coords` | ``false`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`one_shot` | ``false`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`orbit_velocity_curve` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`orbit_velocity_max` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`orbit_velocity_min` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`particle_flag_align_y` | ``false`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`PhysicsInterpolationMode` | physics_interpolation_mode | ``2`` (overrides :ref:`Node`) | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`preprocess` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`radial_accel_curve` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`radial_accel_max` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`radial_accel_min` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`randomness` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`scale_amount_curve` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`scale_amount_max` | ``1.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`scale_amount_min` | ``1.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`scale_curve_x` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`scale_curve_y` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`seed` | ``0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`speed_scale` | ``1.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`split_scale` | ``false`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`spread` | ``45.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`tangential_accel_curve` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`tangential_accel_max` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`tangential_accel_min` | ``0.0`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`Texture2D` | :ref:`texture` | | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`use_fixed_seed` | ``false`` | - +---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`amount` | ``8`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`angle_curve` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`angle_max` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`angle_min` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`angular_velocity_curve` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`angular_velocity_max` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`angular_velocity_min` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`anim_offset_curve` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`anim_offset_max` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`anim_offset_min` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`anim_speed_curve` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`anim_speed_max` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`anim_speed_min` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Color` | :ref:`color` | ``Color(1, 1, 1, 1)`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Gradient` | :ref:`color_initial_ramp` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Gradient` | :ref:`color_ramp` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`damping_curve` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`damping_max` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`damping_min` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Vector2` | :ref:`direction` | ``Vector2(1, 0)`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`DrawOrder` | :ref:`draw_order` | ``0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`PackedColorArray` | :ref:`emission_colors` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`PackedVector2Array` | :ref:`emission_normals` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`PackedVector2Array` | :ref:`emission_points` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Vector2` | :ref:`emission_rect_extents` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`emission_ring_inner_radius` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`emission_ring_radius` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`EmissionShape` | :ref:`emission_shape` | ``0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`emission_sphere_radius` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`emitting` | ``true`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`explosiveness` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`fixed_fps` | ``0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`fract_delta` | ``true`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Vector2` | :ref:`gravity` | ``Vector2(0, 980)`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`hue_variation_curve` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`hue_variation_max` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`hue_variation_min` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`initial_velocity_max` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`initial_velocity_min` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`lifetime` | ``1.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`lifetime_randomness` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`linear_accel_curve` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`linear_accel_max` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`linear_accel_min` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`local_coords` | ``false`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`one_shot` | ``false`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`orbit_velocity_curve` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`orbit_velocity_max` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`orbit_velocity_min` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`particle_flag_align_y` | ``false`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`PhysicsInterpolationMode` | physics_interpolation_mode | ``2`` (overrides :ref:`Node`) | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`preprocess` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`radial_accel_curve` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`radial_accel_max` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`radial_accel_min` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`randomness` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`scale_amount_curve` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`scale_amount_max` | ``1.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`scale_amount_min` | ``1.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`scale_curve_x` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`scale_curve_y` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`seed` | ``0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`speed_scale` | ``1.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`split_scale` | ``false`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`spread` | ``45.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`tangential_accel_curve` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`tangential_accel_max` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`tangential_accel_min` | ``0.0`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Texture2D` | :ref:`texture` | | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`use_fixed_seed` | ``false`` | + +---------------------------------------------------------------------+---------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -465,11 +469,19 @@ Las partículas se emitirán en una posición elegida al azar entre :ref:`emissi Las partículas se emitirán en una posición elegida al azar entre :ref:`emission_points`. La velocidad y rotación de las partículas se fijarán en base a :ref:`emission_normals`. El color de las partículas será modulado por :ref:`emission_colors`. +.. _class_CPUParticles2D_constant_EMISSION_SHAPE_RING: + +.. rst-class:: classref-enumeration-constant + +:ref:`EmissionShape` **EMISSION_SHAPE_RING** = ``6`` + +Particles will be emitted in the area of a ring parameterized by its outer and inner radius. + .. _class_CPUParticles2D_constant_EMISSION_SHAPE_MAX: .. rst-class:: classref-enumeration-constant -:ref:`EmissionShape` **EMISSION_SHAPE_MAX** = ``6`` +:ref:`EmissionShape` **EMISSION_SHAPE_MAX** = ``7`` Representa el tamaño del enum :ref:`EmissionShape`. @@ -915,6 +927,40 @@ La extensión del rectángulo si :ref:`emission_shape` **emission_ring_inner_radius** :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_emission_ring_inner_radius**\ (\ value\: :ref:`float`\ ) +- :ref:`float` **get_emission_ring_inner_radius**\ (\ ) + +The ring's inner radius if :ref:`emission_shape` is set to :ref:`EMISSION_SHAPE_RING`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_CPUParticles2D_property_emission_ring_radius: + +.. rst-class:: classref-property + +:ref:`float` **emission_ring_radius** :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_emission_ring_radius**\ (\ value\: :ref:`float`\ ) +- :ref:`float` **get_emission_ring_radius**\ (\ ) + +The ring's outer radius if :ref:`emission_shape` is set to :ref:`EMISSION_SHAPE_RING`. + +.. rst-class:: classref-item-separator + +---- + .. _class_CPUParticles2D_property_emission_shape: .. rst-class:: classref-property diff --git a/classes/es/class_dictionary.rst b/classes/es/class_dictionary.rst index aae9e5306d..d641862005 100644 --- a/classes/es/class_dictionary.rst +++ b/classes/es/class_dictionary.rst @@ -440,9 +440,9 @@ Si ``deep`` es ``true``, se devuelve una copia **profunda**: todos los arrays y :ref:`Dictionary` **duplicate_deep**\ (\ deep_subresources_mode\: :ref:`int` = 1\ ) |const| :ref:`🔗` -Duplica este diccionario, profundamente, como :ref:`duplicate()`\ ``(true)``, con control adicional sobre cómo se manejan los subrecursos. +Duplicates this dictionary, deeply, like :ref:`duplicate()` when passing ``true``, with extra control over how subresources are handled. -\ ``deep_subresources_mode`` debe ser uno de los valores de :ref:`DeepDuplicateMode`. De forma predeterminada, solo los recursos internos se duplicarán (recursivamente). +\ ``deep_subresources_mode`` must be one of the values from :ref:`DeepDuplicateMode`. By default, only internal resources will be duplicated (recursively). .. rst-class:: classref-item-separator @@ -889,7 +889,7 @@ Returns ``true`` if the two dictionaries contain the same keys and values, inner :ref:`bool` **set**\ (\ key\: :ref:`Variant`, value\: :ref:`Variant`\ ) :ref:`🔗` -Establece el valor del elemento en la ``key`` dada al ``value`` dado. Esto es lo mismo que usar el operador ``[]`` (``array[index] = value``). +Sets the value of the element at the given ``key`` to the given ``value``. Returns ``true`` if the value is set successfully. Fails and returns ``false`` if the dictionary is read-only, or if ``key`` and ``value`` don't match the dictionary's types. This is the same as using the ``[]`` operator (``dict[key] = value``). .. rst-class:: classref-item-separator diff --git a/classes/es/class_displayserver.rst b/classes/es/class_displayserver.rst index e1b4556550..1a924a1778 100644 --- a/classes/es/class_displayserver.rst +++ b/classes/es/class_displayserver.rst @@ -31,7 +31,7 @@ Métodos +-------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`accessibility_create_sub_element`\ (\ parent_rid\: :ref:`RID`, role\: :ref:`AccessibilityRole`, insert_pos\: :ref:`int` = -1\ ) | +-------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`RID` | :ref:`accessibility_create_sub_text_edit_elements`\ (\ parent_rid\: :ref:`RID`, shaped_text\: :ref:`RID`, min_height\: :ref:`float`, insert_pos\: :ref:`int` = -1\ ) | + | :ref:`RID` | :ref:`accessibility_create_sub_text_edit_elements`\ (\ parent_rid\: :ref:`RID`, shaped_text\: :ref:`RID`, min_height\: :ref:`float`, insert_pos\: :ref:`int` = -1, is_last_line\: :ref:`bool` = false\ ) | +-------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Variant` | :ref:`accessibility_element_get_meta`\ (\ id\: :ref:`RID`\ ) |const| | +-------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -517,6 +517,8 @@ Métodos +-------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`window_request_attention`\ (\ window_id\: :ref:`int` = 0\ ) | +-------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`window_set_color`\ (\ color\: :ref:`Color`\ ) | + +-------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`window_set_current_screen`\ (\ screen\: :ref:`int`, window_id\: :ref:`int` = 0\ ) | +-------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`window_set_drop_files_callback`\ (\ callback\: :ref:`Callable`, window_id\: :ref:`int` = 0\ ) | @@ -691,7 +693,9 @@ Display server supports querying the operating system's display scale factor. Th :ref:`Feature` **FEATURE_ICON** = ``13`` -Display server supports changing the window icon (usually displayed in the top-left corner). **Windows, macOS, Linux (X11)** +Display server supports changing the window icon (usually displayed in the top-left corner). **Windows, macOS, Linux (X11/Wayland)**\ + +\ **Note:** Use on Wayland requires the compositor to implement the `xdg_toplevel_icon_v1 `__ protocol, which not all compositors do. See `xdg_toplevel_icon_v1#compositor-support `__ for more information on individual compositor support. .. _class_DisplayServer_constant_FEATURE_NATIVE_ICON: @@ -1297,7 +1301,7 @@ El elemento está oculto para las herramientas de accesibilidad. :ref:`AccessibilityFlags` **FLAG_MULTISELECTABLE** = ``1`` -El elemento admite la selección de múltiples elementos. +Element supports multiple item selection. .. _class_DisplayServer_constant_FLAG_REQUIRED: @@ -2305,7 +2309,7 @@ El botón para maximizar la ventana se deshabilita. :ref:`WindowFlags` **WINDOW_FLAG_MAX** = ``13`` -Valor máximo de :ref:`WindowFlags`. +Represents the size of the :ref:`WindowFlags` enum. .. rst-class:: classref-item-separator @@ -2393,9 +2397,9 @@ Enviado cuando la decoración de la barra de título de la ventana es cambiada ( :ref:`WindowEvent` **WINDOW_EVENT_FORCE_CLOSE** = ``8`` -Se envía cuando el servidor de visualización fuerza el cierre de la ventana. La ventana ocultará y limpiará inmediatamente cualquier referencia de renderizado interna. +Sent when the window has been forcibly closed by the display server. The window will immediately hide and clean any internal rendering references. -\ **Nota:** Esta opción solo se implementa en Linux (Wayland). +\ **Note:** This flag is implemented only on Linux (Wayland). .. rst-class:: classref-item-separator @@ -2785,10 +2789,12 @@ Creates a new, empty accessibility sub-element resource. Sub-elements can be use .. rst-class:: classref-method -:ref:`RID` **accessibility_create_sub_text_edit_elements**\ (\ parent_rid\: :ref:`RID`, shaped_text\: :ref:`RID`, min_height\: :ref:`float`, insert_pos\: :ref:`int` = -1\ ) :ref:`🔗` +:ref:`RID` **accessibility_create_sub_text_edit_elements**\ (\ parent_rid\: :ref:`RID`, shaped_text\: :ref:`RID`, min_height\: :ref:`float`, insert_pos\: :ref:`int` = -1, is_last_line\: :ref:`bool` = false\ ) :ref:`🔗` Creates a new, empty accessibility sub-element from the shaped text buffer. Sub-elements are freed automatically when the parent element is freed, or can be freed early using the :ref:`accessibility_free_element()` method. +If ``is_last_line`` is ``true``, no trailing newline is appended to the text content. Set to ``true`` for the last line in multi-line text fields and for single-line text fields. + .. rst-class:: classref-item-separator ---- @@ -2799,7 +2805,7 @@ Creates a new, empty accessibility sub-element from the shaped text buffer. Sub- :ref:`Variant` **accessibility_element_get_meta**\ (\ id\: :ref:`RID`\ ) |const| :ref:`🔗` -Devuelve los metadatos del elemento de accesibilidad. +Returns the metadata of the accessibility element ``id``. .. rst-class:: classref-item-separator @@ -2811,7 +2817,7 @@ Devuelve los metadatos del elemento de accesibilidad. |void| **accessibility_element_set_meta**\ (\ id\: :ref:`RID`, meta\: :ref:`Variant`\ ) :ref:`🔗` -Establece los metadatos del elemento de accesibilidad. +Sets the metadata of the accessibility element ``id`` to ``meta``. .. rst-class:: classref-item-separator @@ -2823,7 +2829,7 @@ Establece los metadatos del elemento de accesibilidad. |void| **accessibility_free_element**\ (\ id\: :ref:`RID`\ ) :ref:`🔗` -Frees an object created by :ref:`accessibility_create_element()`, :ref:`accessibility_create_sub_element()`, or :ref:`accessibility_create_sub_text_edit_elements()`. +Frees the accessibility element ``id`` created by :ref:`accessibility_create_element()`, :ref:`accessibility_create_sub_element()`, or :ref:`accessibility_create_sub_text_edit_elements()`. .. rst-class:: classref-item-separator @@ -2863,7 +2869,7 @@ Returns ``1`` if a screen reader, Braille display or other assistive app is acti \ **Note:** This method is implemented on Linux, macOS, and Windows. -\ **Note:** Accessibility debugging tools, such as Accessibility Insights for Windows, macOS Accessibility Inspector, or AT-SPI Browser do not count as assistive apps and will not affect this value. To test your app with these tools, set :ref:`ProjectSettings.accessibility/general/accessibility_support` to ``1``. +\ **Note:** Accessibility debugging tools, such as Accessibility Insights for Windows, Accessibility Inspector (macOS), or AT-SPI Browser (Linux/BSD), do not count as assistive apps and will not affect this value. To test your project with these tools, set :ref:`ProjectSettings.accessibility/general/accessibility_support` to ``1``. .. rst-class:: classref-item-separator @@ -3935,7 +3941,7 @@ Callbacks have the following arguments: ``status: bool, selected_paths: PackedSt \ **Note:** ``current_directory`` might be ignored. -\ **Note:** Embedded file dialog and Windows file dialog support only file extensions, while Android, Linux, and macOS file dialogs also support MIME types. +\ **Note:** Embedded file dialogs and Windows file dialogs support only file extensions, while Android, Linux, and macOS file dialogs also support MIME types. \ **Note:** On Android and Linux, ``show_hidden`` is ignored. @@ -3943,6 +3949,28 @@ Callbacks have the following arguments: ``status: bool, selected_paths: PackedSt \ **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:** On Android, this method uses the Android Storage Access Framework (SAF). + +The file picker returns a URI instead of a filesystem path. This URI can be passed directly to :ref:`FileAccess` to perform read/write operations. + +When using :ref:`FILE_DIALOG_MODE_OPEN_DIR`, it returns a tree URI that grants full access to the selected directory. File operations inside this directory can be performed by passing a path on the form ``treeUri#relative/path/to/file`` to :ref:`FileAccess`. + +To avoid opening the file picker again after each app restart, you can take persistable URI permission as follows: + + +.. tabs:: + + .. code-tab:: gdscript + + val uri = "content://com.android..." # URI of the selected file or folder. + val persist = true # Set to false to release the persistable permission. + var android_runtime = Engine.get_singleton("AndroidRuntime") + android_runtime.updatePersistableUriPermission(uri, persist) + + + +The persistable URI permission remains valid across app restarts as long as the directory is not moved, renamed, or deleted. + .. rst-class:: classref-item-separator ---- @@ -3971,7 +3999,7 @@ Callbacks have the following arguments: ``status: bool, selected_paths: PackedSt \ **Note:** ``current_directory`` might be ignored. -\ **Note:** Embedded file dialog and Windows file dialog support only file extensions, while Android, Linux, and macOS file dialogs also support MIME types. +\ **Note:** Embedded file dialogs and Windows file dialogs support only file extensions, while Android, Linux, and macOS file dialogs also support MIME types. \ **Note:** On Linux (X11), ``show_hidden`` is ignored. @@ -4087,9 +4115,9 @@ The names of built-in display servers are ``Windows``, ``macOS``, ``X11`` (Linux :ref:`int` **get_primary_screen**\ (\ ) |const| :ref:`🔗` -Devuelve el índice de la pantalla principal. +Returns the index of the primary screen. -\ **Nota:** Este método está implementado en Linux/X11, macOS y Windows. En otras plataformas, este método siempre devuelve ``0``. +\ **Note:** This method is implemented on Linux/X11, macOS, and Windows. On other platforms, this method always returns ``0``. .. rst-class:: classref-item-separator @@ -5533,11 +5561,11 @@ Returns the ``screen``'s current orientation. See also :ref:`screen_set_orientat :ref:`Color` **screen_get_pixel**\ (\ position\: :ref:`Vector2i`\ ) |const| :ref:`🔗` -Returns color of the display pixel at the ``position``. +Returns the color of the pixel at the given screen ``position``. On multi-monitor setups, the screen position is relative to the virtual desktop area. -\ **Note:** This method is implemented on Linux (X11, excluding XWayland), macOS, and Windows. On other platforms, this method always returns :ref:`Color`. +\ **Note:** This method is implemented on Linux (X11, excluding XWayland), macOS, and Windows. On other platforms, this method always returns ``Color(0, 0, 0, 1)``. -\ **Note:** On macOS, this method requires the "Screen Recording" permission. If permission is not granted, this method returns a screenshot that will only contain the desktop wallpaper, the current application's window, and other related UI elements. +\ **Note:** On macOS, this method requires the "Screen Recording" permission. If permission is not granted, this method returns a color from a screenshot that will not include other application windows or OS elements not related to the application. .. rst-class:: classref-item-separator @@ -5574,7 +5602,7 @@ See also :ref:`screen_get_size()`. :ref:`float` **screen_get_refresh_rate**\ (\ screen\: :ref:`int` = -1\ ) |const| :ref:`🔗` -Returns the current refresh rate of the specified screen. Returns ``-1.0`` if ``screen`` is invalid or the **DisplayServer** fails to find the refresh rate for the specified screen. +Returns the current refresh rate of the specified screen. When V-Sync is enabled, this returns the maximum framerate the project can effectively reach. Returns ``-1.0`` if ``screen`` is invalid or the **DisplayServer** fails to find the refresh rate for the specified screen. To fallback to a default refresh rate if the method fails, try: @@ -5690,7 +5718,7 @@ Sets the ``screen``'s ``orientation``. See also :ref:`screen_get_orientation()`\ ) :ref:`🔗` -Sets the ``callable`` that should be called when hardware keyboard is connected/disconnected. ``callable`` should accept a single :ref:`bool` parameter indicating whether the keyboard is connected (true) or disconnected (false). +Sets the callback that should be called when a hardware keyboard is connected or disconnected. ``callable`` should accept a single :ref:`bool` argument indicating whether the keyboard has been connected (``true``) or disconnected (``false``). \ **Note:** This method is only implemented on Android. @@ -5732,7 +5760,7 @@ Sets the window icon (usually displayed in the top-left corner) in the operating |void| **set_system_theme_change_callback**\ (\ callable\: :ref:`Callable`\ ) :ref:`🔗` -Sets the ``callable`` that should be called when system theme settings are changed. Callback method should have zero arguments. +Sets the callback that should be called when the system's theme settings are changed. ``callable`` should accept zero arguments. \ **Note:** This method is implemented on Android, iOS, macOS, Windows, and Linux (X11/Wayland). @@ -6066,9 +6094,9 @@ Unregisters an :ref:`Object` representing an additional output, th :ref:`int` **virtual_keyboard_get_height**\ (\ ) |const| :ref:`🔗` -Returns the on-screen keyboard's height in pixels. Returns 0 if there is no keyboard or if it is currently hidden. +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. +\ **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 @@ -6366,9 +6394,9 @@ Devuelve ``true`` si la ventana dada puede ser maximizada (el botón de maximiza :ref:`bool` **window_maximize_on_title_dbl_click**\ (\ ) |const| :ref:`🔗` -Devuelve ``true`` si el doble clic en el título de una ventana debería maximizarla. +Returns ``true`` if double-clicking on a window's title should maximize it. -\ **Nota:** Este método solo está implementado en macOS. +\ **Note:** This method is implemented only on macOS. .. rst-class:: classref-item-separator @@ -6380,9 +6408,9 @@ Devuelve ``true`` si el doble clic en el título de una ventana debería maximiz :ref:`bool` **window_minimize_on_title_dbl_click**\ (\ ) |const| :ref:`🔗` -Devuelve ``true`` si el doble clic en el título de una ventana debería minimizarla. +Returns ``true`` if double-clicking on a window's title should minimize it. -\ **Nota:** Este método solo está implementado en macOS. +\ **Note:** This method is implemented only on macOS. .. rst-class:: classref-item-separator @@ -6412,6 +6440,20 @@ Hace que la ventana especificada por ``window_id`` solicite atención, lo que se ---- +.. _class_DisplayServer_method_window_set_color: + +.. rst-class:: classref-method + +|void| **window_set_color**\ (\ color\: :ref:`Color`\ ) :ref:`🔗` + +Sets the background color of the root window. + +\ **Note:** This method is implemented only on Android. + +.. rst-class:: classref-item-separator + +---- + .. _class_DisplayServer_method_window_set_current_screen: .. rst-class:: classref-method diff --git a/classes/es/class_dpitexture.rst b/classes/es/class_dpitexture.rst index 3ed28e60c1..39db1b477a 100644 --- a/classes/es/class_dpitexture.rst +++ b/classes/es/class_dpitexture.rst @@ -127,7 +127,7 @@ Descripciones de Métodos :ref:`DPITexture` **create_from_string**\ (\ source\: :ref:`String`, scale\: :ref:`float` = 1.0, saturation\: :ref:`float` = 1.0, color_map\: :ref:`Dictionary` = {}\ ) |static| :ref:`🔗` -Creates a new **DPITexture** and initializes it by allocating and setting the SVG data from string. +Creates a new **DPITexture** and initializes it by allocating and setting the SVG data to ``source``. .. rst-class:: classref-item-separator @@ -151,7 +151,7 @@ Returns the :ref:`RID` of the texture rasterized to match the oversam :ref:`String` **get_source**\ (\ ) |const| :ref:`🔗` -Devuelve el código fuente SVG. +Returns this SVG texture's source code. .. rst-class:: classref-item-separator @@ -175,7 +175,7 @@ Redimensiona la :ref:`ImageTexture` a las dimensiones especi |void| **set_source**\ (\ source\: :ref:`String`\ ) :ref:`🔗` -Establece el código fuente SVG. +Sets this SVG texture's source code. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_editordock.rst b/classes/es/class_editordock.rst new file mode 100644 index 0000000000..ba11ffc026 --- /dev/null +++ b/classes/es/class_editordock.rst @@ -0,0 +1,479 @@ +:github_url: hide + +.. _class_EditorDock: + +EditorDock +========== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`MarginContainer` **<** :ref:`Container` **<** :ref:`Control` **<** :ref:`CanvasItem` **<** :ref:`Node` **<** :ref:`Object` + +**Heredado por:** :ref:`FileSystemDock` + +Dockable container for the editor. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +EditorDock is a :ref:`Container` node that can be docked in one of the editor's dock slots. Docks are added by plugins to provide space for controls related to an :ref:`EditorPlugin`. The editor comes with a few built-in docks, such as the Scene dock, FileSystem dock, etc. + +You can add a dock by using :ref:`EditorPlugin.add_dock()`. The dock can be customized by changing its properties. + +:: + + @tool + extends EditorPlugin + + # Dock reference. + var dock + + # Plugin initialization. + func _enter_tree(): + dock = EditorDock.new() + dock.title = "My Dock" + dock.dock_icon = preload("./dock_icon.png") + dock.default_slot = EditorPlugin.DOCK_SLOT_RIGHT_UL + var dock_content = preload("./dock_content.tscn").instantiate() + dock.add_child(dock_content) + add_dock(dock) + + # Plugin clean-up. + func _exit_tree(): + remove_dock(dock) + dock.queue_free() + dock = null + +.. rst-class:: classref-introduction-group + +Tutoriales +-------------------- + +- :doc:`Making plugins <../tutorials/plugins/editor/making_plugins>` + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +-------------------------------------------------------------+-----------------------------------------------------------------------+-----------------------+ + | |bitfield|\[:ref:`DockLayout`\] | :ref:`available_layouts` | ``5`` | + +-------------------------------------------------------------+-----------------------------------------------------------------------+-----------------------+ + | :ref:`bool` | :ref:`closable` | ``false`` | + +-------------------------------------------------------------+-----------------------------------------------------------------------+-----------------------+ + | :ref:`DockSlot` | :ref:`default_slot` | ``-1`` | + +-------------------------------------------------------------+-----------------------------------------------------------------------+-----------------------+ + | :ref:`Texture2D` | :ref:`dock_icon` | | + +-------------------------------------------------------------+-----------------------------------------------------------------------+-----------------------+ + | :ref:`Shortcut` | :ref:`dock_shortcut` | | + +-------------------------------------------------------------+-----------------------------------------------------------------------+-----------------------+ + | :ref:`bool` | :ref:`force_show_icon` | ``false`` | + +-------------------------------------------------------------+-----------------------------------------------------------------------+-----------------------+ + | :ref:`bool` | :ref:`global` | ``true`` | + +-------------------------------------------------------------+-----------------------------------------------------------------------+-----------------------+ + | :ref:`StringName` | :ref:`icon_name` | ``&""`` | + +-------------------------------------------------------------+-----------------------------------------------------------------------+-----------------------+ + | :ref:`String` | :ref:`layout_key` | ``""`` | + +-------------------------------------------------------------+-----------------------------------------------------------------------+-----------------------+ + | :ref:`String` | :ref:`title` | ``""`` | + +-------------------------------------------------------------+-----------------------------------------------------------------------+-----------------------+ + | :ref:`Color` | :ref:`title_color` | ``Color(0, 0, 0, 0)`` | + +-------------------------------------------------------------+-----------------------------------------------------------------------+-----------------------+ + | :ref:`bool` | :ref:`transient` | ``false`` | + +-------------------------------------------------------------+-----------------------------------------------------------------------+-----------------------+ + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`_load_layout_from_config`\ (\ config\: :ref:`ConfigFile`, section\: :ref:`String`\ ) |virtual| | + +--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`_save_layout_to_config`\ (\ config\: :ref:`ConfigFile`, section\: :ref:`String`\ ) |virtual| |const| | + +--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`_update_layout`\ (\ layout\: :ref:`int`\ ) |virtual| | + +--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`close`\ (\ ) | + +--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`make_visible`\ (\ ) | + +--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`open`\ (\ ) | + +--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Señales +-------------- + +.. _class_EditorDock_signal_closed: + +.. rst-class:: classref-signal + +**closed**\ (\ ) :ref:`🔗` + +Emitted when the dock is closed with the Close button in the context popup, before it's removed from its parent. See :ref:`closable`. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Enumeraciones +-------------------------- + +.. _enum_EditorDock_DockLayout: + +.. rst-class:: classref-enumeration + +flags **DockLayout**: :ref:`🔗` + +.. _class_EditorDock_constant_DOCK_LAYOUT_VERTICAL: + +.. rst-class:: classref-enumeration-constant + +:ref:`DockLayout` **DOCK_LAYOUT_VERTICAL** = ``1`` + +Allows placing the dock in the vertical dock slots on either side of the editor. + +.. _class_EditorDock_constant_DOCK_LAYOUT_HORIZONTAL: + +.. rst-class:: classref-enumeration-constant + +:ref:`DockLayout` **DOCK_LAYOUT_HORIZONTAL** = ``2`` + +Allows placing the dock in the editor's bottom panel. + +.. _class_EditorDock_constant_DOCK_LAYOUT_FLOATING: + +.. rst-class:: classref-enumeration-constant + +:ref:`DockLayout` **DOCK_LAYOUT_FLOATING** = ``4`` + +Allows making the dock floating (opened as a separate window). + +.. _class_EditorDock_constant_DOCK_LAYOUT_ALL: + +.. rst-class:: classref-enumeration-constant + +:ref:`DockLayout` **DOCK_LAYOUT_ALL** = ``7`` + +Allows placing the dock in all available slots. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_EditorDock_property_available_layouts: + +.. rst-class:: classref-property + +|bitfield|\[:ref:`DockLayout`\] **available_layouts** = ``5`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_available_layouts**\ (\ value\: |bitfield|\[:ref:`DockLayout`\]\ ) +- |bitfield|\[:ref:`DockLayout`\] **get_available_layouts**\ (\ ) + +The available layouts for this dock, as a bitmask. By default, the dock allows vertical and floating layouts. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_property_closable: + +.. rst-class:: classref-property + +:ref:`bool` **closable** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_closable**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_closable**\ (\ ) + +If ``true``, the dock can be closed with the Close button in the context popup. Docks with :ref:`global` enabled are always closable. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_property_default_slot: + +.. rst-class:: classref-property + +:ref:`DockSlot` **default_slot** = ``-1`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_default_slot**\ (\ value\: :ref:`DockSlot`\ ) +- :ref:`DockSlot` **get_default_slot**\ (\ ) + +The default dock slot used when adding the dock with :ref:`EditorPlugin.add_dock()`. + +After the dock is added, it can be moved to a different slot and the editor will automatically remember its position between sessions. If you remove and re-add the dock, it will be reset to default. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_property_dock_icon: + +.. rst-class:: classref-property + +:ref:`Texture2D` **dock_icon** :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_dock_icon**\ (\ value\: :ref:`Texture2D`\ ) +- :ref:`Texture2D` **get_dock_icon**\ (\ ) + +The icon for the dock, as a texture. If specified, it will override :ref:`icon_name`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_property_dock_shortcut: + +.. rst-class:: classref-property + +:ref:`Shortcut` **dock_shortcut** :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_dock_shortcut**\ (\ value\: :ref:`Shortcut`\ ) +- :ref:`Shortcut` **get_dock_shortcut**\ (\ ) + +The shortcut used to open the dock. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_property_force_show_icon: + +.. rst-class:: classref-property + +:ref:`bool` **force_show_icon** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_force_show_icon**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **get_force_show_icon**\ (\ ) + +If ``true``, the dock will always display an icon, regardless of :ref:`EditorSettings.interface/editor/dock_tab_style` or :ref:`EditorSettings.interface/editor/bottom_dock_tab_style`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_property_global: + +.. rst-class:: classref-property + +:ref:`bool` **global** = ``true`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_global**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_global**\ (\ ) + +If ``true``, the dock appears in the **Editor > Editor Docks** menu and can be closed. Non-global docks can still be closed using :ref:`close()` or when :ref:`closable` is ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_property_icon_name: + +.. rst-class:: classref-property + +:ref:`StringName` **icon_name** = ``&""`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_icon_name**\ (\ value\: :ref:`StringName`\ ) +- :ref:`StringName` **get_icon_name**\ (\ ) + +The icon for the dock, as a name from the ``EditorIcons`` theme type in the editor theme. You can find the list of available icons `here `__. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_property_layout_key: + +.. rst-class:: classref-property + +:ref:`String` **layout_key** = ``""`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_layout_key**\ (\ value\: :ref:`String`\ ) +- :ref:`String` **get_layout_key**\ (\ ) + +The key representing this dock in the editor's layout file. If empty, the dock's displayed name will be used instead. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_property_title: + +.. rst-class:: classref-property + +:ref:`String` **title** = ``""`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_title**\ (\ value\: :ref:`String`\ ) +- :ref:`String` **get_title**\ (\ ) + +The title of the dock's tab. If empty, the dock's :ref:`Node.name` will be used. If the name is auto-generated (contains ``@``), the first child's name will be used instead. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_property_title_color: + +.. rst-class:: classref-property + +:ref:`Color` **title_color** = ``Color(0, 0, 0, 0)`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_title_color**\ (\ value\: :ref:`Color`\ ) +- :ref:`Color` **get_title_color**\ (\ ) + +The color of the dock tab's title. If its alpha is ``0.0``, the default font color will be used. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_property_transient: + +.. rst-class:: classref-property + +:ref:`bool` **transient** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_transient**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_transient**\ (\ ) + +If ``true``, the dock is not automatically opened or closed when loading an editor layout, only moved. It also can't be opened using a shortcut. This is meant for docks that are opened and closed in specific cases, such as when selecting a :ref:`TileMap` or :ref:`AnimationTree` node. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_EditorDock_private_method__load_layout_from_config: + +.. rst-class:: classref-method + +|void| **_load_layout_from_config**\ (\ config\: :ref:`ConfigFile`, section\: :ref:`String`\ ) |virtual| :ref:`🔗` + +Implement this method to handle loading this dock's layout. It's equivalent to :ref:`EditorPlugin._set_window_layout()`. ``section`` is a unique section based on :ref:`layout_key`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_private_method__save_layout_to_config: + +.. rst-class:: classref-method + +|void| **_save_layout_to_config**\ (\ config\: :ref:`ConfigFile`, section\: :ref:`String`\ ) |virtual| |const| :ref:`🔗` + +Implement this method to handle saving this dock's layout. It's equivalent to :ref:`EditorPlugin._get_window_layout()`. ``section`` is a unique section based on :ref:`layout_key`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_private_method__update_layout: + +.. rst-class:: classref-method + +|void| **_update_layout**\ (\ layout\: :ref:`int`\ ) |virtual| :ref:`🔗` + +Implement this method to handle the layout switching for this dock. ``layout`` is one of the :ref:`DockLayout` constants. + +:: + + func _update_layout(layout): + box_container.vertical = (layout == DOCK_LAYOUT_VERTICAL) + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_method_close: + +.. rst-class:: classref-method + +|void| **close**\ (\ ) :ref:`🔗` + +Closes the dock, making its tab hidden. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_method_make_visible: + +.. rst-class:: classref-method + +|void| **make_visible**\ (\ ) :ref:`🔗` + +Focuses the dock's tab (or window if it's floating). If the dock was closed, it will be opened. If it's a bottom dock, makes the bottom panel visible. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorDock_method_open: + +.. rst-class:: classref-method + +|void| **open**\ (\ ) :ref:`🔗` + +Opens the dock. It will appear in the last used dock slot. If the dock has no default slot, it will be opened floating. + +\ **Note:** This does not focus the dock. If you want to open and focus the dock, use :ref:`make_visible()`. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_editorexportplatform.rst b/classes/es/class_editorexportplatform.rst index 374874e634..43cd5ee30c 100644 --- a/classes/es/class_editorexportplatform.rst +++ b/classes/es/class_editorexportplatform.rst @@ -381,7 +381,7 @@ Returns additional files that should always be exported regardless of preset con :ref:`String` **get_message_category**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve la categoría del mensaje, para el mensaje con ``index``. +Returns the message category for the message with the given ``index``. .. rst-class:: classref-item-separator @@ -393,7 +393,7 @@ Devuelve la categoría del mensaje, para el mensaje con ``index``. :ref:`int` **get_message_count**\ (\ ) |const| :ref:`🔗` -Devuelve el número de mensajes en el registro de exportación. +Returns the number of messages in the export log. .. rst-class:: classref-item-separator @@ -405,7 +405,7 @@ Devuelve el número de mensajes en el registro de exportación. :ref:`String` **get_message_text**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve el texto del mensaje, para el mensaje con ``index``. +Returns the text for the message with the given ``index``. .. rst-class:: classref-item-separator @@ -417,7 +417,7 @@ Devuelve el texto del mensaje, para el mensaje con ``index``. :ref:`ExportMessageType` **get_message_type**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve el tipo de mensaje, para el mensaje con ``index``. +Returns the type for the message with the given ``index``. .. rst-class:: classref-item-separator diff --git a/classes/es/class_editorexportplatformandroid.rst b/classes/es/class_editorexportplatformandroid.rst index b2ee0d38b7..b8a448a3b1 100644 --- a/classes/es/class_editorexportplatformandroid.rst +++ b/classes/es/class_editorexportplatformandroid.rst @@ -257,6 +257,8 @@ Propiedades +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`permissions/manage_external_storage` | +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`permissions/manage_media` | + +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`permissions/master_clear` | +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`permissions/media_content_control` | @@ -453,7 +455,7 @@ Descripciones de Propiedades :ref:`String` **apk_expansion/SALT** :ref:`🔗` -Array of random bytes that the licensing Policy uses to create an `Obfuscator `__. +Array of random bytes that the licensing policy uses to create an `Obfuscator `__. .. rst-class:: classref-item-separator @@ -1863,6 +1865,18 @@ Permite a una aplicación un amplio acceso al almacenamiento externo en el almac ---- +.. _class_EditorExportPlatformAndroid_property_permissions/manage_media: + +.. rst-class:: classref-property + +:ref:`bool` **permissions/manage_media** :ref:`🔗` + +Allows an application to modify and delete media files on this device or any connected storage device without user confirmation. Applications must already be granted the ``READ_EXTERNAL_STORAGE`` or ``MANAGE_EXTERNAL_STORAGE`` permissions for this permission to take effect. See `MANAGE_MEDIA `__. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorExportPlatformAndroid_property_permissions/master_clear: .. rst-class:: classref-property @@ -2811,7 +2825,7 @@ Permite que una aplicación escriba en el diccionario del usuario. :ref:`Color` **screen/background_color** :ref:`🔗` -El color de fondo utilizado para la ventana raíz. El valor predeterminado es ``black``. +The background color used for the root window. By default it's :ref:`Color.BLACK`. .. rst-class:: classref-item-separator @@ -2897,7 +2911,9 @@ Indica si la aplicación admite factores de formato de pantalla extra grandes. :ref:`bool` **shader_baker/enabled** :ref:`🔗` -Si es ``true``, los shaders se compilarán e integrarán en la aplicación. Esta opción solo es compatible cuando se utilizan los renderizadores Forward+ o Mobile. +If ``true``, shaders will be compiled and embedded in the application. This option is only supported when using the Forward+ or Mobile renderers. + +\ **Note:** When exporting as a dedicated server, the shader baker is always disabled since no rendering is performed. .. rst-class:: classref-item-separator diff --git a/classes/es/class_editorexportplatformextension.rst b/classes/es/class_editorexportplatformextension.rst index a0e83d627f..e3dc814e83 100644 --- a/classes/es/class_editorexportplatformextension.rst +++ b/classes/es/class_editorexportplatformextension.rst @@ -79,6 +79,8 @@ Métodos +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`_has_valid_project_configuration`\ (\ preset\: :ref:`EditorExportPreset`\ ) |virtual| |required| |const| | +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`_initialize`\ (\ ) |virtual| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`_is_executable`\ (\ path\: :ref:`String`\ ) |virtual| |const| | +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`_poll_export`\ (\ ) |virtual| | @@ -111,9 +113,9 @@ Descripciones de Métodos :ref:`bool` **_can_export**\ (\ preset\: :ref:`EditorExportPreset`, debug\: :ref:`bool`\ ) |virtual| |const| :ref:`🔗` -Devuelve ``true``, si el ``preset`` especificado es válido y se puede exportar. Usa :ref:`set_config_error()` y :ref:`set_config_missing_templates()` para establecer los detalles del error. +Returns ``true`` if the specified ``preset`` is valid and can be exported. Use :ref:`set_config_error()` and :ref:`set_config_missing_templates()` to set error details. -La implementación habitual puede llamar a :ref:`_has_valid_export_configuration()` y :ref:`_has_valid_project_configuration()` para determinar si la exportación es posible. +Usual implementations call :ref:`_has_valid_export_configuration()` and :ref:`_has_valid_project_configuration()` to determine if exporting is possible. .. rst-class:: classref-item-separator @@ -453,6 +455,18 @@ Devuelve ``true`` si la configuración del proyecto es válida. ---- +.. _class_EditorExportPlatformExtension_private_method__initialize: + +.. rst-class:: classref-method + +|void| **_initialize**\ (\ ) |virtual| :ref:`🔗` + +Initializes the plugin. Called by the editor when platform is registered. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorExportPlatformExtension_private_method__is_executable: .. rst-class:: classref-method diff --git a/classes/es/class_editorexportplatformios.rst b/classes/es/class_editorexportplatformios.rst index b7cfb4cd0f..152eb7a4c1 100644 --- a/classes/es/class_editorexportplatformios.rst +++ b/classes/es/class_editorexportplatformios.rst @@ -451,13 +451,13 @@ Propiedades +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`privacy/collected_data/purchase_history/used_for_tracking` | +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`privacy/collected_data/search_hhistory/collected` | + | :ref:`bool` | :ref:`privacy/collected_data/search_history/collected` | +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`privacy/collected_data/search_hhistory/collection_purposes` | + | :ref:`int` | :ref:`privacy/collected_data/search_history/collection_purposes` | +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`privacy/collected_data/search_hhistory/linked_to_user` | + | :ref:`bool` | :ref:`privacy/collected_data/search_history/linked_to_user` | +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`privacy/collected_data/search_hhistory/used_for_tracking` | + | :ref:`bool` | :ref:`privacy/collected_data/search_history/used_for_tracking` | +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`privacy/collected_data/sensitive_info/collected` | +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -3093,11 +3093,11 @@ Indica si tu aplicación utiliza el historial de compras para el seguimiento. ---- -.. _class_EditorExportPlatformIOS_property_privacy/collected_data/search_hhistory/collected: +.. _class_EditorExportPlatformIOS_property_privacy/collected_data/search_history/collected: .. rst-class:: classref-property -:ref:`bool` **privacy/collected_data/search_hhistory/collected** :ref:`🔗` +:ref:`bool` **privacy/collected_data/search_history/collected** :ref:`🔗` Indica si tu aplicación recopila el historial de búsqueda. @@ -3105,11 +3105,11 @@ Indica si tu aplicación recopila el historial de búsqueda. ---- -.. _class_EditorExportPlatformIOS_property_privacy/collected_data/search_hhistory/collection_purposes: +.. _class_EditorExportPlatformIOS_property_privacy/collected_data/search_history/collection_purposes: .. rst-class:: classref-property -:ref:`int` **privacy/collected_data/search_hhistory/collection_purposes** :ref:`🔗` +:ref:`int` **privacy/collected_data/search_history/collection_purposes** :ref:`🔗` Las razones por las que tu aplicación recopila el historial de búsqueda. Véase `Descripción del uso de datos en manifiestos de privacidad `__. @@ -3117,11 +3117,11 @@ Las razones por las que tu aplicación recopila el historial de búsqueda. Véas ---- -.. _class_EditorExportPlatformIOS_property_privacy/collected_data/search_hhistory/linked_to_user: +.. _class_EditorExportPlatformIOS_property_privacy/collected_data/search_history/linked_to_user: .. rst-class:: classref-property -:ref:`bool` **privacy/collected_data/search_hhistory/linked_to_user** :ref:`🔗` +:ref:`bool` **privacy/collected_data/search_history/linked_to_user** :ref:`🔗` Indica si tu aplicación vincula el historial de búsqueda a la identidad del usuario. @@ -3129,11 +3129,11 @@ Indica si tu aplicación vincula el historial de búsqueda a la identidad del us ---- -.. _class_EditorExportPlatformIOS_property_privacy/collected_data/search_hhistory/used_for_tracking: +.. _class_EditorExportPlatformIOS_property_privacy/collected_data/search_history/used_for_tracking: .. rst-class:: classref-property -:ref:`bool` **privacy/collected_data/search_hhistory/used_for_tracking** :ref:`🔗` +:ref:`bool` **privacy/collected_data/search_history/used_for_tracking** :ref:`🔗` Indica si tu aplicación utiliza el historial de búsqueda para el seguimiento. @@ -3365,7 +3365,9 @@ Las razones por las que tu aplicación usa la API de valores predeterminados del :ref:`bool` **shader_baker/enabled** :ref:`🔗` -Si es ``true``, los shaders se compilarán e integrarán en la aplicación. Esta opción solo es compatible cuando se utilizan los renderizadores Forward+ o Mobile. +If ``true``, shaders will be compiled and embedded in the application. This option is only supported when using the Forward+ or Mobile renderers. + +\ **Note:** When exporting as a dedicated server, the shader baker is always disabled since no rendering is performed. .. rst-class:: classref-item-separator diff --git a/classes/es/class_editorexportplatformlinuxbsd.rst b/classes/es/class_editorexportplatformlinuxbsd.rst index 7f09a3cd69..3a7794219b 100644 --- a/classes/es/class_editorexportplatformlinuxbsd.rst +++ b/classes/es/class_editorexportplatformlinuxbsd.rst @@ -135,7 +135,9 @@ Si es ``true``, se exporta un envoltorio de consola junto con el ejecutable prin :ref:`bool` **shader_baker/enabled** :ref:`🔗` -Si es ``true``, los shaders se compilarán e integrarán en la aplicación. Esta opción solo es compatible cuando se utilizan los renderizadores Forward+ o Mobile. +If ``true``, shaders will be compiled and embedded in the application. This option is only supported when using the Forward+ or Mobile renderers. + +\ **Note:** When exporting as a dedicated server, the shader baker is always disabled since no rendering is performed. .. rst-class:: classref-item-separator diff --git a/classes/es/class_editorexportplatformmacos.rst b/classes/es/class_editorexportplatformmacos.rst index 63bf9c16af..fc7809854b 100644 --- a/classes/es/class_editorexportplatformmacos.rst +++ b/classes/es/class_editorexportplatformmacos.rst @@ -43,6 +43,8 @@ Propiedades +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`application/icon_interpolation` | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`application/liquid_glass_icon` | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`application/min_macos_version_arm64` | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`application/min_macos_version_x86_64` | @@ -411,13 +413,13 @@ Propiedades +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`privacy/collected_data/purchase_history/used_for_tracking` | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`privacy/collected_data/search_hhistory/collected` | + | :ref:`bool` | :ref:`privacy/collected_data/search_history/collected` | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`privacy/collected_data/search_hhistory/collection_purposes` | + | :ref:`int` | :ref:`privacy/collected_data/search_history/collection_purposes` | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`privacy/collected_data/search_hhistory/linked_to_user` | + | :ref:`bool` | :ref:`privacy/collected_data/search_history/linked_to_user` | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`privacy/collected_data/search_hhistory/used_for_tracking` | + | :ref:`bool` | :ref:`privacy/collected_data/search_history/used_for_tracking` | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`privacy/collected_data/sensitive_info/collected` | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -610,6 +612,22 @@ Método de interpolación utilizado para redimensionar el icono de la aplicació ---- +.. _class_EditorExportPlatformMacOS_property_application/liquid_glass_icon: + +.. rst-class:: classref-property + +:ref:`String` **application/liquid_glass_icon** :ref:`🔗` + +macOS 26 Liquid Glass icon source file. Use `Icon Composer `__ to create Liquid Glass icons. + +\ **Note:** Supported when exporting from macOS only, Xcode 26+ required. + +\ **Note:** Liquid Glass icons are supported on macOS 26 only, use :ref:`application/icon` to set the icon for older macOS versions. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorExportPlatformMacOS_property_application/min_macos_version_arm64: .. rst-class:: classref-property @@ -2851,11 +2869,11 @@ Indica si tu aplicación utiliza el historial de compras para el seguimiento. ---- -.. _class_EditorExportPlatformMacOS_property_privacy/collected_data/search_hhistory/collected: +.. _class_EditorExportPlatformMacOS_property_privacy/collected_data/search_history/collected: .. rst-class:: classref-property -:ref:`bool` **privacy/collected_data/search_hhistory/collected** :ref:`🔗` +:ref:`bool` **privacy/collected_data/search_history/collected** :ref:`🔗` Indica si tu aplicación recopila el historial de búsqueda. @@ -2863,11 +2881,11 @@ Indica si tu aplicación recopila el historial de búsqueda. ---- -.. _class_EditorExportPlatformMacOS_property_privacy/collected_data/search_hhistory/collection_purposes: +.. _class_EditorExportPlatformMacOS_property_privacy/collected_data/search_history/collection_purposes: .. rst-class:: classref-property -:ref:`int` **privacy/collected_data/search_hhistory/collection_purposes** :ref:`🔗` +:ref:`int` **privacy/collected_data/search_history/collection_purposes** :ref:`🔗` Las razones por las que tu aplicación recopila el historial de búsqueda. Véase `Descripción del uso de datos en manifiestos de privacidad `__. @@ -2875,11 +2893,11 @@ Las razones por las que tu aplicación recopila el historial de búsqueda. Véas ---- -.. _class_EditorExportPlatformMacOS_property_privacy/collected_data/search_hhistory/linked_to_user: +.. _class_EditorExportPlatformMacOS_property_privacy/collected_data/search_history/linked_to_user: .. rst-class:: classref-property -:ref:`bool` **privacy/collected_data/search_hhistory/linked_to_user** :ref:`🔗` +:ref:`bool` **privacy/collected_data/search_history/linked_to_user** :ref:`🔗` Indica si tu aplicación vincula el historial de búsqueda a la identidad del usuario. @@ -2887,11 +2905,11 @@ Indica si tu aplicación vincula el historial de búsqueda a la identidad del us ---- -.. _class_EditorExportPlatformMacOS_property_privacy/collected_data/search_hhistory/used_for_tracking: +.. _class_EditorExportPlatformMacOS_property_privacy/collected_data/search_history/used_for_tracking: .. rst-class:: classref-property -:ref:`bool` **privacy/collected_data/search_hhistory/used_for_tracking** :ref:`🔗` +:ref:`bool` **privacy/collected_data/search_history/used_for_tracking** :ref:`🔗` Indica si tu aplicación utiliza el historial de búsqueda para el seguimiento. @@ -3219,7 +3237,9 @@ Indica si tu aplicación utiliza datos para el seguimiento. Véase `Archivos de :ref:`bool` **shader_baker/enabled** :ref:`🔗` -Si es ``true``, los shaders se compilarán e integrarán en la aplicación. Esta opción solo es compatible cuando se utilizan los renderizadores Forward+ o Mobile. +If ``true``, shaders will be compiled and embedded in the application. This option is only supported when using the Forward+ or Mobile renderers. + +\ **Note:** When exporting as a dedicated server, the shader baker is always disabled since no rendering is performed. .. rst-class:: classref-item-separator diff --git a/classes/es/class_editorexportplatformvisionos.rst b/classes/es/class_editorexportplatformvisionos.rst index ef36efbaae..6a25352f7e 100644 --- a/classes/es/class_editorexportplatformvisionos.rst +++ b/classes/es/class_editorexportplatformvisionos.rst @@ -353,13 +353,13 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`privacy/collected_data/purchase_history/used_for_tracking` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`privacy/collected_data/search_hhistory/collected` | + | :ref:`bool` | :ref:`privacy/collected_data/search_history/collected` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`privacy/collected_data/search_hhistory/collection_purposes` | + | :ref:`int` | :ref:`privacy/collected_data/search_history/collection_purposes` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`privacy/collected_data/search_hhistory/linked_to_user` | + | :ref:`bool` | :ref:`privacy/collected_data/search_history/linked_to_user` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`privacy/collected_data/search_hhistory/used_for_tracking` | + | :ref:`bool` | :ref:`privacy/collected_data/search_history/used_for_tracking` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`privacy/collected_data/sensitive_info/collected` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -2399,11 +2399,11 @@ Indica si tu aplicación utiliza el historial de compras para el seguimiento. ---- -.. _class_EditorExportPlatformVisionOS_property_privacy/collected_data/search_hhistory/collected: +.. _class_EditorExportPlatformVisionOS_property_privacy/collected_data/search_history/collected: .. rst-class:: classref-property -:ref:`bool` **privacy/collected_data/search_hhistory/collected** :ref:`🔗` +:ref:`bool` **privacy/collected_data/search_history/collected** :ref:`🔗` Indica si tu aplicación recopila el historial de búsqueda. @@ -2411,11 +2411,11 @@ Indica si tu aplicación recopila el historial de búsqueda. ---- -.. _class_EditorExportPlatformVisionOS_property_privacy/collected_data/search_hhistory/collection_purposes: +.. _class_EditorExportPlatformVisionOS_property_privacy/collected_data/search_history/collection_purposes: .. rst-class:: classref-property -:ref:`int` **privacy/collected_data/search_hhistory/collection_purposes** :ref:`🔗` +:ref:`int` **privacy/collected_data/search_history/collection_purposes** :ref:`🔗` Las razones por las que tu aplicación recopila el historial de búsqueda. Véase `Descripción del uso de datos en manifiestos de privacidad `__. @@ -2423,11 +2423,11 @@ Las razones por las que tu aplicación recopila el historial de búsqueda. Véas ---- -.. _class_EditorExportPlatformVisionOS_property_privacy/collected_data/search_hhistory/linked_to_user: +.. _class_EditorExportPlatformVisionOS_property_privacy/collected_data/search_history/linked_to_user: .. rst-class:: classref-property -:ref:`bool` **privacy/collected_data/search_hhistory/linked_to_user** :ref:`🔗` +:ref:`bool` **privacy/collected_data/search_history/linked_to_user** :ref:`🔗` Indica si tu aplicación vincula el historial de búsqueda a la identidad del usuario. @@ -2435,11 +2435,11 @@ Indica si tu aplicación vincula el historial de búsqueda a la identidad del us ---- -.. _class_EditorExportPlatformVisionOS_property_privacy/collected_data/search_hhistory/used_for_tracking: +.. _class_EditorExportPlatformVisionOS_property_privacy/collected_data/search_history/used_for_tracking: .. rst-class:: classref-property -:ref:`bool` **privacy/collected_data/search_hhistory/used_for_tracking** :ref:`🔗` +:ref:`bool` **privacy/collected_data/search_history/used_for_tracking** :ref:`🔗` Indica si tu aplicación utiliza el historial de búsqueda para el seguimiento. @@ -2673,6 +2673,8 @@ Las razones por las que tu aplicación usa la API de valores predeterminados del If ``true``, shaders will be compiled and embedded in the application. This option is only supported when using the Forward+ and Mobile renderers. +\ **Note:** When exporting as a dedicated server, the shader baker is always disabled since no rendering is performed. + .. rst-class:: classref-item-separator ---- diff --git a/classes/es/class_editorexportplatformweb.rst b/classes/es/class_editorexportplatformweb.rst index de148fdfb3..d8770f13c0 100644 --- a/classes/es/class_editorexportplatformweb.rst +++ b/classes/es/class_editorexportplatformweb.rst @@ -350,9 +350,9 @@ The number of threads that emscripten will allocate at startup. A smaller value :ref:`int` **threads/godot_pool_size** :ref:`🔗` -Override for the default size of the :ref:`WorkerThreadPool`. This setting is used when :ref:`ProjectSettings.threading/worker_pool/max_threads` size is set to -1 (which it is by default). This size must be smaller than :ref:`threads/emscripten_pool_size` otherwise deadlocks may occur. +Override for the default size of the :ref:`WorkerThreadPool`. This setting is used when :ref:`ProjectSettings.threading/worker_pool/max_threads` size is set to ``-1`` (which it is by default). This size must be smaller than :ref:`threads/emscripten_pool_size` otherwise deadlocks may occur. -When using threads this size needs to be large enough to accommodate features that rely on having a dedicated thread like :ref:`ProjectSettings.physics/2d/run_on_separate_thread` or :ref:`ProjectSettings.rendering/driver/threads/thread_model`. In general, it is best to ensure that this is at least 4 and is at least 2 or 3 less than :ref:`threads/emscripten_pool_size`. +When using threads, this size needs to be large enough to accommodate features that rely on having a dedicated thread like :ref:`ProjectSettings.physics/2d/run_on_separate_thread` or :ref:`ProjectSettings.rendering/driver/threads/thread_model`. In general, it is best to ensure that this is at least ``4`` and is at least ``2`` or ``3`` less than :ref:`threads/emscripten_pool_size`. .. rst-class:: classref-item-separator diff --git a/classes/es/class_editorexportplatformwindows.rst b/classes/es/class_editorexportplatformwindows.rst index 4321d447ba..73732feeb7 100644 --- a/classes/es/class_editorexportplatformwindows.rst +++ b/classes/es/class_editorexportplatformwindows.rst @@ -472,6 +472,8 @@ If ``true``, a console wrapper executable is exported alongside the main executa If ``true``, shaders will be compiled and embedded in the application. This option is only supported when using the Forward+ and Mobile renderers. +\ **Note:** When exporting as a dedicated server, the shader baker is always disabled since no rendering is performed. + .. rst-class:: classref-item-separator ---- diff --git a/classes/es/class_editorexportpreset.rst b/classes/es/class_editorexportpreset.rst index 99e480ee40..721c8cd51d 100644 --- a/classes/es/class_editorexportpreset.rst +++ b/classes/es/class_editorexportpreset.rst @@ -24,57 +24,57 @@ Métodos .. table:: :widths: auto - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`are_advanced_options_enabled`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_custom_features`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Dictionary` | :ref:`get_customized_files`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_customized_files_count`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`get_encrypt_directory`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`get_encrypt_pck`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_encryption_ex_filter`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_encryption_in_filter`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_encryption_key`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_exclude_filter`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`ExportFilter` | :ref:`get_export_filter`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_export_path`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`FileExportMode` | :ref:`get_file_export_mode`\ (\ path\: :ref:`String`, default\: :ref:`FileExportMode` = 0\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`get_files_to_export`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_include_filter`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Variant` | :ref:`get_or_env`\ (\ name\: :ref:`StringName`, env_var\: :ref:`String`\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`get_patches`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_preset_name`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Variant` | :ref:`get_project_setting`\ (\ name\: :ref:`StringName`\ ) | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_script_export_mode`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_version`\ (\ name\: :ref:`StringName`, windows_version\: :ref:`bool`\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has`\ (\ property\: :ref:`StringName`\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has_export_file`\ (\ path\: :ref:`String`\ ) | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_dedicated_server`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_runnable`\ (\ ) |const| | - +---------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`are_advanced_options_enabled`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_custom_features`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dictionary` | :ref:`get_customized_files`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_customized_files_count`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`get_encrypt_directory`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`get_encrypt_pck`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_encryption_ex_filter`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_encryption_in_filter`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_encryption_key`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_exclude_filter`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`ExportFilter` | :ref:`get_export_filter`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_export_path`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`FileExportMode` | :ref:`get_file_export_mode`\ (\ path\: :ref:`String`, default\: :ref:`FileExportMode` = 0\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`get_files_to_export`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_include_filter`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Variant` | :ref:`get_or_env`\ (\ name\: :ref:`StringName`, env_var\: :ref:`String`\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`get_patches`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_preset_name`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Variant` | :ref:`get_project_setting`\ (\ name\: :ref:`StringName`\ ) | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`ScriptExportMode` | :ref:`get_script_export_mode`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_version`\ (\ name\: :ref:`StringName`, windows_version\: :ref:`bool`\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has`\ (\ property\: :ref:`StringName`\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_export_file`\ (\ path\: :ref:`String`\ ) | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_dedicated_server`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_runnable`\ (\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -496,7 +496,7 @@ Returns the value of the setting identified by ``name`` using export preset feat .. rst-class:: classref-method -:ref:`int` **get_script_export_mode**\ (\ ) |const| :ref:`🔗` +:ref:`ScriptExportMode` **get_script_export_mode**\ (\ ) |const| :ref:`🔗` Returns the export mode used by GDScript files. ``0`` for "Text", ``1`` for "Binary tokens", and ``2`` for "Compressed binary tokens (smaller files)". diff --git a/classes/es/class_editorfeatureprofile.rst b/classes/es/class_editorfeatureprofile.rst index 3a078e2500..bbcd2fd293 100644 --- a/classes/es/class_editorfeatureprofile.rst +++ b/classes/es/class_editorfeatureprofile.rst @@ -103,6 +103,8 @@ Edición del árbol de escenas. Si esta función está desactivada, el acoplamie :ref:`Feature` **FEATURE_NODE_DOCK** = ``4`` +**Obsoleto:** Replaced by the Signals and Groups docks. + El nodo dock. Si esta característica está desactivada, las señales y grupos no serán visibles y modificables desde el editor. .. _class_EditorFeatureProfile_constant_FEATURE_FILESYSTEM_DOCK: @@ -137,11 +139,27 @@ The History dock. If this feature is disabled, the History dock won't be visible The Game tab, which allows embedding the game window and selecting nodes by clicking inside of it. If this feature is disabled, the Game tab won't display. +.. _class_EditorFeatureProfile_constant_FEATURE_SIGNALS_DOCK: + +.. rst-class:: classref-enumeration-constant + +:ref:`Feature` **FEATURE_SIGNALS_DOCK** = ``9`` + +The Signals dock. If this feature is disabled, signals won't be visible and modifiable from the editor. + +.. _class_EditorFeatureProfile_constant_FEATURE_GROUPS_DOCK: + +.. rst-class:: classref-enumeration-constant + +:ref:`Feature` **FEATURE_GROUPS_DOCK** = ``10`` + +The Groups dock. If this feature is disabled, groups won't be visible and modifiable from the editor. + .. _class_EditorFeatureProfile_constant_FEATURE_MAX: .. rst-class:: classref-enumeration-constant -:ref:`Feature` **FEATURE_MAX** = ``9`` +:ref:`Feature` **FEATURE_MAX** = ``11`` Representa el tamaño del enum :ref:`Feature`. diff --git a/classes/es/class_editorfiledialog.rst b/classes/es/class_editorfiledialog.rst index 91ef6ba239..f12ada45a8 100644 --- a/classes/es/class_editorfiledialog.rst +++ b/classes/es/class_editorfiledialog.rst @@ -5,7 +5,7 @@ EditorFileDialog ================ -**Hereda:** :ref:`ConfirmationDialog` **<** :ref:`AcceptDialog` **<** :ref:`Window` **<** :ref:`Viewport` **<** :ref:`Node` **<** :ref:`Object` +**Hereda:** :ref:`FileDialog` **<** :ref:`ConfirmationDialog` **<** :ref:`AcceptDialog` **<** :ref:`Window` **<** :ref:`Viewport` **<** :ref:`Node` **<** :ref:`Object` Una versión modificada de :ref:`FileDialog` utilizada por el editor. @@ -14,9 +14,11 @@ Una versión modificada de :ref:`FileDialog` utilizada por el Descripción ---------------------- -**EditorFileDialog** is an enhanced version of :ref:`FileDialog` available only to editor plugins. Additional features include list of favorited/recent files and the ability to see files as thumbnails grid instead of list. +**EditorFileDialog** is a :ref:`FileDialog` tweaked to work in the editor. It automatically handles favorite and recent directory lists, and synchronizes some properties with their corresponding editor settings. -Unlike :ref:`FileDialog`, **EditorFileDialog** does not have a property for using native dialogs. Instead, native dialogs can be enabled globally via the :ref:`EditorSettings.interface/editor/use_native_file_dialogs` editor setting. They are also enabled automatically when running in sandbox (e.g. on macOS). +\ **EditorFileDialog** will automatically show a native dialog based on the :ref:`EditorSettings.interface/editor/use_native_file_dialogs` editor setting and ignores :ref:`FileDialog.use_native_dialog`. + +\ **Note:** **EditorFileDialog** is invisible by default. To make it visible, call one of the ``popup_*`` methods from :ref:`Window` on the node, such as :ref:`Window.popup_centered_clamped()`. .. rst-class:: classref-reftable-group @@ -26,31 +28,9 @@ Propiedades .. table:: :widths: auto - +-------------------------------------------------------+---------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`Access` | :ref:`access` | ``0`` | - +-------------------------------------------------------+---------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`current_dir` | | - +-------------------------------------------------------+---------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`current_file` | | - +-------------------------------------------------------+---------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`current_path` | | - +-------------------------------------------------------+---------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`bool` | dialog_hide_on_ok | ``false`` (overrides :ref:`AcceptDialog`) | - +-------------------------------------------------------+---------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`disable_overwrite_warning` | ``false`` | - +-------------------------------------------------------+---------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`DisplayMode` | :ref:`display_mode` | ``0`` | - +-------------------------------------------------------+---------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`FileMode` | :ref:`file_mode` | ``4`` | - +-------------------------------------------------------+---------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`filters` | ``PackedStringArray()`` | - +-------------------------------------------------------+---------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`option_count` | ``0`` | - +-------------------------------------------------------+---------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`show_hidden_files` | ``false`` | - +-------------------------------------------------------+---------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`String` | title | ``"Save a File"`` (overrides :ref:`Window`) | - +-------------------------------------------------------+---------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ + +-------------------------+---------------------------------------------------------------------------------------------+-----------+ + | :ref:`bool` | :ref:`disable_overwrite_warning` | ``false`` | + +-------------------------+---------------------------------------------------------------------------------------------+-----------+ .. rst-class:: classref-reftable-group @@ -60,211 +40,9 @@ Métodos .. table:: :widths: auto - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`add_filter`\ (\ filter\: :ref:`String`, description\: :ref:`String` = ""\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`add_option`\ (\ name\: :ref:`String`, values\: :ref:`PackedStringArray`, default_value_index\: :ref:`int`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`add_side_menu`\ (\ menu\: :ref:`Control`, title\: :ref:`String` = ""\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear_filename_filter`\ (\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear_filters`\ (\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_filename_filter`\ (\ ) |const| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`LineEdit` | :ref:`get_line_edit`\ (\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_option_default`\ (\ option\: :ref:`int`\ ) |const| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_option_name`\ (\ option\: :ref:`int`\ ) |const| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`get_option_values`\ (\ option\: :ref:`int`\ ) |const| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Dictionary` | :ref:`get_selected_options`\ (\ ) |const| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`VBoxContainer` | :ref:`get_vbox`\ (\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`invalidate`\ (\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`popup_file_dialog`\ (\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_filename_filter`\ (\ filter\: :ref:`String`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_option_default`\ (\ option\: :ref:`int`, default_value_index\: :ref:`int`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_option_name`\ (\ option\: :ref:`int`, name\: :ref:`String`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_option_values`\ (\ option\: :ref:`int`, values\: :ref:`PackedStringArray`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - -.. rst-class:: classref-section-separator - ----- - -.. rst-class:: classref-descriptions-group - -Señales --------------- - -.. _class_EditorFileDialog_signal_dir_selected: - -.. rst-class:: classref-signal - -**dir_selected**\ (\ dir\: :ref:`String`\ ) :ref:`🔗` - -Emitida cuando se selecciona un directorio. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_signal_file_selected: - -.. rst-class:: classref-signal - -**file_selected**\ (\ path\: :ref:`String`\ ) :ref:`🔗` - -Emitida cuando se selecciona un archivo. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_signal_filename_filter_changed: - -.. rst-class:: classref-signal - -**filename_filter_changed**\ (\ filter\: :ref:`String`\ ) :ref:`🔗` - -Emitida cuando el filtro de nombres de archivos cambia. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_signal_files_selected: - -.. rst-class:: classref-signal - -**files_selected**\ (\ paths\: :ref:`PackedStringArray`\ ) :ref:`🔗` - -Emitida cuando se seleccionan varios archivos. - -.. rst-class:: classref-section-separator - ----- - -.. rst-class:: classref-descriptions-group - -Enumeraciones --------------------------- - -.. _enum_EditorFileDialog_FileMode: - -.. rst-class:: classref-enumeration - -enum **FileMode**: :ref:`🔗` - -.. _class_EditorFileDialog_constant_FILE_MODE_OPEN_FILE: - -.. rst-class:: classref-enumeration-constant - -:ref:`FileMode` **FILE_MODE_OPEN_FILE** = ``0`` - -El **EditorFileDialog** puede seleccionar sólo un archivo. Al aceptar la ventana se abrirá el archivo. - -.. _class_EditorFileDialog_constant_FILE_MODE_OPEN_FILES: - -.. rst-class:: classref-enumeration-constant - -:ref:`FileMode` **FILE_MODE_OPEN_FILES** = ``1`` - -El **EditorFileDialog** puede seleccionar varios archivos. Al aceptar la ventana se abrirán todos los archivos. - -.. _class_EditorFileDialog_constant_FILE_MODE_OPEN_DIR: - -.. rst-class:: classref-enumeration-constant - -:ref:`FileMode` **FILE_MODE_OPEN_DIR** = ``2`` - -El **EditorFileDialog** puede seleccionar sólo un directorio. Al aceptar la ventana se abrirá el directorio. - -.. _class_EditorFileDialog_constant_FILE_MODE_OPEN_ANY: - -.. rst-class:: classref-enumeration-constant - -:ref:`FileMode` **FILE_MODE_OPEN_ANY** = ``3`` - -El **EditorFileDialog** puede seleccionar un archivo o directorio. Aceptando la ventana se abrirá. - -.. _class_EditorFileDialog_constant_FILE_MODE_SAVE_FILE: - -.. rst-class:: classref-enumeration-constant - -:ref:`FileMode` **FILE_MODE_SAVE_FILE** = ``4`` - -El **EditorFileDialog** puede seleccionar sólo un archivo. Al aceptar la ventana se guardará el archivo. - -.. rst-class:: classref-item-separator - ----- - -.. _enum_EditorFileDialog_Access: - -.. rst-class:: classref-enumeration - -enum **Access**: :ref:`🔗` - -.. _class_EditorFileDialog_constant_ACCESS_RESOURCES: - -.. rst-class:: classref-enumeration-constant - -:ref:`Access` **ACCESS_RESOURCES** = ``0`` - -El **EditorFileDialog** sólo puede ver el contenido del directorio ``res://``. - -.. _class_EditorFileDialog_constant_ACCESS_USERDATA: - -.. rst-class:: classref-enumeration-constant - -:ref:`Access` **ACCESS_USERDATA** = ``1`` - -El **EditorFileDialog** sólo puede ver el contenido del directorio ``user://``. - -.. _class_EditorFileDialog_constant_ACCESS_FILESYSTEM: - -.. rst-class:: classref-enumeration-constant - -:ref:`Access` **ACCESS_FILESYSTEM** = ``2`` - -El **EditorFileDialog** puede ver todo el sistema de archivos locales. - -.. rst-class:: classref-item-separator - ----- - -.. _enum_EditorFileDialog_DisplayMode: - -.. rst-class:: classref-enumeration - -enum **DisplayMode**: :ref:`🔗` - -.. _class_EditorFileDialog_constant_DISPLAY_THUMBNAILS: - -.. rst-class:: classref-enumeration-constant - -:ref:`DisplayMode` **DISPLAY_THUMBNAILS** = ``0`` - -El **EditorFileDialog** muestra los recursos como miniaturas. - -.. _class_EditorFileDialog_constant_DISPLAY_LIST: - -.. rst-class:: classref-enumeration-constant - -:ref:`DisplayMode` **DISPLAY_LIST** = ``1`` - -El **EditorFileDialog** muestra los recursos como una lista de nombres de archivos. + +--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`add_side_menu`\ (\ menu\: :ref:`Control`, title\: :ref:`String` = ""\ ) | + +--------+---------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -275,74 +53,6 @@ El **EditorFileDialog** muestra los recursos como una lista de nombres de archiv Descripciones de Propiedades -------------------------------------------------------- -.. _class_EditorFileDialog_property_access: - -.. rst-class:: classref-property - -:ref:`Access` **access** = ``0`` :ref:`🔗` - -.. rst-class:: classref-property-setget - -- |void| **set_access**\ (\ value\: :ref:`Access`\ ) -- :ref:`Access` **get_access**\ (\ ) - -La ubicación desde la cual el usuario puede seleccionar un archivo, incluyendo ``res://``, ``user://``, y el sistema de archivos local. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_property_current_dir: - -.. rst-class:: classref-property - -:ref:`String` **current_dir** :ref:`🔗` - -.. rst-class:: classref-property-setget - -- |void| **set_current_dir**\ (\ value\: :ref:`String`\ ) -- :ref:`String` **get_current_dir**\ (\ ) - -El directorio actualmente ocupado. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_property_current_file: - -.. rst-class:: classref-property - -:ref:`String` **current_file** :ref:`🔗` - -.. rst-class:: classref-property-setget - -- |void| **set_current_file**\ (\ value\: :ref:`String`\ ) -- :ref:`String` **get_current_file**\ (\ ) - -El archivo actualmente seleccionado. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_property_current_path: - -.. rst-class:: classref-property - -:ref:`String` **current_path** :ref:`🔗` - -.. rst-class:: classref-property-setget - -- |void| **set_current_path**\ (\ value\: :ref:`String`\ ) -- :ref:`String` **get_current_path**\ (\ ) - -La ruta del sistema de archivos en la barra de direcciones. - -.. rst-class:: classref-item-separator - ----- - .. _class_EditorFileDialog_property_disable_overwrite_warning: .. rst-class:: classref-property @@ -354,95 +64,10 @@ La ruta del sistema de archivos en la barra de direcciones. - |void| **set_disable_overwrite_warning**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_overwrite_warning_disabled**\ (\ ) +**Obsoleto:** Use :ref:`FileDialog.overwrite_warning_enabled` instead. + Si es ``true``, el **EditorFileDialog** no avisará al usuario antes de sobrescribir los archivos. -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_property_display_mode: - -.. rst-class:: classref-property - -:ref:`DisplayMode` **display_mode** = ``0`` :ref:`🔗` - -.. rst-class:: classref-property-setget - -- |void| **set_display_mode**\ (\ value\: :ref:`DisplayMode`\ ) -- :ref:`DisplayMode` **get_display_mode**\ (\ ) - -El formato de visualización en el que el **EditorFileDialog** muestra los recursos al usuario. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_property_file_mode: - -.. rst-class:: classref-property - -:ref:`FileMode` **file_mode** = ``4`` :ref:`🔗` - -.. rst-class:: classref-property-setget - -- |void| **set_file_mode**\ (\ value\: :ref:`FileMode`\ ) -- :ref:`FileMode` **get_file_mode**\ (\ ) - -The dialog's open or save mode, which affects the selection behavior. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_property_filters: - -.. rst-class:: classref-property - -:ref:`PackedStringArray` **filters** = ``PackedStringArray()`` :ref:`🔗` - -.. rst-class:: classref-property-setget - -- |void| **set_filters**\ (\ value\: :ref:`PackedStringArray`\ ) -- :ref:`PackedStringArray` **get_filters**\ (\ ) - -The available file type filters. For example, this shows only ``.png`` and ``.gd`` files: ``set_filters(PackedStringArray(["*.png ; PNG Images","*.gd ; GDScript Files"]))``. Multiple file types can also be specified in a single filter. ``"*.png, *.jpg, *.jpeg ; Supported Images"`` will show both PNG and JPEG files when selected. - -**Note:** The returned array is *copied* and any changes to it will not update the original property value. See :ref:`PackedStringArray` for more details. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_property_option_count: - -.. rst-class:: classref-property - -:ref:`int` **option_count** = ``0`` :ref:`🔗` - -.. rst-class:: classref-property-setget - -- |void| **set_option_count**\ (\ value\: :ref:`int`\ ) -- :ref:`int` **get_option_count**\ (\ ) - -The number of additional :ref:`OptionButton`\ s and :ref:`CheckBox`\ es in the dialog. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_property_show_hidden_files: - -.. rst-class:: classref-property - -:ref:`bool` **show_hidden_files** = ``false`` :ref:`🔗` - -.. rst-class:: classref-property-setget - -- |void| **set_show_hidden_files**\ (\ value\: :ref:`bool`\ ) -- :ref:`bool` **is_showing_hidden_files**\ (\ ) - -If ``true``, hidden files and directories will be visible in the **EditorFileDialog**. This property is synchronized with :ref:`EditorSettings.filesystem/file_dialog/show_hidden_files`. - .. rst-class:: classref-section-separator ---- @@ -452,227 +77,15 @@ If ``true``, hidden files and directories will be visible in the **EditorFileDia Descripciones de Métodos ------------------------------------------------ -.. _class_EditorFileDialog_method_add_filter: - -.. rst-class:: classref-method - -|void| **add_filter**\ (\ filter\: :ref:`String`, description\: :ref:`String` = ""\ ) :ref:`🔗` - -Adds a comma-separated file name ``filter`` option to the **EditorFileDialog** with an optional ``description``, which restricts what files can be picked. - -A ``filter`` should be of the form ``"filename.extension"``, where filename and extension can be ``*`` to match any string. Filters starting with ``.`` (i.e. empty filenames) are not allowed. - -For example, a ``filter`` of ``"*.tscn, *.scn"`` and a ``description`` of ``"Scenes"`` results in filter text "Scenes (\*.tscn, \*.scn)". - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_add_option: - -.. rst-class:: classref-method - -|void| **add_option**\ (\ name\: :ref:`String`, values\: :ref:`PackedStringArray`, default_value_index\: :ref:`int`\ ) :ref:`🔗` - -Adds an additional :ref:`OptionButton` to the file dialog. If ``values`` is empty, a :ref:`CheckBox` is added instead. - -\ ``default_value_index`` should be an index of the value in the ``values``. If ``values`` is empty it should be either ``1`` (checked), or ``0`` (unchecked). - -.. rst-class:: classref-item-separator - ----- - .. _class_EditorFileDialog_method_add_side_menu: .. rst-class:: classref-method |void| **add_side_menu**\ (\ menu\: :ref:`Control`, title\: :ref:`String` = ""\ ) :ref:`🔗` -Adds the given ``menu`` to the side of the file dialog with the given ``title`` text on top. Only one side menu is allowed. +**Obsoleto:** This feature is no longer supported. -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_clear_filename_filter: - -.. rst-class:: classref-method - -|void| **clear_filename_filter**\ (\ ) :ref:`🔗` - -Limpiar el filtro de nombres de archivos. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_clear_filters: - -.. rst-class:: classref-method - -|void| **clear_filters**\ (\ ) :ref:`🔗` - -Removes all filters except for "All Files (\*.\*)". - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_get_filename_filter: - -.. rst-class:: classref-method - -:ref:`String` **get_filename_filter**\ (\ ) |const| :ref:`🔗` - -Devuelve el valor del filtro para los nombres de archivos. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_get_line_edit: - -.. rst-class:: classref-method - -:ref:`LineEdit` **get_line_edit**\ (\ ) :ref:`🔗` - -Returns the LineEdit for the selected file. - -\ **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. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_get_option_default: - -.. rst-class:: classref-method - -:ref:`int` **get_option_default**\ (\ option\: :ref:`int`\ ) |const| :ref:`🔗` - -Returns the default value index of the :ref:`OptionButton` or :ref:`CheckBox` with index ``option``. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_get_option_name: - -.. rst-class:: classref-method - -:ref:`String` **get_option_name**\ (\ option\: :ref:`int`\ ) |const| :ref:`🔗` - -Returns the name of the :ref:`OptionButton` or :ref:`CheckBox` with index ``option``. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_get_option_values: - -.. rst-class:: classref-method - -:ref:`PackedStringArray` **get_option_values**\ (\ option\: :ref:`int`\ ) |const| :ref:`🔗` - -Returns an array of values of the :ref:`OptionButton` with index ``option``. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_get_selected_options: - -.. rst-class:: classref-method - -:ref:`Dictionary` **get_selected_options**\ (\ ) |const| :ref:`🔗` - -Returns a :ref:`Dictionary` with the selected values of the additional :ref:`OptionButton`\ s and/or :ref:`CheckBox`\ es. :ref:`Dictionary` keys are names and values are selected value indices. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_get_vbox: - -.. rst-class:: classref-method - -:ref:`VBoxContainer` **get_vbox**\ (\ ) :ref:`🔗` - -Returns the :ref:`VBoxContainer` used to display the file system. - -\ **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. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_invalidate: - -.. rst-class:: classref-method - -|void| **invalidate**\ (\ ) :ref:`🔗` - -Notifique al **EditorFileDialog** que su visión de los datos ya no es precisa. Actualiza el contenido de la vista en la próxima actualización de la misma. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_popup_file_dialog: - -.. rst-class:: classref-method - -|void| **popup_file_dialog**\ (\ ) :ref:`🔗` - -Shows the **EditorFileDialog** at the default size and position for file dialogs in the editor, and selects the file name if there is a current file. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_set_filename_filter: - -.. rst-class:: classref-method - -|void| **set_filename_filter**\ (\ filter\: :ref:`String`\ ) :ref:`🔗` - -Establece el valor del filtro para los nombres de archivos. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_set_option_default: - -.. rst-class:: classref-method - -|void| **set_option_default**\ (\ option\: :ref:`int`, default_value_index\: :ref:`int`\ ) :ref:`🔗` - -Sets the default value index of the :ref:`OptionButton` or :ref:`CheckBox` with index ``option``. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_set_option_name: - -.. rst-class:: classref-method - -|void| **set_option_name**\ (\ option\: :ref:`int`, name\: :ref:`String`\ ) :ref:`🔗` - -Sets the name of the :ref:`OptionButton` or :ref:`CheckBox` with index ``option``. - -.. rst-class:: classref-item-separator - ----- - -.. _class_EditorFileDialog_method_set_option_values: - -.. rst-class:: classref-method - -|void| **set_option_values**\ (\ option\: :ref:`int`, values\: :ref:`PackedStringArray`\ ) :ref:`🔗` - -Sets the option values of the :ref:`OptionButton` with index ``option``. +This method is kept for compatibility and does nothing. As an alternative, you can display another dialog after showing the file dialog. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_editorimportplugin.rst b/classes/es/class_editorimportplugin.rst index 99a40615c0..a3f245f8c6 100644 --- a/classes/es/class_editorimportplugin.rst +++ b/classes/es/class_editorimportplugin.rst @@ -149,37 +149,37 @@ Métodos .. table:: :widths: auto - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_can_import_threaded`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`_get_format_version`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`Dictionary`\] | :ref:`_get_import_options`\ (\ path\: :ref:`String`, preset_index\: :ref:`int`\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`_get_import_order`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`_get_importer_name`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_get_option_visibility`\ (\ path\: :ref:`String`, option_name\: :ref:`StringName`, options\: :ref:`Dictionary`\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`_get_preset_count`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`_get_preset_name`\ (\ preset_index\: :ref:`int`\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`_get_priority`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`_get_recognized_extensions`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`_get_resource_type`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`_get_save_extension`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`_get_visible_name`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Error` | :ref:`_import`\ (\ source_file\: :ref:`String`, save_path\: :ref:`String`, options\: :ref:`Dictionary`, platform_variants\: :ref:`Array`\[:ref:`String`\], gen_files\: :ref:`Array`\[:ref:`String`\]\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Error` | :ref:`append_import_external_resource`\ (\ path\: :ref:`String`, custom_options\: :ref:`Dictionary` = {}, custom_importer\: :ref:`String` = "", generator_parameters\: :ref:`Variant` = null\ ) | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`_can_import_threaded`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`_get_format_version`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Array`\[:ref:`Dictionary`\] | :ref:`_get_import_options`\ (\ path\: :ref:`String`, preset_index\: :ref:`int`\ ) |virtual| |required| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`_get_import_order`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`_get_importer_name`\ (\ ) |virtual| |required| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`_get_option_visibility`\ (\ path\: :ref:`String`, option_name\: :ref:`StringName`, options\: :ref:`Dictionary`\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`_get_preset_count`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`_get_preset_name`\ (\ preset_index\: :ref:`int`\ ) |virtual| |required| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`_get_priority`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`_get_recognized_extensions`\ (\ ) |virtual| |required| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`_get_resource_type`\ (\ ) |virtual| |required| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`_get_save_extension`\ (\ ) |virtual| |required| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`_get_visible_name`\ (\ ) |virtual| |required| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`_import`\ (\ source_file\: :ref:`String`, save_path\: :ref:`String`, options\: :ref:`Dictionary`, platform_variants\: :ref:`Array`\[:ref:`String`\], gen_files\: :ref:`Array`\[:ref:`String`\]\ ) |virtual| |required| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`append_import_external_resource`\ (\ path\: :ref:`String`, custom_options\: :ref:`Dictionary` = {}, custom_importer\: :ref:`String` = "", generator_parameters\: :ref:`Variant` = null\ ) | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -198,10 +198,10 @@ Descripciones de Métodos Tells whether this importer can be run in parallel on threads, or, on the contrary, it's only safe for the editor to call it from the main thread, for one file at a time. -If this method is not overridden, it will return ``false`` by default. - If this importer's implementation is thread-safe and can be run in parallel, override this with ``true`` to optimize for concurrency. +If not overridden, returns ``false``. + .. rst-class:: classref-item-separator ---- @@ -214,6 +214,8 @@ If this importer's implementation is thread-safe and can be run in parallel, ove Gets the format version of this importer. Increment this version when making incompatible changes to the format of the imported resources. +If not overridden, the format version is ``0``. + .. rst-class:: classref-item-separator ---- @@ -222,7 +224,7 @@ Gets the format version of this importer. Increment this version when making inc .. rst-class:: classref-method -:ref:`Array`\[:ref:`Dictionary`\] **_get_import_options**\ (\ path\: :ref:`String`, preset_index\: :ref:`int`\ ) |virtual| |const| :ref:`🔗` +:ref:`Array`\[:ref:`Dictionary`\] **_get_import_options**\ (\ path\: :ref:`String`, preset_index\: :ref:`int`\ ) |virtual| |required| |const| :ref:`🔗` Obtiene las opciones y los valores por defecto para el preajuste en este índice. Devuelve un array de diccionarios con las siguientes claves: ``name``, ``default_value``, ``property_hint`` (opcional), ``hint_string`` (opcional), ``uso`` (opcional). @@ -246,7 +248,7 @@ Obtiene el orden de ejecución de este importador al importar recursos. Los impo .. rst-class:: classref-method -:ref:`String` **_get_importer_name**\ (\ ) |virtual| |const| :ref:`🔗` +:ref:`String` **_get_importer_name**\ (\ ) |virtual| |required| |const| :ref:`🔗` Obtiene el nombre único del importador. @@ -299,7 +301,9 @@ Gets whether the import option specified by ``option_name`` should be visible in :ref:`int` **_get_preset_count**\ (\ ) |virtual| |const| :ref:`🔗` -Obtiene el número de ajustes preestablecidos iniciales definidos por el plugin. Utiliza :ref:`_get_import_options()` para obtener las opciones predeterminadas del ajuste preestablecido y :ref:`_get_preset_name()` para obtener su nombre. +Gets the number of initial presets defined by the plugin. Use :ref:`_get_import_options()` to get the default options for the preset and :ref:`_get_preset_name()` to get the name of the preset. + +By default, there are no presets. .. rst-class:: classref-item-separator @@ -309,7 +313,7 @@ Obtiene el número de ajustes preestablecidos iniciales definidos por el plugin. .. rst-class:: classref-method -:ref:`String` **_get_preset_name**\ (\ preset_index\: :ref:`int`\ ) |virtual| |const| :ref:`🔗` +:ref:`String` **_get_preset_name**\ (\ preset_index\: :ref:`int`\ ) |virtual| |required| |const| :ref:`🔗` Obtiene el nombre de las opciones de preajuste en este índice. @@ -333,7 +337,7 @@ Obtiene la prioridad de este plugin para la extensión reconocida. Se preferirá .. rst-class:: classref-method -:ref:`PackedStringArray` **_get_recognized_extensions**\ (\ ) |virtual| |const| :ref:`🔗` +:ref:`PackedStringArray` **_get_recognized_extensions**\ (\ ) |virtual| |required| |const| :ref:`🔗` Obtiene la lista de extensiones de archivos para asociar con este cargador (sin distinción de mayúsculas y minúsculas). Por ejemplo, ``["obj"]``. @@ -345,7 +349,7 @@ Obtiene la lista de extensiones de archivos para asociar con este cargador (sin .. rst-class:: classref-method -:ref:`String` **_get_resource_type**\ (\ ) |virtual| |const| :ref:`🔗` +:ref:`String` **_get_resource_type**\ (\ ) |virtual| |required| |const| :ref:`🔗` Obtiene el tipo de recurso Godot asociado a este cargador. Por ejemplo, ``"Mesh"`` o ``"Animation"``. @@ -357,7 +361,7 @@ Obtiene el tipo de recurso Godot asociado a este cargador. Por ejemplo, ``"Mesh" .. rst-class:: classref-method -:ref:`String` **_get_save_extension**\ (\ ) |virtual| |const| :ref:`🔗` +:ref:`String` **_get_save_extension**\ (\ ) |virtual| |required| |const| :ref:`🔗` Obtiene la extensión utilizada para guardar este recurso en el directorio ``.godot/imported`` (véase :ref:`ProjectSettings.application/config/use_hidden_project_data_directory`). @@ -369,7 +373,7 @@ Obtiene la extensión utilizada para guardar este recurso en el directorio ``.go .. rst-class:: classref-method -:ref:`String` **_get_visible_name**\ (\ ) |virtual| |const| :ref:`🔗` +:ref:`String` **_get_visible_name**\ (\ ) |virtual| |required| |const| :ref:`🔗` Gets the name to display in the import window. You should choose this name as a continuation to "Import as", e.g. "Import as Special Mesh". @@ -381,7 +385,7 @@ Gets the name to display in the import window. You should choose this name as a .. rst-class:: classref-method -:ref:`Error` **_import**\ (\ source_file\: :ref:`String`, save_path\: :ref:`String`, options\: :ref:`Dictionary`, platform_variants\: :ref:`Array`\[:ref:`String`\], gen_files\: :ref:`Array`\[:ref:`String`\]\ ) |virtual| |const| :ref:`🔗` +:ref:`Error` **_import**\ (\ source_file\: :ref:`String`, save_path\: :ref:`String`, options\: :ref:`Dictionary`, platform_variants\: :ref:`Array`\[:ref:`String`\], gen_files\: :ref:`Array`\[:ref:`String`\]\ ) |virtual| |required| |const| :ref:`🔗` Imports ``source_file`` with the import ``options`` specified. Should return :ref:`@GlobalScope.OK` if the import is successful, other values indicate failure. diff --git a/classes/es/class_editorinterface.rst b/classes/es/class_editorinterface.rst index 2166ce9325..fa93a61fa9 100644 --- a/classes/es/class_editorinterface.rst +++ b/classes/es/class_editorinterface.rst @@ -54,6 +54,8 @@ Métodos .. table:: :widths: auto + +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`add_root_node`\ (\ node\: :ref:`Node`\ ) | +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Error` | :ref:`close_scene`\ (\ ) | +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -75,6 +77,8 @@ Métodos +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Node` | :ref:`get_edited_scene_root`\ (\ ) |const| | +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_editor_language`\ (\ ) |const| | + +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`VBoxContainer` | :ref:`get_editor_main_screen`\ (\ ) |const| | +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`EditorPaths` | :ref:`get_editor_paths`\ (\ ) |const| | @@ -97,6 +101,12 @@ Métodos +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`EditorInspector` | :ref:`get_inspector`\ (\ ) |const| | +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_node_3d_rotate_snap`\ (\ ) |const| | + +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_node_3d_scale_snap`\ (\ ) |const| | + +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_node_3d_translate_snap`\ (\ ) |const| | + +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Array`\[:ref:`Node`\] | :ref:`get_open_scene_roots`\ (\ ) |const| | +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedStringArray` | :ref:`get_open_scenes`\ (\ ) |const| | @@ -117,6 +127,10 @@ Métodos +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_multi_window_enabled`\ (\ ) |const| | +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_node_3d_snap_enabled`\ (\ ) |const| | + +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_object_edited`\ (\ object\: :ref:`Object`\ ) |const| | + +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_playing_scene`\ (\ ) |const| | +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_plugin_enabled`\ (\ plugin\: :ref:`String`\ ) |const| | @@ -167,6 +181,8 @@ Métodos +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_main_screen_editor`\ (\ name\: :ref:`String`\ ) | +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_object_edited`\ (\ object\: :ref:`Object`, edited\: :ref:`bool`\ ) | + +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_plugin_enabled`\ (\ plugin\: :ref:`String`, enabled\: :ref:`bool`\ ) | +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`stop_playing_scene`\ (\ ) | @@ -220,6 +236,18 @@ If ``true``, the Movie Maker mode is enabled in the editor. See :ref:`MovieWrite Descripciones de Métodos ------------------------------------------------ +.. _class_EditorInterface_method_add_root_node: + +.. rst-class:: classref-method + +|void| **add_root_node**\ (\ node\: :ref:`Node`\ ) :ref:`🔗` + +Convierte a ``node`` en la raíz de la escena actualmente abierta. Solo funciona si la escena está vacía. Si ``node`` es una instancia de escena, se creará una escena heredada. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorInterface_method_close_scene: .. rst-class:: classref-method @@ -348,6 +376,18 @@ Devuelve la raíz de la escena editada (actual) :ref:`Node`. ---- +.. _class_EditorInterface_method_get_editor_language: + +.. rst-class:: classref-method + +:ref:`String` **get_editor_language**\ (\ ) |const| :ref:`🔗` + +Returns the language currently used for the editor interface. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorInterface_method_get_editor_main_screen: .. rst-class:: classref-method @@ -492,6 +532,42 @@ Devuelve la instancia :ref:`EditorInspector` del editor. ---- +.. _class_EditorInterface_method_get_node_3d_rotate_snap: + +.. rst-class:: classref-method + +:ref:`float` **get_node_3d_rotate_snap**\ (\ ) |const| :ref:`🔗` + +Returns the amount of degrees the 3D editor's rotational snapping is set to. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorInterface_method_get_node_3d_scale_snap: + +.. rst-class:: classref-method + +:ref:`float` **get_node_3d_scale_snap**\ (\ ) |const| :ref:`🔗` + +Returns the amount of units the 3D editor's scale snapping is set to. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorInterface_method_get_node_3d_translate_snap: + +.. rst-class:: classref-method + +:ref:`float` **get_node_3d_translate_snap**\ (\ ) |const| :ref:`🔗` + +Returns the amount of units the 3D editor's translation snapping is set to. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorInterface_method_get_open_scene_roots: .. rst-class:: classref-method @@ -620,6 +696,30 @@ Returns ``true`` if multiple window support is enabled in the editor. Multiple w ---- +.. _class_EditorInterface_method_is_node_3d_snap_enabled: + +.. rst-class:: classref-method + +:ref:`bool` **is_node_3d_snap_enabled**\ (\ ) |const| :ref:`🔗` + +Returns ``true`` if the 3D editor currently has snapping mode enabled, and ``false`` otherwise. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorInterface_method_is_object_edited: + +.. rst-class:: classref-method + +:ref:`bool` **is_object_edited**\ (\ object\: :ref:`Object`\ ) |const| :ref:`🔗` + +Returns ``true`` if the object has been marked as edited through :ref:`set_object_edited()`. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorInterface_method_is_playing_scene: .. rst-class:: classref-method @@ -726,7 +826,7 @@ Reproduce la escena principal. Pops up an editor dialog for creating an object. -The ``callback`` must take a single argument of type :ref:`StringName` which will contain the type name of the selected object or be empty if no item is selected. +The ``callback`` must take a single argument of type :ref:`String`, which will contain the type name of the selected object (or the script path of the type, if the type is created from a script), or be an empty string if no item is selected. The ``base_type`` specifies the base type of objects to display. For example, if you set this to "Resource", all types derived from :ref:`Resource` will display in the create dialog. @@ -972,6 +1072,22 @@ Establece la pantalla principal actual del editor a la especificada en ``name``. ---- +.. _class_EditorInterface_method_set_object_edited: + +.. rst-class:: classref-method + +|void| **set_object_edited**\ (\ object\: :ref:`Object`, edited\: :ref:`bool`\ ) :ref:`🔗` + +If ``edited`` is ``true``, the object is marked as edited. + +\ **Note:** This is primarily used by the editor for :ref:`Resource` based objects to track their modified state. For example, any changes to an open scene, a resource in the inspector, or an edited script will cause this method to be called with ``true``. Saving the scene, script, or resource resets the edited state by calling this method with ``false``. + +\ **Note:** Each call to this method increments the object's edited version. This is used to track changes in the editor and to trigger when thumbnails should be regenerated for resources. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorInterface_method_set_plugin_enabled: .. rst-class:: classref-method diff --git a/classes/es/class_editorpaths.rst b/classes/es/class_editorpaths.rst index 794b58538e..58a389b0a9 100644 --- a/classes/es/class_editorpaths.rst +++ b/classes/es/class_editorpaths.rst @@ -124,7 +124,7 @@ Returns the absolute path to the user's data folder. This folder should be used :ref:`String` **get_project_settings_dir**\ (\ ) |const| :ref:`🔗` -Devuelve la ruta de configuración específica del editor para el proyecto. Todos los proyectos tienen un subdirectorio único dentro de la ruta de ajustes donde se guardan los ajustes específicos del editor para el proyecto. +Returns the relative path to the editor settings for this project. This is usually ``"res://.godot/editor"``. Projects all have a unique subdirectory inside the settings path where project-specific editor settings are saved. .. rst-class:: classref-item-separator diff --git a/classes/es/class_editorplugin.rst b/classes/es/class_editorplugin.rst index 746d63dbb4..be22d1f073 100644 --- a/classes/es/class_editorplugin.rst +++ b/classes/es/class_editorplugin.rst @@ -78,6 +78,8 @@ Métodos +-----------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_make_visible`\ (\ visible\: :ref:`bool`\ ) |virtual| | +-----------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`_run_scene`\ (\ scene\: :ref:`String`, args\: :ref:`PackedStringArray`\ ) |virtual| |const| | + +-----------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_save_external_data`\ (\ ) |virtual| | +-----------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_set_state`\ (\ state\: :ref:`Dictionary`\ ) |virtual| | @@ -98,6 +100,8 @@ Métodos +-----------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`add_debugger_plugin`\ (\ script\: :ref:`EditorDebuggerPlugin`\ ) | +-----------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`add_dock`\ (\ dock\: :ref:`EditorDock`\ ) | + +-----------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`add_export_platform`\ (\ platform\: :ref:`EditorExportPlatform`\ ) | +-----------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`add_export_plugin`\ (\ plugin\: :ref:`EditorExportPlugin`\ ) | @@ -152,6 +156,8 @@ Métodos +-----------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`remove_debugger_plugin`\ (\ script\: :ref:`EditorDebuggerPlugin`\ ) | +-----------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_dock`\ (\ dock\: :ref:`EditorDock`\ ) | + +-----------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`remove_export_platform`\ (\ platform\: :ref:`EditorExportPlatform`\ ) | +-----------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`remove_export_plugin`\ (\ plugin\: :ref:`EditorExportPlugin`\ ) | @@ -383,6 +389,14 @@ Pestaña del cuadro de diálogo Configuración del proyecto, a la derecha de otr enum **DockSlot**: :ref:`🔗` +.. _class_EditorPlugin_constant_DOCK_SLOT_NONE: + +.. rst-class:: classref-enumeration-constant + +:ref:`DockSlot` **DOCK_SLOT_NONE** = ``-1`` + +The dock is closed. + .. _class_EditorPlugin_constant_DOCK_SLOT_LEFT_UL: .. rst-class:: classref-enumeration-constant @@ -447,11 +461,19 @@ Dock slot, right side, upper-right (empty in default layout). Dock slot, right side, bottom-right (empty in default layout). +.. _class_EditorPlugin_constant_DOCK_SLOT_BOTTOM: + +.. rst-class:: classref-enumeration-constant + +:ref:`DockSlot` **DOCK_SLOT_BOTTOM** = ``8`` + +Bottom panel. + .. _class_EditorPlugin_constant_DOCK_SLOT_MAX: .. rst-class:: classref-enumeration-constant -:ref:`DockSlot` **DOCK_SLOT_MAX** = ``8`` +:ref:`DockSlot` **DOCK_SLOT_MAX** = ``9`` Representa el tamaño del enum :ref:`DockSlot`. @@ -1024,6 +1046,26 @@ Recuerda que tienes que gestionar la visibilidad de todos los controles del edit ---- +.. _class_EditorPlugin_private_method__run_scene: + +.. rst-class:: classref-method + +:ref:`PackedStringArray` **_run_scene**\ (\ scene\: :ref:`String`, args\: :ref:`PackedStringArray`\ ) |virtual| |const| :ref:`🔗` + +This function is called when an individual scene is about to be played in the editor. ``args`` is a list of command line arguments that will be passed to the new Godot instance, which will be replaced by the list returned by this function. + +:: + + func _run_scene(scene, args): + args.append("--an-extra-argument") + return args + +\ **Note:** Text that is printed in this method will not be visible in the editor's Output panel unless :ref:`EditorSettings.run/output/always_clear_output_on_play` is ``false``. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorPlugin_private_method__save_external_data: .. rst-class:: classref-method @@ -1106,9 +1148,13 @@ Adds a plugin to the context menu. ``slot`` is the context menu where the plugin :ref:`Button` **add_control_to_bottom_panel**\ (\ control\: :ref:`Control`, title\: :ref:`String`, shortcut\: :ref:`Shortcut` = null\ ) :ref:`🔗` -Adds a control to the bottom panel (together with Output, Debug, Animation, etc.). Returns a reference to the button added. It's up to you to hide/show the button when needed. When your plugin is deactivated, make sure to remove your custom control with :ref:`remove_control_from_bottom_panel()` and free it with :ref:`Node.queue_free()`. +**Obsoleto:** Use :ref:`add_dock()` instead, with :ref:`EditorDock.default_slot` set to :ref:`DOCK_SLOT_BOTTOM`. -Optionally, you can specify a shortcut parameter. When pressed, this shortcut will toggle the bottom panel's visibility. See the default editor bottom panel shortcuts in the Editor Settings for inspiration. Per convention, they all use :kbd:`Alt` modifier. +Adds a control to the bottom panel (together with Output, Debug, Animation, etc.). Returns a reference to a button that is outside the scene tree. It's up to you to hide/show the button when needed. When your plugin is deactivated, make sure to remove your custom control with :ref:`remove_control_from_bottom_panel()` and free it with :ref:`Node.queue_free()`. + +\ ``shortcut`` is a shortcut that, when activated, will toggle the bottom panel's visibility. The shortcut object is only set when this control is added to the bottom panel. + +\ **Note** See the default editor bottom panel shortcuts in the Editor Settings for inspiration. By convention, they all use :kbd:`Alt` modifier. .. rst-class:: classref-item-separator @@ -1136,6 +1182,8 @@ When your plugin is deactivated, make sure to remove your custom control with :r |void| **add_control_to_dock**\ (\ slot\: :ref:`DockSlot`, control\: :ref:`Control`, shortcut\: :ref:`Shortcut` = null\ ) :ref:`🔗` +**Obsoleto:** Use :ref:`add_dock()` instead. + Adds the control to a specific dock slot. If the dock is repositioned and as long as the plugin is active, the editor will save the dock position on further sessions. @@ -1182,6 +1230,20 @@ Adds a :ref:`Script` as debugger plugin to the Debugger. The scrip ---- +.. _class_EditorPlugin_method_add_dock: + +.. rst-class:: classref-method + +|void| **add_dock**\ (\ dock\: :ref:`EditorDock`\ ) :ref:`🔗` + +Adds a new dock. + +When your plugin is deactivated, make sure to remove your custom dock with :ref:`remove_dock()` and free it with :ref:`Node.queue_free()`. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorPlugin_method_add_export_platform: .. rst-class:: classref-method @@ -1494,6 +1556,8 @@ Elimina el plugin del menú contextual especificado. |void| **remove_control_from_bottom_panel**\ (\ control\: :ref:`Control`\ ) :ref:`🔗` +**Obsoleto:** Use :ref:`remove_dock()` instead. + Quita el control del panel inferior. Tienes que manualmente :ref:`Node.queue_free()` el control. .. rst-class:: classref-item-separator @@ -1518,6 +1582,8 @@ Retira el control del contenedor especificado. Tienes que hacer manualmente :ref |void| **remove_control_from_docks**\ (\ control\: :ref:`Control`\ ) :ref:`🔗` +**Obsoleto:** Use :ref:`remove_dock()` instead. + Quita el control del dock. Tienes que manualmente :ref:`Node.queue_free()` el control. .. rst-class:: classref-item-separator @@ -1548,6 +1614,18 @@ Elimina el plugin del depurador con el script dado del depurador. ---- +.. _class_EditorPlugin_method_remove_dock: + +.. rst-class:: classref-method + +|void| **remove_dock**\ (\ dock\: :ref:`EditorDock`\ ) :ref:`🔗` + +Removes ``dock`` from the available docks. You should manually call :ref:`Node.queue_free()` to free it. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorPlugin_method_remove_export_platform: .. rst-class:: classref-method @@ -1686,6 +1764,8 @@ Removes a callback previously added by :ref:`add_undo_redo_inspector_hook_callba |void| **set_dock_tab_icon**\ (\ control\: :ref:`Control`, icon\: :ref:`Texture2D`\ ) :ref:`🔗` +**Obsoleto:** Use :ref:`EditorDock.dock_icon` instead. + Sets the tab icon for the given control in a dock slot. Setting to ``null`` removes the icon. .. rst-class:: classref-item-separator diff --git a/classes/es/class_editorresourcepreviewgenerator.rst b/classes/es/class_editorresourcepreviewgenerator.rst index a6937f569c..e1e90982c9 100644 --- a/classes/es/class_editorresourcepreviewgenerator.rst +++ b/classes/es/class_editorresourcepreviewgenerator.rst @@ -27,13 +27,15 @@ Métodos +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`_can_generate_small_preview`\ (\ ) |virtual| |const| | +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Texture2D` | :ref:`_generate`\ (\ resource\: :ref:`Resource`, size\: :ref:`Vector2i`, metadata\: :ref:`Dictionary`\ ) |virtual| |const| | + | :ref:`Texture2D` | :ref:`_generate`\ (\ resource\: :ref:`Resource`, size\: :ref:`Vector2i`, metadata\: :ref:`Dictionary`\ ) |virtual| |required| |const| | +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Texture2D` | :ref:`_generate_from_path`\ (\ path\: :ref:`String`, size\: :ref:`Vector2i`, metadata\: :ref:`Dictionary`\ ) |virtual| |const| | +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`_generate_small_preview_automatically`\ (\ ) |virtual| |const| | +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_handles`\ (\ type\: :ref:`String`\ ) |virtual| |const| | + | :ref:`bool` | :ref:`_handles`\ (\ type\: :ref:`String`\ ) |virtual| |required| |const| | + +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`request_draw_and_wait`\ (\ viewport\: :ref:`RID`\ ) |const| | +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -63,7 +65,7 @@ By default, it returns ``false``. .. rst-class:: classref-method -:ref:`Texture2D` **_generate**\ (\ resource\: :ref:`Resource`, size\: :ref:`Vector2i`, metadata\: :ref:`Dictionary`\ ) |virtual| |const| :ref:`🔗` +:ref:`Texture2D` **_generate**\ (\ resource\: :ref:`Resource`, size\: :ref:`Vector2i`, metadata\: :ref:`Dictionary`\ ) |virtual| |required| |const| :ref:`🔗` Generate a preview from a given resource with the specified size. This must always be implemented. @@ -113,10 +115,22 @@ By default, it returns ``false``. .. rst-class:: classref-method -:ref:`bool` **_handles**\ (\ type\: :ref:`String`\ ) |virtual| |const| :ref:`🔗` +:ref:`bool` **_handles**\ (\ type\: :ref:`String`\ ) |virtual| |required| |const| :ref:`🔗` Returns ``true`` if your generator supports the resource of type ``type``. +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorResourcePreviewGenerator_method_request_draw_and_wait: + +.. rst-class:: classref-method + +|void| **request_draw_and_wait**\ (\ viewport\: :ref:`RID`\ ) |const| :ref:`🔗` + +Call from within :ref:`_generate()` to request the rendering server draw to the ``viewport``. + .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` diff --git a/classes/es/class_editorsceneformatimporter.rst b/classes/es/class_editorsceneformatimporter.rst index 365f8aab1f..3a5d98b4f1 100644 --- a/classes/es/class_editorsceneformatimporter.rst +++ b/classes/es/class_editorsceneformatimporter.rst @@ -29,13 +29,13 @@ Métodos :widths: auto +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`_get_extensions`\ (\ ) |virtual| |const| | + | :ref:`PackedStringArray` | :ref:`_get_extensions`\ (\ ) |virtual| |required| |const| | +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_get_import_options`\ (\ path\: :ref:`String`\ ) |virtual| | +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Variant` | :ref:`_get_option_visibility`\ (\ path\: :ref:`String`, for_animation\: :ref:`bool`, option\: :ref:`String`\ ) |virtual| |const| | +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Object` | :ref:`_import_scene`\ (\ path\: :ref:`String`, flags\: :ref:`int`, options\: :ref:`Dictionary`\ ) |virtual| | + | :ref:`Object` | :ref:`_import_scene`\ (\ path\: :ref:`String`, flags\: :ref:`int`, options\: :ref:`Dictionary`\ ) |virtual| |required| | +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`add_import_option`\ (\ name\: :ref:`String`, value\: :ref:`Variant`\ ) | +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -148,7 +148,7 @@ Descripciones de Métodos .. rst-class:: classref-method -:ref:`PackedStringArray` **_get_extensions**\ (\ ) |virtual| |const| :ref:`🔗` +:ref:`PackedStringArray` **_get_extensions**\ (\ ) |virtual| |required| |const| :ref:`🔗` Devuelve las extensiones de archivo admitidas para este importador de escena. @@ -188,7 +188,7 @@ Should return ``true`` to show the given option, ``false`` to hide the given opt .. rst-class:: classref-method -:ref:`Object` **_import_scene**\ (\ path\: :ref:`String`, flags\: :ref:`int`, options\: :ref:`Dictionary`\ ) |virtual| :ref:`🔗` +:ref:`Object` **_import_scene**\ (\ path\: :ref:`String`, flags\: :ref:`int`, options\: :ref:`Dictionary`\ ) |virtual| |required| :ref:`🔗` Realiza la mayor parte de la lógica de importación de la escena aquí, por ejemplo, usando :ref:`GLTFDocument` o :ref:`FBXDocument`. diff --git a/classes/es/class_editorscript.rst b/classes/es/class_editorscript.rst index 5d331aa081..fb40ae9c73 100644 --- a/classes/es/class_editorscript.rst +++ b/classes/es/class_editorscript.rst @@ -95,6 +95,8 @@ Este método es ejecutado por el Editor cuando se utiliza **Archivo > Ejecutar** |void| **add_root_node**\ (\ node\: :ref:`Node`\ ) :ref:`🔗` +**Obsoleto:** Use :ref:`EditorInterface.add_root_node()` instead. + Convierte a ``node`` en la raíz de la escena actualmente abierta. Solo funciona si la escena está vacía. Si ``node`` es una instancia de escena, se creará una escena heredada. .. rst-class:: classref-item-separator @@ -121,6 +123,8 @@ Devuelve la instancia singleton :ref:`EditorInterface`. :ref:`Node` **get_scene**\ (\ ) |const| :ref:`🔗` +**Obsoleto:** Use :ref:`EditorInterface.get_edited_scene_root()` instead. + Devuelve la raíz :ref:`Node` de la escena editada (actual). Equivalente de :ref:`EditorInterface.get_edited_scene_root()`. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` diff --git a/classes/es/class_editorsettings.rst b/classes/es/class_editorsettings.rst index 3c7ba90dd3..253a7a95c5 100644 --- a/classes/es/class_editorsettings.rst +++ b/classes/es/class_editorsettings.rst @@ -18,6 +18,8 @@ Object that holds the project-independent editor settings. These settings are ge Property names use slash delimiters to distinguish sections. Setting values can be of any :ref:`Variant` type. It's recommended to use ``snake_case`` for editor settings to be consistent with the Godot editor itself. +Editor settings are saved automatically when changed. + Accessing the settings can be done using the following methods, such as: @@ -190,6 +192,8 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`editors/3d/navigation/zoom_style` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`editors/3d/navigation_feel/angle_snap_threshold` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`editors/3d/navigation_feel/orbit_inertia` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`editors/3d/navigation_feel/orbit_sensitivity` | @@ -220,6 +224,8 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`editors/3d_gizmos/gizmo_colors/gridmap_grid` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Color` | :ref:`editors/3d_gizmos/gizmo_colors/ik_chain` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`editors/3d_gizmos/gizmo_colors/instantiated` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`editors/3d_gizmos/gizmo_colors/joint` | @@ -282,6 +288,8 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`editors/animation/default_fps_mode` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`editors/animation/insert_at_current_time` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`editors/animation/onion_layers_future_color` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`editors/animation/onion_layers_past_color` | @@ -294,8 +302,6 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`editors/bone_mapper/handle_colors/unset` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`editors/grid_map/palette_min_width` | - +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`editors/grid_map/pick_distance` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`editors/grid_map/preview_size` | @@ -416,12 +422,16 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`filesystem/on_save/safe_save_on_backup_then_rename` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`filesystem/on_save/warn_on_saving_large_text_resources` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`filesystem/quick_open_dialog/default_display_mode` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`filesystem/quick_open_dialog/enable_fuzzy_matching` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`filesystem/quick_open_dialog/include_addons` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`filesystem/quick_open_dialog/instant_preview` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`filesystem/quick_open_dialog/max_fuzzy_misses` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`filesystem/quick_open_dialog/max_results` | @@ -440,6 +450,8 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`interface/editor/automatically_open_screenshots` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`interface/editor/bottom_dock_tab_style` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`interface/editor/code_font` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`interface/editor/code_font_contextual_ligatures` | @@ -458,6 +470,8 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`interface/editor/dock_tab_style` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`interface/editor/dragging_hover_wait_seconds` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`interface/editor/editor_language` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`interface/editor/editor_screen` | @@ -486,6 +500,8 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`interface/editor/main_font_bold` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`interface/editor/main_font_custom_opentype_features` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`interface/editor/main_font_size` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`interface/editor/mouse_extra_buttons_navigate_history` | @@ -544,6 +560,8 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`interface/inspector/horizontal_vector_types_editing` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`interface/inspector/integer_drag_speed` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`interface/inspector/max_array_dictionary_items_per_page` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`interface/inspector/nested_color_mode` | @@ -560,6 +578,8 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`interface/multi_window/restore_windows_on_load` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`interface/scene_tabs/auto_select_current_scene_file` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`interface/scene_tabs/display_close_button` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`interface/scene_tabs/maximum_width` | @@ -580,6 +600,8 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`interface/theme/border_size` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`interface/theme/color_preset` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`interface/theme/contrast` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`interface/theme/corner_radius` | @@ -588,18 +610,20 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`interface/theme/draw_extra_borders` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`interface/theme/draw_relationship_lines` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`interface/theme/follow_system_theme` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`interface/theme/icon_and_font_color` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`interface/theme/icon_saturation` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`interface/theme/preset` | - +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`interface/theme/relationship_line_opacity` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`interface/theme/spacing_preset` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`interface/theme/style` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`interface/theme/use_system_accent_color` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`interface/touchscreen/enable_long_press_as_right_click` | @@ -900,6 +924,8 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`text_editor/theme/highlighting/string_color` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Color` | :ref:`text_editor/theme/highlighting/string_placeholder_color` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`text_editor/theme/highlighting/symbol_color` | +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`text_editor/theme/highlighting/text_color` | @@ -930,6 +956,8 @@ Métodos +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`add_property_info`\ (\ info\: :ref:`Dictionary`\ ) | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`add_shortcut`\ (\ path\: :ref:`String`, shortcut\: :ref:`Shortcut`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`check_changed_settings_in_group`\ (\ setting_prefix\: :ref:`String`\ ) |const| | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`erase`\ (\ property\: :ref:`String`\ ) | @@ -944,10 +972,20 @@ Métodos +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Variant` | :ref:`get_setting`\ (\ name\: :ref:`String`\ ) |const| | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Shortcut` | :ref:`get_shortcut`\ (\ path\: :ref:`String`\ ) |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`get_shortcut_list`\ (\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_setting`\ (\ name\: :ref:`String`\ ) |const| | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_shortcut`\ (\ path\: :ref:`String`\ ) |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_shortcut`\ (\ path\: :ref:`String`, event\: :ref:`InputEvent`\ ) |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`mark_setting_changed`\ (\ setting\: :ref:`String`\ ) | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_shortcut`\ (\ path\: :ref:`String`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_builtin_action_override`\ (\ name\: :ref:`String`, actions_list\: :ref:`Array`\[:ref:`InputEvent`\]\ ) | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_favorites`\ (\ dirs\: :ref:`PackedStringArray`\ ) | @@ -1864,6 +1902,18 @@ La dirección del movimiento del cursor del ratón a usar al hacer zoom moviendo ---- +.. _class_EditorSettings_property_editors/3d/navigation_feel/angle_snap_threshold: + +.. rst-class:: classref-property + +:ref:`float` **editors/3d/navigation_feel/angle_snap_threshold** :ref:`🔗` + +The angle threshold for snapping camera rotation to 45-degree angles while orbiting with :kbd:`Alt` held. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_property_editors/3d/navigation_feel/orbit_inertia: .. rst-class:: classref-property @@ -2044,6 +2094,18 @@ El color del gizmo del editor 3D para la cuadrícula de :ref:`GridMap` **editors/3d_gizmos/gizmo_colors/ik_chain** :ref:`🔗` + +The 3D editor gizmo color for the :ref:`IKModifier3D` guides. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_property_editors/3d_gizmos/gizmo_colors/instantiated: .. rst-class:: classref-property @@ -2420,6 +2482,20 @@ Default step mode for :ref:`AnimationPlayer` (seconds or ---- +.. _class_EditorSettings_property_editors/animation/insert_at_current_time: + +.. rst-class:: classref-property + +:ref:`bool` **editors/animation/insert_at_current_time** :ref:`🔗` + +If ``true``, animation keys and markers are inserted at the current time in the animation. + +If ``false``, they are inserted at the mouse cursor's position. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_property_editors/animation/onion_layers_future_color: .. rst-class:: classref-property @@ -2500,18 +2576,6 @@ The modulate color to use for "past" frames displayed in the animation editor's ---- -.. _class_EditorSettings_property_editors/grid_map/palette_min_width: - -.. rst-class:: classref-property - -:ref:`int` **editors/grid_map/palette_min_width** :ref:`🔗` - -Minimum width of GridMap's mesh palette side panel. - -.. rst-class:: classref-item-separator - ----- - .. _class_EditorSettings_property_editors/grid_map/pick_distance: .. rst-class:: classref-property @@ -3297,6 +3361,20 @@ Si es ``true``, al guardar un archivo, el editor renombrará el archivo antiguo ---- +.. _class_EditorSettings_property_filesystem/on_save/warn_on_saving_large_text_resources: + +.. rst-class:: classref-property + +:ref:`bool` **filesystem/on_save/warn_on_saving_large_text_resources** :ref:`🔗` + +If ``true``, displays a warning toast message when saving a text-based scene or resource that is larger than 500 KiB on disk. This is typically caused by binary subresources being embedded as text, which results in slow and inefficient conversion to text. This in turn impacts scene saving and loading times. + +This should usually be resolved by moving the embedded binary subresource to its own binary resource file (``.res`` extension instead of ``.tres``). This is the preferred approach. Alternatively, the entire scene can be saved with the binary ``.scn`` format as opposed to ``.tscn``, but this will make it less friendly to version control systems. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_property_filesystem/quick_open_dialog/default_display_mode: .. rst-class:: classref-property @@ -3337,6 +3415,18 @@ Si es ``true``, los resultados incluirán archivos ubicados en la carpeta ``addo ---- +.. _class_EditorSettings_property_filesystem/quick_open_dialog/instant_preview: + +.. rst-class:: classref-property + +:ref:`bool` **filesystem/quick_open_dialog/instant_preview** :ref:`🔗` + +If ``true``, highlighting a resource will preview it quickly without confirming the selection or closing the dialog. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_property_filesystem/quick_open_dialog/max_fuzzy_misses: .. rst-class:: classref-property @@ -3433,7 +3523,7 @@ Editor accessibility support mode: - **Disabled** (``2``): Accessibility support is fully disabled. -\ **Note:** Accessibility debugging tools, such as Accessibility Insights for Windows, Accessibility Inspector (macOS), or AT-SPI Browser (Linux/BSD) do not count as assistive apps. To test your project with these tools, use **Always Active**. +\ **Note:** Accessibility debugging tools, such as Accessibility Insights for Windows, Accessibility Inspector (macOS), or AT-SPI Browser (Linux/BSD), do not count as assistive apps. To test the editor with these tools, use **Always Active**. .. rst-class:: classref-item-separator @@ -3445,13 +3535,15 @@ Editor accessibility support mode: :ref:`int` **interface/editor/accept_dialog_cancel_ok_buttons** :ref:`🔗` -How to position the Cancel and OK buttons in the editor's :ref:`AcceptDialog`\ s. Different platforms have different standard behaviors for this, which can be overridden using this setting. This is useful if you use Godot both on Windows and macOS/Linux and your Godot muscle memory is stronger than your OS specific one. +How to position the Cancel and OK buttons in the editor's :ref:`AcceptDialog` windows. Different platforms have different conventions for this, which can be overridden through this setting to avoid accidental clicks when using Godot on multiple platforms. -- **Auto** follows the platform convention: OK first on Windows, KDE, and LXQt, Cancel first on macOS and other Linux desktop environments. +- **Auto** follows the platform convention: OK first on Windows, KDE, and LXQt; Cancel first on macOS and other Linux desktop environments. -- **Cancel First** forces the ordering Cancel/OK. +- **Cancel First** forces the Cancel/OK ordering. -- **OK First** forces the ordering OK/Cancel. +- **OK First** forces the OK/Cancel ordering. + +To check if these buttons are swapped at runtime, use :ref:`DisplayServer.get_swap_cancel_ok()`. .. rst-class:: classref-item-separator @@ -3469,6 +3561,18 @@ If ``true``, automatically opens screenshots with the default program associated ---- +.. _class_EditorSettings_property_interface/editor/bottom_dock_tab_style: + +.. rst-class:: classref-property + +:ref:`int` **interface/editor/bottom_dock_tab_style** :ref:`🔗` + +Tab style of editor docks located at the bottom. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_property_interface/editor/code_font: .. rst-class:: classref-property @@ -3587,7 +3691,19 @@ If set to **Custom**, the scaling value in :ref:`interface/editor/custom_display :ref:`int` **interface/editor/dock_tab_style** :ref:`🔗` -Tab style of editor docks. +Tab style of editor docks, except bottom docks. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_property_interface/editor/dragging_hover_wait_seconds: + +.. rst-class:: classref-property + +:ref:`float` **interface/editor/dragging_hover_wait_seconds** :ref:`🔗` + +During a drag-and-drop, this is how long to wait over a UI element before it triggers a reaction (e.g. a section unfolds to show nested items). .. rst-class:: classref-item-separator @@ -3599,7 +3715,7 @@ Tab style of editor docks. :ref:`String` **interface/editor/editor_language** :ref:`🔗` -The language to use for the editor interface. +The language to use for the editor interface. If set to **Auto**, the language is automatically determined based on the system locale. See also :ref:`EditorInterface.get_editor_language()`. Translations are provided by the community. If you spot a mistake, `contribute to editor translations on Weblate! `__ @@ -3781,6 +3897,22 @@ La fuente que se usará para el texto en negrita en la interfaz del editor. Debe ---- +.. _class_EditorSettings_property_interface/editor/main_font_custom_opentype_features: + +.. rst-class:: classref-property + +:ref:`String` **interface/editor/main_font_custom_opentype_features** :ref:`🔗` + +List of custom OpenType features to use, if supported by the currently configured main font. Check what OpenType features are supported by your font first. + +The string should follow the OpenType specification, e.g. ``ss01,tnum,calt=false``. Microsoft's documentation contains a list of `all registered features `__. + +\ **Note:** The default editor main font (`Inter `__) has custom OpenType features in its font file, with ``ss04`` and ``tnum`` enabled and ``calt`` disabled by default. Supported features can be found at its website. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_property_interface/editor/main_font_size: .. rst-class:: classref-property @@ -4167,6 +4299,18 @@ Si es ``true``, las propiedades :ref:`Vector3`, :ref:`Vector3i` **interface/inspector/integer_drag_speed** :ref:`🔗` + +Base speed for increasing/decreasing integer values by dragging them in the inspector. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_property_interface/inspector/max_array_dictionary_items_per_page: .. rst-class:: classref-property @@ -4277,6 +4421,18 @@ Si es ``true``, la posición, el tamaño y la pantalla del panel flotante se gua ---- +.. _class_EditorSettings_property_interface/scene_tabs/auto_select_current_scene_file: + +.. rst-class:: classref-property + +:ref:`bool` **interface/scene_tabs/auto_select_current_scene_file** :ref:`🔗` + +If ``true``, the FileSystem dock will automatically navigate to the currently selected scene tab. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_property_interface/scene_tabs/display_close_button: .. rst-class:: classref-property @@ -4401,6 +4557,18 @@ El tamaño del borde que se usará para los elementos de la interfaz (en píxele ---- +.. _class_EditorSettings_property_interface/theme/color_preset: + +.. rst-class:: classref-property + +:ref:`String` **interface/theme/color_preset** :ref:`🔗` + +The editor color preset to use. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_property_interface/theme/contrast: .. rst-class:: classref-property @@ -4449,6 +4617,24 @@ Si es ``true``, dibuja bordes adicionales alrededor de los elementos interactivo ---- +.. _class_EditorSettings_property_interface/theme/draw_relationship_lines: + +.. rst-class:: classref-property + +:ref:`int` **interface/theme/draw_relationship_lines** :ref:`🔗` + +What relationship lines to draw in the editor's :ref:`Tree`-based GUIs (such as the Scene tree dock). + +- **None** will make it so that no relationship lines are drawn. + +- **Selected Only** will only draw them for selected items. + +- **All** will always draw them for all items. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_property_interface/theme/follow_system_theme: .. rst-class:: classref-property @@ -4493,18 +4679,6 @@ La saturación que se usará para los iconos del editor. Los valores más altos ---- -.. _class_EditorSettings_property_interface/theme/preset: - -.. rst-class:: classref-property - -:ref:`String` **interface/theme/preset** :ref:`🔗` - -El tema del editor preestablecido a utilizar. - -.. rst-class:: classref-item-separator - ----- - .. _class_EditorSettings_property_interface/theme/relationship_line_opacity: .. rst-class:: classref-property @@ -4529,6 +4703,18 @@ El preajuste de espaciado del tema del editor que se utilizará. Véase también ---- +.. _class_EditorSettings_property_interface/theme/style: + +.. rst-class:: classref-property + +:ref:`String` **interface/theme/style** :ref:`🔗` + +The editor theme style to use. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_property_interface/theme/use_system_accent_color: .. rst-class:: classref-property @@ -4577,7 +4763,7 @@ Si es ``true``, habilita los gestos de desplazamiento y escala con dos dedos en :ref:`bool` **interface/touchscreen/enable_touch_optimizations** :ref:`🔗` -If ``true``, increases the scrollbar touch area and enables a larger dragger for split containers to improve usability on touchscreen devices +If ``true``, increases the scrollbar touch area, enables a larger dragger for split containers, and increases PopupMenu vertical separation to improve usability on touchscreen devices. \ **Note:** Defaults to ``true`` on touchscreen devices. @@ -4641,9 +4827,9 @@ Todos los modos de actualización ignorarán las compilaciones con diferentes ve :ref:`int` **network/connection/network_mode** :ref:`🔗` -Determina si las funciones en línea están habilitadas en el editor, como la Asset Library o las comprobaciones de actualización. Deshabilitar estas funciones en línea ayuda a aliviar las preocupaciones de privacidad al evitar que el editor realice solicitudes HTTP al sitio web de Godot o a plataformas de terceros que alojan activos de la Asset Library. +Determines whether online features, such as the Asset Library or update checks, are enabled in the editor. If this is a privacy concern, disabling these online features prevents the editor from making HTTP requests to the Godot website or third-party platforms hosting assets from the Asset Library. -Se recomienda que los plugins del editor y los scripts de herramientas sigan esta configuración. Sin embargo, Godot no puede evitar que violen esta regla. +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 @@ -4707,7 +4893,7 @@ El número de puerto a utilizar para contactar con el proxy HTTP y HTTPS en el e :ref:`String` **network/tls/editor_tls_certificates** :ref:`🔗` -The TLS certificate bundle to use for HTTP requests made within the editor (e.g. from the AssetLib tab). If left empty, the `included Mozilla certificate bundle `__ will be used. +The TLS certificate bundle to use for HTTP requests made within the editor (e.g. from the AssetLib tab). If left empty, the `included Mozilla certificate bundle `__ will be used. .. rst-class:: classref-item-separator @@ -4745,7 +4931,7 @@ El tipo de renderizador que se marcará por defecto al crear un nuevo proyecto. :ref:`int` **project_manager/directory_naming_convention** :ref:`🔗` -Convención de nomenclatura de directorios para el administrador de proyectos. Las opciones son "Sin convención" (el nombre del proyecto es el nombre del directorio), "kebab-case" (predeterminado), "snake_case", "camelCase", "PascalCase" o "Title Case". +Directory naming convention for the project manager. Options are "No Convention" (project name is directory name), "kebab-case" (default), "snake_case", "camelCase", "PascalCase", or "Title Case". .. rst-class:: classref-item-separator @@ -5403,7 +5589,7 @@ Si es ``true``, el cursor se moverá al hacer clic derecho en algún lugar del e :ref:`bool` **text_editor/behavior/navigation/open_script_when_connecting_signal_to_existing_method** :ref:`🔗` -Si es ``true``, se abre el editor de código al conectar una señal a un código existente desde el panel lateral de nodos. +If ``true``, opens the script editor when connecting a signal to an existing script method from the Signals dock. .. rst-class:: classref-item-separator @@ -5515,15 +5701,15 @@ If ``true``, uses :ref:`StringName` instead of :ref:`String` **text_editor/completion/add_type_hints** :ref:`🔗` -Si es ``true``, añade automáticamente :doc:`tipado estático de GDScript <../tutorials/scripting/gdscript/static_typing>` (como ``-> void`` y ``: int``) en muchas situaciones donde es posible, incluyendo cuando: +If ``true``, automatically adds :doc:`GDScript static typing <../tutorials/scripting/gdscript/static_typing>` (such as ``-> void`` and ``: int``) in many situations where it's possible to, including when: -- Aceptas una sugerencia del completado automático de código; +- Accepting a suggestion from code autocompletion; -- Creas un nuevo script desde una plantilla; +- Creating a new script from a template; -- Conectas señales desde el dock del Nodo; +- Connecting signals from the Signals dock; -- Creas variables prefijadas con :ref:`@GDScript.@onready`, arrastrando nodos desde el dock de la Escena al editor de scripts mientras mantienes pulsado :kbd:`Ctrl`. +- Creating variables prefixed with :ref:`@GDScript.@onready`, by dropping nodes from the Scene dock into the script editor while holding :kbd:`Ctrl`. .. rst-class:: classref-item-separator @@ -5811,7 +5997,7 @@ Cuántos nombres de script se pueden resaltar como máximo, si :ref:`text_editor :ref:`bool` **text_editor/script_list/show_members_overview** :ref:`🔗` -Si es ``true``, muestra una vista general de las variables miembro y las funciones del script actual a la izquierda del editor de scripts. Véase también :ref:`text_editor/script_list/sort_members_outline_alphabetically`. +If ``true``, displays an overview of the current script's member functions at the left of the script editor. See also :ref:`text_editor/script_list/sort_members_outline_alphabetically`. .. rst-class:: classref-item-separator @@ -6415,6 +6601,20 @@ El color del editor de scripts para strings de texto (de una o varias líneas). ---- +.. _class_EditorSettings_property_text_editor/theme/highlighting/string_placeholder_color: + +.. rst-class:: classref-property + +:ref:`Color` **text_editor/theme/highlighting/string_placeholder_color** :ref:`🔗` + +The script editor's color for string placeholders, such as ``%s`` and ``{_}``. Refer to the :doc:`GDScript format strings documentation <../tutorials/scripting/gdscript/gdscript_format_string>` for more details. + +\ **Note:** Only the default ``{_}`` placeholder patterns are highlighted for the :ref:`String.format()` method. Custom patterns still appear as plain strings. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_property_text_editor/theme/highlighting/symbol_color: .. rst-class:: classref-property @@ -6576,6 +6776,43 @@ Adds a custom property info to a property. The dictionary must contain: +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_method_add_shortcut: + +.. rst-class:: classref-method + +|void| **add_shortcut**\ (\ path\: :ref:`String`, shortcut\: :ref:`Shortcut`\ ) :ref:`🔗` + +Adds a ``shortcut`` whose path is specified by ``path``. + +The ``path`` determines how the shortcut is organized and displayed in the editor's shortcut settings. The path format affects the display as follows: + +- ``"name"`` (no slash): Creates a category named ``name`` with the shortcut displayed as ``name``. + +- ``"category/name"`` (single slash): Displays as ``name`` in the ``category`` section. + +- ``"category/name/extra"`` (multiple slashes): Extra path components are ignored, so this behaves the same as ``"category/name"``. + +\ **Note:** Shortcuts are only saved to the editor settings if they differ from their original/default state. This means empty shortcuts that were originally empty will not persist between editor sessions and must be re-added. If a shortcut with the same ``path`` already exists, this method will update it with the new ``shortcut`` instead of creating a duplicate. + +:: + + # Add a custom shortcut for a plugin action. + var my_shortcut = Shortcut.new() + var input_event = InputEventKey.new() + input_event.keycode = KEY_F5 + input_event.ctrl_pressed = true + my_shortcut.events.append(input_event) + + # This will appear under the "My Plugin" category as "Reload Data". + EditorInterface.get_editor_settings().add_shortcut("my_plugin/reload_data", my_shortcut) + + # This will appear under the "Test Action" category as "Test Action". + EditorInterface.get_editor_settings().add_shortcut("test_action", my_shortcut) + .. rst-class:: classref-item-separator ---- @@ -6664,6 +6901,30 @@ Devuelve el valor del ajuste especificado por ``name``. Esto es equivalente a us ---- +.. _class_EditorSettings_method_get_shortcut: + +.. rst-class:: classref-method + +:ref:`Shortcut` **get_shortcut**\ (\ path\: :ref:`String`\ ) |const| :ref:`🔗` + +Returns the shortcut specified by ``path``. Tries to find a built-in action if no shortcut with the provided path is found in the shortcut list. If found, adds it to the list and returns it, otherwise returns ``null``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_method_get_shortcut_list: + +.. rst-class:: classref-method + +:ref:`PackedStringArray` **get_shortcut_list**\ (\ ) :ref:`🔗` + +Returns the list of stored shortcut paths. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_method_has_setting: .. rst-class:: classref-method @@ -6676,6 +6937,30 @@ Devuelve ``true`` si el ajuste especificado por ``name`` existe, ``false`` en ca ---- +.. _class_EditorSettings_method_has_shortcut: + +.. rst-class:: classref-method + +:ref:`bool` **has_shortcut**\ (\ path\: :ref:`String`\ ) |const| :ref:`🔗` + +Returns ``true`` if the shortcut specified by ``path`` exists, ``false`` otherwise. + +.. rst-class:: classref-item-separator + +---- + +.. _class_EditorSettings_method_is_shortcut: + +.. rst-class:: classref-method + +:ref:`bool` **is_shortcut**\ (\ path\: :ref:`String`, event\: :ref:`InputEvent`\ ) |const| :ref:`🔗` + +Returns ``true`` if the shortcut specified by ``path`` matches the event specified by ``event``, ``false`` otherwise. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_method_mark_setting_changed: .. rst-class:: classref-method @@ -6688,6 +6973,18 @@ Marca el ajuste del editor pasado como modificado, véase :ref:`get_changed_sett ---- +.. _class_EditorSettings_method_remove_shortcut: + +.. rst-class:: classref-method + +|void| **remove_shortcut**\ (\ path\: :ref:`String`\ ) :ref:`🔗` + +Removes the shortcut specified by ``path``. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSettings_method_set_builtin_action_override: .. rst-class:: classref-method diff --git a/classes/es/class_editorspinslider.rst b/classes/es/class_editorspinslider.rst index 07f8560c3f..c85b78e262 100644 --- a/classes/es/class_editorspinslider.rst +++ b/classes/es/class_editorspinslider.rst @@ -26,25 +26,27 @@ Propiedades .. table:: :widths: auto - +--------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`editing_integer` | ``false`` | - +--------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`flat` | ``false`` | - +--------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ - | :ref:`FocusMode` | focus_mode | ``2`` (overrides :ref:`Control`) | - +--------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`hide_slider` | ``false`` | - +--------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`label` | ``""`` | - +--------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`read_only` | ``false`` | - +--------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ - | |bitfield|\[:ref:`SizeFlags`\] | size_flags_vertical | ``1`` (overrides :ref:`Control`) | - +--------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ - | :ref:`float` | step | ``1.0`` (overrides :ref:`Range`) | - +--------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`suffix` | ``""`` | - +--------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ + +---------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | :ref:`ControlState` | :ref:`control_state` | ``0`` | + +---------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`editing_integer` | ``false`` | + +---------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`flat` | ``false`` | + +---------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | :ref:`FocusMode` | focus_mode | ``2`` (overrides :ref:`Control`) | + +---------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`hide_slider` | ``false`` | + +---------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`label` | ``""`` | + +---------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`read_only` | ``false`` | + +---------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | |bitfield|\[:ref:`SizeFlags`\] | size_flags_vertical | ``1`` (overrides :ref:`Control`) | + +---------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | :ref:`float` | step | ``1.0`` (overrides :ref:`Range`) | + +---------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`suffix` | ``""`` | + +---------------------------------------------------------+-------------------------------------------------------------------------+------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -131,9 +133,65 @@ Emitida cuando el formulario del valor pierde el foco. .. rst-class:: classref-descriptions-group +Enumeraciones +-------------------------- + +.. _enum_EditorSpinSlider_ControlState: + +.. rst-class:: classref-enumeration + +enum **ControlState**: :ref:`🔗` + +.. _class_EditorSpinSlider_constant_CONTROL_STATE_DEFAULT: + +.. rst-class:: classref-enumeration-constant + +:ref:`ControlState` **CONTROL_STATE_DEFAULT** = ``0`` + +The type of control used will depend on the value of :ref:`editing_integer`. Up-down arrows if ``true``, a slider if ``false``. + +.. _class_EditorSpinSlider_constant_CONTROL_STATE_PREFER_SLIDER: + +.. rst-class:: classref-enumeration-constant + +:ref:`ControlState` **CONTROL_STATE_PREFER_SLIDER** = ``1`` + +A slider will always be used, even if :ref:`editing_integer` is enabled. + +.. _class_EditorSpinSlider_constant_CONTROL_STATE_HIDE: + +.. rst-class:: classref-enumeration-constant + +:ref:`ControlState` **CONTROL_STATE_HIDE** = ``2`` + +Neither the up-down arrows nor the slider will be shown. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + Descripciones de Propiedades -------------------------------------------------------- +.. _class_EditorSpinSlider_property_control_state: + +.. rst-class:: classref-property + +:ref:`ControlState` **control_state** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_control_state**\ (\ value\: :ref:`ControlState`\ ) +- :ref:`ControlState` **get_control_state**\ (\ ) + +The state in which the control used to manipulate the value will be. + +.. rst-class:: classref-item-separator + +---- + .. _class_EditorSpinSlider_property_editing_integer: .. rst-class:: classref-property @@ -145,7 +203,7 @@ Descripciones de Propiedades - |void| **set_editing_integer**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_editing_integer**\ (\ ) -Si es ``true``, se considera que **EditorSpinSlider** está editando un valor entero. Si es ``false``, se considera que **EditorSpinSlider** está editando un valor de punto flotante. Esto se utiliza para determinar si se debe dibujar un deslizador. El deslizador solo se dibuja para floats; los enteros usan flechas arriba-abajo similares a :ref:`SpinBox` en su lugar. +If ``true``, the **EditorSpinSlider** is considered to be editing an integer value. If ``false``, the **EditorSpinSlider** is considered to be editing a floating-point value. This is used to determine whether a slider should be drawn by default. The slider is only drawn for floats; integers use up-down arrows similar to :ref:`SpinBox` instead, unless :ref:`control_state` is set to :ref:`CONTROL_STATE_PREFER_SLIDER`. It will also use :ref:`EditorSettings.interface/inspector/integer_drag_speed` instead of :ref:`EditorSettings.interface/inspector/float_drag_speed` if the slider is available. .. rst-class:: classref-item-separator @@ -179,6 +237,8 @@ Si es ``true``, el deslizador no dibujará el fondo. - |void| **set_hide_slider**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_hiding_slider**\ (\ ) +**Obsoleto:** Use :ref:`control_state` instead. + Si es ``true``, el deslizador y las flechas arriba/abajo están ocultas. .. rst-class:: classref-item-separator diff --git a/classes/es/class_editortoaster.rst b/classes/es/class_editortoaster.rst index 30fbf3cd14..181fe863c3 100644 --- a/classes/es/class_editortoaster.rst +++ b/classes/es/class_editortoaster.rst @@ -14,9 +14,9 @@ Gestiona las notificaciones toast dentro del editor. Descripción ---------------------- -Este objeto gestiona la funcionalidad y la visualización de las notificaciones toast dentro del editor, asegurando que se presenten alertas oportunas e informativas a los usuarios. +This object manages the functionality and display of toast notifications within the editor, ensuring immediate and informative alerts are presented to the user. -\ **Nota:** Esta clase no debe ser instanciada directamente. En su lugar, accede al singleton usando :ref:`EditorInterface.get_editor_toaster()`. +\ **Note:** This class shouldn't be instantiated directly. Instead, access the singleton using :ref:`EditorInterface.get_editor_toaster()`. .. rst-class:: classref-reftable-group diff --git a/classes/es/class_editortranslationparserplugin.rst b/classes/es/class_editortranslationparserplugin.rst index 0897dec61f..c3ab5eeee0 100644 --- a/classes/es/class_editortranslationparserplugin.rst +++ b/classes/es/class_editortranslationparserplugin.rst @@ -16,11 +16,11 @@ Descripción **EditorTranslationParserPlugin** is invoked when a file is being parsed to extract strings that require translation. To define the parsing and string extraction logic, override the :ref:`_parse_file()` method in script. -The return value should be an :ref:`Array` of :ref:`PackedStringArray`\ s, one for each extracted translatable string. Each entry should contain ``[msgid, msgctxt, msgid_plural, comment]``, where all except ``msgid`` are optional. Empty strings will be ignored. +The return value should be an :ref:`Array` of :ref:`PackedStringArray`\ s, one for each extracted translatable string. Each entry should contain ``[msgid, msgctxt, msgid_plural, comment, source_line]``, where all except ``msgid`` are optional. Empty strings will be ignored. -The extracted strings will be written into a POT file selected by user under "POT Generation" in "Localization" tab in "Project Settings" menu. +The extracted strings will be written into a translation template file selected by user under "Template Generation" in "Localization" tab in "Project Settings" menu. -Below shows an example of a custom parser that extracts strings from a CSV file to write into a POT. +Below shows an example of a custom parser that extracts strings from a CSV file to write into a template. .. tabs:: @@ -73,15 +73,15 @@ Below shows an example of a custom parser that extracts strings from a CSV file -To add a translatable string associated with a context, plural, or comment: +To add a translatable string associated with a context, plural, comment, or source line: .. tabs:: .. code-tab:: gdscript - # This will add a message with msgid "Test 1", msgctxt "context", msgid_plural "test 1 plurals", and comment "test 1 comment". - ret.append(PackedStringArray(["Test 1", "context", "test 1 plurals", "test 1 comment"])) + # This will add a message with msgid "Test 1", msgctxt "context", msgid_plural "test 1 plurals", comment "test 1 comment", and source line "7". + ret.append(PackedStringArray(["Test 1", "context", "test 1 plurals", "test 1 comment", "7"])) # This will add a message with msgid "A test without context" and msgid_plural "plurals". ret.append(PackedStringArray(["A test without context", "", "plurals"])) # This will add a message with msgid "Only with context" and msgctxt "a friendly context". @@ -89,8 +89,8 @@ To add a translatable string associated with a context, plural, or comment: .. code-tab:: csharp - // This will add a message with msgid "Test 1", msgctxt "context", msgid_plural "test 1 plurals", and comment "test 1 comment". - ret.Add(["Test 1", "context", "test 1 plurals", "test 1 comment"]); + // This will add a message with msgid "Test 1", msgctxt "context", msgid_plural "test 1 plurals", comment "test 1 comment", and source line "7". + ret.Add(["Test 1", "context", "test 1 plurals", "test 1 comment", "7"]); // This will add a message with msgid "A test without context" and msgid_plural "plurals". ret.Add(["A test without context", "", "plurals"]); // This will add a message with msgid "Only with context" and msgctxt "a friendly context". diff --git a/classes/es/class_engine.rst b/classes/es/class_engine.rst index f417eb3302..cf58d320fa 100644 --- a/classes/es/class_engine.rst +++ b/classes/es/class_engine.rst @@ -128,11 +128,9 @@ The maximum number of frames that can be rendered every second (FPS). A value of Limiting the FPS can be useful to reduce the host machine's power consumption, which reduces heat, noise emissions, and improves battery life. -If :ref:`ProjectSettings.display/window/vsync/vsync_mode` is **Enabled** or **Adaptive**, the setting takes precedence and the max FPS number cannot exceed the monitor's refresh rate. +If :ref:`ProjectSettings.display/window/vsync/vsync_mode` is **Enabled** or **Adaptive**, the setting takes precedence and the max FPS number cannot exceed the monitor's refresh rate. See also :ref:`DisplayServer.screen_get_refresh_rate()`. -If :ref:`ProjectSettings.display/window/vsync/vsync_mode` is **Enabled**, on monitors with variable refresh rate enabled (G-Sync/FreeSync), using an FPS limit a few frames lower than the monitor's refresh rate will `reduce input lag while avoiding tearing `__. - -See also :ref:`physics_ticks_per_second` and :ref:`ProjectSettings.application/run/max_fps`. +If :ref:`ProjectSettings.display/window/vsync/vsync_mode` is **Enabled**, on monitors with variable refresh rate enabled (G-Sync/FreeSync), using an FPS limit a few frames lower than the monitor's refresh rate will `reduce input lag while avoiding tearing `__. At higher refresh rates, the difference between the FPS limit and the monitor refresh rate should be increased to ensure frames to account for timing inaccuracies. The optimal formula for the FPS limit value in this scenario is ``r - (r * r) / 3600.0``, where ``r`` is the monitor's refresh rate. \ **Note:** The actual number of frames per second may still be below this value if the CPU or GPU cannot keep up with the project's logic and rendering. diff --git a/classes/es/class_environment.rst b/classes/es/class_environment.rst index 17ab06a477..ef2a085be0 100644 --- a/classes/es/class_environment.rst +++ b/classes/es/class_environment.rst @@ -14,15 +14,17 @@ Recurso para nodos del entorno (como :ref:`WorldEnvironment`) que definen múltiples operaciones de entorno (como :ref:`Sky` o :ref:`Color` de fondo, luz ambiental, niebla, profundidad de campo...). Estos parámetros afectan el render final de la escena. El orden de estas operaciones es: +Resource for environment nodes (like :ref:`WorldEnvironment`) that define multiple environment operations (such as background :ref:`Sky` or :ref:`Color`, ambient light, fog, depth-of-field...). These parameters affect the final render of the scene. The order of these operations is: -- Desenfoque de profundidad de campo +- Depth of Field Blur -- Resplandor +- Auto Exposure -- Asignación de tonos (exposición automática) +- Glow -- Ajustes +- Tonemap + +- Adjustments .. rst-class:: classref-introduction-group @@ -102,7 +104,7 @@ Propiedades +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`float` | :ref:`fog_sun_scatter` | ``0.0`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ - | :ref:`GlowBlendMode` | :ref:`glow_blend_mode` | ``2`` | + | :ref:`GlowBlendMode` | :ref:`glow_blend_mode` | ``1`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`float` | :ref:`glow_bloom` | ``0.0`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ @@ -114,17 +116,17 @@ Propiedades +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`float` | :ref:`glow_hdr_threshold` | ``1.0`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ - | :ref:`float` | :ref:`glow_intensity` | ``0.8`` | + | :ref:`float` | :ref:`glow_intensity` | ``0.3`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`float` | :ref:`glow_levels/1` | ``0.0`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ - | :ref:`float` | :ref:`glow_levels/2` | ``0.0`` | + | :ref:`float` | :ref:`glow_levels/2` | ``0.8`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ - | :ref:`float` | :ref:`glow_levels/3` | ``1.0`` | + | :ref:`float` | :ref:`glow_levels/3` | ``0.4`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ - | :ref:`float` | :ref:`glow_levels/4` | ``0.0`` | + | :ref:`float` | :ref:`glow_levels/4` | ``0.1`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ - | :ref:`float` | :ref:`glow_levels/5` | ``1.0`` | + | :ref:`float` | :ref:`glow_levels/5` | ``0.0`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`float` | :ref:`glow_levels/6` | ``0.0`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ @@ -200,7 +202,7 @@ Propiedades +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`float` | :ref:`ssil_sharpness` | ``0.98`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ - | :ref:`float` | :ref:`ssr_depth_tolerance` | ``0.2`` | + | :ref:`float` | :ref:`ssr_depth_tolerance` | ``0.5`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`bool` | :ref:`ssr_enabled` | ``false`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ @@ -210,6 +212,10 @@ Propiedades +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`int` | :ref:`ssr_max_steps` | ``64`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ + | :ref:`float` | :ref:`tonemap_agx_contrast` | ``1.25`` | + +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ + | :ref:`float` | :ref:`tonemap_agx_white` | ``16.29`` | + +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`float` | :ref:`tonemap_exposure` | ``1.0`` | +------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`ToneMapper` | :ref:`tonemap_mode` | ``0`` | @@ -456,9 +462,7 @@ Uses a high-contrast film-like tonemapping curve and desaturates bright values f :ref:`ToneMapper` **TONE_MAPPER_AGX** = ``4`` -Uses a film-like tonemapping curve and desaturates bright values for a more realistic appearance. Better than other tonemappers at maintaining the hue of colors as they become brighter. The slowest tonemapping option. - -\ **Note:** :ref:`tonemap_white` is fixed at a value of ``16.29``, which makes :ref:`TONE_MAPPER_AGX` unsuitable for use with the Mobile rendering method. +Uses an adjustable film-like tonemapping curve and desaturates bright values for a more realistic appearance. Better than other tonemappers at maintaining the hue of colors as they become brighter. The slowest tonemapping option. .. rst-class:: classref-item-separator @@ -476,7 +480,7 @@ enum **GlowBlendMode**: :ref:`🔗` :ref:`GlowBlendMode` **GLOW_BLEND_MODE_ADDITIVE** = ``0`` -Modo de mezcla de brillo aditivo. Se utiliza principalmente para partículas, brillos (florecimiento), destellos de lentes, fuentes brillantes. +Adds the glow effect to the scene. .. _class_Environment_constant_GLOW_BLEND_MODE_SCREEN: @@ -484,7 +488,7 @@ Modo de mezcla de brillo aditivo. Se utiliza principalmente para partículas, br :ref:`GlowBlendMode` **GLOW_BLEND_MODE_SCREEN** = ``1`` -Modo de mezcla de brillo de pantalla. Aumenta el brillo, se usa frecuentemente con el bloom. +Adds the glow effect to the scene after modifying the glow influence based on the scene value; dark values will be highly influenced by glow and bright values will not be influenced by glow. This approach avoids bright values becoming overly bright from the glow effect. :ref:`tonemap_white` is used to determine the maximum scene value where the glow should have no influence. When :ref:`tonemap_mode` is set to :ref:`TONE_MAPPER_LINEAR`, a value of ``1.0`` will be used as the maximum scene value. .. _class_Environment_constant_GLOW_BLEND_MODE_SOFTLIGHT: @@ -492,7 +496,7 @@ Modo de mezcla de brillo de pantalla. Aumenta el brillo, se usa frecuentemente c :ref:`GlowBlendMode` **GLOW_BLEND_MODE_SOFTLIGHT** = ``2`` -Modo de mezcla de brillo de luz suave. Modifica el contraste, expone sombras y luces (bloom vivo). +Adds the glow effect to the tonemapped image after modifying the glow influence based on the image value; dark values and bright values will not be influenced by glow and mid-range values will be highly influenced by glow. This approach avoids bright values becoming overly bright from the glow effect. The glow will have the largest influence on image values of ``0.25`` and will have no influence when applied to image values greater than ``1.0``. .. _class_Environment_constant_GLOW_BLEND_MODE_REPLACE: @@ -500,7 +504,7 @@ Modo de mezcla de brillo de luz suave. Modifica el contraste, expone sombras y l :ref:`GlowBlendMode` **GLOW_BLEND_MODE_REPLACE** = ``3`` -Reemplazar el modo de mezcla de brillo. Reemplaza el color de todos los píxeles por el valor de brillo. Puede utilizarse para simular un efecto de desenfoque en pantalla completa ajustando los parámetros de brillo para que coincidan con el brillo de la imagen original. +Replaces all pixels' color by the glow effect. This can be used to simulate a full-screen blur effect by tweaking the glow parameters to match the original image's brightness or to preview glow configuration in the editor. .. _class_Environment_constant_GLOW_BLEND_MODE_MIX: @@ -508,7 +512,7 @@ Reemplazar el modo de mezcla de brillo. Reemplaza el color de todos los píxeles :ref:`GlowBlendMode` **GLOW_BLEND_MODE_MIX** = ``4`` -Mixes the glow with the underlying color to avoid increasing brightness as much while still maintaining a glow effect. +Mixes the glow image with the scene image. Best used with :ref:`glow_bloom` to avoid darkening the scene. .. rst-class:: classref-item-separator @@ -590,7 +594,7 @@ Descripciones de Propiedades - |void| **set_adjustment_brightness**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_adjustment_brightness**\ (\ ) -El valor de brillo global de la escena renderizada. Solo es efectivo si :ref:`adjustment_enabled` es ``true``. +Applies a simple brightness adjustment to the rendered image after tonemaping. To adjust scene brightness use :ref:`tonemap_exposure` instead, which is applied before tonemapping and thus less prone to issues with bright colors. Effective only if :ref:`adjustment_enabled` is ``true``. .. rst-class:: classref-item-separator @@ -624,7 +628,7 @@ La tabla de búsqueda (:ref:`Texture2D` o :ref:`Texture3D`\ ) - :ref:`float` **get_adjustment_contrast**\ (\ ) -El valor de contraste global de la escena renderizada (el valor por defecto es 1). Efectivo solo si :ref:`adjustment_enabled` es ``true``. +Increasing :ref:`adjustment_contrast` will make dark values darker and bright values brighter. This simple adjustment is applied to the rendered image after tonemaping. When set to a value greater than ``1.0``, :ref:`adjustment_contrast` is prone to clipping colors that become too bright or too dark. Effective only if :ref:`adjustment_enabled` is ``true``. .. rst-class:: classref-item-separator @@ -658,7 +662,7 @@ Si es ``true``, activa las propiedades ``adjustment_*`` proporcionadas por este - |void| **set_adjustment_saturation**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_adjustment_saturation**\ (\ ) -El valor de saturación de color global de la escena renderizada (el valor por defecto es 1). Efectivo solo si :ref:`adjustment_enabled` es ``true``. +Applies a simple saturation adjustment to the rendered image after tonemaping. When :ref:`adjustment_saturation` is set to ``0.0``, the rendered image will be fully converted to a grayscale image. Effective only if :ref:`adjustment_enabled` is ``true``. .. rst-class:: classref-item-separator @@ -1071,7 +1075,7 @@ If set above ``0.0``, renders the scene's directional light(s) in the fog color .. rst-class:: classref-property -:ref:`GlowBlendMode` **glow_blend_mode** = ``2`` :ref:`🔗` +:ref:`GlowBlendMode` **glow_blend_mode** = ``1`` :ref:`🔗` .. rst-class:: classref-property-setget @@ -1080,7 +1084,7 @@ If set above ``0.0``, renders the scene's directional light(s) in the fog color The glow blending mode. -\ **Note:** :ref:`glow_blend_mode` has no effect when using the Compatibility rendering method, due to this rendering method using a simpler glow implementation optimized for low-end devices. +\ **Note:** The Compatibility renderer always uses :ref:`GLOW_BLEND_MODE_SCREEN` and :ref:`glow_blend_mode` will have no effect. .. rst-class:: classref-item-separator @@ -1114,7 +1118,7 @@ La intensidad del bloom. Si se ajusta a un valor superior a ``0``, esto hará qu - |void| **set_glow_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_glow_enabled**\ (\ ) -If ``true``, the glow effect is enabled. This simulates real world eye/camera behavior where bright pixels bleed onto surrounding pixels. +If ``true``, the glow effect is enabled. This simulates real world atmosphere and eye/camera behavior by causing bright pixels to bleed onto surrounding pixels. \ **Note:** When using the Mobile rendering method, glow looks different due to the lower dynamic range available in the Mobile rendering method. @@ -1152,7 +1156,7 @@ El umbral más alto del brillo del HDR. Las áreas más brillantes que este umbr - |void| **set_glow_hdr_bleed_scale**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_glow_hdr_bleed_scale**\ (\ ) -La escala de sangrado del brillo del HDR. +Smooths the transition between values that are below and above :ref:`glow_hdr_threshold` by reducing the amount of glow generated by values that are close to :ref:`glow_hdr_threshold`. Values above ``glow_hdr_threshold + glow_hdr_scale`` will not have glow reduced in this way. .. rst-class:: classref-item-separator @@ -1179,14 +1183,14 @@ The lower threshold of the HDR glow. When using the Mobile rendering method (whi .. rst-class:: classref-property -:ref:`float` **glow_intensity** = ``0.8`` :ref:`🔗` +:ref:`float` **glow_intensity** = ``0.3`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_glow_intensity**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_glow_intensity**\ (\ ) -The overall brightness multiplier of the glow effect. When using the Mobile rendering method (which only supports a lower dynamic range up to ``2.0``), this should be increased to ``1.5`` to compensate. +The overall brightness multiplier that is applied to the glow effect just before it is blended with the scene. When using the Mobile rendering method (which only supports a lower dynamic range up to ``2.0``), this should be increased to ``1.5`` to compensate. .. rst-class:: classref-item-separator @@ -1215,7 +1219,7 @@ The intensity of the 1st level of glow. This is the most "local" level (least bl .. rst-class:: classref-property -:ref:`float` **glow_levels/2** = ``0.0`` :ref:`🔗` +:ref:`float` **glow_levels/2** = ``0.8`` :ref:`🔗` .. rst-class:: classref-property-setget @@ -1234,7 +1238,7 @@ The intensity of the 2nd level of glow. .. rst-class:: classref-property -:ref:`float` **glow_levels/3** = ``1.0`` :ref:`🔗` +:ref:`float` **glow_levels/3** = ``0.4`` :ref:`🔗` .. rst-class:: classref-property-setget @@ -1253,7 +1257,7 @@ The intensity of the 3rd level of glow. .. rst-class:: classref-property -:ref:`float` **glow_levels/4** = ``0.0`` :ref:`🔗` +:ref:`float` **glow_levels/4** = ``0.1`` :ref:`🔗` .. rst-class:: classref-property-setget @@ -1272,7 +1276,7 @@ The intensity of the 4th level of glow. .. rst-class:: classref-property -:ref:`float` **glow_levels/5** = ``1.0`` :ref:`🔗` +:ref:`float` **glow_levels/5** = ``0.0`` :ref:`🔗` .. rst-class:: classref-property-setget @@ -1416,9 +1420,9 @@ If ``true``, glow levels will be normalized so that summed together their intens - |void| **set_glow_strength**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_glow_strength**\ (\ ) -La fuerza del efecto de brillo. Esto se aplica a medida que el brillo se difumina por la pantalla y aumenta la distancia e intensidad del desenfoque. Cuando se utiliza el método de renderizado Mobile, esto debe aumentarse para compensar el menor rango dinámico. +The strength that is used when blurring across the screen to generate the glow effect. This affects the distance and intensity of the blur. When using the Mobile rendering method, this should be increased to compensate for the lower dynamic range. -\ **Nota:** :ref:`glow_strength` no tiene ningún efecto cuando se utiliza el método de renderizado Compatibility, debido a que este método de renderizado utiliza una implementación de brillo más sencilla optimizada para dispositivos de gama baja. +\ **Note:** :ref:`glow_strength` has no effect when using the Compatibility rendering method, due to this rendering method using a simpler glow implementation optimized for low-end devices. .. rst-class:: classref-item-separator @@ -1757,7 +1761,7 @@ Establece la fuerza del nivel de detalle adicional para el efecto de oclusión a If ``true``, the screen-space ambient occlusion effect is enabled. This darkens objects' corners and cavities to simulate ambient light not reaching the entire object as in real life. This works well for small, dynamic objects, but baked lighting or ambient occlusion textures will do a better job at displaying ambient occlusion on large static objects. Godot uses a form of SSAO called Adaptive Screen Space Ambient Occlusion which is itself a form of Horizon Based Ambient Occlusion. -\ **Note:** SSAO is only supported in the Forward+ rendering method, not Mobile or Compatibility. +\ **Note:** SSAO is only supported in the Forward+ and Compatibility rendering methods, not Mobile. .. rst-class:: classref-item-separator @@ -1956,7 +1960,7 @@ La cantidad que se permite que el efecto de iluminación indirecta del espacio d .. rst-class:: classref-property -:ref:`float` **ssr_depth_tolerance** = ``0.2`` :ref:`🔗` +:ref:`float` **ssr_depth_tolerance** = ``0.5`` :ref:`🔗` .. rst-class:: classref-property-setget @@ -2041,6 +2045,42 @@ El número máximo de pasos para los reflejos en el espacio de la pantalla. Los ---- +.. _class_Environment_property_tonemap_agx_contrast: + +.. rst-class:: classref-property + +:ref:`float` **tonemap_agx_contrast** = ``1.25`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_tonemap_agx_contrast**\ (\ value\: :ref:`float`\ ) +- :ref:`float` **get_tonemap_agx_contrast**\ (\ ) + +Increasing :ref:`tonemap_agx_contrast` will make dark values darker and bright values brighter. Produces a higher quality result than :ref:`adjustment_contrast` without any additional performance cost, but is only available when using the :ref:`TONE_MAPPER_AGX` tonemapper. + +.. rst-class:: classref-item-separator + +---- + +.. _class_Environment_property_tonemap_agx_white: + +.. rst-class:: classref-property + +:ref:`float` **tonemap_agx_white** = ``16.29`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_tonemap_agx_white**\ (\ value\: :ref:`float`\ ) +- :ref:`float` **get_tonemap_agx_white**\ (\ ) + +The white reference value for tonemapping, which indicates where bright white is located in the scale of values provided to the tonemapper. For photorealistic lighting, it is recommended to set :ref:`tonemap_agx_white` to at least ``6.0``. Higher values result in less blown out highlights, but may make the scene appear lower contrast. :ref:`tonemap_agx_white` is the same as :ref:`tonemap_white`, but is only effective with the :ref:`TONE_MAPPER_AGX` tonemapper. See also :ref:`tonemap_exposure`. + +\ **Note:** When using the Mobile renderer with :ref:`Viewport.use_hdr_2d` disabled, :ref:`tonemap_agx_white` is ignored and a white value of ``2.0`` will always be used instead. + +.. rst-class:: classref-item-separator + +---- + .. _class_Environment_property_tonemap_exposure: .. rst-class:: classref-property @@ -2088,9 +2128,9 @@ El modo de mapeo de tonos a utilizar. El mapeo de tonos es el proceso que "convi - |void| **set_tonemap_white**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_tonemap_white**\ (\ ) -The white reference value for tonemapping, which indicates where bright white is located in the scale of values provided to the tonemapper. For photorealistic lighting, recommended values are between ``6.0`` and ``8.0``. Higher values result in less blown out highlights, but may make the scene appear lower contrast. See also :ref:`tonemap_exposure`. +The white reference value for tonemapping, which indicates where bright white is located in the scale of values provided to the tonemapper. For photorealistic lighting, it is recommended to set :ref:`tonemap_white` to at least ``6.0``. Higher values result in less blown out highlights, but may make the scene appear lower contrast. :ref:`tonemap_agx_white` will be used instead when using the :ref:`TONE_MAPPER_AGX` tonemapper. See also :ref:`tonemap_exposure`. -\ **Note:** :ref:`tonemap_white` is ignored when using :ref:`TONE_MAPPER_LINEAR` or :ref:`TONE_MAPPER_AGX`. +\ **Note:** :ref:`tonemap_white` must be set to ``2.0`` or lower on the Mobile renderer to produce bright images. .. rst-class:: classref-item-separator diff --git a/classes/es/class_fabrik3d.rst b/classes/es/class_fabrik3d.rst new file mode 100644 index 0000000000..2ba260bebd --- /dev/null +++ b/classes/es/class_fabrik3d.rst @@ -0,0 +1,31 @@ +:github_url: hide + +.. _class_FABRIK3D: + +FABRIK3D +======== + +**Hereda:** :ref:`IterateIK3D` **<** :ref:`ChainIK3D` **<** :ref:`IKModifier3D` **<** :ref:`SkeletonModifier3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` + +Position based forward and backward reaching inverse kinematics solver. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +**FABRIK3D** is position based IK, allowing precise and accurate tracking of targets. It's ideal for simple chains without limitations. + +The resulting twist around the forward vector will always be kept from the previous pose. + +\ **Note:** When the target is close to the root, it tends to produce zig-zag patterns, resulting in unnatural visual movement. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_fileaccess.rst b/classes/es/class_fileaccess.rst index 9fc12def7e..caacae6e12 100644 --- a/classes/es/class_fileaccess.rst +++ b/classes/es/class_fileaccess.rst @@ -111,7 +111,7 @@ Métodos +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_access_time`\ (\ file\: :ref:`String`\ ) |static| | +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_as_text`\ (\ skip_cr\: :ref:`bool` = false\ ) |const| | + | :ref:`String` | :ref:`get_as_text`\ (\ ) |const| | +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedByteArray` | :ref:`get_buffer`\ (\ length\: :ref:`int`\ ) |const| | +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -121,6 +121,12 @@ Métodos +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Error` | :ref:`get_error`\ (\ ) |const| | +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedByteArray` | :ref:`get_extended_attribute`\ (\ file\: :ref:`String`, attribute_name\: :ref:`String`\ ) |static| | + +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_extended_attribute_string`\ (\ file\: :ref:`String`, attribute_name\: :ref:`String`\ ) |static| | + +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`get_extended_attributes_list`\ (\ file\: :ref:`String`\ ) |static| | + +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedByteArray` | :ref:`get_file_as_bytes`\ (\ path\: :ref:`String`\ ) |static| | +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_file_as_string`\ (\ path\: :ref:`String`\ ) |static| | @@ -171,12 +177,18 @@ Métodos +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`FileAccess` | :ref:`open_encrypted_with_pass`\ (\ path\: :ref:`String`, mode_flags\: :ref:`ModeFlags`, pass\: :ref:`String`\ ) |static| | +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`remove_extended_attribute`\ (\ file\: :ref:`String`, attribute_name\: :ref:`String`\ ) |static| | + +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Error` | :ref:`resize`\ (\ length\: :ref:`int`\ ) | +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`seek`\ (\ position\: :ref:`int`\ ) | +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`seek_end`\ (\ position\: :ref:`int` = 0\ ) | +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`set_extended_attribute`\ (\ file\: :ref:`String`, attribute_name\: :ref:`String`, data\: :ref:`PackedByteArray`\ ) |static| | + +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`set_extended_attribute_string`\ (\ file\: :ref:`String`, attribute_name\: :ref:`String`, data\: :ref:`String`\ ) |static| | + +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Error` | :ref:`set_hidden_attribute`\ (\ file\: :ref:`String`, hidden\: :ref:`bool`\ ) |static| | +-------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Error` | :ref:`set_read_only_attribute`\ (\ file\: :ref:`String`, ro\: :ref:`bool`\ ) |static| | @@ -241,9 +253,9 @@ Abre el archivo para operaciones de lectura. El cursor del archivo se posiciona :ref:`ModeFlags` **WRITE** = ``2`` -Abre el archivo para operaciones de escritura. El archivo se crea si no existe y se trunca si existe. +Opens the file for write operations. If the file exists, it is truncated to zero length and its contents are cleared. Otherwise, it is created. -\ **Nota:** Al crear un archivo, debe estar en un directorio ya existente. Para crear directorios de forma recursiva para una ruta de archivo, véase :ref:`DirAccess.make_dir_recursive()`. +\ **Note:** When creating a file it must be in an already existing directory. To recursively create directories for a file path, see :ref:`DirAccess.make_dir_recursive()`. .. _class_FileAccess_constant_READ_WRITE: @@ -259,9 +271,9 @@ Abre el archivo para operaciones de lectura y escritura. No trunca el archivo. E :ref:`ModeFlags` **WRITE_READ** = ``7`` -Abre el archivo para operaciones de lectura y escritura. El archivo se crea si no existe y se trunca si existe. El cursor del archivo se posiciona al principio del archivo. +Opens the file for read and write operations. If the file exists, it is truncated to zero length and its contents are cleared. Otherwise, it is created. The file cursor is positioned at the beginning of the file. -\ **Nota:** Al crear un archivo, debe estar en un directorio ya existente. Para crear directorios de forma recursiva para una ruta de archivo, véase :ref:`DirAccess.make_dir_recursive()`. +\ **Note:** When creating a file it must be in an already existing directory. To recursively create directories for a file path, see :ref:`DirAccess.make_dir_recursive()`. .. rst-class:: classref-item-separator @@ -611,11 +623,9 @@ Devuelve la última vez que se accedió al ``file`` en formato de marca de tiemp .. rst-class:: classref-method -:ref:`String` **get_as_text**\ (\ skip_cr\: :ref:`bool` = false\ ) |const| :ref:`🔗` +:ref:`String` **get_as_text**\ (\ ) |const| :ref:`🔗` -Devuelve el archivo completo como una :ref:`String`. El texto se interpreta como codificado en UTF-8. Esto ignora el cursor del archivo y no lo afecta. - -Si ``skip_cr`` es ``true``, los caracteres de retorno de carro (``\r``, CR) se ignorarán al analizar el UTF-8, de modo que solo los caracteres de avance de línea (``\n``, LF) representen una nueva línea (convención de Unix). +Returns the whole file as a :ref:`String`. Text is interpreted as being UTF-8 encoded. This ignores the file cursor and does not affect it. .. rst-class:: classref-item-separator @@ -681,6 +691,66 @@ Devuelve el último error que ocurrió al intentar realizar las operaciones. Com ---- +.. _class_FileAccess_method_get_extended_attribute: + +.. rst-class:: classref-method + +:ref:`PackedByteArray` **get_extended_attribute**\ (\ file\: :ref:`String`, attribute_name\: :ref:`String`\ ) |static| :ref:`🔗` + +Reads the file extended attribute with name ``attribute_name`` as a byte array. + +\ **Note:** This method is implemented on Linux, macOS, and Windows. + +\ **Note:** Extended attributes support depends on the file system. Attributes will be lost when the file is moved between incompatible file systems. + +\ **Note:** On Linux, only "user" namespace attributes are accessible, namespace prefix should not be included. + +\ **Note:** On Windows, alternate data streams are used to store extended attributes. + +.. rst-class:: classref-item-separator + +---- + +.. _class_FileAccess_method_get_extended_attribute_string: + +.. rst-class:: classref-method + +:ref:`String` **get_extended_attribute_string**\ (\ file\: :ref:`String`, attribute_name\: :ref:`String`\ ) |static| :ref:`🔗` + +Reads the file extended attribute with name ``attribute_name`` as a UTF-8 encoded string. + +\ **Note:** This method is implemented on Linux, macOS, and Windows. + +\ **Note:** Extended attributes support depends on the file system. Attributes will be lost when the file is moved between incompatible file systems. + +\ **Note:** On Linux, only "user" namespace attributes are accessible, namespace prefix should not be included. + +\ **Note:** On Windows, alternate data streams are used to store extended attributes. + +.. rst-class:: classref-item-separator + +---- + +.. _class_FileAccess_method_get_extended_attributes_list: + +.. rst-class:: classref-method + +:ref:`PackedStringArray` **get_extended_attributes_list**\ (\ file\: :ref:`String`\ ) |static| :ref:`🔗` + +Returns a list of file extended attributes. + +\ **Note:** This method is implemented on Linux, macOS, and Windows. + +\ **Note:** Extended attributes support depends on the file system. Attributes will be lost when the file is moved between incompatible file systems. + +\ **Note:** On Linux, only "user" namespace attributes are accessible, namespace prefix should not be included. + +\ **Note:** On Windows, alternate data streams are used to store extended attributes. + +.. rst-class:: classref-item-separator + +---- + .. _class_FileAccess_method_get_file_as_bytes: .. rst-class:: classref-method @@ -739,9 +809,9 @@ Devuelve los siguientes 16 bits del archivo como un número de punto flotante de :ref:`bool` **get_hidden_attribute**\ (\ file\: :ref:`String`\ ) |static| :ref:`🔗` -Devuelve ``true`` si el atributo ``hidden`` del archivo está activado. +Returns ``true`` if the **hidden** attribute is set on the file at the given path. -\ **Nota:** Este método está implementado en iOS, BSD, macOS y Windows. +\ **Note:** This method is implemented on iOS, BSD, macOS, and Windows. .. rst-class:: classref-item-separator @@ -865,9 +935,9 @@ Devuelve la posición en bytes del cursor del archivo desde el principio del arc :ref:`bool` **get_read_only_attribute**\ (\ file\: :ref:`String`\ ) |static| :ref:`🔗` -Devuelve ``true`` si el atributo ``read only`` del archivo está establecido. +Returns ``true`` if the **read only** attribute is set on the file at the given path. -\ **Nota:** Este método está implementado en iOS, BSD, macOS y Windows. +\ **Note:** This method is implemented on iOS, BSD, macOS, and Windows. .. rst-class:: classref-item-separator @@ -905,7 +975,7 @@ Devuelve un SHA-256 :ref:`String` que representa el archivo en la :ref:`int` **get_size**\ (\ file\: :ref:`String`\ ) |static| :ref:`🔗` -Devuelve el tamaño del archivo en bytes o ``-1`` en caso de error. +Returns the size of the file at the given path, in bytes, or ``-1`` on error. .. rst-class:: classref-item-separator @@ -917,9 +987,9 @@ Devuelve el tamaño del archivo en bytes o ``-1`` en caso de error. |bitfield|\[:ref:`UnixPermissionFlags`\] **get_unix_permissions**\ (\ file\: :ref:`String`\ ) |static| :ref:`🔗` -Devuelve los permisos de archivo UNIX. +Returns the UNIX permissions of the file at the given path. -\ **Nota:** Este método está implementado en iOS, Linux/BSD y macOS. +\ **Note:** This method is implemented on iOS, Linux/BSD, and macOS. .. rst-class:: classref-item-separator @@ -1013,6 +1083,26 @@ Devuelve ``null`` si la apertura del archivo falla. Puedes usar :ref:`get_open_e ---- +.. _class_FileAccess_method_remove_extended_attribute: + +.. rst-class:: classref-method + +:ref:`Error` **remove_extended_attribute**\ (\ file\: :ref:`String`, attribute_name\: :ref:`String`\ ) |static| :ref:`🔗` + +Removes file extended attribute with name ``attribute_name``. + +\ **Note:** This method is implemented on Linux, macOS, and Windows. + +\ **Note:** Extended attributes support depends on the file system. Attributes will be lost when the file is moved between incompatible file systems. + +\ **Note:** On Linux, only "user" namespace attributes are accessible, namespace prefix should not be included. + +\ **Note:** On Windows, alternate data streams are used to store extended attributes. + +.. rst-class:: classref-item-separator + +---- + .. _class_FileAccess_method_resize: .. rst-class:: classref-method @@ -1031,7 +1121,7 @@ Cambia el tamaño del archivo a una longitud especificada. El archivo debe estar |void| **seek**\ (\ position\: :ref:`int`\ ) :ref:`🔗` -Cambia el cursor de lectura/escritura del archivo a la posición especificada (en bytes desde el principio del archivo). Esto cambia el valor devuelto por :ref:`get_position()`. +Sets the file cursor to the specified position in bytes, from the beginning of the file. This changes the value returned by :ref:`get_position()`. .. rst-class:: classref-item-separator @@ -1043,9 +1133,49 @@ Cambia el cursor de lectura/escritura del archivo a la posición especificada (e |void| **seek_end**\ (\ position\: :ref:`int` = 0\ ) :ref:`🔗` -Cambia el cursor de lectura/escritura del archivo a la posición especificada (en bytes desde el final del archivo). Esto cambia el valor devuelto por :ref:`get_position()`. +Sets the file cursor to the specified position in bytes, from the end of the file. This changes the value returned by :ref:`get_position()`. -\ **Nota:** Esto es un offset, así que deberías usar números negativos o el cursor del archivo estará al final del archivo. +\ **Note:** This is an offset, so you should use negative numbers otherwise the file cursor will be at the end of the file. + +.. rst-class:: classref-item-separator + +---- + +.. _class_FileAccess_method_set_extended_attribute: + +.. rst-class:: classref-method + +:ref:`Error` **set_extended_attribute**\ (\ file\: :ref:`String`, attribute_name\: :ref:`String`, data\: :ref:`PackedByteArray`\ ) |static| :ref:`🔗` + +Writes file extended attribute with name ``attribute_name`` as a byte array. + +\ **Note:** This method is implemented on Linux, macOS, and Windows. + +\ **Note:** Extended attributes support depends on the file system. Attributes will be lost when the file is moved between incompatible file systems. + +\ **Note:** On Linux, only "user" namespace attributes are accessible, namespace prefix should not be included. + +\ **Note:** On Windows, alternate data streams are used to store extended attributes. + +.. rst-class:: classref-item-separator + +---- + +.. _class_FileAccess_method_set_extended_attribute_string: + +.. rst-class:: classref-method + +:ref:`Error` **set_extended_attribute_string**\ (\ file\: :ref:`String`, attribute_name\: :ref:`String`, data\: :ref:`String`\ ) |static| :ref:`🔗` + +Writes file extended attribute with name ``attribute_name`` as a UTF-8 encoded string. + +\ **Note:** This method is implemented on Linux, macOS, and Windows. + +\ **Note:** Extended attributes support depends on the file system. Attributes will be lost when the file is moved between incompatible file systems. + +\ **Note:** On Linux, only "user" namespace attributes are accessible, namespace prefix should not be included. + +\ **Note:** On Windows, alternate data streams are used to store extended attributes. .. rst-class:: classref-item-separator @@ -1220,11 +1350,11 @@ Almacena la array de bytes dada en el archivo. Esto avanza el cursor del archivo :ref:`bool` **store_csv_line**\ (\ values\: :ref:`PackedStringArray`, delim\: :ref:`String` = ","\ ) :ref:`🔗` -Almacena el :ref:`PackedStringArray` dado en el archivo como una línea formateada en formato CSV (valores separados por comas). Puedes pasar un ``delim`` diferente para usar otro que no sea el predeterminado ``","`` (coma). Este delimitador debe tener un carácter de longitud. +Stores the given :ref:`PackedStringArray` in the file as a line formatted in the CSV (Comma-Separated Values) format. You can pass a different delimiter ``delim`` to use other than the default ``","`` (comma). This delimiter must be one-character long. -El texto se codificará como UTF-8. Devuelve ``true`` si la operación se realiza correctamente. +Text will be encoded as UTF-8. Returns ``true`` if the operation is successful. -\ **Nota:** Si se produce un error, el valor resultante del indicador de posición del archivo es indeterminado. +\ **Note:** If an error occurs, the resulting value of the file position indicator is indeterminate. .. rst-class:: classref-item-separator diff --git a/classes/es/class_filedialog.rst b/classes/es/class_filedialog.rst index 33af244c7a..43a9ec0338 100644 --- a/classes/es/class_filedialog.rst +++ b/classes/es/class_filedialog.rst @@ -7,6 +7,8 @@ FileDialog **Hereda:** :ref:`ConfirmationDialog` **<** :ref:`AcceptDialog` **<** :ref:`Window` **<** :ref:`Viewport` **<** :ref:`Node` **<** :ref:`Object` +**Heredado por:** :ref:`EditorFileDialog` + Un diálogo para seleccionar archivos o directorios en el sistema de archivos. .. rst-class:: classref-introduction-group @@ -14,7 +16,9 @@ Un diálogo para seleccionar archivos o directorios en el sistema de archivos. Descripción ---------------------- -**FileDialog** es un diálogo preestablecido que se utiliza para elegir archivos y directorios en el sistema de archivos. Soporta máscaras de filtro. **FileDialog** establece automáticamente el título de su ventana de acuerdo con :ref:`file_mode`. Si quieres usar un título personalizado, desactiva esto estableciendo :ref:`mode_overrides_title` a ``false``. +**FileDialog** is a preset dialog used to choose files and directories in the filesystem. It supports filter masks. **FileDialog** automatically sets its window title according to the :ref:`file_mode`. If you want to use a custom title, disable this by setting :ref:`mode_overrides_title` to ``false``. + +\ **Note:** **FileDialog** is invisible by default. To make it visible, call one of the ``popup_*`` methods from :ref:`Window` on the node, such as :ref:`Window.popup_centered_clamped()`. .. rst-class:: classref-reftable-group @@ -33,6 +37,8 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`current_path` | | +---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`deleting_enabled` | ``true`` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ | :ref:`bool` | dialog_hide_on_ok | ``false`` (overrides :ref:`AcceptDialog`) | +---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ | :ref:`DisplayMode` | :ref:`display_mode` | ``0`` | @@ -59,6 +65,8 @@ Propiedades +---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`option_count` | ``0`` | +---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`overwrite_warning_enabled` | ``true`` | + +---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`recent_list_enabled` | ``true`` | +---------------------------------------------------+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`root_subfolder` | ``""`` | @@ -81,7 +89,7 @@ Métodos :widths: auto +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`add_filter`\ (\ filter\: :ref:`String`, description\: :ref:`String` = ""\ ) | + | |void| | :ref:`add_filter`\ (\ filter\: :ref:`String`, description\: :ref:`String` = "", mime_type\: :ref:`String` = ""\ ) | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`add_option`\ (\ name\: :ref:`String`, values\: :ref:`PackedStringArray`, default_value_index\: :ref:`int`\ ) | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -91,6 +99,8 @@ Métodos +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`deselect_all`\ (\ ) | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`get_favorite_list`\ (\ ) |static| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`LineEdit` | :ref:`get_line_edit`\ (\ ) | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_option_default`\ (\ option\: :ref:`int`\ ) |const| | @@ -99,6 +109,8 @@ Métodos +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedStringArray` | :ref:`get_option_values`\ (\ option\: :ref:`int`\ ) |const| | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`get_recent_list`\ (\ ) |static| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Dictionary` | :ref:`get_selected_options`\ (\ ) |const| | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`VBoxContainer` | :ref:`get_vbox`\ (\ ) | @@ -107,14 +119,24 @@ Métodos +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_customization_flag_enabled`\ (\ flag\: :ref:`Customization`\ ) |const| | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`popup_file_dialog`\ (\ ) | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_customization_flag_enabled`\ (\ flag\: :ref:`Customization`, enabled\: :ref:`bool`\ ) | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_favorite_list`\ (\ favorites\: :ref:`PackedStringArray`\ ) |static| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_get_icon_callback`\ (\ callback\: :ref:`Callable`\ ) |static| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_get_thumbnail_callback`\ (\ callback\: :ref:`Callable`\ ) |static| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_option_default`\ (\ option\: :ref:`int`, default_value_index\: :ref:`int`\ ) | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_option_name`\ (\ option\: :ref:`int`, name\: :ref:`String`\ ) | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_option_values`\ (\ option\: :ref:`int`, values\: :ref:`PackedStringArray`\ ) | +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_recent_list`\ (\ recents\: :ref:`PackedStringArray`\ ) |static| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -416,6 +438,26 @@ Si está habilitado, muestra los botones de cambio de diseño (lista/miniaturas) Equivalente a :ref:`layout_toggle_enabled`. +.. _class_FileDialog_constant_CUSTOMIZATION_OVERWRITE_WARNING: + +.. rst-class:: classref-enumeration-constant + +:ref:`Customization` **CUSTOMIZATION_OVERWRITE_WARNING** = ``7`` + +If enabled, the **FileDialog** will warn the user before overwriting files in save mode. + +Equivalent to :ref:`overwrite_warning_enabled`. + +.. _class_FileDialog_constant_CUSTOMIZATION_DELETE: + +.. rst-class:: classref-enumeration-constant + +:ref:`Customization` **CUSTOMIZATION_DELETE** = ``8`` + +If enabled, the context menu will show the "Delete" option, which allows moving files and folders to trash. + +Equivalent to :ref:`deleting_enabled`. + .. rst-class:: classref-section-separator ---- @@ -497,6 +539,23 @@ La ruta de archivo actualmente seleccionada del diálogo de archivo. ---- +.. _class_FileDialog_property_deleting_enabled: + +.. rst-class:: classref-property + +:ref:`bool` **deleting_enabled** = ``true`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_customization_flag_enabled**\ (\ flag\: :ref:`Customization`, enabled\: :ref:`bool`\ ) +- :ref:`bool` **is_customization_flag_enabled**\ (\ flag\: :ref:`Customization`\ ) |const| + +If ``true``, the context menu will show the "Delete" option, which allows moving files and folders to trash. + +.. rst-class:: classref-item-separator + +---- + .. _class_FileDialog_property_display_mode: .. rst-class:: classref-property @@ -612,9 +671,9 @@ Véase también :ref:`filters`, que debería - |void| **set_filters**\ (\ value\: :ref:`PackedStringArray`\ ) - :ref:`PackedStringArray` **get_filters**\ (\ ) -Los filtros de tipo de archivo disponibles. Cada string de filtro en el array debe tener el siguiente formato: ``*.png,*.jpg,*.jpeg;Archivos de imagen;image/png,image/jpeg``. El texto de descripción del filtro es opcional y puede omitirse. Tanto las extensiones de archivo como el tipo MIME siempre deben estar establecidos. +The available file type filters. Each filter string in the array should be formatted like this: ``*.png,*.jpg,*.jpeg;Image Files;image/png,image/jpeg``. The description text of the filter is optional and can be omitted. Both file extensions and MIME type should be always set. -\ **Nota:** El diálogo de archivo integrado y el diálogo de archivo de Windows solo admiten extensiones de archivo, mientras que los diálogos de archivo de Android, Linux y macOS también admiten tipos MIME. +\ **Note:** Embedded file dialogs and Windows file dialogs support only file extensions, while Android, Linux, and macOS file dialogs also support MIME types. **Note:** The returned array is *copied* and any changes to it will not update the original property value. See :ref:`PackedStringArray` for more details. @@ -633,7 +692,7 @@ Los filtros de tipo de archivo disponibles. Cada string de filtro en el array de - |void| **set_customization_flag_enabled**\ (\ flag\: :ref:`Customization`, enabled\: :ref:`bool`\ ) - :ref:`bool` **is_customization_flag_enabled**\ (\ flag\: :ref:`Customization`\ ) |const| -Si es ``true``, muestra el botón para crear nuevos directorios (cuando se usa :ref:`FILE_MODE_OPEN_DIR`, :ref:`FILE_MODE_OPEN_ANY` o :ref:`FILE_MODE_SAVE_FILE`). +If ``true``, shows the button for creating new directories (when using :ref:`FILE_MODE_OPEN_DIR`, :ref:`FILE_MODE_OPEN_ANY`, or :ref:`FILE_MODE_SAVE_FILE`), and the context menu will have the "New Folder..." option. .. rst-class:: classref-item-separator @@ -707,6 +766,23 @@ The number of additional :ref:`OptionButton`\ s and :ref:`Ch ---- +.. _class_FileDialog_property_overwrite_warning_enabled: + +.. rst-class:: classref-property + +:ref:`bool` **overwrite_warning_enabled** = ``true`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_customization_flag_enabled**\ (\ flag\: :ref:`Customization`, enabled\: :ref:`bool`\ ) +- :ref:`bool` **is_customization_flag_enabled**\ (\ flag\: :ref:`Customization`\ ) |const| + +If ``true``, the **FileDialog** will warn the user before overwriting files in save mode. + +.. rst-class:: classref-item-separator + +---- + .. _class_FileDialog_property_recent_list_enabled: .. rst-class:: classref-property @@ -773,15 +849,17 @@ Si es ``true``, el diálogo mostrará los archivos ocultos. - |void| **set_use_native_dialog**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **get_use_native_dialog**\ (\ ) -Si es ``true``, y si es compatible con el :ref:`DisplayServer` actual, se utilizará el diálogo nativo del SO en lugar del personalizado. +If ``true``, and if supported by the current :ref:`DisplayServer`, OS native dialog will be used instead of custom one. -\ **Nota:** En Android, solo se admite para dispositivos Android 10+ y cuando se usa :ref:`ACCESS_FILESYSTEM`. Para el modo de acceso :ref:`ACCESS_RESOURCES` y :ref:`ACCESS_USERDATA`, el sistema volverá a FileDialog personalizado. +\ **Note:** On Android, it is only supported for Android 10+ devices and when using :ref:`ACCESS_FILESYSTEM`. For access mode :ref:`ACCESS_RESOURCES` and :ref:`ACCESS_USERDATA`, the system will fall back to custom FileDialog. -\ **Nota:** En Linux y macOS, las aplicaciones en espacio aislado siempre usan diálogos nativos para acceder al sistema de archivos del host. +\ **Note:** On Linux and macOS, sandboxed apps always use native dialogs to access the host file system. -\ **Nota:** En macOS, las aplicaciones en espacio aislado guardarán marcadores con ámbito de seguridad para conservar el acceso a las carpetas abiertas en varias sesiones. Usa :ref:`OS.get_granted_permissions()` para obtener una lista de marcadores guardados. +\ **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. -\ **Nota:** Los diálogos nativos están aislados del proceso base, las propiedades del diálogo de archivo no se pueden modificar una vez que se muestra el diálogo. +\ **Note:** Native dialogs are isolated from the base process, file dialog properties can't be modified once the dialog is shown. + +\ **Note:** This property is ignored in :ref:`EditorFileDialog`. .. rst-class:: classref-section-separator @@ -796,13 +874,15 @@ Descripciones de Métodos .. rst-class:: classref-method -|void| **add_filter**\ (\ filter\: :ref:`String`, description\: :ref:`String` = ""\ ) :ref:`🔗` +|void| **add_filter**\ (\ filter\: :ref:`String`, description\: :ref:`String` = "", mime_type\: :ref:`String` = ""\ ) :ref:`🔗` -Añade una opción de ``filter`` de nombre de archivo separada por comas al **FileDialog** con una ``description`` opcional, que restringe qué archivos se pueden elegir. +Adds a comma-separated file extension ``filter`` and comma-separated MIME type ``mime_type`` option to the **FileDialog** with an optional ``description``, which restricts what files can be picked. -Un ``filter`` debe tener la forma ``"nombrearchivo.extensión"``, donde nombrearchivo y extensión pueden ser ``*`` para coincidir con cualquier string. No se permiten filtros que empiecen por ``.`` (es decir, nombres de archivo vacíos). +A ``filter`` should be of the form ``"filename.extension"``, where filename and extension can be ``*`` to match any string. Filters starting with ``.`` (i.e. empty filenames) are not allowed. -Por ejemplo, un ``filter`` de ``"*.png, *.jpg"`` y una ``description`` de ``"Imágenes"`` da como resultado el texto del filtro "Imágenes (\*.png, \*.jpg)". +For example, a ``filter`` of ``"*.png, *.jpg"``, a ``mime_type`` of ``image/png, image/jpeg``, and a ``description`` of ``"Images"`` results in filter text "Images (\*.png, \*.jpg)". + +\ **Note:** Embedded file dialogs and Windows file dialogs support only file extensions, while Android, Linux, and macOS file dialogs also support MIME types. .. rst-class:: classref-item-separator @@ -858,6 +938,18 @@ Borra los elementos actualmente seleccionados en el diálogo. ---- +.. _class_FileDialog_method_get_favorite_list: + +.. rst-class:: classref-method + +:ref:`PackedStringArray` **get_favorite_list**\ (\ ) |static| :ref:`🔗` + +Returns the list of favorite directories, which is shared by all **FileDialog** nodes. Useful to store the list of favorites between project sessions. This method can be called only from the main thread. + +.. rst-class:: classref-item-separator + +---- + .. _class_FileDialog_method_get_line_edit: .. rst-class:: classref-method @@ -908,6 +1000,18 @@ Returns an array of values of the :ref:`OptionButton` with i ---- +.. _class_FileDialog_method_get_recent_list: + +.. rst-class:: classref-method + +:ref:`PackedStringArray` **get_recent_list**\ (\ ) |static| :ref:`🔗` + +Returns the list of recent directories, which is shared by all **FileDialog** nodes. Useful to store the list of recents between project sessions. This method can be called only from the main thread. + +.. rst-class:: classref-item-separator + +---- + .. _class_FileDialog_method_get_selected_options: .. rst-class:: classref-method @@ -942,9 +1046,9 @@ Devuelve el contenedor de caja vertical del diálogo, se le pueden añadir contr |void| **invalidate**\ (\ ) :ref:`🔗` -Invalida y actualiza la lista de contenido del diálogo actual. +Invalidates and updates this dialog's content list. -\ **Nota:** Este método no hace nada en los diálogos de archivo nativos. +\ **Note:** This method does nothing on native file dialogs. .. rst-class:: classref-item-separator @@ -962,13 +1066,79 @@ Devuelve ``true`` si la ``flag`` proporcionada está habilitada. ---- +.. _class_FileDialog_method_popup_file_dialog: + +.. rst-class:: classref-method + +|void| **popup_file_dialog**\ (\ ) :ref:`🔗` + +Shows the **FileDialog** using the default size and position for file dialogs, and selects the file name if there is a current file. + +.. rst-class:: classref-item-separator + +---- + .. _class_FileDialog_method_set_customization_flag_enabled: .. rst-class:: classref-method |void| **set_customization_flag_enabled**\ (\ flag\: :ref:`Customization`, enabled\: :ref:`bool`\ ) :ref:`🔗` -Alterna la ``flag`` de personalización especificada, lo que permite personalizar las funciones disponibles en este **FileDialog**. Véase :ref:`Customization` para ver las opciones. +Sets the specified customization ``flag``, allowing to customize the features available in this **FileDialog**. + +.. rst-class:: classref-item-separator + +---- + +.. _class_FileDialog_method_set_favorite_list: + +.. rst-class:: classref-method + +|void| **set_favorite_list**\ (\ favorites\: :ref:`PackedStringArray`\ ) |static| :ref:`🔗` + +Sets the list of favorite directories, which is shared by all **FileDialog** nodes. Useful to restore the list of favorites saved with :ref:`get_favorite_list()`. This method can be called only from the main thread. + +\ **Note:** **FileDialog** will update its internal :ref:`ItemList` of favorites when its visibility changes. Be sure to call this method earlier if you want your changes to have effect. + +.. rst-class:: classref-item-separator + +---- + +.. _class_FileDialog_method_set_get_icon_callback: + +.. rst-class:: classref-method + +|void| **set_get_icon_callback**\ (\ callback\: :ref:`Callable`\ ) |static| :ref:`🔗` + +Sets the callback used by the **FileDialog** nodes to get a file icon, when :ref:`DISPLAY_LIST` mode is used. The callback should take a single :ref:`String` argument (file path), and return a :ref:`Texture2D`. If an invalid texture is returned, the :ref:`file` icon will be used instead. + +.. rst-class:: classref-item-separator + +---- + +.. _class_FileDialog_method_set_get_thumbnail_callback: + +.. rst-class:: classref-method + +|void| **set_get_thumbnail_callback**\ (\ callback\: :ref:`Callable`\ ) |static| :ref:`🔗` + +Sets the callback used by the **FileDialog** nodes to get a file icon, when :ref:`DISPLAY_THUMBNAILS` mode is used. The callback should take a single :ref:`String` argument (file path), and return a :ref:`Texture2D`. If an invalid texture is returned, the :ref:`file_thumbnail` icon will be used instead. + +Thumbnails are usually more complex and may take a while to load. To avoid stalling the application, you can use :ref:`ImageTexture` to asynchronously create the thumbnail. + +:: + + func _ready(): + FileDialog.set_get_thumbnail_callback(thumbnail_method) + + func thumbnail_method(path): + var image_texture = ImageTexture.new() + make_thumbnail_async(path, image_texture) + return image_texture + + func make_thumbnail_async(path, image_texture): + var thumbnail_texture = await generate_thumbnail(path) # Some method that generates a thumbnail. + image_texture.set_image(thumbnail_texture.get_image()) .. rst-class:: classref-item-separator @@ -1006,6 +1176,20 @@ Sets the name of the :ref:`OptionButton` or :ref:`CheckBox` with index ``option``. +.. rst-class:: classref-item-separator + +---- + +.. _class_FileDialog_method_set_recent_list: + +.. rst-class:: classref-method + +|void| **set_recent_list**\ (\ recents\: :ref:`PackedStringArray`\ ) |static| :ref:`🔗` + +Sets the list of recent directories, which is shared by all **FileDialog** nodes. Useful to restore the list of recents saved with :ref:`set_recent_list()`. This method can be called only from the main thread. + +\ **Note:** **FileDialog** will update its internal :ref:`ItemList` of recent directories when its visibility changes. Be sure to call this method earlier if you want your changes to have effect. + .. rst-class:: classref-section-separator ---- diff --git a/classes/es/class_filesystemdock.rst b/classes/es/class_filesystemdock.rst index 6bb93e68da..b573f2d9df 100644 --- a/classes/es/class_filesystemdock.rst +++ b/classes/es/class_filesystemdock.rst @@ -5,7 +5,7 @@ FileSystemDock ============== -**Hereda:** :ref:`VBoxContainer` **<** :ref:`BoxContainer` **<** :ref:`Container` **<** :ref:`Control` **<** :ref:`CanvasItem` **<** :ref:`Node` **<** :ref:`Object` +**Hereda:** :ref:`EditorDock` **<** :ref:`MarginContainer` **<** :ref:`Container` **<** :ref:`Control` **<** :ref:`CanvasItem` **<** :ref:`Node` **<** :ref:`Object` El panel del editor de Godot para gestionar los archivos del proyecto. @@ -147,6 +147,18 @@ Emitida cuando las escenas dadas se instancian en el editor. Emitida cuando se elimina un archivo de un ``resource`` externo. +.. rst-class:: classref-item-separator + +---- + +.. _class_FileSystemDock_signal_selection_changed: + +.. rst-class:: classref-signal + +**selection_changed**\ (\ ) :ref:`🔗` + +Emitted when the selection changes. Use :ref:`EditorInterface.get_selected_paths()` in the connected method to get the selected paths. + .. rst-class:: classref-section-separator ---- diff --git a/classes/es/class_foldablecontainer.rst b/classes/es/class_foldablecontainer.rst index 8d86463990..d6c6dcf041 100644 --- a/classes/es/class_foldablecontainer.rst +++ b/classes/es/class_foldablecontainer.rst @@ -1,7 +1,7 @@ :github_url: hide .. meta:: - :keywords: expandable, collapsible, collapse + :keywords: expandable, collapsible, collapse, accordion, details .. _class_FoldableContainer: @@ -17,15 +17,11 @@ Un contenedor que puede ser expandido/colapsado. Descripción ---------------------- -Un contenedor que puede ser expandido/colapsado, con un título que puede ser rellenado con controles, como botones. +A container that can be expanded/collapsed, with a title that can be filled with controls, such as buttons. This is also called an accordion. -El título puede ser posicionado en la parte superior o inferior del contenedor. +The title can be positioned at the top or bottom of the container. The container can be expanded or collapsed by clicking the title or by pressing ``ui_accept`` when focused. Child control nodes are hidden when the container is collapsed. Ignores non-control children. -El contenedor puede ser expandido o colapsado haciendo clic en el título o presionando ``ui_accept`` cuando está enfocado. - -Los nodos de control hijo se ocultan cuando el contenedor está colapsado. Ignora los hijos que no son controles. - -Puede permitir la agrupación con otros FoldableContainers, comprueba :ref:`foldable_group` y :ref:`FoldableGroup`. +A FoldableContainer can be grouped with other FoldableContainers so that only one of them can be opened at a time; see :ref:`foldable_group` and :ref:`FoldableGroup`. .. rst-class:: classref-reftable-group @@ -223,7 +219,7 @@ Si es ``true``, el contenedor se plegará y ocultará a todos sus hijos. - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_language**\ (\ ) -Código de idioma utilizado para los algoritmos de modelado de texto. Si se deja vacío, se utiliza la configuración regional actual en su lugar. +Language code used for text shaping algorithms. If left empty, the current locale is used instead. .. rst-class:: classref-item-separator diff --git a/classes/es/class_font.rst b/classes/es/class_font.rst index de6b42fa62..125620a46d 100644 --- a/classes/es/class_font.rst +++ b/classes/es/class_font.rst @@ -555,7 +555,7 @@ Devuelve ``true`` si un ``char`` Unicode está disponible en la fuente. :ref:`bool` **is_language_supported**\ (\ language\: :ref:`String`\ ) |const| :ref:`🔗` -Devuelve ``true`` si la fuente soporta el idioma dado (código `ISO 639 `__). +Returns ``true`` if the font supports the given language (as a `ISO 639 `__ code). .. rst-class:: classref-item-separator @@ -567,7 +567,7 @@ Devuelve ``true`` si la fuente soporta el idioma dado (código `ISO 639 ` **is_script_supported**\ (\ script\: :ref:`String`\ ) |const| :ref:`🔗` -Devuelve ``true`` si la fuente soporta el script dado (código `ISO 15924 `__). +Returns ``true`` if the font supports the given script (as a `ISO 15924 `__ code). .. rst-class:: classref-item-separator diff --git a/classes/es/class_gdextensionmanager.rst b/classes/es/class_gdextensionmanager.rst index b5d1477c0c..745b26b40f 100644 --- a/classes/es/class_gdextensionmanager.rst +++ b/classes/es/class_gdextensionmanager.rst @@ -35,19 +35,21 @@ Métodos .. table:: :widths: auto - +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`GDExtension` | :ref:`get_extension`\ (\ path\: :ref:`String`\ ) | - +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`get_loaded_extensions`\ (\ ) |const| | - +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_extension_loaded`\ (\ path\: :ref:`String`\ ) |const| | - +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`LoadStatus` | :ref:`load_extension`\ (\ path\: :ref:`String`\ ) | - +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`LoadStatus` | :ref:`reload_extension`\ (\ path\: :ref:`String`\ ) | - +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`LoadStatus` | :ref:`unload_extension`\ (\ path\: :ref:`String`\ ) | - +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ + +-------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`GDExtension` | :ref:`get_extension`\ (\ path\: :ref:`String`\ ) | + +-------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`get_loaded_extensions`\ (\ ) |const| | + +-------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_extension_loaded`\ (\ path\: :ref:`String`\ ) |const| | + +-------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`LoadStatus` | :ref:`load_extension`\ (\ path\: :ref:`String`\ ) | + +-------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`LoadStatus` | :ref:`load_extension_from_function`\ (\ path\: :ref:`String`, init_func\: ``const GDExtensionInitializationFunction*``\ ) | + +-------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`LoadStatus` | :ref:`reload_extension`\ (\ path\: :ref:`String`\ ) | + +-------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`LoadStatus` | :ref:`unload_extension`\ (\ path\: :ref:`String`\ ) | + +-------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -206,6 +208,18 @@ Carga una extensión por la ruta de archivo absoluta. La ``path`` debe apuntar a ---- +.. _class_GDExtensionManager_method_load_extension_from_function: + +.. rst-class:: classref-method + +:ref:`LoadStatus` **load_extension_from_function**\ (\ path\: :ref:`String`, init_func\: ``const GDExtensionInitializationFunction*``\ ) :ref:`🔗` + +Loads the extension already in address space via the given path and initialization function. The ``path`` needs to be unique and start with ``"libgodot://"``. Returns :ref:`LOAD_STATUS_OK` if successful. + +.. rst-class:: classref-item-separator + +---- + .. _class_GDExtensionManager_method_reload_extension: .. rst-class:: classref-method diff --git a/classes/es/class_geometryinstance3d.rst b/classes/es/class_geometryinstance3d.rst index be64c97cac..29cb95bedb 100644 --- a/classes/es/class_geometryinstance3d.rst +++ b/classes/es/class_geometryinstance3d.rst @@ -286,7 +286,7 @@ Descripciones de Propiedades - |void| **set_cast_shadows_setting**\ (\ value\: :ref:`ShadowCastingSetting`\ ) - :ref:`ShadowCastingSetting` **get_cast_shadows_setting**\ (\ ) -La bandera de proyección de sombra seleccionada. +The mode used to cast shadows from this instance. .. rst-class:: classref-item-separator diff --git a/classes/es/class_gltfaccessor.rst b/classes/es/class_gltfaccessor.rst index f259b6bca7..b49c8342e8 100644 --- a/classes/es/class_gltfaccessor.rst +++ b/classes/es/class_gltfaccessor.rst @@ -67,6 +67,20 @@ Propiedades | :ref:`int` | :ref:`type` | | +---------------------------------------------------------------+-------------------------------------------------------------------------------------------------+--------------------------+ +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-----------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`GLTFAccessor` | :ref:`from_dictionary`\ (\ dictionary\: :ref:`Dictionary`\ ) |static| | + +-----------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dictionary` | :ref:`to_dictionary`\ (\ ) |const| | + +-----------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + .. rst-class:: classref-section-separator ---- @@ -510,6 +524,35 @@ El desplazamiento relativo al inicio de bufferView en bytes. El tipo de accessor glTF, como un :ref:`int`. Los valores posibles son ``0`` para "SCALAR", ``1`` para "VEC2", ``2`` para "VEC3", ``3`` para "VEC4", ``4`` para "MAT2", ``5`` para "MAT3" y ``6`` para "MAT4". +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_GLTFAccessor_method_from_dictionary: + +.. rst-class:: classref-method + +:ref:`GLTFAccessor` **from_dictionary**\ (\ dictionary\: :ref:`Dictionary`\ ) |static| :ref:`🔗` + +Creates a new GLTFAccessor instance by parsing the given :ref:`Dictionary`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_GLTFAccessor_method_to_dictionary: + +.. rst-class:: classref-method + +:ref:`Dictionary` **to_dictionary**\ (\ ) |const| :ref:`🔗` + +Serializes this GLTFAccessor instance into a :ref:`Dictionary`. + .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` diff --git a/classes/es/class_gltfbufferview.rst b/classes/es/class_gltfbufferview.rst index 7864cc65b6..9bdf6acd53 100644 --- a/classes/es/class_gltfbufferview.rst +++ b/classes/es/class_gltfbufferview.rst @@ -57,9 +57,13 @@ Métodos .. table:: :widths: auto + +-----------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`GLTFBufferView` | :ref:`from_dictionary`\ (\ dictionary\: :ref:`Dictionary`\ ) |static| | +-----------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedByteArray` | :ref:`load_buffer_view_data`\ (\ state\: :ref:`GLTFState`\ ) |const| | +-----------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dictionary` | :ref:`to_dictionary`\ (\ ) |const| | + +-----------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -177,6 +181,18 @@ Es ``true`` si el tipo de búfer OpenGL GPU de GLTFBufferView es un ``ARRAY_BUFF Descripciones de Métodos ------------------------------------------------ +.. _class_GLTFBufferView_method_from_dictionary: + +.. rst-class:: classref-method + +:ref:`GLTFBufferView` **from_dictionary**\ (\ dictionary\: :ref:`Dictionary`\ ) |static| :ref:`🔗` + +Creates a new GLTFBufferView instance by parsing the given :ref:`Dictionary`. + +.. rst-class:: classref-item-separator + +---- + .. _class_GLTFBufferView_method_load_buffer_view_data: .. rst-class:: classref-method @@ -185,6 +201,18 @@ Descripciones de Métodos Carga los datos de la vista de búfer del búfer al que hace referencia esta vista de búfer en el :ref:`GLTFState` dado. Los datos entrelazados con un byte stride aún no son compatibles con este método. Los datos se devuelven como un :ref:`PackedByteArray`. +.. rst-class:: classref-item-separator + +---- + +.. _class_GLTFBufferView_method_to_dictionary: + +.. rst-class:: classref-method + +:ref:`Dictionary` **to_dictionary**\ (\ ) |const| :ref:`🔗` + +Serializes this GLTFBufferView instance into a :ref:`Dictionary`. + .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` diff --git a/classes/es/class_gltfnode.rst b/classes/es/class_gltfnode.rst index d0b291354b..7fea4db159 100644 --- a/classes/es/class_gltfnode.rst +++ b/classes/es/class_gltfnode.rst @@ -309,7 +309,7 @@ Si este nodo glTF tiene una piel, el índice de la :ref:`GLTFSkin`\ ) - :ref:`bool` **get_visible**\ (\ ) -Si es ``true``, el nodo GLTF es visible. Si es ``false``, el nodo GLTF no es visible. Esto se traduce a la propiedad :ref:`Node3D.visible` en la escena de Godot, y se exporta a ``KHR_node_visibility`` cuando ``false``. +If ``true``, the GLTF node is visible. If ``false``, the GLTF node is not visible. This is converted to the :ref:`Node3D.visible` property in the Godot scene, and is exported to ``KHR_node_visibility`` when ``false``. .. rst-class:: classref-item-separator diff --git a/classes/es/class_gltfstate.rst b/classes/es/class_gltfstate.rst index 2ee9b049f8..1ab4d4f5a4 100644 --- a/classes/es/class_gltfstate.rst +++ b/classes/es/class_gltfstate.rst @@ -52,6 +52,8 @@ Propiedades +----------------------------------------------------------------------------+------------------------------------------------------------------------------------+------------------------+ | :ref:`PackedByteArray` | :ref:`glb_data` | ``PackedByteArray()`` | +----------------------------------------------------------------------------+------------------------------------------------------------------------------------+------------------------+ + | :ref:`HandleBinaryImageMode` | :ref:`handle_binary_image_mode` | ``1`` | + +----------------------------------------------------------------------------+------------------------------------------------------------------------------------+------------------------+ | :ref:`bool` | :ref:`import_as_skeleton_bones` | ``false`` | +----------------------------------------------------------------------------+------------------------------------------------------------------------------------+------------------------+ | :ref:`Dictionary` | :ref:`json` | ``{}`` | @@ -82,47 +84,47 @@ Métodos +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`append_gltf_node`\ (\ gltf_node\: :ref:`GLTFNode`, godot_scene_node\: :ref:`Node`, parent_node_index\: :ref:`int`\ ) | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`GLTFAccessor`\] | :ref:`get_accessors`\ (\ ) | + | :ref:`Array`\[:ref:`GLTFAccessor`\] | :ref:`get_accessors`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Variant` | :ref:`get_additional_data`\ (\ extension_name\: :ref:`StringName`\ ) | + | :ref:`Variant` | :ref:`get_additional_data`\ (\ extension_name\: :ref:`StringName`\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`AnimationPlayer` | :ref:`get_animation_player`\ (\ idx\: :ref:`int`\ ) | + | :ref:`AnimationPlayer` | :ref:`get_animation_player`\ (\ anim_player_index\: :ref:`int`\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_animation_players_count`\ (\ idx\: :ref:`int`\ ) | + | :ref:`int` | :ref:`get_animation_players_count`\ (\ anim_player_index\: :ref:`int`\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`GLTFAnimation`\] | :ref:`get_animations`\ (\ ) | + | :ref:`Array`\[:ref:`GLTFAnimation`\] | :ref:`get_animations`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`GLTFBufferView`\] | :ref:`get_buffer_views`\ (\ ) | + | :ref:`Array`\[:ref:`GLTFBufferView`\] | :ref:`get_buffer_views`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`GLTFCamera`\] | :ref:`get_cameras`\ (\ ) | + | :ref:`Array`\[:ref:`GLTFCamera`\] | :ref:`get_cameras`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_handle_binary_image`\ (\ ) | + | :ref:`int` | :ref:`get_handle_binary_image`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`Texture2D`\] | :ref:`get_images`\ (\ ) | + | :ref:`Array`\[:ref:`Texture2D`\] | :ref:`get_images`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`GLTFLight`\] | :ref:`get_lights`\ (\ ) | + | :ref:`Array`\[:ref:`GLTFLight`\] | :ref:`get_lights`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`Material`\] | :ref:`get_materials`\ (\ ) | + | :ref:`Array`\[:ref:`Material`\] | :ref:`get_materials`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`GLTFMesh`\] | :ref:`get_meshes`\ (\ ) | + | :ref:`Array`\[:ref:`GLTFMesh`\] | :ref:`get_meshes`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_node_index`\ (\ scene_node\: :ref:`Node`\ ) | + | :ref:`int` | :ref:`get_node_index`\ (\ scene_node\: :ref:`Node`\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`GLTFNode`\] | :ref:`get_nodes`\ (\ ) | + | :ref:`Array`\[:ref:`GLTFNode`\] | :ref:`get_nodes`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Node` | :ref:`get_scene_node`\ (\ idx\: :ref:`int`\ ) | + | :ref:`Node` | :ref:`get_scene_node`\ (\ gltf_node_index\: :ref:`int`\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`GLTFSkeleton`\] | :ref:`get_skeletons`\ (\ ) | + | :ref:`Array`\[:ref:`GLTFSkeleton`\] | :ref:`get_skeletons`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`GLTFSkin`\] | :ref:`get_skins`\ (\ ) | + | :ref:`Array`\[:ref:`GLTFSkin`\] | :ref:`get_skins`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`GLTFTextureSampler`\] | :ref:`get_texture_samplers`\ (\ ) | + | :ref:`Array`\[:ref:`GLTFTextureSampler`\] | :ref:`get_texture_samplers`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`GLTFTexture`\] | :ref:`get_textures`\ (\ ) | + | :ref:`Array`\[:ref:`GLTFTexture`\] | :ref:`get_textures`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`String`\] | :ref:`get_unique_animation_names`\ (\ ) | + | :ref:`Array`\[:ref:`String`\] | :ref:`get_unique_animation_names`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`String`\] | :ref:`get_unique_names`\ (\ ) | + | :ref:`Array`\[:ref:`String`\] | :ref:`get_unique_names`\ (\ ) |const| | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_accessors`\ (\ accessors\: :ref:`Array`\[:ref:`GLTFAccessor`\]\ ) | +----------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -165,6 +167,57 @@ Métodos .. rst-class:: classref-descriptions-group +Enumeraciones +-------------------------- + +.. _enum_GLTFState_HandleBinaryImageMode: + +.. rst-class:: classref-enumeration + +enum **HandleBinaryImageMode**: :ref:`🔗` + +.. _class_GLTFState_constant_HANDLE_BINARY_IMAGE_MODE_DISCARD_TEXTURES: + +.. rst-class:: classref-enumeration-constant + +:ref:`HandleBinaryImageMode` **HANDLE_BINARY_IMAGE_MODE_DISCARD_TEXTURES** = ``0`` + +When importing a glTF file with embedded binary images, discards all images and uses untextured materials in their place. Images stored as separate files in the ``res://`` folder are not affected by this; those will be used as Godot imported them. + +.. _class_GLTFState_constant_HANDLE_BINARY_IMAGE_MODE_EXTRACT_TEXTURES: + +.. rst-class:: classref-enumeration-constant + +:ref:`HandleBinaryImageMode` **HANDLE_BINARY_IMAGE_MODE_EXTRACT_TEXTURES** = ``1`` + +When importing a glTF file with embedded binary images, extracts them and saves them to their own files. This allows the image to be imported by Godot's image importer, which can then have their import options customized by the user, including optionally compressing the image to VRAM texture formats. + +This will save the images's bytes exactly as-is, without recompression. For image formats supplied by glTF extensions, the file will have a filename ending with the file extension supplied by :ref:`GLTFDocumentExtension._get_image_file_extension()` of the extension class. + +\ **Note:** This option is editor-only. At runtime, this acts the same as :ref:`HANDLE_BINARY_IMAGE_MODE_EMBED_AS_UNCOMPRESSED`. + +.. _class_GLTFState_constant_HANDLE_BINARY_IMAGE_MODE_EMBED_AS_BASISU: + +.. rst-class:: classref-enumeration-constant + +:ref:`HandleBinaryImageMode` **HANDLE_BINARY_IMAGE_MODE_EMBED_AS_BASISU** = ``2`` + +When importing a glTF file with embedded binary images, embeds textures VRAM compressed with Basis Universal into the generated scene. Images stored as separate files in the ``res://`` folder are not affected by this; those will be used as Godot imported them. + +.. _class_GLTFState_constant_HANDLE_BINARY_IMAGE_MODE_EMBED_AS_UNCOMPRESSED: + +.. rst-class:: classref-enumeration-constant + +:ref:`HandleBinaryImageMode` **HANDLE_BINARY_IMAGE_MODE_EMBED_AS_UNCOMPRESSED** = ``3`` + +When importing a glTF file with embedded binary images, embeds textures compressed losslessly into the generated scene. Images stored as separate files in the ``res://`` folder are not affected by this; those will be used as Godot imported them. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + Constantes -------------------- @@ -174,6 +227,8 @@ Constantes **HANDLE_BINARY_DISCARD_TEXTURES** = ``0`` :ref:`🔗` +**Obsoleto:** Use :ref:`HANDLE_BINARY_IMAGE_MODE_DISCARD_TEXTURES` instead. + Descarta todas las texturas incrustadas y usa materiales sin textura. .. _class_GLTFState_constant_HANDLE_BINARY_EXTRACT_TEXTURES: @@ -182,6 +237,8 @@ Descarta todas las texturas incrustadas y usa materiales sin textura. **HANDLE_BINARY_EXTRACT_TEXTURES** = ``1`` :ref:`🔗` +**Obsoleto:** Use :ref:`HANDLE_BINARY_IMAGE_MODE_EXTRACT_TEXTURES` instead. + Extrae las texturas incrustadas para ser reimportadas y comprimidas. Solo en el editor. Actúa como sin comprimir en tiempo de ejecución. .. _class_GLTFState_constant_HANDLE_BINARY_EMBED_AS_BASISU: @@ -190,6 +247,8 @@ Extrae las texturas incrustadas para ser reimportadas y comprimidas. Solo en el **HANDLE_BINARY_EMBED_AS_BASISU** = ``2`` :ref:`🔗` +**Obsoleto:** Use :ref:`HANDLE_BINARY_IMAGE_MODE_EMBED_AS_BASISU` instead. + Incrusta texturas comprimidas para VRAM con Basis Universal en la escena generada. .. _class_GLTFState_constant_HANDLE_BINARY_EMBED_AS_UNCOMPRESSED: @@ -198,6 +257,8 @@ Incrusta texturas comprimidas para VRAM con Basis Universal en la escena generad **HANDLE_BINARY_EMBED_AS_UNCOMPRESSED** = ``3`` :ref:`🔗` +**Obsoleto:** Use :ref:`HANDLE_BINARY_IMAGE_MODE_EMBED_AS_UNCOMPRESSED` instead. + Incrusta texturas comprimidas sin pérdida en la escena generada, coincidiendo con el comportamiento anterior. .. rst-class:: classref-section-separator @@ -334,6 +395,25 @@ El búfer binario adjunto a un archivo .glb. ---- +.. _class_GLTFState_property_handle_binary_image_mode: + +.. rst-class:: classref-property + +:ref:`HandleBinaryImageMode` **handle_binary_image_mode** = ``1`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_handle_binary_image_mode**\ (\ value\: :ref:`HandleBinaryImageMode`\ ) +- :ref:`HandleBinaryImageMode` **get_handle_binary_image_mode**\ (\ ) + +When importing a glTF file with unimported raw binary images embedded inside of binary blob buffers, in data URIs, or separate files not imported by Godot, this controls how the images are handled. Images can be discarded, saved as separate files, or embedded in the scene lossily or losslessly. See :ref:`HandleBinaryImageMode` for options. + +This property does nothing for image files in the ``res://`` folder imported by Godot, as those are handled by Godot's image importer directly, and then the Godot scene generated from the glTF file will use the images as Godot imported them. + +.. rst-class:: classref-item-separator + +---- + .. _class_GLTFState_property_import_as_skeleton_bones: .. rst-class:: classref-property @@ -510,7 +590,7 @@ El parámetro ``parent_node_index`` es el índice del :ref:`GLTFNode`\[:ref:`GLTFAccessor`\] **get_accessors**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`GLTFAccessor`\] **get_accessors**\ (\ ) |const| :ref:`🔗` .. container:: contribute @@ -524,7 +604,7 @@ El parámetro ``parent_node_index`` es el índice del :ref:`GLTFNode` **get_additional_data**\ (\ extension_name\: :ref:`StringName`\ ) :ref:`🔗` +:ref:`Variant` **get_additional_data**\ (\ extension_name\: :ref:`StringName`\ ) |const| :ref:`🔗` Obtiene datos arbitrarios adicionales en esta instancia de **GLTFState**. Esto se puede usar para mantener datos de estado por archivo en las clases :ref:`GLTFDocumentExtension`, lo cual es importante porque no tienen estado. @@ -538,7 +618,7 @@ El argumento debe ser el nombre de :ref:`GLTFDocumentExtension` **get_animation_player**\ (\ idx\: :ref:`int`\ ) :ref:`🔗` +:ref:`AnimationPlayer` **get_animation_player**\ (\ anim_player_index\: :ref:`int`\ ) |const| :ref:`🔗` Devuelve el nodo :ref:`AnimationPlayer` con el índice dado. Estos nodos solo se usan durante el proceso de exportación al convertir los nodos :ref:`AnimationPlayer` de Godot en animaciones glTF. @@ -550,7 +630,7 @@ Devuelve el nodo :ref:`AnimationPlayer` con el índice da .. rst-class:: classref-method -:ref:`int` **get_animation_players_count**\ (\ idx\: :ref:`int`\ ) :ref:`🔗` +:ref:`int` **get_animation_players_count**\ (\ anim_player_index\: :ref:`int`\ ) |const| :ref:`🔗` Devuelve el número de nodos :ref:`AnimationPlayer` en este **GLTFState**. Estos nodos solo se utilizan durante el proceso de exportación al convertir los nodos :ref:`AnimationPlayer` de Godot en animaciones glTF. @@ -562,7 +642,7 @@ Devuelve el número de nodos :ref:`AnimationPlayer` en es .. rst-class:: classref-method -:ref:`Array`\[:ref:`GLTFAnimation`\] **get_animations**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`GLTFAnimation`\] **get_animations**\ (\ ) |const| :ref:`🔗` Devuelve un array de todos los :ref:`GLTFAnimation`\ s en el archivo glTF. Al importar, estos se generarán como animaciones en un nodo :ref:`AnimationPlayer`. Al exportar, estos se generarán a partir de nodos :ref:`AnimationPlayer` de Godot. @@ -574,7 +654,7 @@ Devuelve un array de todos los :ref:`GLTFAnimation`\ s en e .. rst-class:: classref-method -:ref:`Array`\[:ref:`GLTFBufferView`\] **get_buffer_views**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`GLTFBufferView`\] **get_buffer_views**\ (\ ) |const| :ref:`🔗` .. container:: contribute @@ -588,7 +668,7 @@ Devuelve un array de todos los :ref:`GLTFAnimation`\ s en e .. rst-class:: classref-method -:ref:`Array`\[:ref:`GLTFCamera`\] **get_cameras**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`GLTFCamera`\] **get_cameras**\ (\ ) |const| :ref:`🔗` Devuelve un array de todos los :ref:`GLTFCamera` en el archivo glTF. Estas son las cámaras a las que se refiere el índice :ref:`GLTFNode.camera`. @@ -600,11 +680,11 @@ Devuelve un array de todos los :ref:`GLTFCamera` en el archivo .. rst-class:: classref-method -:ref:`int` **get_handle_binary_image**\ (\ ) :ref:`🔗` +:ref:`int` **get_handle_binary_image**\ (\ ) |const| :ref:`🔗` -.. container:: contribute +**Obsoleto:** Use :ref:`handle_binary_image_mode` instead. - There is currently no description for this method. Please help us by `contributing one `__! +Deprecated untyped alias for :ref:`handle_binary_image_mode`. When importing a glTF file with unimported raw binary images embedded inside of binary blob buffers, in data URIs, or separate files not imported by Godot, this controls how the images are handled. .. rst-class:: classref-item-separator @@ -614,7 +694,7 @@ Devuelve un array de todos los :ref:`GLTFCamera` en el archivo .. rst-class:: classref-method -:ref:`Array`\[:ref:`Texture2D`\] **get_images**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`Texture2D`\] **get_images**\ (\ ) |const| :ref:`🔗` Obtiene las imágenes del archivo glTF como un array de :ref:`Texture2D`\ s. Estas son las imágenes a las que se refiere el índice :ref:`GLTFTexture.src_image`. @@ -626,7 +706,7 @@ Obtiene las imágenes del archivo glTF como un array de :ref:`Texture2D`\[:ref:`GLTFLight`\] **get_lights**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`GLTFLight`\] **get_lights**\ (\ ) |const| :ref:`🔗` Devuelve un array de todas las :ref:`GLTFLight`\ s en el archivo glTF. Estas son las luces a las que se refiere el índice :ref:`GLTFNode.light`. @@ -638,7 +718,7 @@ Devuelve un array de todas las :ref:`GLTFLight`\ s en el archiv .. rst-class:: classref-method -:ref:`Array`\[:ref:`Material`\] **get_materials**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`Material`\] **get_materials**\ (\ ) |const| :ref:`🔗` .. container:: contribute @@ -652,7 +732,7 @@ Devuelve un array de todas las :ref:`GLTFLight`\ s en el archiv .. rst-class:: classref-method -:ref:`Array`\[:ref:`GLTFMesh`\] **get_meshes**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`GLTFMesh`\] **get_meshes**\ (\ ) |const| :ref:`🔗` Devuelve un array de todos los :ref:`GLTFMesh` del archivo glTF. Estas son las mallas a las que se refiere el índice :ref:`GLTFNode.mesh`. @@ -664,7 +744,7 @@ Devuelve un array de todos los :ref:`GLTFMesh` del archivo glTF. .. rst-class:: classref-method -:ref:`int` **get_node_index**\ (\ scene_node\: :ref:`Node`\ ) :ref:`🔗` +:ref:`int` **get_node_index**\ (\ scene_node\: :ref:`Node`\ ) |const| :ref:`🔗` Devuelve el índice del :ref:`GLTFNode` correspondiente a este nodo de escena de Godot. Esta es la inversa de :ref:`get_scene_node()`. Útil durante el proceso de exportación. @@ -678,7 +758,7 @@ Devuelve el índice del :ref:`GLTFNode` correspondiente a este n .. rst-class:: classref-method -:ref:`Array`\[:ref:`GLTFNode`\] **get_nodes**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`GLTFNode`\] **get_nodes**\ (\ ) |const| :ref:`🔗` Devuelve un array de todos los :ref:`GLTFNode`\ s en el archivo glTF. Estos son los nodos a los que :ref:`GLTFNode.children` y :ref:`root_nodes` se refieren. Esto incluye los nodos que pueden no ser generados en la escena de Godot, o los nodos que pueden generar múltiples nodos de la escena de Godot. @@ -690,7 +770,7 @@ Devuelve un array de todos los :ref:`GLTFNode`\ s en el archivo .. rst-class:: classref-method -:ref:`Node` **get_scene_node**\ (\ idx\: :ref:`int`\ ) :ref:`🔗` +:ref:`Node` **get_scene_node**\ (\ gltf_node_index\: :ref:`int`\ ) |const| :ref:`🔗` Devuelve el nodo de la escena de Godot que corresponde al mismo índice que el :ref:`GLTFNode` del que fue generado. Esta es la inversa de :ref:`get_node_index()`. Útil durante el proceso de importación. @@ -704,7 +784,7 @@ Devuelve el nodo de la escena de Godot que corresponde al mismo índice que el : .. rst-class:: classref-method -:ref:`Array`\[:ref:`GLTFSkeleton`\] **get_skeletons**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`GLTFSkeleton`\] **get_skeletons**\ (\ ) |const| :ref:`🔗` Devuelve un array de todos los :ref:`GLTFSkeleton`\ s en el archivo glTF. Estos son los esqueletos a los que se refiere el índice de :ref:`GLTFNode.skeleton`. @@ -716,7 +796,7 @@ Devuelve un array de todos los :ref:`GLTFSkeleton`\ s en el .. rst-class:: classref-method -:ref:`Array`\[:ref:`GLTFSkin`\] **get_skins**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`GLTFSkin`\] **get_skins**\ (\ ) |const| :ref:`🔗` Devuelve un array de todos los :ref:`GLTFSkin`\ s en el archivo glTF. Estos son las pieles a las que se refiere el índice de :ref:`GLTFNode.skin`. @@ -728,7 +808,7 @@ Devuelve un array de todos los :ref:`GLTFSkin`\ s en el archivo .. rst-class:: classref-method -:ref:`Array`\[:ref:`GLTFTextureSampler`\] **get_texture_samplers**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`GLTFTextureSampler`\] **get_texture_samplers**\ (\ ) |const| :ref:`🔗` Retrieves the array of texture samplers that are used by the textures contained in the glTF. @@ -740,7 +820,7 @@ Retrieves the array of texture samplers that are used by the textures contained .. rst-class:: classref-method -:ref:`Array`\[:ref:`GLTFTexture`\] **get_textures**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`GLTFTexture`\] **get_textures**\ (\ ) |const| :ref:`🔗` .. container:: contribute @@ -754,7 +834,7 @@ Retrieves the array of texture samplers that are used by the textures contained .. rst-class:: classref-method -:ref:`Array`\[:ref:`String`\] **get_unique_animation_names**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`String`\] **get_unique_animation_names**\ (\ ) |const| :ref:`🔗` Devuelve una lista de nombres de animación únicos. Esto solo se usa durante el proceso de importación. @@ -766,7 +846,7 @@ Devuelve una lista de nombres de animación únicos. Esto solo se usa durante el .. rst-class:: classref-method -:ref:`Array`\[:ref:`String`\] **get_unique_names**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`String`\] **get_unique_names**\ (\ ) |const| :ref:`🔗` Devuelve una lista de nombres de nodo únicos. Esto se usa tanto en el proceso de importación como en el de exportación. @@ -846,9 +926,9 @@ Establece las :ref:`GLTFCamera`\ s en el estado. Estas son las |void| **set_handle_binary_image**\ (\ method\: :ref:`int`\ ) :ref:`🔗` -.. container:: contribute +**Obsoleto:** Use :ref:`handle_binary_image_mode` instead. - There is currently no description for this method. Please help us by `contributing one `__! +Deprecated untyped alias for :ref:`handle_binary_image_mode`. When importing a glTF file with unimported raw binary images embedded inside of binary blob buffers, in data URIs, or separate files not imported by Godot, this controls how the images are handled. .. rst-class:: classref-item-separator diff --git a/classes/es/class_godotinstance.rst b/classes/es/class_godotinstance.rst new file mode 100644 index 0000000000..8dbaf91de4 --- /dev/null +++ b/classes/es/class_godotinstance.rst @@ -0,0 +1,140 @@ +:github_url: hide + +.. _class_GodotInstance: + +GodotInstance +============= + +**Hereda:** :ref:`Object` + +Provides access to an embedded Godot instance. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +GodotInstance represents a running Godot instance that is controlled from an outside codebase, without a perpetual main loop. It is created by the C API ``libgodot_create_godot_instance``. Only one may be created per process. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------+----------------------------------------------------------------+ + | |void| | :ref:`focus_in`\ (\ ) | + +-------------------------+----------------------------------------------------------------+ + | |void| | :ref:`focus_out`\ (\ ) | + +-------------------------+----------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_started`\ (\ ) | + +-------------------------+----------------------------------------------------------------+ + | :ref:`bool` | :ref:`iteration`\ (\ ) | + +-------------------------+----------------------------------------------------------------+ + | |void| | :ref:`pause`\ (\ ) | + +-------------------------+----------------------------------------------------------------+ + | |void| | :ref:`resume`\ (\ ) | + +-------------------------+----------------------------------------------------------------+ + | :ref:`bool` | :ref:`start`\ (\ ) | + +-------------------------+----------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_GodotInstance_method_focus_in: + +.. rst-class:: classref-method + +|void| **focus_in**\ (\ ) :ref:`🔗` + +Notifies the instance that it is now in focus. + +.. rst-class:: classref-item-separator + +---- + +.. _class_GodotInstance_method_focus_out: + +.. rst-class:: classref-method + +|void| **focus_out**\ (\ ) :ref:`🔗` + +Notifies the instance that it is now not in focus. + +.. rst-class:: classref-item-separator + +---- + +.. _class_GodotInstance_method_is_started: + +.. rst-class:: classref-method + +:ref:`bool` **is_started**\ (\ ) :ref:`🔗` + +Returns ``true`` if this instance has been fully started. + +.. rst-class:: classref-item-separator + +---- + +.. _class_GodotInstance_method_iteration: + +.. rst-class:: classref-method + +:ref:`bool` **iteration**\ (\ ) :ref:`🔗` + +Runs a single iteration of the main loop. Returns ``true`` if the engine is attempting to quit. + +.. rst-class:: classref-item-separator + +---- + +.. _class_GodotInstance_method_pause: + +.. rst-class:: classref-method + +|void| **pause**\ (\ ) :ref:`🔗` + +Notifies the instance that it is going to be paused. + +.. rst-class:: classref-item-separator + +---- + +.. _class_GodotInstance_method_resume: + +.. rst-class:: classref-method + +|void| **resume**\ (\ ) :ref:`🔗` + +Notifies the instance that it is being resumed. + +.. rst-class:: classref-item-separator + +---- + +.. _class_GodotInstance_method_start: + +.. rst-class:: classref-method + +:ref:`bool` **start**\ (\ ) :ref:`🔗` + +Finishes this instance's startup sequence. Returns ``true`` on success. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_gradient.rst b/classes/es/class_gradient.rst index 216b482248..fd6226936d 100644 --- a/classes/es/class_gradient.rst +++ b/classes/es/class_gradient.rst @@ -178,9 +178,9 @@ Los colores del gradiente como un :ref:`PackedColorArray - |void| **set_interpolation_color_space**\ (\ value\: :ref:`ColorSpace`\ ) - :ref:`ColorSpace` **get_interpolation_color_space**\ (\ ) -El espacio de color utilizado para interpolar entre los puntos del gradiente. No afecta a los colores devueltos, que siempre estarán en el espacio sRGB. +The color space used to interpolate between points of the gradient. It does not affect the returned colors, which will always use nonlinear sRGB encoding. -\ **Nota:** Este ajuste no tiene efecto cuando :ref:`interpolation_mode` se establece en :ref:`GRADIENT_INTERPOLATE_CONSTANT`. +\ **Note:** This setting has no effect when :ref:`interpolation_mode` is set to :ref:`GRADIENT_INTERPOLATE_CONSTANT`. .. rst-class:: classref-item-separator diff --git a/classes/es/class_graphedit.rst b/classes/es/class_graphedit.rst index abe189fb43..f8c671d917 100644 --- a/classes/es/class_graphedit.rst +++ b/classes/es/class_graphedit.rst @@ -876,7 +876,7 @@ Si es ``true``, habilita el snapping. - |void| **set_type_names**\ (\ value\: :ref:`Dictionary`\ ) - :ref:`Dictionary` **get_type_names**\ (\ ) -:ref:`Dictionary` de nombres de tipo de puerto legibles por humanos. +:ref:`Dictionary` of human-readable port type names. .. rst-class:: classref-item-separator @@ -1388,7 +1388,7 @@ See also :ref:`is_valid_connection_type()`\ ) :ref:`🔗` -Disallows to disconnect nodes when dragging from the left port of the :ref:`GraphNode`'s slot if it has the specified type. Use this to disable disconnection previously allowed with :ref:`add_valid_left_disconnect_type()`. +Disallows to disconnect nodes when dragging from the left port of the :ref:`GraphNode`'s slot if it has the specified type. Use this to disable a disconnection previously allowed with :ref:`add_valid_left_disconnect_type()`. .. rst-class:: classref-item-separator @@ -1400,7 +1400,7 @@ Disallows to disconnect nodes when dragging from the left port of the :ref:`Grap |void| **remove_valid_right_disconnect_type**\ (\ type\: :ref:`int`\ ) :ref:`🔗` -Disallows to disconnect nodes when dragging from the right port of the :ref:`GraphNode`'s slot if it has the specified type. Use this to disable disconnection previously allowed with :ref:`add_valid_right_disconnect_type()`. +Disallows to disconnect nodes when dragging from the right port of the :ref:`GraphNode`'s slot if it has the specified type. Use this to disable a disconnection previously allowed with :ref:`add_valid_right_disconnect_type()`. .. rst-class:: classref-item-separator @@ -1537,7 +1537,7 @@ El color del contorno del rectángulo de selección. :ref:`int` **connection_hover_thickness** = ``0`` :ref:`🔗` -Ensancha la línea de la conexión cuando el ratón se sitúa sobre ella en un factor porcentual. Un valor de ``0`` desactiva el resaltado. Un valor de ``100`` duplica el ancho de la línea. +Widens the line of a connection when the mouse is hovering over it by a percentage factor. A value of ``0`` disables the highlight. A value of ``100`` doubles the line width. .. rst-class:: classref-item-separator diff --git a/classes/es/class_graphelement.rst b/classes/es/class_graphelement.rst index 1fc4513e65..d99d1651df 100644 --- a/classes/es/class_graphelement.rst +++ b/classes/es/class_graphelement.rst @@ -35,6 +35,8 @@ Propiedades +-------------------------------+---------------------------------------------------------------------+-------------------+ | :ref:`bool` | :ref:`resizable` | ``false`` | +-------------------------------+---------------------------------------------------------------------+-------------------+ + | :ref:`bool` | :ref:`scaling_menus` | ``false`` | + +-------------------------------+---------------------------------------------------------------------+-------------------+ | :ref:`bool` | :ref:`selectable` | ``true`` | +-------------------------------+---------------------------------------------------------------------+-------------------+ | :ref:`bool` | :ref:`selected` | ``false`` | @@ -215,6 +217,23 @@ Si es ``true``, el usuario puede cambiar el tamaño del GraphElement. ---- +.. _class_GraphElement_property_scaling_menus: + +.. rst-class:: classref-property + +:ref:`bool` **scaling_menus** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_scaling_menus**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_scaling_menus**\ (\ ) + +If ``true``, :ref:`PopupMenu`\ s that are descendants of the GraphElement are scaled with the :ref:`GraphEdit` zoom. + +.. rst-class:: classref-item-separator + +---- + .. _class_GraphElement_property_selectable: .. rst-class:: classref-property diff --git a/classes/es/class_graphnode.rst b/classes/es/class_graphnode.rst index 5e7ef16dd7..ff8a711b98 100644 --- a/classes/es/class_graphnode.rst +++ b/classes/es/class_graphnode.rst @@ -87,6 +87,10 @@ Métodos +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Texture2D` | :ref:`get_slot_custom_icon_right`\ (\ slot_index\: :ref:`int`\ ) |const| | +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Variant` | :ref:`get_slot_metadata_left`\ (\ slot_index\: :ref:`int`\ ) |const| | + +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Variant` | :ref:`get_slot_metadata_right`\ (\ slot_index\: :ref:`int`\ ) |const| | + +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_slot_type_left`\ (\ slot_index\: :ref:`int`\ ) |const| | +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_slot_type_right`\ (\ slot_index\: :ref:`int`\ ) |const| | @@ -115,6 +119,10 @@ Métodos +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_slot_enabled_right`\ (\ slot_index\: :ref:`int`, enable\: :ref:`bool`\ ) | +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_slot_metadata_left`\ (\ slot_index\: :ref:`int`, value\: :ref:`Variant`\ ) | + +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_slot_metadata_right`\ (\ slot_index\: :ref:`int`, value\: :ref:`Variant`\ ) | + +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_slot_type_left`\ (\ slot_index\: :ref:`int`, type\: :ref:`int`\ ) | +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_slot_type_right`\ (\ slot_index\: :ref:`int`, type\: :ref:`int`\ ) | @@ -458,6 +466,30 @@ Devuelve la :ref:`Texture2D` personalizada derecha (salida) de ---- +.. _class_GraphNode_method_get_slot_metadata_left: + +.. rst-class:: classref-method + +:ref:`Variant` **get_slot_metadata_left**\ (\ slot_index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the left (input) metadata of the slot with the given ``slot_index``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_GraphNode_method_get_slot_metadata_right: + +.. rst-class:: classref-method + +:ref:`Variant` **get_slot_metadata_right**\ (\ slot_index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the right (output) metadata of the slot with the given ``slot_index``. + +.. rst-class:: classref-item-separator + +---- + .. _class_GraphNode_method_get_slot_type_left: .. rst-class:: classref-method @@ -638,6 +670,30 @@ Activa o desactiva el lado derecho (salida) de la ranura con el ``slot_index`` d ---- +.. _class_GraphNode_method_set_slot_metadata_left: + +.. rst-class:: classref-method + +|void| **set_slot_metadata_left**\ (\ slot_index\: :ref:`int`, value\: :ref:`Variant`\ ) :ref:`🔗` + +Sets the custom metadata for the left (input) side of the slot with the given ``slot_index`` to ``value``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_GraphNode_method_set_slot_metadata_right: + +.. rst-class:: classref-method + +|void| **set_slot_metadata_right**\ (\ slot_index\: :ref:`int`, value\: :ref:`Variant`\ ) :ref:`🔗` + +Sets the custom metadata for the right (output) side of the slot with the given ``slot_index`` to ``value``. + +.. rst-class:: classref-item-separator + +---- + .. _class_GraphNode_method_set_slot_type_left: .. rst-class:: classref-method diff --git a/classes/es/class_heightmapshape3d.rst b/classes/es/class_heightmapshape3d.rst index 7257eff7f1..964e894ae9 100644 --- a/classes/es/class_heightmapshape3d.rst +++ b/classes/es/class_heightmapshape3d.rst @@ -7,14 +7,18 @@ HeightMapShape3D **Hereda:** :ref:`Shape3D` **<** :ref:`Resource` **<** :ref:`RefCounted` **<** :ref:`Object` -Una forma de mapa de altura 3D utilizada para la colisión física. +A 3D heightmap shape used for physics collision. .. rst-class:: classref-introduction-group Descripción ---------------------- -A 3D heightmap shape, intended for use in physics. Usually used to provide a shape for a :ref:`CollisionShape3D`. This type is most commonly used for terrain with vertices placed in a fixed width grid. Due to the nature of the heightmap, it cannot be used to model overhangs or caves, which would require multiple vertices at the same vertical location. Holes can be punched through the collision by assigning :ref:`@GDScript.NAN` to the height of the desired vertices (this is supported in both GodotPhysics3D and Jolt Physics). You could then insert meshes with their own separate collision to provide overhangs, caves, and so on. +A 3D heightmap shape, intended for use in physics to provide a shape for a :ref:`CollisionShape3D`. This type is most commonly used for terrain with vertices placed in a fixed-width grid. + +The heightmap is represented as a 2D grid of height values, which represent the position of grid points on the Y axis. Grid points are spaced 1 unit apart on the X and Z axes, and the grid is centered on the origin of the :ref:`CollisionShape3D` node. Internally, each grid square is divided into two triangles. + +Due to the nature of the heightmap, it cannot be used to model overhangs or caves, which would require multiple vertices at the same vertical location. Holes can be punched through the collision by assigning :ref:`@GDScript.NAN` to the height of the desired vertices (this is supported in both GodotPhysics3D and Jolt Physics). You could then insert meshes with their own separate collision to provide overhangs, caves, and so on. \ **Performance:** **HeightMapShape3D** is faster to check collisions against than :ref:`ConcavePolygonShape3D`, but it is significantly slower than primitive shapes like :ref:`BoxShape3D`. @@ -36,6 +40,8 @@ A heightmap collision shape can also be built by using an :ref:`Image` of the shape. However, keep in mind that GodotPhysics3D does not support non-uniform scaling: you'll need to scale the Y axis by the same amount as the X and Z axes, which means the values in :ref:`map_data` will need to be pre-scaled by the inverse of that scale. Also note that GodotPhysics3D does not support scaling at all for dynamic bodies (that is, non-frozen :ref:`RigidBody3D` nodes); to use a scaled **HeightMapShape3D** with those, you will need to use Jolt Physics. + .. rst-class:: classref-reftable-group Propiedades @@ -88,7 +94,7 @@ Descripciones de Propiedades - |void| **set_map_data**\ (\ value\: :ref:`PackedFloat32Array`\ ) - :ref:`PackedFloat32Array` **get_map_data**\ (\ ) -Datos del mapa de altura. El tamaño del array debe ser igual a :ref:`map_width` multiplicado por :ref:`map_depth`. +Heightmap data. The array's size must be equal to :ref:`map_width` multiplied by :ref:`map_depth`. **Note:** The returned array is *copied* and any changes to it will not update the original property value. See :ref:`PackedFloat32Array` for more details. @@ -107,7 +113,7 @@ Datos del mapa de altura. El tamaño del array debe ser igual a :ref:`map_width< - |void| **set_map_depth**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_map_depth**\ (\ ) -Número de vértices en la profundidad del mapa de altura. Cambiar esto redimensionará :ref:`map_data`. +Number of vertices in the depth of the heightmap. Changing this will resize the :ref:`map_data`. .. rst-class:: classref-item-separator @@ -124,7 +130,7 @@ Número de vértices en la profundidad del mapa de altura. Cambiar esto redimens - |void| **set_map_width**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_map_width**\ (\ ) -Número de vértices en el ancho del mapa de altura. Cambiar esto redimensionará :ref:`map_data`. +Number of vertices in the width of the heightmap. Changing this will resize the :ref:`map_data`. .. rst-class:: classref-section-separator diff --git a/classes/es/class_hscrollbar.rst b/classes/es/class_hscrollbar.rst index 88e8541648..b14f063f5c 100644 --- a/classes/es/class_hscrollbar.rst +++ b/classes/es/class_hscrollbar.rst @@ -16,6 +16,53 @@ Descripción A horizontal scrollbar, typically used to navigate through content that extends beyond the visible width of a control. It is a :ref:`Range`-based control and goes from left (min) to right (max). +.. rst-class:: classref-reftable-group + +Propiedades del Tema +---------------------------------------- + +.. table:: + :widths: auto + + +-----------------------+-----------------------------------------------------------------------+-------+ + | :ref:`int` | :ref:`padding_bottom` | ``0`` | + +-----------------------+-----------------------------------------------------------------------+-------+ + | :ref:`int` | :ref:`padding_top` | ``0`` | + +-----------------------+-----------------------------------------------------------------------+-------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de las propiedades del tema +---------------------------------------------------------------------------------- + +.. _class_HScrollBar_theme_constant_padding_bottom: + +.. rst-class:: classref-themeproperty + +:ref:`int` **padding_bottom** = ``0`` :ref:`🔗` + +Padding between the bottom of the :ref:`ScrollBar.scroll` element and the :ref:`ScrollBar.grabber`. + +\ **Note:** To apply horizontal padding, modify the left/right content margins of :ref:`ScrollBar.scroll` instead. + +.. rst-class:: classref-item-separator + +---- + +.. _class_HScrollBar_theme_constant_padding_top: + +.. rst-class:: classref-themeproperty + +:ref:`int` **padding_top** = ``0`` :ref:`🔗` + +Padding between the top of the :ref:`ScrollBar.scroll` element and the :ref:`ScrollBar.grabber`. + +\ **Note:** To apply horizontal padding, modify the left/right content margins of :ref:`ScrollBar.scroll` instead. + .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` diff --git a/classes/es/class_httprequest.rst b/classes/es/class_httprequest.rst index 335d4108e2..05ce72d004 100644 --- a/classes/es/class_httprequest.rst +++ b/classes/es/class_httprequest.rst @@ -496,7 +496,9 @@ Maximum number of allowed redirects. - |void| **set_timeout**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_timeout**\ (\ ) -The duration to wait in seconds before a request times out. If :ref:`timeout` is set to ``0.0`` then the request will never time out. For simple requests, such as communication with a REST API, it is recommended that :ref:`timeout` is set to a value suitable for the server response time (e.g. between ``1.0`` and ``10.0``). This will help prevent unwanted timeouts caused by variation in server response times while still allowing the application to detect when a request has timed out. For larger requests such as file downloads it is suggested the :ref:`timeout` be set to ``0.0``, disabling the timeout functionality. This will help to prevent large transfers from failing due to exceeding the timeout value. +The duration to wait before a request times out, in seconds (independent of :ref:`Engine.time_scale`). If :ref:`timeout` is set to ``0.0``, the request will never time out. + +For simple requests, such as communication with a REST API, it is recommended to set :ref:`timeout` to a value suitable for the server response time (commonly between ``1.0`` and ``10.0``). This will help prevent unwanted timeouts caused by variation in response times while still allowing the application to detect when a request has timed out. For larger requests such as file downloads, it is recommended to set :ref:`timeout` to ``0.0``, disabling the timeout functionality. This will help prevent large transfers from failing due to exceeding the timeout value. .. rst-class:: classref-item-separator diff --git a/classes/es/class_ikmodifier3d.rst b/classes/es/class_ikmodifier3d.rst new file mode 100644 index 0000000000..18bdacb822 --- /dev/null +++ b/classes/es/class_ikmodifier3d.rst @@ -0,0 +1,136 @@ +:github_url: hide + +.. _class_IKModifier3D: + +IKModifier3D +============ + +**Hereda:** :ref:`SkeletonModifier3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` + +**Heredado por:** :ref:`ChainIK3D`, :ref:`TwoBoneIK3D` + +A node for inverse kinematics which may modify more than one bone. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Base class of :ref:`SkeletonModifier3D`\ s that has some joint lists and applies inverse kinematics. This class has some structs, enums, and helper methods which are useful to solve inverse kinematics. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +-------------------------+-------------------------------------------------------------------------+----------+ + | :ref:`bool` | :ref:`mutable_bone_axes` | ``true`` | + +-------------------------+-------------------------------------------------------------------------+----------+ + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-----------------------+------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear_settings`\ (\ ) | + +-----------------------+------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_setting_count`\ (\ ) |const| | + +-----------------------+------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`reset`\ (\ ) | + +-----------------------+------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_setting_count`\ (\ count\: :ref:`int`\ ) | + +-----------------------+------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_IKModifier3D_property_mutable_bone_axes: + +.. rst-class:: classref-property + +:ref:`bool` **mutable_bone_axes** = ``true`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_mutable_bone_axes**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **are_bone_axes_mutable**\ (\ ) + +If ``true``, the solver retrieves the bone axis from the bone pose every frame. + +If ``false``, the solver retrieves the bone axis from the bone rest and caches it, which increases performance slightly, but position changes in the bone pose made before processing this **IKModifier3D** are ignored. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_IKModifier3D_method_clear_settings: + +.. rst-class:: classref-method + +|void| **clear_settings**\ (\ ) :ref:`🔗` + +Limpia todos los ajustes. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IKModifier3D_method_get_setting_count: + +.. rst-class:: classref-method + +:ref:`int` **get_setting_count**\ (\ ) |const| :ref:`🔗` + +Returns the number of settings. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IKModifier3D_method_reset: + +.. rst-class:: classref-method + +|void| **reset**\ (\ ) :ref:`🔗` + +Resets a state with respect to the current bone pose. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IKModifier3D_method_set_setting_count: + +.. rst-class:: classref-method + +|void| **set_setting_count**\ (\ count\: :ref:`int`\ ) :ref:`🔗` + +Sets the number of settings. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_image.rst b/classes/es/class_image.rst index 17dc08690d..a95327c3c4 100644 --- a/classes/es/class_image.rst +++ b/classes/es/class_image.rst @@ -14,11 +14,13 @@ Tipo de datos de imagen. Descripción ---------------------- -El tipo de datos de imagen nativa. Contiene datos de imagen que pueden convertirse en una :ref:`ImageTexture` y proporciona métodos de *procesamiento de imágenes* de uso común. El ancho y el alto máximos para una **Image** son :ref:`MAX_WIDTH` y :ref:`MAX_HEIGHT`. +Native image datatype. Contains image data which can be converted to an :ref:`ImageTexture` and provides commonly used *image processing* methods. The maximum width and height for an **Image** are :ref:`MAX_WIDTH` and :ref:`MAX_HEIGHT`. -Una **Image** no se puede asignar directamente a una propiedad de textura de un objeto (como :ref:`Sprite2D.texture`), y primero debe convertirse manualmente en una :ref:`ImageTexture`. +An **Image** cannot be assigned to a texture property of an object directly (such as :ref:`Sprite2D.texture`), and has to be converted manually to an :ref:`ImageTexture` first. -\ **Nota:** El tamaño máximo de imagen es de 16384×16384 píxeles debido a las limitaciones del hardware de gráficos. Es posible que las imágenes más grandes no se importen. +\ **Note:** Methods that modify the image data cannot be used on VRAM-compressed images. Use :ref:`decompress()` to convert the image to an uncompressed format first. + +\ **Note:** The maximum image size is 16384×16384 pixels due to graphics hardware limitations. Larger images may fail to import. .. rst-class:: classref-introduction-group @@ -140,6 +142,8 @@ Métodos +-----------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Error` | :ref:`load_dds_from_buffer`\ (\ buffer\: :ref:`PackedByteArray`\ ) | +-----------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`load_exr_from_buffer`\ (\ buffer\: :ref:`PackedByteArray`\ ) | + +-----------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Image` | :ref:`load_from_file`\ (\ path\: :ref:`String`\ ) |static| | +-----------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Error` | :ref:`load_jpg_from_buffer`\ (\ buffer\: :ref:`PackedByteArray`\ ) | @@ -254,9 +258,9 @@ Formato de textura OpenGL ``RG`` con dos componentes y una profundidad de bits d :ref:`Format` **FORMAT_RGB8** = ``4`` -Formato de textura OpenGL ``RGB`` con tres componentes, cada uno con una profundidad de 8 bits. +OpenGL texture format ``RGB`` with three components, each with a bitdepth of 8. -\ **Nota:** Al crear una :ref:`ImageTexture`, se realiza una conversión del espacio de color sRGB a lineal. +\ **Note:** When creating an :ref:`ImageTexture`, a nonlinear sRGB to linear encoding conversion is performed. .. _class_Image_constant_FORMAT_RGBA8: @@ -264,9 +268,9 @@ Formato de textura OpenGL ``RGB`` con tres componentes, cada uno con una profund :ref:`Format` **FORMAT_RGBA8** = ``5`` -Formato de textura OpenGL ``RGB`` con tres componentes, cada uno con una profundidad de 8 bits. +OpenGL texture format ``RGBA`` with four components, each with a bitdepth of 8. -\ **Nota:** Al crear una :ref:`ImageTexture`, se realiza una conversión del espacio de color sRGB a lineal. +\ **Note:** When creating an :ref:`ImageTexture`, a nonlinear sRGB to linear encoding conversion is performed. .. _class_Image_constant_FORMAT_RGBA4444: @@ -362,9 +366,9 @@ Un formato especial de textura OpenGL donde los tres componentes de color tienen :ref:`Format` **FORMAT_DXT1** = ``17`` -El formato de textura `S3TC `__ que utiliza la Compresión de Bloque 1, y es la variación más pequeña de S3TC, sólo proporciona 1 bit de datos alfa y de color siendo premultiplicado con alfa. +The `S3TC `__ texture format that uses Block Compression 1, and is the smallest variation of S3TC, only providing 1 bit of alpha and color data being premultiplied with alpha. -\ **Nota:** Al crear una :ref:`ImageTexture`, se realiza una conversión del espacio de color sRGB a lineal. +\ **Note:** When creating an :ref:`ImageTexture`, a nonlinear sRGB to linear encoding conversion is performed. .. _class_Image_constant_FORMAT_DXT3: @@ -372,9 +376,9 @@ El formato de textura `S3TC ` **FORMAT_DXT3** = ``18`` -El formato de textura `S3TC `__ que utiliza la Compresión de Bloque 2, y los datos de color se interpretan como que no han sido premultiplicados por el alfa. Es muy adecuado para imágenes con transiciones alfa nítidas entre áreas translúcidas y opacas. +The `S3TC `__ texture format that uses Block Compression 2, and color data is interpreted as not having been premultiplied by alpha. Well suited for images with sharp alpha transitions between translucent and opaque areas. -\ **Nota:** Al crear una :ref:`ImageTexture`, se realiza una conversión del espacio de color sRGB a lineal. +\ **Note:** When creating an :ref:`ImageTexture`, a nonlinear sRGB to linear encoding conversion is performed. .. _class_Image_constant_FORMAT_DXT5: @@ -382,9 +386,9 @@ El formato de textura `S3TC ` **FORMAT_DXT5** = ``19`` -El formato de textura `S3TC `__ también conocido como Compresión de Bloque 3 o BC3 que contiene 64 bits de datos de canal alfa seguidos de 64 bits de datos de color codificados en DXT1. Los datos de color no son premultiplicados por el alfa, igual que el DXT3. DXT5 generalmente produce resultados superiores para gradientes transparentes en comparación con DXT3. +The `S3TC `__ texture format also known as Block Compression 3 or BC3 that contains 64 bits of alpha channel data followed by 64 bits of DXT1-encoded color data. Color data is not premultiplied by alpha, same as DXT3. DXT5 generally produces superior results for transparent gradients compared to DXT3. -\ **Nota:** Al crear una :ref:`ImageTexture`, se realiza una conversión del espacio de color sRGB a lineal. +\ **Note:** When creating an :ref:`ImageTexture`, a nonlinear sRGB to linear encoding conversion is performed. .. _class_Image_constant_FORMAT_RGTC_R: @@ -408,9 +412,9 @@ Formato de textura que utiliza `Compresión de textura rojo-verde ` **FORMAT_BPTC_RGBA** = ``22`` -Formato de textura que utiliza la compresión `BPTC `__ con componentes RGBA normalizados sin signo. +Texture format that uses `BPTC `__ compression with unsigned normalized RGBA components. -\ **Nota:** Al crear una :ref:`ImageTexture`, se realiza una conversión del espacio de color sRGB a lineal. +\ **Note:** When creating an :ref:`ImageTexture`, a nonlinear sRGB to linear encoding conversion is performed. .. _class_Image_constant_FORMAT_BPTC_RGBF: @@ -474,9 +478,9 @@ Formato de textura que utiliza la compresión `BPTC ` **FORMAT_ETC2_RGB8** = ``30`` -`Formato de compresión de textura de Ericsson 2 `__ (``RGB8`` variant), que es una continuación del ETC1 y comprime los datos del RGB888. +`Ericsson Texture Compression format 2 `__ (``RGB8`` variant), which is a follow-up of ETC1 and compresses RGB888 data. -\ **Nota:** Al crear una :ref:`ImageTexture`, se realiza una conversión del espacio de color sRGB a lineal. +\ **Note:** When creating an :ref:`ImageTexture`, a nonlinear sRGB to linear encoding conversion is performed. .. _class_Image_constant_FORMAT_ETC2_RGBA8: @@ -484,9 +488,9 @@ Formato de textura que utiliza la compresión `BPTC ` **FORMAT_ETC2_RGBA8** = ``31`` -`Formato de compresión de textura de Ericsson 2 `__ (``RGBA8``\ variant), que comprime los datos de RGBA8888 con soporte alfa completo. +`Ericsson Texture Compression format 2 `__ (``RGBA8``\ variant), which compresses RGBA8888 data with full alpha support. -\ **Nota:** Al crear una :ref:`ImageTexture`, se realiza una conversión del espacio de color sRGB a lineal. +\ **Note:** When creating an :ref:`ImageTexture`, a nonlinear sRGB to linear encoding conversion is performed. .. _class_Image_constant_FORMAT_ETC2_RGB8A1: @@ -494,9 +498,9 @@ Formato de textura que utiliza la compresión `BPTC ` **FORMAT_ETC2_RGB8A1** = ``32`` -`Formato de compresión de textura de Ericsson 2 `__ (``RGB8_PUNCHTHROUGH_ALPHA1`` variant), que comprime los datos de RGBA para hacer el alfa totalmente transparente o totalmente opaco. +`Ericsson Texture Compression format 2 `__ (``RGB8_PUNCHTHROUGH_ALPHA1`` variant), which compresses RGBA data to make alpha either fully transparent or fully opaque. -\ **Nota:** Al crear una :ref:`ImageTexture`, se realiza una conversión del espacio de color sRGB a lineal. +\ **Note:** When creating an :ref:`ImageTexture`, a nonlinear sRGB to linear encoding conversion is performed. .. _class_Image_constant_FORMAT_ETC2_RA_AS_RG: @@ -546,11 +550,99 @@ Mismo formato que :ref:`FORMAT_ASTC_4x4`, Mismo formato que :ref:`FORMAT_ASTC_8x8`, pero con la pista para que la GPU sepa que se utiliza para HDR. +.. _class_Image_constant_FORMAT_R16: + +.. rst-class:: classref-enumeration-constant + +:ref:`Format` **FORMAT_R16** = ``39`` + +OpenGL texture format ``GL_R16`` where there's one component, a 16-bit unsigned normalized integer value. Since the value is normalized, each component is clamped between ``0.0`` and ``1.0`` (inclusive). + +\ **Note:** Due to limited hardware support, it is mainly recommended to be used on desktop or console devices. It may be unsupported on mobile or web, and will consequently be converted to :ref:`FORMAT_RF`. + +.. _class_Image_constant_FORMAT_RG16: + +.. rst-class:: classref-enumeration-constant + +:ref:`Format` **FORMAT_RG16** = ``40`` + +OpenGL texture format ``GL_RG16`` where there are two components, each a 16-bit unsigned normalized integer value. Since the value is normalized, each component is clamped between ``0.0`` and ``1.0`` (inclusive). + +\ **Note:** Due to limited hardware support, it is mainly recommended to be used on desktop or console devices. It may be unsupported on mobile or web, and will consequently be converted to :ref:`FORMAT_RGF`. + +.. _class_Image_constant_FORMAT_RGB16: + +.. rst-class:: classref-enumeration-constant + +:ref:`Format` **FORMAT_RGB16** = ``41`` + +OpenGL texture format ``GL_RGB16`` where there are three components, each a 16-bit unsigned normalized integer value. Since the value is normalized, each component is clamped between ``0.0`` and ``1.0`` (inclusive). + +\ **Note:** Due to limited hardware support, it is mainly recommended to be used on desktop or console devices. It may be unsupported on mobile or web, and will consequently be converted to :ref:`FORMAT_RGBF`. + +.. _class_Image_constant_FORMAT_RGBA16: + +.. rst-class:: classref-enumeration-constant + +:ref:`Format` **FORMAT_RGBA16** = ``42`` + +OpenGL texture format ``GL_RGBA16`` where there are four components, each a 16-bit unsigned normalized integer value. Since the value is normalized, each component is clamped between ``0.0`` and ``1.0`` (inclusive). + +\ **Note:** Due to limited hardware support, it is mainly recommended to be used on desktop or console devices. It may be unsupported on mobile or web, and will consequently be converted to :ref:`FORMAT_RGBAF`. + +.. _class_Image_constant_FORMAT_R16I: + +.. rst-class:: classref-enumeration-constant + +:ref:`Format` **FORMAT_R16I** = ``43`` + +OpenGL texture format ``GL_R16UI`` where there's one component, a 16-bit unsigned integer value. Each component is clamped between ``0`` and ``65535`` (inclusive). + +\ **Note:** When used in a shader, the texture requires usage of ``usampler`` samplers. Additionally, it only supports nearest-neighbor filtering under the Compatibility renderer. + +\ **Note:** When sampling using :ref:`get_pixel()`, returned :ref:`Color`\ s have to be divided by ``65535`` to get the correct color value. + +.. _class_Image_constant_FORMAT_RG16I: + +.. rst-class:: classref-enumeration-constant + +:ref:`Format` **FORMAT_RG16I** = ``44`` + +OpenGL texture format ``GL_RG16UI`` where there are two components, each a 16-bit unsigned integer value. Each component is clamped between ``0`` and ``65535`` (inclusive). + +\ **Note:** When used in a shader, the texture requires usage of ``usampler`` samplers. Additionally, it only supports nearest-neighbor filtering under the Compatibility renderer. + +\ **Note:** When sampling using :ref:`get_pixel()`, returned :ref:`Color`\ s have to be divided by ``65535`` to get the correct color value. + +.. _class_Image_constant_FORMAT_RGB16I: + +.. rst-class:: classref-enumeration-constant + +:ref:`Format` **FORMAT_RGB16I** = ``45`` + +OpenGL texture format ``GL_RGB16UI`` where there are three components, each a 16-bit unsigned integer value. Each component is clamped between ``0`` and ``65535`` (inclusive). + +\ **Note:** When used in a shader, the texture requires usage of ``usampler`` samplers. Additionally, it only supports nearest-neighbor filtering under the Compatibility renderer. + +\ **Note:** When sampling using :ref:`get_pixel()`, returned :ref:`Color`\ s have to be divided by ``65535`` to get the correct color value. + +.. _class_Image_constant_FORMAT_RGBA16I: + +.. rst-class:: classref-enumeration-constant + +:ref:`Format` **FORMAT_RGBA16I** = ``46`` + +OpenGL texture format ``GL_RGBA16UI`` where there are four components, each a 16-bit unsigned integer value. Each component is clamped between ``0`` and ``65535`` (inclusive). + +\ **Note:** When used in a shader, the texture requires usage of ``usampler`` samplers. Additionally, it only supports nearest-neighbor filtering under the Compatibility renderer. + +\ **Note:** When sampling using :ref:`get_pixel()`, returned :ref:`Color`\ s have to be divided by ``65535`` to get the correct color value. + .. _class_Image_constant_FORMAT_MAX: .. rst-class:: classref-enumeration-constant -:ref:`Format` **FORMAT_MAX** = ``39`` +:ref:`Format` **FORMAT_MAX** = ``47`` Representa el tamaño del enum :ref:`Format`. @@ -628,7 +720,7 @@ enum **AlphaMode**: :ref:`🔗` :ref:`AlphaMode` **ALPHA_NONE** = ``0`` -La imagen no tiene alfa. +Image is fully opaque. It does not store alpha data. .. _class_Image_constant_ALPHA_BIT: @@ -636,7 +728,7 @@ La imagen no tiene alfa. :ref:`AlphaMode` **ALPHA_BIT** = ``1`` -La imagen almacena el alfa en un solo bit. +Image stores either fully opaque or fully transparent pixels. Also known as punchthrough alpha. .. _class_Image_constant_ALPHA_BLEND: @@ -644,7 +736,7 @@ La imagen almacena el alfa en un solo bit. :ref:`AlphaMode` **ALPHA_BLEND** = ``2`` -La imagen usa el alfa. +Image stores alpha data with values varying between ``0.0`` and ``1.0``. .. rst-class:: classref-item-separator @@ -786,7 +878,7 @@ La textura de la fuente (antes de la compresión) es una textura regular. Por de :ref:`CompressSource` **COMPRESS_SOURCE_SRGB** = ``1`` -La textura de la fuente (antes de la compresión) está en el espacio sRGB. +Source texture (before compression) uses nonlinear sRGB encoding. .. _class_Image_constant_COMPRESS_SOURCE_NORMAL: @@ -965,11 +1057,13 @@ Elimina los mipmaps de la imagen. :ref:`Error` **compress**\ (\ mode\: :ref:`CompressMode`, source\: :ref:`CompressSource` = 0, astc_format\: :ref:`ASTCFormat` = 0\ ) :ref:`🔗` -Compresses the image to use less memory. Can not directly access pixel data while the image is compressed. Returns error if the chosen compression mode is not available. +Compresses the image with a VRAM-compressed format to use less memory. Can not directly access pixel data while the image is compressed. Returns error if the chosen compression mode is not available. The ``source`` parameter helps to pick the best compression method for DXT and ETC2 formats. It is ignored for ASTC compression. -For ASTC compression, the ``astc_format`` parameter must be supplied. +The ``astc_format`` parameter is only taken into account when using ASTC compression; it is ignored for all other formats. + +\ **Note:** :ref:`compress()` is only supported in editor builds. When run in an exported project, this method always returns :ref:`@GlobalScope.ERR_UNAVAILABLE`. .. rst-class:: classref-item-separator @@ -981,11 +1075,13 @@ For ASTC compression, the ``astc_format`` parameter must be supplied. :ref:`Error` **compress_from_channels**\ (\ mode\: :ref:`CompressMode`, channels\: :ref:`UsedChannels`, astc_format\: :ref:`ASTCFormat` = 0\ ) :ref:`🔗` -Comprime la imagen para usar menos memoria. No se puede acceder directamente a los datos de los píxeles mientras la imagen está comprimida. Devuelve un error si el modo de compresión elegido no está disponible. +Compresses the image with a VRAM-compressed format to use less memory. Can not directly access pixel data while the image is compressed. Returns error if the chosen compression mode is not available. -Esta es una alternativa a :ref:`compress()` que permite al usuario proporcionar los canales utilizados para que el compresor elija los mejores formatos DXT y ETC2. Para otros formatos (no DXT o ETC2), este argumento se ignora. +This is an alternative to :ref:`compress()` that lets the user supply the channels used in order for the compressor to pick the best DXT and ETC2 formats. For other formats (non DXT or ETC2), this argument is ignored. -Para la compresión ASTC, se debe proporcionar el parámetro ``astc_format``. +The ``astc_format`` parameter is only taken into account when using ASTC compression; it is ignored for all other formats. + +\ **Note:** :ref:`compress_from_channels()` is only supported in editor builds. When run in an exported project, this method always returns :ref:`@GlobalScope.ERR_UNAVAILABLE`. .. rst-class:: classref-item-separator @@ -997,9 +1093,9 @@ Para la compresión ASTC, se debe proporcionar el parámetro ``astc_format``. :ref:`Dictionary` **compute_image_metrics**\ (\ compared_image\: :ref:`Image`, use_luma\: :ref:`bool`\ ) :ref:`🔗` -Calcula las métricas de la imagen en la imagen actual y la imagen comparada. +Compute image metrics on the current image and the compared image. This can be used to calculate the similarity between two images. -El diccionario contiene ``max``, ``mean``, ``mean_squared``, ``root_mean_squared`` y ``peak_snr``. +The dictionary contains ``max``, ``mean``, ``mean_squared``, ``root_mean_squared`` and ``peak_snr``. .. rst-class:: classref-item-separator @@ -1037,7 +1133,7 @@ Copia la imagen ``src`` a esta imagen. **Obsoleto:** Use :ref:`create_empty()`. -Crea una imagen vacía con el tamaño y formato dados. Si ``use_mipmaps`` es ``true``, genera mipmaps para esta imagen. Véase :ref:`generate_mipmaps()`. +Creates an empty image of the given size and format. If ``use_mipmaps`` is ``true``, generates mipmaps for this image (see :ref:`generate_mipmaps()`). .. rst-class:: classref-item-separator @@ -1049,7 +1145,7 @@ Crea una imagen vacía con el tamaño y formato dados. Si ``use_mipmaps`` es ``t :ref:`Image` **create_empty**\ (\ width\: :ref:`int`, height\: :ref:`int`, use_mipmaps\: :ref:`bool`, format\: :ref:`Format`\ ) |static| :ref:`🔗` -Crea una imagen vacía con el tamaño y formato dados. Si ``use_mipmaps`` es ``true``, genera mipmaps para esta imagen. Véase :ref:`generate_mipmaps()`. +Creates an empty image of the given size and format. If ``use_mipmaps`` is ``true``, generates mipmaps for this image (see :ref:`generate_mipmaps()`). .. rst-class:: classref-item-separator @@ -1085,9 +1181,7 @@ Recorta la imagen al ``width`` y ``height`` dados. Si el tamaño especificado es :ref:`Error` **decompress**\ (\ ) :ref:`🔗` -Descomprime la imagen si está comprimida en VRAM en un formato compatible. Devuelve :ref:`@GlobalScope.OK` si el formato es compatible, de lo contrario :ref:`@GlobalScope.ERR_UNAVAILABLE`. - -\ **Nota:** Los siguientes formatos se pueden descomprimir: DXT, RGTC, BPTC. Los formatos ETC1 y ETC2 no son compatibles. +Decompresses the image if it is VRAM-compressed in a supported format. This increases memory utilization, but allows modifying the image. Returns :ref:`@GlobalScope.OK` if the format is supported, otherwise :ref:`@GlobalScope.ERR_UNAVAILABLE`. All VRAM-compressed formats supported by Godot can be decompressed with this method, except :ref:`FORMAT_ETC2_R11S`, :ref:`FORMAT_ETC2_RG11S`, and :ref:`FORMAT_ETC2_RGB8A1`. .. rst-class:: classref-item-separator @@ -1393,7 +1487,7 @@ Devuelve ``true`` si todos los píxeles de la imagen tienen un valor alfa de 0. |void| **linear_to_srgb**\ (\ ) :ref:`🔗` -Convierte toda la imagen del espacio de color lineal al espacio de color sRGB. Solo funciona en imágenes con formatos :ref:`FORMAT_RGB8` o :ref:`FORMAT_RGBA8`. +Converts the entire image from linear encoding to nonlinear sRGB encoding by using a lookup table. Only works on images with :ref:`FORMAT_RGB8` or :ref:`FORMAT_RGBA8` formats. .. rst-class:: classref-item-separator @@ -1445,6 +1539,18 @@ Carga una imagen desde el contenido binario de un archivo DDS. ---- +.. _class_Image_method_load_exr_from_buffer: + +.. rst-class:: classref-method + +:ref:`Error` **load_exr_from_buffer**\ (\ buffer\: :ref:`PackedByteArray`\ ) :ref:`🔗` + +Loads an image from the binary contents of an OpenEXR file. + +.. rst-class:: classref-item-separator + +---- + .. _class_Image_method_load_from_file: .. rst-class:: classref-method @@ -1607,7 +1713,7 @@ Redimensiona la imagen a la potencia de 2 más cercana para el ancho y la altura :ref:`Image` **rgbe_to_srgb**\ (\ ) :ref:`🔗` -Convierte una imagen estándar RGBE (Red Green Blue Exponent) en una imagen sRGB. +Converts a standard linear RGBE (Red Green Blue Exponent) image to an image that uses nonlinear sRGB encoding. .. rst-class:: classref-item-separator @@ -1671,9 +1777,7 @@ Guarda la imagen como un archivo DDS (DirectDraw Surface) en un array de bytes. :ref:`Error` **save_exr**\ (\ path\: :ref:`String`, grayscale\: :ref:`bool` = false\ ) |const| :ref:`🔗` -Guarda la imagen como un archivo EXR en ``path``. Si ``grayscale`` es ``true`` y la imagen tiene solo un canal, se guardará explícitamente como monocromo en lugar de como un canal rojo. Esta función devolverá :ref:`@GlobalScope.ERR_UNAVAILABLE` si Godot se compiló sin el módulo TinyEXR. - -\ **Nota:** El módulo TinyEXR está deshabilitado en las compilaciones que no son del editor, lo que significa que :ref:`save_exr()` devolverá :ref:`@GlobalScope.ERR_UNAVAILABLE` cuando se le llame desde un proyecto exportado. +Saves the image as an EXR file to ``path``. If ``grayscale`` is ``true`` and the image has only one channel, it will be saved explicitly as monochrome rather than one red channel. This function will return :ref:`@GlobalScope.ERR_UNAVAILABLE` if Godot was compiled without the TinyEXR module. .. rst-class:: classref-item-separator @@ -1685,9 +1789,7 @@ Guarda la imagen como un archivo EXR en ``path``. Si ``grayscale`` es ``true`` y :ref:`PackedByteArray` **save_exr_to_buffer**\ (\ grayscale\: :ref:`bool` = false\ ) |const| :ref:`🔗` -Guarda la imagen como un archivo EXR en un array de bytes. Si ``grayscale`` es ``true`` y la imagen tiene solo un canal, se guardará explícitamente como monocromo en lugar de como un canal rojo. Esta función devolverá un array de bytes vacío si Godot se compiló sin el módulo TinyEXR. - -\ **Nota:** El módulo TinyEXR está deshabilitado en las compilaciones que no son del editor, lo que significa que :ref:`save_exr_to_buffer()` devolverá un array de bytes vacío cuando se le llame desde un proyecto exportado. +Saves the image as an EXR file to a byte array. If ``grayscale`` is ``true`` and the image has only one channel, it will be saved explicitly as monochrome rather than one red channel. This function will return an empty byte array if Godot was compiled without the TinyEXR module. .. rst-class:: classref-item-separator @@ -1816,6 +1918,10 @@ Sets the :ref:`Color` of the pixel at ``(x, y)`` to ``color``. This is the same as :ref:`set_pixelv()`, but with a two integer arguments instead of a :ref:`Vector2i` argument. +\ **Note:** Depending on the image's format, the color set here may be clamped or lose precision. Do not assume the color returned by :ref:`get_pixel()` to be identical to the one set here; any comparisons will likely need to use an approximation like :ref:`Color.is_equal_approx()`. + +\ **Note:** On grayscale image formats, only the red channel of ``color`` is used (and alpha if relevant). The green and blue channels are ignored. + .. rst-class:: classref-item-separator ---- @@ -1851,6 +1957,10 @@ Sets the :ref:`Color` of the pixel at ``point`` to ``color``. This is the same as :ref:`set_pixel()`, but with a :ref:`Vector2i` argument instead of two integer arguments. +\ **Note:** Depending on the image's format, the color set here may be clamped or lose precision. Do not assume the color returned by :ref:`get_pixelv()` to be identical to the one set here; any comparisons will likely need to use an approximation like :ref:`Color.is_equal_approx()`. + +\ **Note:** On grayscale image formats, only the red channel of ``color`` is used (and alpha if relevant). The green and blue channels are ignored. + .. rst-class:: classref-item-separator ---- @@ -1873,7 +1983,9 @@ Reduce la imagen por un factor de 2 en cada eje (esto divide el número de píxe |void| **srgb_to_linear**\ (\ ) :ref:`🔗` -Convierte los datos sin procesar del espacio de color sRGB a una escala lineal. Solo funciona en imágenes con formatos :ref:`FORMAT_RGB8` o :ref:`FORMAT_RGBA8`. +Converts the raw data from nonlinear sRGB encoding to linear encoding using a lookup table. Only works on images with :ref:`FORMAT_RGB8` or :ref:`FORMAT_RGBA8` formats. + +\ **Note:** The 8-bit formats required by this method are not suitable for storing linearly encoded values; a significant amount of color information will be lost in darker values. To maintain image quality, this method should not be used. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_immediatemesh.rst b/classes/es/class_immediatemesh.rst index 784d73f65e..387301fca4 100644 --- a/classes/es/class_immediatemesh.rst +++ b/classes/es/class_immediatemesh.rst @@ -179,7 +179,9 @@ Establece el atributo normal que se enviará con el siguiente vértice. |void| **surface_set_tangent**\ (\ tangent\: :ref:`Plane`\ ) :ref:`🔗` -Establece el atributo tangente que se enviará con el siguiente vértice. +Set the tangent attribute that will be pushed with the next vertex. + +\ **Note:** Even though ``tangent`` is a :ref:`Plane`, it does not directly represent the tangent plane. Its :ref:`Plane.x`, :ref:`Plane.y`, and :ref:`Plane.z` represent the tangent vector and :ref:`Plane.d` should be either ``-1`` or ``1``. See also :ref:`Mesh.ARRAY_TANGENT`. .. rst-class:: classref-item-separator diff --git a/classes/es/class_importermesh.rst b/classes/es/class_importermesh.rst index 78c133d265..e3d8d2c3a1 100644 --- a/classes/es/class_importermesh.rst +++ b/classes/es/class_importermesh.rst @@ -33,6 +33,8 @@ Métodos +-------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`clear`\ (\ ) | +-------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`ImporterMesh` | :ref:`from_mesh`\ (\ mesh\: :ref:`Mesh`\ ) |static| | + +-------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`generate_lods`\ (\ normal_merge_angle\: :ref:`float`, normal_split_angle\: :ref:`float`, bone_transform_array\: :ref:`Array`\ ) | +-------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_blend_shape_count`\ (\ ) |const| | @@ -131,6 +133,18 @@ Elimina todas las superficies y las blendshapes de este **ImporterMesh**. ---- +.. _class_ImporterMesh_method_from_mesh: + +.. rst-class:: classref-method + +:ref:`ImporterMesh` **from_mesh**\ (\ mesh\: :ref:`Mesh`\ ) |static| :ref:`🔗` + +Converts the given :ref:`Mesh` into an **ImporterMesh** by copying all its surfaces, blend shapes, materials, and metadata into a new **ImporterMesh** object. + +.. rst-class:: classref-item-separator + +---- + .. _class_ImporterMesh_method_generate_lods: .. rst-class:: classref-method diff --git a/classes/es/class_input.rst b/classes/es/class_input.rst index b0900c1707..9c7d69c423 100644 --- a/classes/es/class_input.rst +++ b/classes/es/class_input.rst @@ -102,6 +102,8 @@ Métodos +-------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`get_vector`\ (\ negative_x\: :ref:`StringName`, positive_x\: :ref:`StringName`, negative_y\: :ref:`StringName`, positive_y\: :ref:`StringName`, deadzone\: :ref:`float` = -1.0\ ) |const| | +-------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_joy_light`\ (\ device\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_action_just_pressed`\ (\ action\: :ref:`StringName`, exact_match\: :ref:`bool` = false\ ) |const| | +-------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_action_just_pressed_by_event`\ (\ action\: :ref:`StringName`, event\: :ref:`InputEvent`, exact_match\: :ref:`bool` = false\ ) |const| | @@ -140,6 +142,8 @@ Métodos +-------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_gyroscope`\ (\ value\: :ref:`Vector3`\ ) | +-------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`set_joy_light`\ (\ device\: :ref:`int`, color\: :ref:`Color`\ ) | + +-------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_magnetometer`\ (\ value\: :ref:`Vector3`\ ) | +-------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`should_ignore_device`\ (\ vendor_id\: :ref:`int`, product_id\: :ref:`int`\ ) |const| | @@ -797,6 +801,20 @@ By default, the deadzone is automatically calculated from the average of the act ---- +.. _class_Input_method_has_joy_light: + +.. rst-class:: classref-method + +:ref:`bool` **has_joy_light**\ (\ device\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns ``true`` if the joypad has an LED light that can change colors and/or brightness. See also :ref:`set_joy_light()`. + +\ **Note:** This feature is only supported on Windows, Linux, and macOS. + +.. rst-class:: classref-item-separator + +---- + .. _class_Input_method_is_action_just_pressed: .. rst-class:: classref-method @@ -1110,6 +1128,22 @@ Sets the value of the rotation rate of the gyroscope sensor. Can be used for deb ---- +.. _class_Input_method_set_joy_light: + +.. rst-class:: classref-method + +:ref:`bool` **set_joy_light**\ (\ device\: :ref:`int`, color\: :ref:`Color`\ ) :ref:`🔗` + +Sets the joypad's LED light, if available, to the specified color. Returns ``true`` if the operation was successful. See also :ref:`has_joy_light()`. + +\ **Note:** There is no way to get the color of the light from a joypad. If you need to know the assigned color, store it separately. + +\ **Note:** This feature is only supported on Windows, Linux, and macOS. + +.. rst-class:: classref-item-separator + +---- + .. _class_Input_method_set_magnetometer: .. rst-class:: classref-method diff --git a/classes/es/class_inputeventkey.rst b/classes/es/class_inputeventkey.rst index ac8573cf01..7b2271654f 100644 --- a/classes/es/class_inputeventkey.rst +++ b/classes/es/class_inputeventkey.rst @@ -114,7 +114,7 @@ If ``true``, the key was already pressed before this event. An echo event is a r - |void| **set_key_label**\ (\ value\: :ref:`Key`\ ) - :ref:`Key` **get_key_label**\ (\ ) -Represents the localized label printed on the key in the current keyboard layout, which corresponds to one of the :ref:`Key` constants or any valid Unicode character. +Represents the localized label printed on the key in the current keyboard layout, which corresponds to one of the :ref:`Key` constants or any valid Unicode character. Key labels are meant for key prompts. For keyboard layouts with a single label on the key, it is equivalent to :ref:`keycode`. @@ -142,7 +142,7 @@ To get a human-readable representation of the **InputEventKey**, use ``OS.get_ke - |void| **set_keycode**\ (\ value\: :ref:`Key`\ ) - :ref:`Key` **get_keycode**\ (\ ) -Latin label printed on the key in the current keyboard layout, which corresponds to one of the :ref:`Key` constants. +Latin label printed on the key in the current keyboard layout, which corresponds to one of the :ref:`Key` constants. Key codes are meant for shortcuts expressed with a standard Latin keyboard, such as :kbd:`Ctrl + S` for a "Save" shortcut. To get a human-readable representation of the **InputEventKey**, use ``OS.get_keycode_string(event.keycode)`` where ``event`` is the **InputEventKey**. @@ -185,9 +185,9 @@ Represents the location of a key which has both left and right versions, such as - |void| **set_physical_keycode**\ (\ value\: :ref:`Key`\ ) - :ref:`Key` **get_physical_keycode**\ (\ ) -Represents the physical location of a key on the 101/102-key US QWERTY keyboard, which corresponds to one of the :ref:`Key` constants. +Represents the physical location of a key on the 101/102-key US QWERTY keyboard, which corresponds to one of the :ref:`Key` constants. Physical key codes meant for game input, such as WASD movement, where only the location of the keys is important. -To get a human-readable representation of the **InputEventKey**, use :ref:`OS.get_keycode_string()` in combination with :ref:`DisplayServer.keyboard_get_keycode_from_physical()`: +To get a human-readable representation of the **InputEventKey**, use :ref:`OS.get_keycode_string()` in combination with :ref:`DisplayServer.keyboard_get_keycode_from_physical()` or :ref:`DisplayServer.keyboard_get_label_from_physical()`: .. tabs:: @@ -197,7 +197,9 @@ To get a human-readable representation of the **InputEventKey**, use :ref:`OS.ge func _input(event): if event is InputEventKey: var keycode = DisplayServer.keyboard_get_keycode_from_physical(event.physical_keycode) + var label = DisplayServer.keyboard_get_label_from_physical(event.physical_keycode) print(OS.get_keycode_string(keycode)) + print(OS.get_keycode_string(label)) .. code-tab:: csharp @@ -206,7 +208,9 @@ To get a human-readable representation of the **InputEventKey**, use :ref:`OS.ge if (@event is InputEventKey inputEventKey) { var keycode = DisplayServer.KeyboardGetKeycodeFromPhysical(inputEventKey.PhysicalKeycode); + var label = DisplayServer.KeyboardGetLabelFromPhysical(inputEventKey.PhysicalKeycode); GD.Print(OS.GetKeycodeString(keycode)); + GD.Print(OS.GetKeycodeString(label)); } } @@ -244,7 +248,9 @@ Si es ``true``, se pulsa el estado de la tecla. Si es ``false``, el estado de la - |void| **set_unicode**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_unicode**\ (\ ) -The key Unicode character code (when relevant), shifted by modifier keys. Unicode character codes for composite characters and complex scripts may not be available unless IME input mode is active. See :ref:`Window.set_ime_active()` for more information. +The key Unicode character code (when relevant), shifted by modifier keys. Unicode character codes for composite characters and complex scripts may not be available unless IME input mode is active. See :ref:`Window.set_ime_active()` for more information. Unicode character codes are meant for text input. + +\ **Note:** This property is set by the engine only for a pressed event. If the event is sent by an IME or a virtual keyboard, no corresponding key released event is sent. .. rst-class:: classref-section-separator diff --git a/classes/es/class_itemlist.rst b/classes/es/class_itemlist.rst index 5ec48a63af..3679f811f8 100644 --- a/classes/es/class_itemlist.rst +++ b/classes/es/class_itemlist.rst @@ -63,10 +63,14 @@ Propiedades +---------------------------------------------------------+-----------------------------------------------------------------------------+---------------------------------------------------------------------------+ | :ref:`bool` | :ref:`same_column_width` | ``false`` | +---------------------------------------------------------+-----------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`ScrollHintMode` | :ref:`scroll_hint_mode` | ``0`` | + +---------------------------------------------------------+-----------------------------------------------------------------------------+---------------------------------------------------------------------------+ | :ref:`SelectMode` | :ref:`select_mode` | ``0`` | +---------------------------------------------------------+-----------------------------------------------------------------------------+---------------------------------------------------------------------------+ | :ref:`OverrunBehavior` | :ref:`text_overrun_behavior` | ``3`` | +---------------------------------------------------------+-----------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`tile_scroll_hint` | ``false`` | + +---------------------------------------------------------+-----------------------------------------------------------------------------+---------------------------------------------------------------------------+ | :ref:`bool` | :ref:`wraparound_items` | ``true`` | +---------------------------------------------------------+-----------------------------------------------------------------------------+---------------------------------------------------------------------------+ @@ -184,51 +188,53 @@ Propiedades del Tema .. table:: :widths: auto - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`Color` | :ref:`font_color` | ``Color(0.65, 0.65, 0.65, 1)`` | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`Color` | :ref:`font_hovered_color` | ``Color(0.95, 0.95, 0.95, 1)`` | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`Color` | :ref:`font_hovered_selected_color` | ``Color(1, 1, 1, 1)`` | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`Color` | :ref:`font_outline_color` | ``Color(0, 0, 0, 1)`` | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`Color` | :ref:`font_selected_color` | ``Color(1, 1, 1, 1)`` | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`Color` | :ref:`guide_color` | ``Color(0.7, 0.7, 0.7, 0.25)`` | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`int` | :ref:`h_separation` | ``4`` | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`int` | :ref:`icon_margin` | ``4`` | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`int` | :ref:`line_separation` | ``2`` | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`int` | :ref:`outline_size` | ``0`` | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`int` | :ref:`v_separation` | ``4`` | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`Font` | :ref:`font` | | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`int` | :ref:`font_size` | | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`StyleBox` | :ref:`cursor` | | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`StyleBox` | :ref:`cursor_unfocused` | | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`StyleBox` | :ref:`focus` | | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`StyleBox` | :ref:`hovered` | | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`StyleBox` | :ref:`hovered_selected` | | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`StyleBox` | :ref:`hovered_selected_focus` | | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`StyleBox` | :ref:`panel` | | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`StyleBox` | :ref:`selected` | | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ - | :ref:`StyleBox` | :ref:`selected_focus` | | - +---------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`Color` | :ref:`font_color` | ``Color(0.65, 0.65, 0.65, 1)`` | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`Color` | :ref:`font_hovered_color` | ``Color(0.95, 0.95, 0.95, 1)`` | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`Color` | :ref:`font_hovered_selected_color` | ``Color(1, 1, 1, 1)`` | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`Color` | :ref:`font_outline_color` | ``Color(0, 0, 0, 1)`` | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`Color` | :ref:`font_selected_color` | ``Color(1, 1, 1, 1)`` | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`Color` | :ref:`guide_color` | ``Color(0.7, 0.7, 0.7, 0.25)`` | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`int` | :ref:`h_separation` | ``4`` | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`int` | :ref:`icon_margin` | ``4`` | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`int` | :ref:`line_separation` | ``2`` | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`int` | :ref:`outline_size` | ``0`` | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`int` | :ref:`v_separation` | ``4`` | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`Font` | :ref:`font` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`int` | :ref:`font_size` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`Texture2D` | :ref:`scroll_hint` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`StyleBox` | :ref:`cursor` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`StyleBox` | :ref:`cursor_unfocused` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`StyleBox` | :ref:`focus` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`StyleBox` | :ref:`hovered` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`StyleBox` | :ref:`hovered_selected` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`StyleBox` | :ref:`hovered_selected_focus` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`StyleBox` | :ref:`panel` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`StyleBox` | :ref:`selected` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ + | :ref:`StyleBox` | :ref:`selected_focus` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+--------------------------------+ .. rst-class:: classref-section-separator @@ -366,6 +372,48 @@ Permite seleccionar varios elementos manteniendo pulsada la tecla :kbd:`Ctrl` o Permite seleccionar varios elementos activándolos y desactivándolos. +.. rst-class:: classref-item-separator + +---- + +.. _enum_ItemList_ScrollHintMode: + +.. rst-class:: classref-enumeration + +enum **ScrollHintMode**: :ref:`🔗` + +.. _class_ItemList_constant_SCROLL_HINT_MODE_DISABLED: + +.. rst-class:: classref-enumeration-constant + +:ref:`ScrollHintMode` **SCROLL_HINT_MODE_DISABLED** = ``0`` + +Scroll hints will never be shown. + +.. _class_ItemList_constant_SCROLL_HINT_MODE_BOTH: + +.. rst-class:: classref-enumeration-constant + +:ref:`ScrollHintMode` **SCROLL_HINT_MODE_BOTH** = ``1`` + +Scroll hints will be shown at the top and bottom. + +.. _class_ItemList_constant_SCROLL_HINT_MODE_TOP: + +.. rst-class:: classref-enumeration-constant + +:ref:`ScrollHintMode` **SCROLL_HINT_MODE_TOP** = ``2`` + +Only the top scroll hint will be shown. + +.. _class_ItemList_constant_SCROLL_HINT_MODE_BOTTOM: + +.. rst-class:: classref-enumeration-constant + +:ref:`ScrollHintMode` **SCROLL_HINT_MODE_BOTTOM** = ``3`` + +Only the bottom scroll hint will be shown. + .. rst-class:: classref-section-separator ---- @@ -608,6 +656,23 @@ Si es ``true``, el ancho es igual al mayor ancho de todas las columnas. ---- +.. _class_ItemList_property_scroll_hint_mode: + +.. rst-class:: classref-property + +:ref:`ScrollHintMode` **scroll_hint_mode** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_scroll_hint_mode**\ (\ value\: :ref:`ScrollHintMode`\ ) +- :ref:`ScrollHintMode` **get_scroll_hint_mode**\ (\ ) + +The way which scroll hints (indicators that show that the content can still be scrolled in a certain direction) will be shown. + +.. rst-class:: classref-item-separator + +---- + .. _class_ItemList_property_select_mode: .. rst-class:: classref-property @@ -642,6 +707,23 @@ El comportamiento de recorte cuando el texto excede el rectángulo delimitador d ---- +.. _class_ItemList_property_tile_scroll_hint: + +.. rst-class:: classref-property + +:ref:`bool` **tile_scroll_hint** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_tile_scroll_hint**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_scroll_hint_tiled**\ (\ ) + +If ``true``, the scroll hint texture will be tiled instead of stretched. See :ref:`scroll_hint_mode`. + +.. rst-class:: classref-item-separator + +---- + .. _class_ItemList_property_wraparound_items: .. rst-class:: classref-property @@ -1172,7 +1254,7 @@ Establece si el icono del elemento se dibujará transpuesto. |void| **set_item_language**\ (\ idx\: :ref:`int`, language\: :ref:`String`\ ) :ref:`🔗` -Establece el código de idioma del texto del elemento utilizado para los algoritmos de ajuste de línea y modelado de texto, si se deja vacío se utiliza la configuración regional actual. +Sets the language code of the text for the item at the given index to ``language``. This is used for line-breaking and text shaping algorithms. If ``language`` is empty, the current locale is used. .. rst-class:: classref-item-separator @@ -1425,6 +1507,18 @@ Tamaño de la fuente del texto del elemento. ---- +.. _class_ItemList_theme_icon_scroll_hint: + +.. rst-class:: classref-themeproperty + +:ref:`Texture2D` **scroll_hint** :ref:`🔗` + +The indicator that will be shown when the content can still be scrolled. See :ref:`scroll_hint_mode`. + +.. rst-class:: classref-item-separator + +---- + .. _class_ItemList_theme_style_cursor: .. rst-class:: classref-themeproperty @@ -1455,7 +1549,7 @@ Tamaño de la fuente del texto del elemento. :ref:`StyleBox` **focus** :ref:`🔗` -El estilo de foco para el **ItemList**, dibujado sobre el fondo, pero debajo de todo lo demás. +The focused style for the **ItemList**, drawn on top of everything. .. rst-class:: classref-item-separator diff --git a/classes/es/class_iterateik3d.rst b/classes/es/class_iterateik3d.rst new file mode 100644 index 0000000000..609ec908bf --- /dev/null +++ b/classes/es/class_iterateik3d.rst @@ -0,0 +1,380 @@ +:github_url: hide + +.. _class_IterateIK3D: + +IterateIK3D +=========== + +**Hereda:** :ref:`ChainIK3D` **<** :ref:`IKModifier3D` **<** :ref:`SkeletonModifier3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` + +**Heredado por:** :ref:`CCDIK3D`, :ref:`FABRIK3D`, :ref:`JacobianIK3D` + +A :ref:`SkeletonModifier3D` to approach the goal by repeating small rotations. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Base class of :ref:`SkeletonModifier3D` to approach the goal by repeating small rotations. + +Each bone chain (setting) has one effector, which is processed in order of the setting list. You can set some limitations for each joint. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +---------------------------+----------------------------------------------------------------------------+-----------------+ + | :ref:`float` | :ref:`angular_delta_limit` | ``0.034906585`` | + +---------------------------+----------------------------------------------------------------------------+-----------------+ + | :ref:`bool` | :ref:`deterministic` | ``false`` | + +---------------------------+----------------------------------------------------------------------------+-----------------+ + | :ref:`int` | :ref:`max_iterations` | ``4`` | + +---------------------------+----------------------------------------------------------------------------+-----------------+ + | :ref:`float` | :ref:`min_distance` | ``0.001`` | + +---------------------------+----------------------------------------------------------------------------+-----------------+ + | :ref:`int` | :ref:`setting_count` | ``0`` | + +---------------------------+----------------------------------------------------------------------------+-----------------+ + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`JointLimitation3D` | :ref:`get_joint_limitation`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`SecondaryDirection` | :ref:`get_joint_limitation_right_axis`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Vector3` | :ref:`get_joint_limitation_right_axis_vector`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Quaternion` | :ref:`get_joint_limitation_rotation_offset`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`RotationAxis` | :ref:`get_joint_rotation_axis`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Vector3` | :ref:`get_joint_rotation_axis_vector`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`NodePath` | :ref:`get_target_node`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_limitation`\ (\ index\: :ref:`int`, joint\: :ref:`int`, limitation\: :ref:`JointLimitation3D`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_limitation_right_axis`\ (\ index\: :ref:`int`, joint\: :ref:`int`, direction\: :ref:`SecondaryDirection`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_limitation_right_axis_vector`\ (\ index\: :ref:`int`, joint\: :ref:`int`, vector\: :ref:`Vector3`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_limitation_rotation_offset`\ (\ index\: :ref:`int`, joint\: :ref:`int`, offset\: :ref:`Quaternion`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_rotation_axis`\ (\ index\: :ref:`int`, joint\: :ref:`int`, axis\: :ref:`RotationAxis`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_rotation_axis_vector`\ (\ index\: :ref:`int`, joint\: :ref:`int`, axis_vector\: :ref:`Vector3`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_target_node`\ (\ index\: :ref:`int`, target_node\: :ref:`NodePath`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_IterateIK3D_property_angular_delta_limit: + +.. rst-class:: classref-property + +:ref:`float` **angular_delta_limit** = ``0.034906585`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_angular_delta_limit**\ (\ value\: :ref:`float`\ ) +- :ref:`float` **get_angular_delta_limit**\ (\ ) + +The maximum amount each bone can rotate in a single iteration. + +\ **Note:** This limitation is applied during each iteration. For example, if :ref:`max_iterations` is ``4`` and :ref:`angular_delta_limit` is ``5`` degrees, the maximum rotation possible in a single frame is ``20`` degrees. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_property_deterministic: + +.. rst-class:: classref-property + +:ref:`bool` **deterministic** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_deterministic**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_deterministic**\ (\ ) + +If ``false``, the result is calculated from the previous frame's **IterateIK3D** result as the initial state. + +If ``true``, the previous frame's **IterateIK3D** result is discarded. At this point, the new result is calculated from the bone pose excluding the **IterateIK3D** as the initial state. This means the result will be always equal as long as the target position and the previous bone pose are the same. However, if :ref:`angular_delta_limit` and :ref:`max_iterations` are set too small, the end bone of the chain will never reach the target. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_property_max_iterations: + +.. rst-class:: classref-property + +:ref:`int` **max_iterations** = ``4`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_max_iterations**\ (\ value\: :ref:`int`\ ) +- :ref:`int` **get_max_iterations**\ (\ ) + +The number of iteration loops used by the IK solver to produce more accurate results. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_property_min_distance: + +.. rst-class:: classref-property + +:ref:`float` **min_distance** = ``0.001`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_min_distance**\ (\ value\: :ref:`float`\ ) +- :ref:`float` **get_min_distance**\ (\ ) + +The minimum distance between the end bone and the target. If the distance is below this value, the IK solver stops any further iterations. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_property_setting_count: + +.. rst-class:: classref-property + +:ref:`int` **setting_count** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_setting_count**\ (\ value\: :ref:`int`\ ) +- :ref:`int` **get_setting_count**\ (\ ) + +El número de configuraciones. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_IterateIK3D_method_get_joint_limitation: + +.. rst-class:: classref-method + +:ref:`JointLimitation3D` **get_joint_limitation**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the joint limitation at ``joint`` in the bone chain's joint list. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_method_get_joint_limitation_right_axis: + +.. rst-class:: classref-method + +:ref:`SecondaryDirection` **get_joint_limitation_right_axis**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the joint limitation right axis at ``joint`` in the bone chain's joint list. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_method_get_joint_limitation_right_axis_vector: + +.. rst-class:: classref-method + +:ref:`Vector3` **get_joint_limitation_right_axis_vector**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the joint limitation right axis vector at ``joint`` in the bone chain's joint list. + +If :ref:`get_joint_limitation_right_axis()` is :ref:`SkeletonModifier3D.SECONDARY_DIRECTION_NONE`, this method returns ``Vector3(0, 0, 0)``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_method_get_joint_limitation_rotation_offset: + +.. rst-class:: classref-method + +:ref:`Quaternion` **get_joint_limitation_rotation_offset**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the joint limitation rotation offset at ``joint`` in the bone chain's joint list. + +Rotation is done in the local space which is constructed by the bone direction (in general parent to child) as the +Y axis and :ref:`get_joint_limitation_right_axis_vector()` as the +X axis. + +If the +X and +Y axes are not orthogonal, the +X axis is implicitly modified to make it orthogonal. + +Also, if the length of :ref:`get_joint_limitation_right_axis_vector()` is zero, the space is created by rotating the bone rest using the shortest arc that rotates the +Y axis of the bone rest to match the bone direction. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_method_get_joint_rotation_axis: + +.. rst-class:: classref-method + +:ref:`RotationAxis` **get_joint_rotation_axis**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el eje de rotación en ``joint`` en la lista de articulaciones de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_method_get_joint_rotation_axis_vector: + +.. rst-class:: classref-method + +:ref:`Vector3` **get_joint_rotation_axis_vector**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the rotation axis vector for the specified joint in the bone chain. This vector represents the axis around which the joint can rotate. It is determined based on the rotation axis set for the joint. + +If :ref:`get_joint_rotation_axis()` is :ref:`SkeletonModifier3D.ROTATION_AXIS_ALL`, this method returns ``Vector3(0, 0, 0)``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_method_get_target_node: + +.. rst-class:: classref-method + +:ref:`NodePath` **get_target_node**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the target node that the end bone is trying to reach. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_method_set_joint_limitation: + +.. rst-class:: classref-method + +|void| **set_joint_limitation**\ (\ index\: :ref:`int`, joint\: :ref:`int`, limitation\: :ref:`JointLimitation3D`\ ) :ref:`🔗` + +Sets the joint limitation at ``joint`` in the bone chain's joint list. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_method_set_joint_limitation_right_axis: + +.. rst-class:: classref-method + +|void| **set_joint_limitation_right_axis**\ (\ index\: :ref:`int`, joint\: :ref:`int`, direction\: :ref:`SecondaryDirection`\ ) :ref:`🔗` + +Sets the joint limitation right axis at ``joint`` in the bone chain's joint list. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_method_set_joint_limitation_right_axis_vector: + +.. rst-class:: classref-method + +|void| **set_joint_limitation_right_axis_vector**\ (\ index\: :ref:`int`, joint\: :ref:`int`, vector\: :ref:`Vector3`\ ) :ref:`🔗` + +Sets the optional joint limitation right axis vector at ``joint`` in the bone chain's joint list. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_method_set_joint_limitation_rotation_offset: + +.. rst-class:: classref-method + +|void| **set_joint_limitation_rotation_offset**\ (\ index\: :ref:`int`, joint\: :ref:`int`, offset\: :ref:`Quaternion`\ ) :ref:`🔗` + +Sets the joint limitation rotation offset at ``joint`` in the bone chain's joint list. + +Rotation is done in the local space which is constructed by the bone direction (in general parent to child) as the +Y axis and :ref:`get_joint_limitation_right_axis_vector()` as the +X axis. + +If the +X and +Y axes are not orthogonal, the +X axis is implicitly modified to make it orthogonal. + +Also, if the length of :ref:`get_joint_limitation_right_axis_vector()` is zero, the space is created by rotating the bone rest using the shortest arc that rotates the +Y axis of the bone rest to match the bone direction. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_method_set_joint_rotation_axis: + +.. rst-class:: classref-method + +|void| **set_joint_rotation_axis**\ (\ index\: :ref:`int`, joint\: :ref:`int`, axis\: :ref:`RotationAxis`\ ) :ref:`🔗` + +Sets the rotation axis at ``joint`` in the bone chain's joint list. + +The axes are based on the :ref:`Skeleton3D.get_bone_rest()`'s space, if ``axis`` is :ref:`SkeletonModifier3D.ROTATION_AXIS_CUSTOM`, you can specify any axis. + +\ **Note:** The rotation axis and the forward vector shouldn't be colinear to avoid unintended rotation since :ref:`ChainIK3D` does not factor in twisting forces. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_method_set_joint_rotation_axis_vector: + +.. rst-class:: classref-method + +|void| **set_joint_rotation_axis_vector**\ (\ index\: :ref:`int`, joint\: :ref:`int`, axis_vector\: :ref:`Vector3`\ ) :ref:`🔗` + +Sets the rotation axis vector for the specified joint in the bone chain. + +This vector is normalized by an internal process and represents the axis around which the bone chain can rotate. + +If the vector length is ``0``, it is considered synonymous with :ref:`SkeletonModifier3D.ROTATION_AXIS_ALL`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_IterateIK3D_method_set_target_node: + +.. rst-class:: classref-method + +|void| **set_target_node**\ (\ index\: :ref:`int`, target_node\: :ref:`NodePath`\ ) :ref:`🔗` + +Sets the target node that the end bone is trying to reach. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_jacobianik3d.rst b/classes/es/class_jacobianik3d.rst new file mode 100644 index 0000000000..e49a3c110d --- /dev/null +++ b/classes/es/class_jacobianik3d.rst @@ -0,0 +1,31 @@ +:github_url: hide + +.. _class_JacobianIK3D: + +JacobianIK3D +============ + +**Hereda:** :ref:`IterateIK3D` **<** :ref:`ChainIK3D` **<** :ref:`IKModifier3D` **<** :ref:`SkeletonModifier3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` + +Jacobian transpose based inverse kinematics solver. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +**JacobianIK3D** calculates rotations for all joints simultaneously, producing natural and smooth movement. It is particularly suited for biological animations. + +The resulting twist around the forward vector will always be kept from the previous pose. + +\ **Note:** It converges more slowly than other IK solvers, leading to gentler and less immediate tracking of targets. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_javaclass.rst b/classes/es/class_javaclass.rst index c2e4588d3b..2653fd50ba 100644 --- a/classes/es/class_javaclass.rst +++ b/classes/es/class_javaclass.rst @@ -28,13 +28,15 @@ Métodos .. table:: :widths: auto - +------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_java_class_name`\ (\ ) |const| | - +------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`Dictionary`\] | :ref:`get_java_method_list`\ (\ ) |const| | - +------------------------------------------------------------------+------------------------------------------------------------------------------------------+ - | :ref:`JavaClass` | :ref:`get_java_parent_class`\ (\ ) |const| | - +------------------------------------------------------------------+------------------------------------------------------------------------------------------+ + +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_java_class_name`\ (\ ) |const| | + +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Array`\[:ref:`Dictionary`\] | :ref:`get_java_method_list`\ (\ ) |const| | + +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | :ref:`JavaClass` | :ref:`get_java_parent_class`\ (\ ) |const| | + +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_java_method`\ (\ method\: :ref:`StringName`\ ) |const| | + +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -77,6 +79,18 @@ Devuelve los métodos Java del objeto y sus firmas como un :ref:`Array` **has_java_method**\ (\ method\: :ref:`StringName`\ ) |const| :ref:`🔗` + +Returns ``true`` if the given ``method`` name exists in the object's Java methods. + .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` diff --git a/classes/es/class_javaobject.rst b/classes/es/class_javaobject.rst index 6b6feee77c..709cef37a7 100644 --- a/classes/es/class_javaobject.rst +++ b/classes/es/class_javaobject.rst @@ -28,9 +28,11 @@ Métodos .. table:: :widths: auto - +-----------------------------------+-----------------------------------------------------------------------------+ - | :ref:`JavaClass` | :ref:`get_java_class`\ (\ ) |const| | - +-----------------------------------+-----------------------------------------------------------------------------+ + +-----------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | :ref:`JavaClass` | :ref:`get_java_class`\ (\ ) |const| | + +-----------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_java_method`\ (\ method\: :ref:`StringName`\ ) |const| | + +-----------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -49,6 +51,18 @@ Descripciones de Métodos Devuelve la :ref:`JavaClass` de la que este objeto es una instancia. +.. rst-class:: classref-item-separator + +---- + +.. _class_JavaObject_method_has_java_method: + +.. rst-class:: classref-method + +:ref:`bool` **has_java_method**\ (\ method\: :ref:`StringName`\ ) |const| :ref:`🔗` + +Returns ``true`` if the given ``method`` name exists in the object's Java methods. + .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` diff --git a/classes/es/class_javascriptbridge.rst b/classes/es/class_javascriptbridge.rst index e10ab925f2..99ce685e5a 100644 --- a/classes/es/class_javascriptbridge.rst +++ b/classes/es/class_javascriptbridge.rst @@ -23,7 +23,7 @@ The JavaScriptBridge singleton is implemented only in the Web export. It's used Tutoriales -------------------- -- `Exportar para la Web: Llamar a JavaScript desde el script <../tutorials/export/exporting_for_web.html#calling-javascript-from-script>`__ +- :doc:`The JavaScriptBridge singleton <../tutorials/platform/web/javascript_bridge>` .. rst-class:: classref-reftable-group diff --git a/classes/es/class_jnisingleton.rst b/classes/es/class_jnisingleton.rst index ba363eb9cf..fd5623fa13 100644 --- a/classes/es/class_jnisingleton.rst +++ b/classes/es/class_jnisingleton.rst @@ -23,6 +23,35 @@ Tutoriales - `Crear plugins de Android <../tutorials/platform/android/android_plugin.html#doc-android-plugin>`__ +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------+-------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_java_method`\ (\ method\: :ref:`StringName`\ ) |const| | + +-------------------------+-------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_JNISingleton_method_has_java_method: + +.. rst-class:: classref-method + +:ref:`bool` **has_java_method**\ (\ method\: :ref:`StringName`\ ) |const| :ref:`🔗` + +Returns ``true`` if the given ``method`` name exists in the JNISingleton's Java methods. + .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` diff --git a/classes/es/class_jointlimitation3d.rst b/classes/es/class_jointlimitation3d.rst new file mode 100644 index 0000000000..243f8191da --- /dev/null +++ b/classes/es/class_jointlimitation3d.rst @@ -0,0 +1,29 @@ +:github_url: hide + +.. _class_JointLimitation3D: + +JointLimitation3D +================= + +**Hereda:** :ref:`Resource` **<** :ref:`RefCounted` **<** :ref:`Object` + +**Heredado por:** :ref:`JointLimitationCone3D` + +A base class of the limitation that interacts with :ref:`ChainIK3D`. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +The limitation is attached to each joint and limits the rotation of the bone. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_jointlimitationcone3d.rst b/classes/es/class_jointlimitationcone3d.rst new file mode 100644 index 0000000000..f80d12e187 --- /dev/null +++ b/classes/es/class_jointlimitationcone3d.rst @@ -0,0 +1,63 @@ +:github_url: hide + +.. _class_JointLimitationCone3D: + +JointLimitationCone3D +===================== + +**Hereda:** :ref:`JointLimitation3D` **<** :ref:`Resource` **<** :ref:`RefCounted` **<** :ref:`Object` + +A cone shape limitation that interacts with :ref:`ChainIK3D`. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +A cone shape limitation that interacts with :ref:`ChainIK3D`. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +---------------------------+------------------------------------------------------------------------+----------+ + | :ref:`float` | :ref:`radius_range` | ``0.25`` | + +---------------------------+------------------------------------------------------------------------+----------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_JointLimitationCone3D_property_radius_range: + +.. rst-class:: classref-property + +:ref:`float` **radius_range** = ``0.25`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_radius_range**\ (\ value\: :ref:`float`\ ) +- :ref:`float` **get_radius_range**\ (\ ) + +The size of the hole made by the cone. + +\ ``0`` is no hole, ``0.5`` makes a hemisphere, and ``1.0`` makes a sphere (no limitation). + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_json.rst b/classes/es/class_json.rst index 0e3a80a50d..a8ec50bf3c 100644 --- a/classes/es/class_json.rst +++ b/classes/es/class_json.rst @@ -224,6 +224,8 @@ Converts a :ref:`Variant` var to JSON text and returns the result The ``indent`` parameter controls if and how something is indented; its contents will be used where there should be an indent in the output. Even spaces like ``" "`` will work. ``\t`` and ``\n`` can also be used for a tab indent, or to make a newline for each indent respectively. +\ **Warning:** Non-finite numbers are not supported in JSON. Any occurrences of :ref:`@GDScript.INF` will be replaced with ``1e99999``, and negative :ref:`@GDScript.INF` will be replaced with ``-1e99999``, but they will be interpreted correctly as infinity by most JSON parsers. :ref:`@GDScript.NAN` will be replaced with ``null``, and it will not be interpreted as NaN in JSON parsers. If you expect non-finite numbers, consider passing your data through :ref:`from_native()` first. + \ **Example output:**\ :: diff --git a/classes/es/class_jsonrpc.rst b/classes/es/class_jsonrpc.rst index badc453198..91daf0a368 100644 --- a/classes/es/class_jsonrpc.rst +++ b/classes/es/class_jsonrpc.rst @@ -208,11 +208,11 @@ To add new supported methods extend the JSONRPC class and call :ref:`process_act |void| **set_method**\ (\ name\: :ref:`String`, callback\: :ref:`Callable`\ ) :ref:`🔗` -Registra una función de retorno para el nombre de método dado. +Registers a callback for the given method name. -- ``name`` El nombre que los clientes pueden usar para acceder a la función de retorno. +- ``name``: The name that clients can use to access the callback. -- ``callback`` La función de retorno que manejará el método específico. +- ``callback``: The callback which will handle the specified method. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_label.rst b/classes/es/class_label.rst index 87e1732977..3b4c0905f4 100644 --- a/classes/es/class_label.rst +++ b/classes/es/class_label.rst @@ -17,7 +17,9 @@ Un control para mostrar texto sin formato. Descripción ---------------------- -Un control para mostrar texto sin formato. Te da control sobre la alineación horizontal y vertical y puede ajustar el texto dentro del rectángulo delimitador del nodo. No admite negrita, cursiva u otro formato de texto enriquecido. Para eso, usa :ref:`RichTextLabel` en su lugar. +A control for displaying plain text. It gives you control over the horizontal and vertical alignment and can wrap the text inside the node's bounding rectangle. It doesn't support bold, italics, or other rich text formatting. For that, use :ref:`RichTextLabel` instead. + +\ **Note:** A single Label node is not designed to display huge amounts of text. To display large amounts of text in a single node, consider using :ref:`RichTextLabel` instead as it supports features like an integrated scroll bar and threading. :ref:`RichTextLabel` generally performs better when displaying large amounts of text (several pages or more). .. rst-class:: classref-introduction-group @@ -279,7 +281,7 @@ Un recurso :ref:`LabelSettings` que puede ser compartido en - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_language**\ (\ ) -Código de idioma utilizado para los algoritmos de salto de línea y forma del texto, si se deja vacío se utiliza la configuración regional actual. +Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead. .. rst-class:: classref-item-separator diff --git a/classes/es/class_label3d.rst b/classes/es/class_label3d.rst index cd494e2f6a..9f373d2dee 100644 --- a/classes/es/class_label3d.rst +++ b/classes/es/class_label3d.rst @@ -485,7 +485,7 @@ Reglas de alineación de relleno de línea. - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_language**\ (\ ) -Código de idioma utilizado para los algoritmos de salto de línea y forma del texto, si se deja vacío se utiliza la configuración regional actual. +Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead. .. rst-class:: classref-item-separator diff --git a/classes/es/class_light3d.rst b/classes/es/class_light3d.rst index 8e80f0e654..9f9dc30d79 100644 --- a/classes/es/class_light3d.rst +++ b/classes/es/class_light3d.rst @@ -491,7 +491,7 @@ El modo de procesado de la luz. Esto afectará a las técnicas de iluminación g - |void| **set_color**\ (\ value\: :ref:`Color`\ ) - :ref:`Color` **get_color**\ (\ ) -El color de la luz en el espacio de color sRGB no lineal. Se puede usar un color *sobrebrillante* para lograr un resultado equivalente a aumentar la :ref:`light_energy` de la luz. +The light's color in nonlinear sRGB encoding. An *overbright* color can be used to achieve a result equivalent to increasing the light's :ref:`light_energy`. .. rst-class:: classref-item-separator diff --git a/classes/es/class_limitangularvelocitymodifier3d.rst b/classes/es/class_limitangularvelocitymodifier3d.rst new file mode 100644 index 0000000000..64d85281d1 --- /dev/null +++ b/classes/es/class_limitangularvelocitymodifier3d.rst @@ -0,0 +1,274 @@ +:github_url: hide + +.. _class_LimitAngularVelocityModifier3D: + +LimitAngularVelocityModifier3D +============================== + +**Hereda:** :ref:`SkeletonModifier3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` + +Limit bone rotation angular velocity. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +This modifier limits bone rotation angular velocity by comparing poses between previous and current frame. + +You can add bone chains by specifying their root and end bones, then add the bones between them to a list. Modifier processes either that list or the bones excluding those in the list depending on the option :ref:`exclude`. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +---------------------------+-------------------------------------------------------------------------------------------------+---------------+ + | :ref:`int` | :ref:`chain_count` | ``0`` | + +---------------------------+-------------------------------------------------------------------------------------------------+---------------+ + | :ref:`bool` | :ref:`exclude` | ``false`` | + +---------------------------+-------------------------------------------------------------------------------------------------+---------------+ + | :ref:`int` | :ref:`joint_count` | ``0`` | + +---------------------------+-------------------------------------------------------------------------------------------------+---------------+ + | :ref:`float` | :ref:`max_angular_velocity` | ``6.2831855`` | + +---------------------------+-------------------------------------------------------------------------------------------------+---------------+ + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear_chains`\ (\ ) | + +-----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_end_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_end_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_root_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_root_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`reset`\ (\ ) | + +-----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_root_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_root_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_LimitAngularVelocityModifier3D_property_chain_count: + +.. rst-class:: classref-property + +:ref:`int` **chain_count** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_chain_count**\ (\ value\: :ref:`int`\ ) +- :ref:`int` **get_chain_count**\ (\ ) + +The number of chains. + +.. rst-class:: classref-item-separator + +---- + +.. _class_LimitAngularVelocityModifier3D_property_exclude: + +.. rst-class:: classref-property + +:ref:`bool` **exclude** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_exclude**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_exclude**\ (\ ) + +If ``true``, the modifier processes bones not included in the bone list. + +If ``false``, the bones processed by the modifier are equal to the bone list. + +.. rst-class:: classref-item-separator + +---- + +.. _class_LimitAngularVelocityModifier3D_property_joint_count: + +.. rst-class:: classref-property + +:ref:`int` **joint_count** = ``0`` :ref:`🔗` + +The number of joints in the list which created by chains dynamically. + +.. rst-class:: classref-item-separator + +---- + +.. _class_LimitAngularVelocityModifier3D_property_max_angular_velocity: + +.. rst-class:: classref-property + +:ref:`float` **max_angular_velocity** = ``6.2831855`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_max_angular_velocity**\ (\ value\: :ref:`float`\ ) +- :ref:`float` **get_max_angular_velocity**\ (\ ) + +The maximum angular velocity per second. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_LimitAngularVelocityModifier3D_method_clear_chains: + +.. rst-class:: classref-method + +|void| **clear_chains**\ (\ ) :ref:`🔗` + +Clear all chains. + +.. rst-class:: classref-item-separator + +---- + +.. _class_LimitAngularVelocityModifier3D_method_get_end_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_end_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el índice del hueso final de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_LimitAngularVelocityModifier3D_method_get_end_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_end_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el nombre del hueso final de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_LimitAngularVelocityModifier3D_method_get_root_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_root_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el índice del hueso raíz de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_LimitAngularVelocityModifier3D_method_get_root_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_root_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Devuelve el nombre del hueso raíz de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_LimitAngularVelocityModifier3D_method_reset: + +.. rst-class:: classref-method + +|void| **reset**\ (\ ) :ref:`🔗` + +Sets the reference pose for angle comparison to the current pose with the influence of constraints removed. This function is automatically triggered when joints change or upon activation. + +.. rst-class:: classref-item-separator + +---- + +.. _class_LimitAngularVelocityModifier3D_method_set_end_bone: + +.. rst-class:: classref-method + +|void| **set_end_bone**\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) :ref:`🔗` + +Establece el índice del hueso final de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_LimitAngularVelocityModifier3D_method_set_end_bone_name: + +.. rst-class:: classref-method + +|void| **set_end_bone_name**\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) :ref:`🔗` + +Sets the end bone name of the bone chain. + +\ **Note:** End bone must be the root bone or a child of the root bone. + +.. rst-class:: classref-item-separator + +---- + +.. _class_LimitAngularVelocityModifier3D_method_set_root_bone: + +.. rst-class:: classref-method + +|void| **set_root_bone**\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) :ref:`🔗` + +Establece el índice del hueso raíz de la cadena de huesos. + +.. rst-class:: classref-item-separator + +---- + +.. _class_LimitAngularVelocityModifier3D_method_set_root_bone_name: + +.. rst-class:: classref-method + +|void| **set_root_bone_name**\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) :ref:`🔗` + +Establece el nombre del hueso raíz de la cadena de huesos. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_lineedit.rst b/classes/es/class_lineedit.rst index d5a88a719d..f8ebfab059 100644 --- a/classes/es/class_lineedit.rst +++ b/classes/es/class_lineedit.rst @@ -128,6 +128,8 @@ Propiedades +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`FocusMode` | focus_mode | ``2`` (overrides :ref:`Control`) | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ + | :ref:`ExpandMode` | :ref:`icon_expand_mode` | ``0`` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`keep_editing_on_text_submit` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`language` | ``""`` | @@ -142,6 +144,8 @@ Propiedades +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`Texture2D` | :ref:`right_icon` | | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`right_icon_scale` | ``1.0`` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`secret` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`secret_character` | ``"•"`` | @@ -188,7 +192,7 @@ Métodos +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`deselect`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`edit`\ (\ ) | + | |void| | :ref:`edit`\ (\ hide_focus\: :ref:`bool` = false\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PopupMenu` | :ref:`get_menu`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -675,6 +679,40 @@ Teclado virtual para introducir una contraseña. En la mayoría de las plataform Teclado virtual con teclas adicionales para ayudar a escribir URLs. +.. rst-class:: classref-item-separator + +---- + +.. _enum_LineEdit_ExpandMode: + +.. rst-class:: classref-enumeration + +enum **ExpandMode**: :ref:`🔗` + +.. _class_LineEdit_constant_EXPAND_MODE_ORIGINAL_SIZE: + +.. rst-class:: classref-enumeration-constant + +:ref:`ExpandMode` **EXPAND_MODE_ORIGINAL_SIZE** = ``0`` + +Use the original size for the right icon. + +.. _class_LineEdit_constant_EXPAND_MODE_FIT_TO_TEXT: + +.. rst-class:: classref-enumeration-constant + +:ref:`ExpandMode` **EXPAND_MODE_FIT_TO_TEXT** = ``1`` + +Scale the right icon's size to match the size of the text. + +.. _class_LineEdit_constant_EXPAND_MODE_FIT_TO_LINE_EDIT: + +.. rst-class:: classref-enumeration-constant + +:ref:`ExpandMode` **EXPAND_MODE_FIT_TO_LINE_EDIT** = ``2`` + +Scale the right icon to fit the LineEdit. + .. rst-class:: classref-section-separator ---- @@ -695,7 +733,7 @@ Descripciones de Propiedades - |void| **set_horizontal_alignment**\ (\ value\: :ref:`HorizontalAlignment`\ ) - :ref:`HorizontalAlignment` **get_horizontal_alignment**\ (\ ) -Alineación del texto como se define en el enum :ref:`HorizontalAlignment`. +The text's horizontal alignment. .. rst-class:: classref-item-separator @@ -958,6 +996,23 @@ Si es ``true``, **LineEdit** no muestra la decoración. ---- +.. _class_LineEdit_property_icon_expand_mode: + +.. rst-class:: classref-property + +:ref:`ExpandMode` **icon_expand_mode** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_icon_expand_mode**\ (\ value\: :ref:`ExpandMode`\ ) +- :ref:`ExpandMode` **get_icon_expand_mode**\ (\ ) + +Define the scaling behavior of the :ref:`right_icon`. + +.. rst-class:: classref-item-separator + +---- + .. _class_LineEdit_property_keep_editing_on_text_submit: .. rst-class:: classref-property @@ -986,7 +1041,7 @@ Si es ``true``, el **LineEdit** no saldrá del modo de edición cuando se envíe - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_language**\ (\ ) -Código de idioma utilizado para los algoritmos de ajuste de línea y de formación de texto. Si se deja vacío, se utiliza la configuración regional actual. +Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead. .. rst-class:: classref-item-separator @@ -1091,6 +1146,23 @@ Establece el icono que aparecerá en el extremo derecho de la **LineEdit** si no ---- +.. _class_LineEdit_property_right_icon_scale: + +.. rst-class:: classref-property + +:ref:`float` **right_icon_scale** = ``1.0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_right_icon_scale**\ (\ value\: :ref:`float`\ ) +- :ref:`float` **get_right_icon_scale**\ (\ ) + +Scale ratio of the icon when :ref:`icon_expand_mode` is set to :ref:`EXPAND_MODE_FIT_TO_LINE_EDIT`. + +.. rst-class:: classref-item-separator + +---- + .. _class_LineEdit_property_secret: .. rst-class:: classref-property @@ -1378,11 +1450,11 @@ Borra la selección actual. .. rst-class:: classref-method -|void| **edit**\ (\ ) :ref:`🔗` +|void| **edit**\ (\ hide_focus\: :ref:`bool` = false\ ) :ref:`🔗` -Permite entrar en el modo de edición tanto si el **LineEdit** está enfocado como si no. +Allows entering edit mode whether the **LineEdit** is focused or not. If ``hide_focus`` is ``true``, the focused state will not be shown (see :ref:`Control.grab_focus()`). -Véase también :ref:`keep_editing_on_text_submit`. +See also :ref:`keep_editing_on_text_submit`. .. rst-class:: classref-item-separator diff --git a/classes/es/class_linkbutton.rst b/classes/es/class_linkbutton.rst index b754997586..bdfaa41b24 100644 --- a/classes/es/class_linkbutton.rst +++ b/classes/es/class_linkbutton.rst @@ -26,6 +26,8 @@ Propiedades .. table:: :widths: auto + +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`ellipsis_char` | ``"…"`` | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`FocusMode` | focus_mode | ``3`` (overrides :ref:`Control`) | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ @@ -41,6 +43,8 @@ Propiedades +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`TextDirection` | :ref:`text_direction` | ``0`` | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ + | :ref:`OverrunBehavior` | :ref:`text_overrun_behavior` | ``0`` | + +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`UnderlineMode` | :ref:`underline` | ``0`` | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`uri` | ``""`` | @@ -128,6 +132,23 @@ El LinkButton nunca mostrará un subrayado en la parte inferior de su texto. Descripciones de Propiedades -------------------------------------------------------- +.. _class_LinkButton_property_ellipsis_char: + +.. rst-class:: classref-property + +:ref:`String` **ellipsis_char** = ``"…"`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_ellipsis_char**\ (\ value\: :ref:`String`\ ) +- :ref:`String` **get_ellipsis_char**\ (\ ) + +Carácter de elipsis utilizado para el recorte de texto. + +.. rst-class:: classref-item-separator + +---- + .. _class_LinkButton_property_language: .. rst-class:: classref-property @@ -139,7 +160,7 @@ Descripciones de Propiedades - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_language**\ (\ ) -Código de idioma utilizado para los algoritmos de salto de línea y forma del texto, si se deja vacío se utiliza la configuración regional actual. +Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead. .. rst-class:: classref-item-separator @@ -213,6 +234,23 @@ Dirección base de escritura del texto. ---- +.. _class_LinkButton_property_text_overrun_behavior: + +.. rst-class:: classref-property + +:ref:`OverrunBehavior` **text_overrun_behavior** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_text_overrun_behavior**\ (\ value\: :ref:`OverrunBehavior`\ ) +- :ref:`OverrunBehavior` **get_text_overrun_behavior**\ (\ ) + +Sets the clipping behavior when the text exceeds the node's bounding rectangle. + +.. rst-class:: classref-item-separator + +---- + .. _class_LinkButton_property_underline: .. rst-class:: classref-property diff --git a/classes/es/class_logger.rst b/classes/es/class_logger.rst index a0eb33d9fb..79a88577ed 100644 --- a/classes/es/class_logger.rst +++ b/classes/es/class_logger.rst @@ -98,10 +98,12 @@ The type of error provided by ``error_type`` is described in the :ref:`ErrorType Additionally, ``script_backtraces`` provides backtraces for each of the script languages. These will only contain stack frames in editor builds and debug builds by default. To enable them for release builds as well, you need to enable :ref:`ProjectSettings.debug/settings/gdscript/always_track_call_stacks`. -\ **Warning:** This function may be called from multiple different threads, so you may need to do your own locking. +\ **Warning:** This method will be called from threads other than the main thread, possibly at the same time, so you will need to have some kind of thread-safety in your implementation of it, like a :ref:`Mutex`. \ **Note:** ``script_backtraces`` will not contain any captured variables, due to its prohibitively high cost. To get those you will need to capture the backtraces yourself, from within the **Logger** virtual methods, using :ref:`Engine.capture_script_backtraces()`. +\ **Note:** Logging errors from this method using functions like :ref:`@GlobalScope.push_error()` or :ref:`@GlobalScope.push_warning()` is not supported, as it could cause infinite recursion. These errors will only show up in the console output. + .. rst-class:: classref-item-separator ---- @@ -114,7 +116,9 @@ Additionally, ``script_backtraces`` provides backtraces for each of the script l Called when a message is logged. If ``error`` is ``true``, then this message was meant to be sent to ``stderr``. -\ **Warning:** This function may be called from multiple different threads, so you may need to do your own locking. +\ **Warning:** This method will be called from threads other than the main thread, possibly at the same time, so you will need to have some kind of thread-safety in your implementation of it, like a :ref:`Mutex`. + +\ **Note:** Logging another message from this method using functions like :ref:`@GlobalScope.print()` is not supported, as it could cause infinite recursion. These messages will only show up in the console output. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_lookatmodifier3d.rst b/classes/es/class_lookatmodifier3d.rst index 8c11a1b840..5559273eea 100644 --- a/classes/es/class_lookatmodifier3d.rst +++ b/classes/es/class_lookatmodifier3d.rst @@ -63,6 +63,8 @@ Propiedades +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------+----------------------+ | :ref:`Axis` | :ref:`primary_rotation_axis` | ``1`` | +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------+----------------------+ + | :ref:`bool` | :ref:`relative` | ``true`` | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------+----------------------+ | :ref:`float` | :ref:`secondary_damp_threshold` | | +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------+----------------------+ | :ref:`float` | :ref:`secondary_limit_angle` | | @@ -470,6 +472,23 @@ El eje de la primera rotación. Este :ref:`SkeletonModifier3D` **relative** = ``true`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_relative**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_relative**\ (\ ) + +The relative option. If ``true``, the rotation is applied relative to the pose. If ``false``, the rotation is applied relative to the rest. It means to replace the current pose with the **LookAtModifier3D**'s result. + +.. rst-class:: classref-item-separator + +---- + .. _class_LookAtModifier3D_property_secondary_damp_threshold: .. rst-class:: classref-property diff --git a/classes/es/class_mainloop.rst b/classes/es/class_mainloop.rst index 7784a302b7..4a8efbe5b5 100644 --- a/classes/es/class_mainloop.rst +++ b/classes/es/class_mainloop.rst @@ -164,9 +164,9 @@ Implementado en las plataformas de escritorio si el manejador de fallos está ha **NOTIFICATION_OS_IME_UPDATE** = ``2013`` :ref:`🔗` -Notificación recibida del sistema operativo cuando se produce una actualización del motor del método de entrada (por ejemplo, cambio de la posición del cursor de la IME o de la string de composición). +Notification received from the OS when an update of the Input Method Engine occurs (e.g. change of IME cursor position or composition string). -Específico de la plataforma MacOS. +Implemented on desktop and web platforms. .. _class_MainLoop_constant_NOTIFICATION_APPLICATION_RESUMED: diff --git a/classes/es/class_margincontainer.rst b/classes/es/class_margincontainer.rst index bfe3def4f6..8276ece85c 100644 --- a/classes/es/class_margincontainer.rst +++ b/classes/es/class_margincontainer.rst @@ -10,6 +10,8 @@ MarginContainer **Hereda:** :ref:`Container` **<** :ref:`Control` **<** :ref:`CanvasItem` **<** :ref:`Node` **<** :ref:`Object` +**Heredado por:** :ref:`EditorDock` + Un contenedor que mantiene un margen alrededor de sus controles hijos. .. rst-class:: classref-introduction-group diff --git a/classes/es/class_menubar.rst b/classes/es/class_menubar.rst index a8c05b1572..15044cdbd9 100644 --- a/classes/es/class_menubar.rst +++ b/classes/es/class_menubar.rst @@ -163,7 +163,7 @@ Los **MenuBar** planos no muestran la decoración del elemento. - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_language**\ (\ ) -Código de idioma utilizado para los algoritmos de salto de línea y forma del texto, si se deja vacío se utiliza la configuración regional actual. +Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead. .. rst-class:: classref-item-separator @@ -300,7 +300,7 @@ Devuelve la información sobre herramientas del elemento del menú. :ref:`bool` **is_menu_disabled**\ (\ menu\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve ``true`` si el elemento del menú está desactivado. +Returns ``true`` if the menu item is disabled. .. rst-class:: classref-item-separator @@ -312,7 +312,7 @@ Devuelve ``true`` si el elemento del menú está desactivado. :ref:`bool` **is_menu_hidden**\ (\ menu\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve ``true`` si el elemento del menú está oculto. +Returns ``true`` if the menu item is hidden. .. rst-class:: classref-item-separator @@ -324,7 +324,7 @@ Devuelve ``true`` si el elemento del menú está oculto. :ref:`bool` **is_native_menu**\ (\ ) |const| :ref:`🔗` -Devuelve ``true`` si el menú global del sistema es soportado y usado por esta **MenuBar**. +Returns ``true`` if the current system's global menu is supported and used by this **MenuBar**. .. rst-class:: classref-item-separator diff --git a/classes/es/class_meshdatatool.rst b/classes/es/class_meshdatatool.rst index 68eee97cec..1522d47853 100644 --- a/classes/es/class_meshdatatool.rst +++ b/classes/es/class_meshdatatool.rst @@ -608,7 +608,9 @@ Establece la normal del vértice dado. |void| **set_vertex_tangent**\ (\ idx\: :ref:`int`, tangent\: :ref:`Plane`\ ) :ref:`🔗` -Establece la tangente del vértice dado. +Sets the tangent of the given vertex. + +\ **Note:** Even though ``tangent`` is a :ref:`Plane`, it does not directly represent the tangent plane. Its :ref:`Plane.x`, :ref:`Plane.y`, and :ref:`Plane.z` represent the tangent vector and :ref:`Plane.d` should be either ``-1`` or ``1``. See also :ref:`Mesh.ARRAY_TANGENT`. .. rst-class:: classref-item-separator diff --git a/classes/es/class_meshinstance3d.rst b/classes/es/class_meshinstance3d.rst index 4517565ea3..8fd7dc5632 100644 --- a/classes/es/class_meshinstance3d.rst +++ b/classes/es/class_meshinstance3d.rst @@ -39,13 +39,13 @@ Propiedades .. table:: :widths: auto - +---------------------------------+---------------------------------------------------------+--------------------+ - | :ref:`Mesh` | :ref:`mesh` | | - +---------------------------------+---------------------------------------------------------+--------------------+ - | :ref:`NodePath` | :ref:`skeleton` | ``NodePath("..")`` | - +---------------------------------+---------------------------------------------------------+--------------------+ - | :ref:`Skin` | :ref:`skin` | | - +---------------------------------+---------------------------------------------------------+--------------------+ + +---------------------------------+---------------------------------------------------------+------------------+ + | :ref:`Mesh` | :ref:`mesh` | | + +---------------------------------+---------------------------------------------------------+------------------+ + | :ref:`NodePath` | :ref:`skeleton` | ``NodePath("")`` | + +---------------------------------+---------------------------------------------------------+------------------+ + | :ref:`Skin` | :ref:`skin` | | + +---------------------------------+---------------------------------------------------------+------------------+ .. rst-class:: classref-reftable-group @@ -117,14 +117,16 @@ El recurso :ref:`Mesh` para la instancia. .. rst-class:: classref-property -:ref:`NodePath` **skeleton** = ``NodePath("..")`` :ref:`🔗` +:ref:`NodePath` **skeleton** = ``NodePath("")`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_skeleton_path**\ (\ value\: :ref:`NodePath`\ ) - :ref:`NodePath` **get_skeleton_path**\ (\ ) -:ref:`NodePath` al :ref:`Skeleton3D` asociado con la instancia. +:ref:`NodePath` to the :ref:`Skeleton3D` associated with the instance. + +\ **Note:** The default value of this property has changed in Godot 4.6. Enable :ref:`ProjectSettings.animation/compatibility/default_parent_skeleton_in_mesh_instance_3d` if the old behavior is needed for compatibility. .. rst-class:: classref-item-separator diff --git a/classes/es/class_missingnode.rst b/classes/es/class_missingnode.rst index e2a5745221..77a6e5c6d1 100644 --- a/classes/es/class_missingnode.rst +++ b/classes/es/class_missingnode.rst @@ -33,6 +33,8 @@ Propiedades +-----------------------------+------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`recording_properties` | +-----------------------------+------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`recording_signals` | + +-----------------------------+------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -90,6 +92,23 @@ Devuelve la ruta de la escena de la cual este nodo fue instancia originalmente. If ``true``, allows new properties to be set along with existing ones. If ``false``, only existing properties' values can be set, and new properties cannot be added. +.. rst-class:: classref-item-separator + +---- + +.. _class_MissingNode_property_recording_signals: + +.. rst-class:: classref-property + +:ref:`bool` **recording_signals** :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_recording_signals**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_recording_signals**\ (\ ) + +If ``true``, allows new signals to be connected to along with existing ones. If ``false``, only existing signals can be connected to, and new signals cannot be added. + .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` diff --git a/classes/es/class_multimesh.rst b/classes/es/class_multimesh.rst index 2c7e9f11df..0345e473b3 100644 --- a/classes/es/class_multimesh.rst +++ b/classes/es/class_multimesh.rst @@ -97,6 +97,8 @@ Métodos +---------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`reset_instance_physics_interpolation`\ (\ instance\: :ref:`int`\ ) | +---------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`reset_instances_physics_interpolation`\ (\ ) | + +---------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_buffer_interpolated`\ (\ buffer_curr\: :ref:`PackedFloat32Array`, buffer_prev\: :ref:`PackedFloat32Array`\ ) | +---------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_instance_color`\ (\ instance\: :ref:`int`, color\: :ref:`Color`\ ) | @@ -482,6 +484,20 @@ This allows you to move instances instantaneously, and should usually be used wh ---- +.. _class_MultiMesh_method_reset_instances_physics_interpolation: + +.. rst-class:: classref-method + +|void| **reset_instances_physics_interpolation**\ (\ ) :ref:`🔗` + +When using *physics interpolation*, this function allows you to prevent interpolation for all instances in the current physics tick. + +This allows you to move all instances instantaneously, and should usually be used when initially placing instances to prevent graphical glitches. + +.. rst-class:: classref-item-separator + +---- + .. _class_MultiMesh_method_set_buffer_interpolated: .. rst-class:: classref-method diff --git a/classes/es/class_mutex.rst b/classes/es/class_mutex.rst index 171f813aa5..f699612a4f 100644 --- a/classes/es/class_mutex.rst +++ b/classes/es/class_mutex.rst @@ -18,8 +18,6 @@ A synchronization mutex (mutual exclusion). This is used to synchronize multiple This is a reentrant mutex, meaning that it can be locked multiple times by one thread, provided it also unlocks it as many times. -\ **Warning:** Mutexes must be used carefully to avoid deadlocks. - \ **Warning:** To ensure proper cleanup without crashes or deadlocks, the following conditions must be met: - When a **Mutex**'s reference count reaches zero and it is therefore destroyed, no threads (including the one on which the destruction will happen) must have it locked. @@ -98,7 +96,7 @@ Unlocks this **Mutex**, leaving it to other threads. \ **Note:** If a thread called :ref:`lock()` or :ref:`try_lock()` multiple times while already having ownership of the mutex, it must also call :ref:`unlock()` the same number of times in order to unlock it correctly. -\ **Warning:** Calling :ref:`unlock()` more times that :ref:`lock()` on a given thread, thus ending up trying to unlock a non-locked mutex, is wrong and may causes crashes or deadlocks. +\ **Warning:** Calling :ref:`unlock()` more times than :ref:`lock()` on a given thread, thus ending up trying to unlock a non-locked mutex, is wrong and may causes crashes or deadlocks. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_nativemenu.rst b/classes/es/class_nativemenu.rst index 741714d552..5b6c4b4b15 100644 --- a/classes/es/class_nativemenu.rst +++ b/classes/es/class_nativemenu.rst @@ -123,6 +123,8 @@ Métodos +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_system_menu_name`\ (\ menu_id\: :ref:`SystemMenus`\ ) |const| | +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_system_menu_text`\ (\ menu_id\: :ref:`SystemMenus`\ ) |const| | + +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_feature`\ (\ feature\: :ref:`Feature`\ ) |const| | +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_menu`\ (\ rid\: :ref:`RID`\ ) |const| | @@ -189,6 +191,8 @@ Métodos +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_popup_open_callback`\ (\ rid\: :ref:`RID`, callback\: :ref:`Callable`\ ) | +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_system_menu_text`\ (\ menu_id\: :ref:`SystemMenus`, name\: :ref:`String`\ ) | + +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -842,6 +846,20 @@ Returns readable name of a special system menu. ---- +.. _class_NativeMenu_method_get_system_menu_text: + +.. rst-class:: classref-method + +:ref:`String` **get_system_menu_text**\ (\ menu_id\: :ref:`SystemMenus`\ ) |const| :ref:`🔗` + +Returns the text of the system menu item. + +\ **Note:** This method is implemented on macOS. + +.. rst-class:: classref-item-separator + +---- + .. _class_NativeMenu_method_has_feature: .. rst-class:: classref-method @@ -1320,6 +1338,20 @@ Registra un objeto invocable para que se emita después de que el menú se haya \ **Nota:** Este método solo está implementado en macOS. +.. rst-class:: classref-item-separator + +---- + +.. _class_NativeMenu_method_set_system_menu_text: + +.. rst-class:: classref-method + +|void| **set_system_menu_text**\ (\ menu_id\: :ref:`SystemMenus`, name\: :ref:`String`\ ) :ref:`🔗` + +Sets the text of the system menu item. + +\ **Note:** This method is implemented on macOS. + .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` diff --git a/classes/es/class_navigationpolygon.rst b/classes/es/class_navigationpolygon.rst index ba2f2c145a..bcf3132775 100644 --- a/classes/es/class_navigationpolygon.rst +++ b/classes/es/class_navigationpolygon.rst @@ -172,7 +172,7 @@ enum **SamplePartitionType**: :ref:`🔗` **SAMPLE_PARTITION_CONVEX_PARTITION** = ``0`` -Particionado convexo que produce una malla de navegación con polígonos convexos. +Convex partitioning that results in a navigation mesh with convex polygons. .. _class_NavigationPolygon_constant_SAMPLE_PARTITION_TRIANGULATE: @@ -180,7 +180,7 @@ Particionado convexo que produce una malla de navegación con polígonos convexo :ref:`SamplePartitionType` **SAMPLE_PARTITION_TRIANGULATE** = ``1`` -Particionado de triangulación que produce una malla de navegación con polígonos triangulares. +Triangulation partitioning that results in a navigation mesh with triangle polygons. .. _class_NavigationPolygon_constant_SAMPLE_PARTITION_MAX: diff --git a/classes/es/class_navigationserver2dmanager.rst b/classes/es/class_navigationserver2dmanager.rst new file mode 100644 index 0000000000..f0b1ff825f --- /dev/null +++ b/classes/es/class_navigationserver2dmanager.rst @@ -0,0 +1,72 @@ +:github_url: hide + +.. _class_NavigationServer2DManager: + +NavigationServer2DManager +========================= + +**Hereda:** :ref:`Object` + +A singleton for managing :ref:`NavigationServer2D` implementations. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +**NavigationServer2DManager** is the API for registering :ref:`NavigationServer2D` implementations and setting the default implementation. + +\ **Note:** It is not possible to switch servers at runtime. This class is only used on startup at the server initialization level. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`register_server`\ (\ name\: :ref:`String`, create_callback\: :ref:`Callable`\ ) | + +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_default_server`\ (\ name\: :ref:`String`, priority\: :ref:`int`\ ) | + +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_NavigationServer2DManager_method_register_server: + +.. rst-class:: classref-method + +|void| **register_server**\ (\ name\: :ref:`String`, create_callback\: :ref:`Callable`\ ) :ref:`🔗` + +Registers a :ref:`NavigationServer2D` implementation by passing a ``name`` and a :ref:`Callable` that returns a :ref:`NavigationServer2D` object. + +.. rst-class:: classref-item-separator + +---- + +.. _class_NavigationServer2DManager_method_set_default_server: + +.. rst-class:: classref-method + +|void| **set_default_server**\ (\ name\: :ref:`String`, priority\: :ref:`int`\ ) :ref:`🔗` + +Sets the default :ref:`NavigationServer2D` implementation to the one identified by ``name``, if ``priority`` is greater than the priority of the current default implementation. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_navigationserver3dmanager.rst b/classes/es/class_navigationserver3dmanager.rst new file mode 100644 index 0000000000..55fae6960e --- /dev/null +++ b/classes/es/class_navigationserver3dmanager.rst @@ -0,0 +1,72 @@ +:github_url: hide + +.. _class_NavigationServer3DManager: + +NavigationServer3DManager +========================= + +**Hereda:** :ref:`Object` + +A singleton for managing :ref:`NavigationServer3D` implementations. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +**NavigationServer3DManager** is the API for registering :ref:`NavigationServer3D` implementations and setting the default implementation. + +\ **Note:** It is not possible to switch servers at runtime. This class is only used on startup at the server initialization level. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`register_server`\ (\ name\: :ref:`String`, create_callback\: :ref:`Callable`\ ) | + +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_default_server`\ (\ name\: :ref:`String`, priority\: :ref:`int`\ ) | + +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_NavigationServer3DManager_method_register_server: + +.. rst-class:: classref-method + +|void| **register_server**\ (\ name\: :ref:`String`, create_callback\: :ref:`Callable`\ ) :ref:`🔗` + +Registers a :ref:`NavigationServer3D` implementation by passing a ``name`` and a :ref:`Callable` that returns a :ref:`NavigationServer3D` object. + +.. rst-class:: classref-item-separator + +---- + +.. _class_NavigationServer3DManager_method_set_default_server: + +.. rst-class:: classref-method + +|void| **set_default_server**\ (\ name\: :ref:`String`, priority\: :ref:`int`\ ) :ref:`🔗` + +Sets the default :ref:`NavigationServer3D` implementation to the one identified by ``name``, if ``priority`` is greater than the priority of the current default implementation. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_node.rst b/classes/es/class_node.rst index a04adfac2e..83c3b1c2d8 100644 --- a/classes/es/class_node.rst +++ b/classes/es/class_node.rst @@ -657,6 +657,27 @@ Duplicate the node's script (also overriding the duplicated children's scripts, Duplicate using :ref:`PackedScene.instantiate()`. If the node comes from a scene saved on disk, reuses :ref:`PackedScene.instantiate()` as the base for the duplicated node and its children. +.. _class_Node_constant_DUPLICATE_INTERNAL_STATE: + +.. rst-class:: classref-enumeration-constant + +:ref:`DuplicateFlags` **DUPLICATE_INTERNAL_STATE** = ``16`` + +Duplicate also non-serializable variables (i.e. without :ref:`@GlobalScope.PROPERTY_USAGE_STORAGE`). + +.. _class_Node_constant_DUPLICATE_DEFAULT: + +.. rst-class:: classref-enumeration-constant + +:ref:`DuplicateFlags` **DUPLICATE_DEFAULT** = ``15`` + +Duplicate using default flags. This constant is useful to add or remove a single flag. + +:: + + # Duplicate non-exported variables. + var dupe = duplicate(DUPLICATE_DEFAULT | DUPLICATE_INTERNAL_STATE) + .. rst-class:: classref-item-separator ---- @@ -723,9 +744,9 @@ Always automatically translate. This is the inverse of :ref:`AUTO_TRANSLATE_MODE :ref:`AutoTranslateMode` **AUTO_TRANSLATE_MODE_DISABLED** = ``2`` -Nunca traducir automáticamente. Esta es la inversa de :ref:`AUTO_TRANSLATE_MODE_ALWAYS`. +Never automatically translate. This is the inverse of :ref:`AUTO_TRANSLATE_MODE_ALWAYS`. -El análisis de strings para la generación de POT se omitirá para este nodo y los hijos que estén configurados como :ref:`AUTO_TRANSLATE_MODE_INHERIT`. +String parsing for translation template generation will be skipped for this node and children that are set to :ref:`AUTO_TRANSLATE_MODE_INHERIT`. .. rst-class:: classref-section-separator @@ -752,9 +773,11 @@ Esta notificación se recibe *antes* de la señal :ref:`tree_entered` -Notificación recibida cuando el nodo está a punto de salir de un :ref:`SceneTree`. Véase :ref:`_exit_tree()`. +Notification received when the node is about to exit a :ref:`SceneTree`. See :ref:`_exit_tree()`. -Esta notificación se recibe *después* de la señal :ref:`tree_exiting` relacionada. +This notification is received *after* the related :ref:`tree_exiting` signal. + +This notification is sent in reversed order. .. _class_Node_constant_NOTIFICATION_MOVED_IN_PARENT: @@ -1094,7 +1117,7 @@ Implemented on desktop platforms, if the crash handler is enabled. Notification received from the OS when an update of the Input Method Engine occurs (e.g. change of IME cursor position or composition string). -Implemented only on macOS. +Implemented on desktop and web platforms. .. _class_Node_constant_NOTIFICATION_APPLICATION_RESUMED: @@ -1182,7 +1205,7 @@ Descripciones de Propiedades - |void| **set_auto_translate_mode**\ (\ value\: :ref:`AutoTranslateMode`\ ) - :ref:`AutoTranslateMode` **get_auto_translate_mode**\ (\ ) -Defines if any text should automatically change to its translated version depending on the current locale (for nodes such as :ref:`Label`, :ref:`RichTextLabel`, :ref:`Window`, etc.). Also decides if the node's strings should be parsed for POT generation. +Defines if any text should automatically change to its translated version depending on the current locale (for nodes such as :ref:`Label`, :ref:`RichTextLabel`, :ref:`Window`, etc.). Also decides if the node's strings should be parsed for translation template generation. \ **Note:** For the root node, auto translate mode can also be set via :ref:`ProjectSettings.internationalization/rendering/root_node_auto_translate`. @@ -1735,7 +1758,7 @@ Use :ref:`add_child()` instead of this method if yo Adds the node to the ``group``. Groups can be helpful to organize a subset of nodes, for example ``"enemies"`` or ``"collectables"``. See notes in the description, and the group methods in :ref:`SceneTree`. -If ``persistent`` is ``true``, the group will be stored when saved inside a :ref:`PackedScene`. All groups created and displayed in the Node dock are persistent. +If ``persistent`` is ``true``, the group will be stored when saved inside a :ref:`PackedScene`. All groups created and displayed in the Groups dock are persistent. \ **Note:** To improve performance, the order of group names is *not* guaranteed and may vary between project runs. Therefore, do not rely on the group order. @@ -1882,10 +1905,12 @@ The Tween will start automatically on the next process frame or physics frame (d :ref:`Node` **duplicate**\ (\ flags\: :ref:`int` = 15\ ) |const| :ref:`🔗` -Duplicates the node, returning a new node with all of its properties, signals, groups, and children copied from the original. The behavior can be tweaked through the ``flags`` (see :ref:`DuplicateFlags`). Internal nodes are not duplicated. +Duplicates the node, returning a new node with all of its properties, signals, groups, and children copied from the original, recursively. The behavior can be tweaked through the ``flags`` (see :ref:`DuplicateFlags`). Internal nodes are not duplicated. \ **Note:** For nodes with a :ref:`Script` attached, if :ref:`Object._init()` has been defined with required parameters, the duplicated node will not have a :ref:`Script`. +\ **Note:** By default, this method will duplicate only properties marked for serialization (i.e. using :ref:`@GlobalScope.PROPERTY_USAGE_STORAGE`, or in GDScript, :ref:`@GDScript.@export`). If you want to duplicate all properties, use :ref:`DUPLICATE_INTERNAL_STATE`. + .. rst-class:: classref-item-separator ---- @@ -2708,7 +2733,7 @@ Similar to :ref:`call_thread_safe()`, but fo Prints all orphan nodes (nodes outside the :ref:`SceneTree`). Useful for debugging. -\ **Note:** This method only works in debug builds. Does nothing in a project exported in release mode. +\ **Note:** This method only works in debug builds. It does nothing in a project exported in release mode. .. rst-class:: classref-item-separator diff --git a/classes/es/class_node2d.rst b/classes/es/class_node2d.rst index 61f7b337e8..b9325694ef 100644 --- a/classes/es/class_node2d.rst +++ b/classes/es/class_node2d.rst @@ -339,9 +339,9 @@ Multiplica la escala actual por el vector ``ratio``. :ref:`float` **get_angle_to**\ (\ point\: :ref:`Vector2`\ ) |const| :ref:`🔗` -Devuelve el ángulo entre el nodo y el ``point`` en radianes. +Returns the angle between the node and the ``point`` in radians. See also :ref:`look_at()`. -\ `Ilustración del ángulo devuelto. `__ +\ `Illustration of the returned angle. `__ .. rst-class:: classref-item-separator @@ -377,9 +377,9 @@ Añade el vector ``offset`` a la posición global del nodo. |void| **look_at**\ (\ point\: :ref:`Vector2`\ ) :ref:`🔗` -Rota el nodo para que su eje +X local apunte hacia el ``point``, que se espera que use coordenadas globales. +Rotates the node so that its local +X axis points towards the ``point``, which is expected to use global coordinates. This method is a combination of both :ref:`rotate()` and :ref:`get_angle_to()`. -El ``point`` no debe ser el mismo que la posición del nodo, de lo contrario el nodo siempre mirará hacia la derecha. +\ ``point`` should not be the same as the node's position, otherwise the node always looks to the right. .. rst-class:: classref-item-separator @@ -415,7 +415,7 @@ Applies a local translation on the node's Y axis with the amount specified in `` |void| **rotate**\ (\ radians\: :ref:`float`\ ) :ref:`🔗` -Aplica una rotación al nodo, en radianes, a partir de su rotación actual. +Applies a rotation to the node, in radians, starting from its current rotation. This is equivalent to ``rotation += radians``. .. rst-class:: classref-item-separator @@ -451,7 +451,7 @@ Transforma la posición global proporcionada en una posición en el espacio de c |void| **translate**\ (\ offset\: :ref:`Vector2`\ ) :ref:`🔗` -Traslada el nodo por el ``offset`` dado en coordenadas locales. +Translates the node by the given ``offset`` in local coordinates. This is equivalent to ``position += offset``. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_node3d.rst b/classes/es/class_node3d.rst index b377dc653e..756c605b65 100644 --- a/classes/es/class_node3d.rst +++ b/classes/es/class_node3d.rst @@ -257,7 +257,9 @@ Notificación recibida cuando este nodo se registra en un nuevo :ref:`World3D` -Notificación recibida cuando este nodo se da de baja del :ref:`World3D` actual (véase :ref:`get_world_3d()`). +Notification received when this node is unregistered from the current :ref:`World3D` (see :ref:`get_world_3d()`). + +This notification is sent in reversed order. .. _class_Node3D_constant_NOTIFICATION_VISIBILITY_CHANGED: diff --git a/classes/es/class_object.rst b/classes/es/class_object.rst index d1d04982a3..0df892080b 100644 --- a/classes/es/class_object.rst +++ b/classes/es/class_object.rst @@ -5,7 +5,7 @@ Object ====== -**Heredado por:** :ref:`AudioServer`, :ref:`CameraServer`, :ref:`ClassDB`, :ref:`DisplayServer`, :ref:`EditorFileSystemDirectory`, :ref:`EditorInterface`, :ref:`EditorPaths`, :ref:`EditorSelection`, :ref:`EditorUndoRedoManager`, :ref:`EditorVCSInterface`, :ref:`Engine`, :ref:`EngineDebugger`, :ref:`FramebufferCacheRD`, :ref:`GDExtensionManager`, :ref:`Geometry2D`, :ref:`Geometry3D`, :ref:`Input`, :ref:`InputMap`, :ref:`IP`, :ref:`JavaClassWrapper`, :ref:`JavaScriptBridge`, :ref:`JNISingleton`, :ref:`JSONRPC`, :ref:`MainLoop`, :ref:`Marshalls`, :ref:`MovieWriter`, :ref:`NativeMenu`, :ref:`NavigationMeshGenerator`, :ref:`NavigationServer2D`, :ref:`NavigationServer3D`, :ref:`Node`, :ref:`OpenXRExtensionWrapper`, :ref:`OpenXRInteractionProfileMetadata`, :ref:`OS`, :ref:`Performance`, :ref:`PhysicsDirectBodyState2D`, :ref:`PhysicsDirectBodyState3D`, :ref:`PhysicsDirectSpaceState2D`, :ref:`PhysicsDirectSpaceState3D`, :ref:`PhysicsServer2D`, :ref:`PhysicsServer2DManager`, :ref:`PhysicsServer3D`, :ref:`PhysicsServer3DManager`, :ref:`PhysicsServer3DRenderingServerHandler`, :ref:`ProjectSettings`, :ref:`RefCounted`, :ref:`RenderData`, :ref:`RenderingDevice`, :ref:`RenderingServer`, :ref:`RenderSceneData`, :ref:`ResourceLoader`, :ref:`ResourceSaver`, :ref:`ResourceUID`, :ref:`ScriptLanguage`, :ref:`ShaderIncludeDB`, :ref:`TextServerManager`, :ref:`ThemeDB`, :ref:`TileData`, :ref:`Time`, :ref:`TranslationServer`, :ref:`TreeItem`, :ref:`UndoRedo`, :ref:`UniformSetCacheRD`, :ref:`WorkerThreadPool`, :ref:`XRServer`, :ref:`XRVRS` +**Heredado por:** :ref:`AudioServer`, :ref:`CameraServer`, :ref:`ClassDB`, :ref:`DisplayServer`, :ref:`EditorFileSystemDirectory`, :ref:`EditorInterface`, :ref:`EditorPaths`, :ref:`EditorSelection`, :ref:`EditorUndoRedoManager`, :ref:`EditorVCSInterface`, :ref:`Engine`, :ref:`EngineDebugger`, :ref:`FramebufferCacheRD`, :ref:`GDExtensionManager`, :ref:`Geometry2D`, :ref:`Geometry3D`, :ref:`GodotInstance`, :ref:`Input`, :ref:`InputMap`, :ref:`IP`, :ref:`JavaClassWrapper`, :ref:`JavaScriptBridge`, :ref:`JNISingleton`, :ref:`JSONRPC`, :ref:`MainLoop`, :ref:`Marshalls`, :ref:`MovieWriter`, :ref:`NativeMenu`, :ref:`NavigationMeshGenerator`, :ref:`NavigationServer2D`, :ref:`NavigationServer2DManager`, :ref:`NavigationServer3D`, :ref:`NavigationServer3DManager`, :ref:`Node`, :ref:`OpenXRExtensionWrapper`, :ref:`OpenXRInteractionProfileMetadata`, :ref:`OS`, :ref:`Performance`, :ref:`PhysicsDirectBodyState2D`, :ref:`PhysicsDirectBodyState3D`, :ref:`PhysicsDirectSpaceState2D`, :ref:`PhysicsDirectSpaceState3D`, :ref:`PhysicsServer2D`, :ref:`PhysicsServer2DManager`, :ref:`PhysicsServer3D`, :ref:`PhysicsServer3DManager`, :ref:`PhysicsServer3DRenderingServerHandler`, :ref:`ProjectSettings`, :ref:`RefCounted`, :ref:`RenderData`, :ref:`RenderingDevice`, :ref:`RenderingServer`, :ref:`RenderSceneData`, :ref:`ResourceLoader`, :ref:`ResourceSaver`, :ref:`ResourceUID`, :ref:`ScriptLanguage`, :ref:`ShaderIncludeDB`, :ref:`TextServerManager`, :ref:`ThemeDB`, :ref:`TileData`, :ref:`Time`, :ref:`TranslationServer`, :ref:`TreeItem`, :ref:`UndoRedo`, :ref:`UniformSetCacheRD`, :ref:`WorkerThreadPool`, :ref:`XRServer`, :ref:`XRVRS` Base class for all other classes in the engine. @@ -251,7 +251,9 @@ Deferred connections trigger their :ref:`Callable`\ s on idle ti :ref:`ConnectFlags` **CONNECT_PERSIST** = ``2`` -Las conexiones persistentes se almacenan cuando el objeto se serializa (como cuando se usa :ref:`PackedScene.pack()`). En el editor, las conexiones creadas a través del dock Nodo son siempre persistentes. +Persisting connections are stored when the object is serialized (such as when using :ref:`PackedScene.pack()`). In the editor, connections created through the Signals dock are always persisting. + +\ **Note:** Connections to lambda functions (that is, when the function code is embedded in the :ref:`connect()` call) cannot be made persistent. .. _class_Object_constant_CONNECT_ONE_SHOT: @@ -300,7 +302,9 @@ Notificación recibida cuando el objeto se inicializa, antes de que su script se **NOTIFICATION_PREDELETE** = ``1`` :ref:`🔗` -Notificación recibida cuando el objeto está a punto de ser borrado. Puede ser usado como los destructores en lenguajes de programación orientados a objetos. +Notification received when the object is about to be deleted. Can be used like destructors in object-oriented programming languages. + +This notification is sent in reversed order. .. _class_Object_constant_NOTIFICATION_EXTENSION_RELOADED: @@ -372,6 +376,8 @@ Combined with :ref:`_set()` and :ref:`_get_pro +\ **Note:** Unlike other virtual methods, this method is called automatically for every script that overrides it. This means that the base implementation should not be called via ``super`` in GDScript or its equivalents in other languages. The bottom-most sub-class will be called first, with subsequent calls ascending the class hierarchy. The call chain will stop on the first class that returns a non-``null`` value. + .. rst-class:: classref-item-separator ---- @@ -500,6 +506,8 @@ The example below displays a list of numbers shown as words going from ``ZERO`` \ **Note:** If the object's script is not :ref:`@GDScript.@tool`, this method will not be called in the editor. +\ **Note:** Unlike other virtual methods, this method is called automatically for every script that overrides it. This means that the base implementation should not be called via ``super`` in GDScript or its equivalents in other languages. The bottom-most sub-class will be called first, with subsequent calls ascending the class hierarchy. + .. rst-class:: classref-item-separator ---- @@ -616,7 +624,7 @@ Called when the object receives a notification, which can be identified in ``wha \ **Note:** The base **Object** defines a few notifications (:ref:`NOTIFICATION_POSTINITIALIZE` and :ref:`NOTIFICATION_PREDELETE`). Inheriting classes such as :ref:`Node` define a lot more notifications, which are also received by this method. -\ **Note:** Unlike other virtual methods, this method is called automatically for every script that overrides it. This means that the base implementation should not be called via ``super`` in GDScript or its equivalents in other languages. +\ **Note:** Unlike other virtual methods, this method is called automatically for every script that overrides it. This means that the base implementation should not be called via ``super`` in GDScript or its equivalents in other languages. Call order depends on the ``reversed`` argument of :ref:`notification()` and varies between different notifications. Most notifications are sent in the forward order (i.e. Object class first, most derived class last). .. rst-class:: classref-item-separator @@ -632,6 +640,8 @@ Override this method to customize the given ``property``'s revert behavior. Shou \ **Note:** This method must return consistently, regardless of the current value of the ``property``. +\ **Note:** Unlike other virtual methods, this method is called automatically for every script that overrides it. This means that the base implementation should not be called via ``super`` in GDScript or its equivalents in other languages. The bottom-most sub-class will be called first, with subsequent calls ascending the class hierarchy. The call chain will stop on the first class that returns ``true``. + .. rst-class:: classref-item-separator ---- @@ -646,6 +656,8 @@ Override this method to customize the given ``property``'s revert behavior. Shou \ **Note:** :ref:`_property_can_revert()` must also be overridden for this method to be called. +\ **Note:** Unlike other virtual methods, this method is called automatically for every script that overrides it. This means that the base implementation should not be called via ``super`` in GDScript or its equivalents in other languages. The bottom-most sub-class will be called first, with subsequent calls ascending the class hierarchy. The call chain will stop on the first class that returns a non-``null`` value. + .. rst-class:: classref-item-separator ---- @@ -711,6 +723,8 @@ Combined with :ref:`_get()` and :ref:`_get_pro +\ **Note:** Unlike other virtual methods, this method is called automatically for every script that overrides it. This means that the base implementation should not be called via ``super`` in GDScript or its equivalents in other languages. The bottom-most sub-class will be called first, with subsequent calls ascending the class hierarchy. The call chain will stop on the first class that returns ``true``. + .. rst-class:: classref-item-separator ---- @@ -895,6 +909,8 @@ This method supports a variable number of arguments, so parameters can be passed +For methods that are deferred from the same thread, the order of execution at idle time is identical to the order in which ``call_deferred`` was called. + See also :ref:`Callable.call_deferred()`. \ **Note:** In C#, ``method`` must be in snake_case when referring to built-in Godot methods. Prefer using the names exposed in the ``MethodName`` class to avoid allocating a new :ref:`StringName` on each call. @@ -981,7 +997,7 @@ A signal can only be connected once to the same :ref:`Callable`. \ **Note:** In GDScript, it is generally recommended to connect signals with :ref:`Signal.connect()` instead. -\ **Note:** This operation (and all other signal related operations) is thread-safe. +\ **Note:** This method, and all other signal-related methods, are thread-safe. .. rst-class:: classref-item-separator @@ -1288,7 +1304,7 @@ Returns an :ref:`Array` of connections for the given ``signal`` nam Returns the list of existing signals as an :ref:`Array` of dictionaries. -\ **Note:** Due of the implementation, each :ref:`Dictionary` is formatted very similarly to the returned values of :ref:`get_method_list()`. +\ **Note:** Due to the implementation, each :ref:`Dictionary` is formatted very similarly to the returned values of :ref:`get_method_list()`. .. rst-class:: classref-item-separator diff --git a/classes/es/class_openxranchortracker.rst b/classes/es/class_openxranchortracker.rst new file mode 100644 index 0000000000..61dbf59254 --- /dev/null +++ b/classes/es/class_openxranchortracker.rst @@ -0,0 +1,109 @@ +:github_url: hide + +.. _class_OpenXRAnchorTracker: + +OpenXRAnchorTracker +=================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialEntityTracker` **<** :ref:`XRPositionalTracker` **<** :ref:`XRTracker` **<** :ref:`RefCounted` **<** :ref:`Object` + +Positional tracker for our spatial entity anchor extension. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Positional tracker for our OpenXR spatial entity anchor extension, it tracks a user defined location in real space and maps it to our virtual space. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +-----------------------------+------------------------------------------------------+--------+ + | :ref:`String` | :ref:`uuid` | ``""`` | + +-----------------------------+------------------------------------------------------+--------+ + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------+--------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_uuid`\ (\ ) |const| | + +-------------------------+--------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Señales +-------------- + +.. _class_OpenXRAnchorTracker_signal_uuid_changed: + +.. rst-class:: classref-signal + +**uuid_changed**\ (\ ) :ref:`🔗` + +Emitted when the UUID for this anchor was changed. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_OpenXRAnchorTracker_property_uuid: + +.. rst-class:: classref-property + +:ref:`String` **uuid** = ``""`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_uuid**\ (\ value\: :ref:`String`\ ) +- :ref:`String` **get_uuid**\ (\ ) + +The UUID provided for persistent anchors. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRAnchorTracker_method_has_uuid: + +.. rst-class:: classref-method + +:ref:`bool` **has_uuid**\ (\ ) |const| :ref:`🔗` + +Returns ``true`` if a non-zero UUID is set. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrandroidthreadsettingsextension.rst b/classes/es/class_openxrandroidthreadsettingsextension.rst new file mode 100644 index 0000000000..f85f6cbf42 --- /dev/null +++ b/classes/es/class_openxrandroidthreadsettingsextension.rst @@ -0,0 +1,107 @@ +:github_url: hide + +.. _class_OpenXRAndroidThreadSettingsExtension: + +OpenXRAndroidThreadSettingsExtension +==================================== + +**Hereda:** :ref:`OpenXRExtensionWrapper` **<** :ref:`Object` + +Wraps the `XR_KHR_android_thread_settings `__ extension. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +For XR to be comfortable, it is important for applications to deliver frames quickly and consistently. In order to make sure the important application threads get their full share of time, these threads must be identified to the system, which will adjust their scheduling priority accordingly. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`set_application_thread_type`\ (\ thread_type\: :ref:`ThreadType`, thread_id\: :ref:`int` = 0\ ) | + +-------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Enumeraciones +-------------------------- + +.. _enum_OpenXRAndroidThreadSettingsExtension_ThreadType: + +.. rst-class:: classref-enumeration + +enum **ThreadType**: :ref:`🔗` + +.. _class_OpenXRAndroidThreadSettingsExtension_constant_THREAD_TYPE_APPLICATION_MAIN: + +.. rst-class:: classref-enumeration-constant + +:ref:`ThreadType` **THREAD_TYPE_APPLICATION_MAIN** = ``0`` + +Hints to the XR runtime that the thread is doing time critical CPU tasks. + +.. _class_OpenXRAndroidThreadSettingsExtension_constant_THREAD_TYPE_APPLICATION_WORKER: + +.. rst-class:: classref-enumeration-constant + +:ref:`ThreadType` **THREAD_TYPE_APPLICATION_WORKER** = ``1`` + +Hints to the XR runtime that the thread is doing background CPU tasks. + +.. _class_OpenXRAndroidThreadSettingsExtension_constant_THREAD_TYPE_RENDERER_MAIN: + +.. rst-class:: classref-enumeration-constant + +:ref:`ThreadType` **THREAD_TYPE_RENDERER_MAIN** = ``2`` + +Hints to the XR runtime that the thread is doing time critical graphics device tasks. + +.. _class_OpenXRAndroidThreadSettingsExtension_constant_THREAD_TYPE_RENDERER_WORKER: + +.. rst-class:: classref-enumeration-constant + +:ref:`ThreadType` **THREAD_TYPE_RENDERER_WORKER** = ``3`` + +Hints to the XR runtime that the thread is doing background graphics device tasks. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRAndroidThreadSettingsExtension_method_set_application_thread_type: + +.. rst-class:: classref-method + +:ref:`bool` **set_application_thread_type**\ (\ thread_type\: :ref:`ThreadType`, thread_id\: :ref:`int` = 0\ ) :ref:`🔗` + +Sets the thread type of the given thread, so that the XR runtime can adjust its scheduling priority accordingly. + +\ ``thread_id`` refers to the OS thread id (ie from ``gettid()``). When ``thread_id`` is ``0``, it will set the thread type of the current thread. + +\ **NOTE:** The id returned by :ref:`Thread.get_id()` is incompatible with ``thread_id``. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrapiextension.rst b/classes/es/class_openxrapiextension.rst index 003297b711..56752e5aa3 100644 --- a/classes/es/class_openxrapiextension.rst +++ b/classes/es/class_openxrapiextension.rst @@ -66,6 +66,8 @@ Métodos +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_next_frame_time`\ (\ ) | +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_openxr_version`\ (\ ) | + +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_play_space`\ (\ ) | +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_predicted_display_time`\ (\ ) | @@ -134,6 +136,8 @@ Métodos +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`unregister_projection_views_extension`\ (\ extension\: :ref:`OpenXRExtensionWrapper`\ ) | +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`update_main_swapchain_size`\ (\ ) | + +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`xr_result`\ (\ result\: :ref:`int`, format\: :ref:`String`, args\: :ref:`Array`\ ) | +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -307,6 +311,18 @@ Returns the predicted display timing for the next frame. ---- +.. _class_OpenXRAPIExtension_method_get_openxr_version: + +.. rst-class:: classref-method + +:ref:`int` **get_openxr_version**\ (\ ) :ref:`🔗` + +Returns the version of OpenXR that was initialized. Only valid after the OpenXR instance has been created. See `XR_MAKE_VERSION `__ for how the version is calculated. + +.. rst-class:: classref-item-separator + +---- + .. _class_OpenXRAPIExtension_method_get_play_space: .. rst-class:: classref-method @@ -415,7 +431,7 @@ Returns the name of the specified swapchain format. :ref:`int` **get_system_id**\ (\ ) :ref:`🔗` -Returns the id of the system, which is an `XrSystemId `__ cast to an integer. +Returns the ID of the system, which is an `XrSystemId `__ cast to an integer. .. rst-class:: classref-item-separator @@ -561,6 +577,8 @@ Releases the image of the provided swapchain. Registers the given extension as a composition layer provider. +\ **Note:** This cannot be called after the OpenXR session has started. However, it can be called in :ref:`OpenXRExtensionWrapper._on_session_created()`. + .. rst-class:: classref-item-separator ---- @@ -573,6 +591,8 @@ Registers the given extension as a composition layer provider. Registers the given extension as modifying frame info via the :ref:`OpenXRExtensionWrapper._set_frame_wait_info_and_get_next_pointer()`, :ref:`OpenXRExtensionWrapper._set_view_locate_info_and_get_next_pointer()`, or :ref:`OpenXRExtensionWrapper._set_frame_end_info_and_get_next_pointer()` virtual methods. +\ **Note:** This cannot be called after the OpenXR session has started. However, it can be called in :ref:`OpenXRExtensionWrapper._on_session_created()`. + .. rst-class:: classref-item-separator ---- @@ -583,7 +603,9 @@ Registers the given extension as modifying frame info via the :ref:`OpenXRExtens |void| **register_projection_views_extension**\ (\ extension\: :ref:`OpenXRExtensionWrapper`\ ) :ref:`🔗` -Registra la extensión dada como un proveedor de estructuras de datos adicionales para las vistas de proyección. +Registers the given extension as a provider of additional data structures to projections views. + +\ **Note:** This cannot be called after the OpenXR session has started. However, it can be called in :ref:`OpenXRExtensionWrapper._on_session_created()`. .. rst-class:: classref-item-separator @@ -693,6 +715,8 @@ Creates a :ref:`Transform3D` from an `XrPosef ` + +Request the recommended resolution from the OpenXR runtime and update the main swapchain size if it has changed. + .. rst-class:: classref-item-separator ---- diff --git a/classes/es/class_openxrcompositionlayer.rst b/classes/es/class_openxrcompositionlayer.rst index d9011a71ad..b9f3907840 100644 --- a/classes/es/class_openxrcompositionlayer.rst +++ b/classes/es/class_openxrcompositionlayer.rst @@ -39,6 +39,8 @@ Propiedades +-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+ | :ref:`SubViewport` | :ref:`layer_viewport` | | +-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+ + | :ref:`bool` | :ref:`protected_content` | ``false`` | + +-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+ | :ref:`int` | :ref:`sort_order` | ``1`` | +-----------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+--------------------------+ | :ref:`Swizzle` | :ref:`swapchain_state_alpha_swizzle` | ``3`` | @@ -348,6 +350,25 @@ El :ref:`SubViewport` para renderizar en la capa de composici ---- +.. _class_OpenXRCompositionLayer_property_protected_content: + +.. rst-class:: classref-property + +:ref:`bool` **protected_content** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_protected_content**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_protected_content**\ (\ ) + +If enabled, the OpenXR swapchain will be created with the ``XR_SWAPCHAIN_CREATE_PROTECTED_CONTENT_BIT`` flag, which will protect its contents from CPU access. + +When used with an Android Surface, this may allow DRM content to be presented, and will only take effect when the Surface is first created; later changes to this property will have no effect. + +.. rst-class:: classref-item-separator + +---- + .. _class_OpenXRCompositionLayer_property_sort_order: .. rst-class:: classref-property diff --git a/classes/es/class_openxrextensionwrapper.rst b/classes/es/class_openxrextensionwrapper.rst index a90470cc4c..60c2177561 100644 --- a/classes/es/class_openxrextensionwrapper.rst +++ b/classes/es/class_openxrextensionwrapper.rst @@ -7,7 +7,7 @@ OpenXRExtensionWrapper **Hereda:** :ref:`Object` -**Heredado por:** :ref:`OpenXRExtensionWrapperExtension`, :ref:`OpenXRFutureExtension`, :ref:`OpenXRRenderModelExtension` +**Heredado por:** :ref:`OpenXRAndroidThreadSettingsExtension`, :ref:`OpenXRExtensionWrapperExtension`, :ref:`OpenXRFrameSynthesisExtension`, :ref:`OpenXRFutureExtension`, :ref:`OpenXRRenderModelExtension`, :ref:`OpenXRSpatialAnchorCapability`, :ref:`OpenXRSpatialEntityExtension`, :ref:`OpenXRSpatialMarkerTrackingCapability`, :ref:`OpenXRSpatialPlaneTrackingCapability` Permite implementar extensiones de OpenXR con GDExtension. @@ -16,7 +16,17 @@ Permite implementar extensiones de OpenXR con GDExtension. Descripción ---------------------- -**OpenXRExtensionWrapper** permite implementar extensiones de OpenXR con GDExtension. La extensión debe registrarse con :ref:`register_extension_wrapper()`. +**OpenXRExtensionWrapper** allows implementing OpenXR extensions with GDExtension. The extension should be registered with :ref:`register_extension_wrapper()`. + +When :ref:`OpenXRInterface` is initialized as the primary interface and any :ref:`Viewport` has :ref:`Viewport.use_xr` set to ``true``, OpenXR will become involved in Godot's rendering process. If :ref:`ProjectSettings.rendering/driver/threads/thread_model` is set to "Separate", Godot's renderer will run on its own thread, and special care must be taken in all **OpenXRExtensionWrapper**\ s in order to prevent crashes or unexpected behavior. Some virtual methods will be called on the render thread, and any data they access should not be directly written to on the main thread. This is to prevent two potential issues: + +1. Changes intended for the next frame, taking effect on the current frame. When using the "Separate" thread model, the main thread will immediately start working on the next frame while the render thread may still be rendering the current frame. If the main thread changes anything used by the render thread directly, the change could end up being used one frame earlier than intended. + +2. Reading and writing to the same data at the same time from different threads can lead to the render thread using data in an invalid state. + +In most cases, the solution is to use :ref:`RenderingServer.call_on_render_thread()` to schedule :ref:`Callable`\ s to write to any data used on the render thread. When using the "Separate" thread model, these :ref:`Callable`\ s will run after the renderer finishes the current frame and before it starts rendering the next frame. When not using this mode, they'll run immediately, so it's recommended to always use :ref:`RenderingServer.call_on_render_thread()` in these cases, which will allow your code to do the right thing regardless of the thread model. + +Any virtual methods that run on the render thread will be noted below. .. rst-class:: classref-reftable-group @@ -33,7 +43,7 @@ Métodos +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`_get_composition_layer_order`\ (\ index\: :ref:`int`\ ) |virtual| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Dictionary` | :ref:`_get_requested_extensions`\ (\ ) |virtual| | + | :ref:`Dictionary` | :ref:`_get_requested_extensions`\ (\ xr_version\: :ref:`int`\ ) |virtual| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedStringArray` | :ref:`_get_suggested_tracker_names`\ (\ ) |virtual| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -85,6 +95,10 @@ Métodos +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_on_viewport_composition_layer_destroyed`\ (\ layer\: ``const void*``\ ) |virtual| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`_prepare_view_configuration`\ (\ view_count\: :ref:`int`\ ) |virtual| | + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`_print_view_configuration_info`\ (\ view\: :ref:`int`\ ) |virtual| |const| | + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`_set_android_surface_swapchain_create_info_and_get_next_pointer`\ (\ property_values\: :ref:`Dictionary`, next_pointer\: ``void*``\ ) |virtual| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`_set_frame_end_info_and_get_next_pointer`\ (\ next_pointer\: ``void*``\ ) |virtual| | @@ -93,7 +107,7 @@ Métodos +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`_set_hand_joint_locations_and_get_next_pointer`\ (\ hand_index\: :ref:`int`, next_pointer\: ``void*``\ ) |virtual| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`_set_instance_create_info_and_get_next_pointer`\ (\ next_pointer\: ``void*``\ ) |virtual| | + | :ref:`int` | :ref:`_set_instance_create_info_and_get_next_pointer`\ (\ xr_version\: :ref:`int`, next_pointer\: ``void*``\ ) |virtual| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`_set_projection_views_and_get_next_pointer`\ (\ view_index\: :ref:`int`, next_pointer\: ``void*``\ ) |virtual| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -105,6 +119,8 @@ Métodos +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`_set_system_properties_and_get_next_pointer`\ (\ next_pointer\: ``void*``\ ) |virtual| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`_set_view_configuration_and_get_next_pointer`\ (\ view\: :ref:`int`, next_pointer\: ``void*``\ ) |virtual| | + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`_set_view_locate_info_and_get_next_pointer`\ (\ next_pointer\: ``void*``\ ) |virtual| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`_set_viewport_composition_layer_and_get_next_pointer`\ (\ layer\: ``const void*``, property_values\: :ref:`Dictionary`, next_pointer\: ``void*``\ ) |virtual| | @@ -129,9 +145,11 @@ Descripciones de Métodos :ref:`int` **_get_composition_layer**\ (\ index\: :ref:`int`\ ) |virtual| :ref:`🔗` -Devuelve un puntero a una estructura ``XrCompositionLayerBaseHeader`` para proporcionar la capa de composición dada. +Returns a pointer to an ``XrCompositionLayerBaseHeader`` struct to provide the given composition layer. -Esto solo se llamará si la extensión se registró previamente con :ref:`OpenXRAPIExtension.register_composition_layer_provider()`. +This will only be called if the extension previously registered itself with :ref:`OpenXRAPIExtension.register_composition_layer_provider()`. + +\ **Note:** This virtual method will be called on the render thread. Additionally, the data it returns will be used shortly after this method is called, so it needs to remain valid until the next time :ref:`_on_pre_render()` runs. .. rst-class:: classref-item-separator @@ -143,9 +161,11 @@ Esto solo se llamará si la extensión se registró previamente con :ref:`OpenXR :ref:`int` **_get_composition_layer_count**\ (\ ) |virtual| :ref:`🔗` -Devuelve el número de capas de composición que este wrapper de extensión proporciona a través de :ref:`_get_composition_layer()`. +Returns the number of composition layers this extension wrapper provides via :ref:`_get_composition_layer()`. -Esto solo se llamará si la extensión se registró previamente con :ref:`OpenXRAPIExtension.register_composition_layer_provider()`. +This will only be called if the extension previously registered itself with :ref:`OpenXRAPIExtension.register_composition_layer_provider()`. + +\ **Note:** This virtual method will be called on the render thread. Additionally, the data it returns will be used shortly after this method is called, so it needs to remain valid until the next time :ref:`_on_pre_render()` runs. .. rst-class:: classref-item-separator @@ -157,9 +177,11 @@ Esto solo se llamará si la extensión se registró previamente con :ref:`OpenXR :ref:`int` **_get_composition_layer_order**\ (\ index\: :ref:`int`\ ) |virtual| :ref:`🔗` -Devuelve un entero que se utilizará para ordenar la capa de composición dada proporcionada a través de :ref:`_get_composition_layer()`. Los números más bajos moverán la capa al frente de la lista, y los números más altos al final. La capa de proyección predeterminada tiene un orden de ``0``, por lo que las capas proporcionadas por este método probablemente deberían estar por encima o por debajo (pero no exactamente) de ``0``. +Returns an integer that will be used to sort the given composition layer provided via :ref:`_get_composition_layer()`. Lower numbers will move the layer to the front of the list, and higher numbers to the end. The default projection layer has an order of ``0``, so layers provided by this method should probably be above or below (but not exactly) ``0``. -Esto solo se llamará si la extensión se registró previamente con :ref:`OpenXRAPIExtension.register_composition_layer_provider()`. +This will only be called if the extension previously registered itself with :ref:`OpenXRAPIExtension.register_composition_layer_provider()`. + +\ **Note:** This virtual method will be called on the render thread. Additionally, the data it returns will be used shortly after this method is called, so it needs to remain valid until the next time :ref:`_on_pre_render()` runs. .. rst-class:: classref-item-separator @@ -169,13 +191,13 @@ Esto solo se llamará si la extensión se registró previamente con :ref:`OpenXR .. rst-class:: classref-method -:ref:`Dictionary` **_get_requested_extensions**\ (\ ) |virtual| :ref:`🔗` +:ref:`Dictionary` **_get_requested_extensions**\ (\ xr_version\: :ref:`int`\ ) |virtual| :ref:`🔗` -Devuelve un :ref:`Dictionary` de extensiones de OpenXR relacionadas con esta extensión. El :ref:`Dictionary` debe contener el nombre de la extensión, asignado a un ``bool *`` casteado a un entero: +Returns a :ref:`Dictionary` of OpenXR extensions related to this extension. ``xr_version`` specifies the OpenXR version we're instantiating. This will be zero if the editor requests this list to flag supported features. The :ref:`Dictionary` should contain the name of the extension, mapped to a ``bool *`` cast to an integer: -- Si el ``bool *`` es un ``nullptr`` esta extensión es obligatoria. +- If the ``bool *`` is a ``nullptr`` this extension is mandatory. -- Si el ``bool *`` apunta a un booleano, el booleano se actualizará a ``true`` si la extensión está habilitada. +- If the ``bool *`` points to a boolean, the boolean will be updated to ``true`` if the extension is enabled. .. rst-class:: classref-item-separator @@ -199,7 +221,9 @@ Returns a :ref:`PackedStringArray` of positional tracke :ref:`Array`\[:ref:`Dictionary`\] **_get_viewport_composition_layer_extension_properties**\ (\ ) |virtual| :ref:`🔗` -Obtiene un array de :ref:`Dictionary`\ s que representan propiedades, al igual que :ref:`Object._get_property_list()`, que se añadirán a los nodos :ref:`OpenXRCompositionLayer`. +Gets an array of :ref:`Dictionary`\ s that represent properties, just like :ref:`Object._get_property_list()`, that will be added to :ref:`OpenXRCompositionLayer` nodes. + +\ **Note:** This virtual method will be called on the render thread. .. rst-class:: classref-item-separator @@ -223,7 +247,9 @@ Obtiene un :ref:`Dictionary` que contiene los valores por defe |void| **_on_before_instance_created**\ (\ ) |virtual| :ref:`🔗` -Llamado antes de que se cree la instancia de OpenXR. +Called before the OpenXR instance is created. + +\ **Note:** This virtual method will be called on the main thread, however, it will be called *before* OpenXR becomes involved in rendering, so it is safe to write to data that will be used by the render thread. .. rst-class:: classref-item-separator @@ -247,7 +273,9 @@ Llamado cuando hay un evento de OpenXR para procesar. Al implementar, devuelve ` |void| **_on_instance_created**\ (\ instance\: :ref:`int`\ ) |virtual| :ref:`🔗` -Llamado justo después de que se cree la instancia de OpenXR. +Called right after the OpenXR instance is created. + +\ **Note:** This virtual method will be called on the main thread, however, it will be called *before* OpenXR becomes involved in rendering, so it is safe to write to data that will be used by the render thread. .. rst-class:: classref-item-separator @@ -259,7 +287,9 @@ Llamado justo después de que se cree la instancia de OpenXR. |void| **_on_instance_destroyed**\ (\ ) |virtual| :ref:`🔗` -Llamado justo antes de que se destruya la instancia de OpenXR. +Called right before the OpenXR instance is destroyed. + +\ **Note:** This virtual method will be called on the main thread, however, it will be called *after* OpenXR is done being involved in rendering, so it is safe to write to data that was used by the render thread. .. rst-class:: classref-item-separator @@ -271,7 +301,9 @@ Llamado justo antes de que se destruya la instancia de OpenXR. |void| **_on_main_swapchains_created**\ (\ ) |virtual| :ref:`🔗` -Llamado justo después de que se (re)creen las swapchains principales. +Called right after the main swapchains are (re)created. + +\ **Note:** This virtual method will be called on the render thread. .. rst-class:: classref-item-separator @@ -283,9 +315,11 @@ Llamado justo después de que se (re)creen las swapchains principales. |void| **_on_post_draw_viewport**\ (\ viewport\: :ref:`RID`\ ) |virtual| :ref:`🔗` -Llamado justo después de que se renderiza el viewport dado. +Called right after the given viewport is rendered. -\ **Nota:** Los comandos de dibujo podrían estar solo en cola en este punto, no ejecutados. +\ **Note:** The draw commands might only be queued at this point, not executed. + +\ **Note:** This virtual method will be called on the render thread. .. rst-class:: classref-item-separator @@ -297,7 +331,9 @@ Llamado justo después de que se renderiza el viewport dado. |void| **_on_pre_draw_viewport**\ (\ viewport\: :ref:`RID`\ ) |virtual| :ref:`🔗` -Llamado justo antes de que se renderice el viewport dado. +Called right before the given viewport is rendered. + +\ **Note:** This virtual method will be called on the render thread. .. rst-class:: classref-item-separator @@ -309,7 +345,9 @@ Llamado justo antes de que se renderice el viewport dado. |void| **_on_pre_render**\ (\ ) |virtual| :ref:`🔗` -Llamado justo antes de que los viewports de XR comiencen su paso de renderizado. +Called right before the XR viewports begin their rendering step. + +\ **Note:** This virtual method will be called on the render thread. .. rst-class:: classref-item-separator @@ -347,7 +385,9 @@ Las extensiones también deben proporcionar metadatos independientemente de si s |void| **_on_session_created**\ (\ session\: :ref:`int`\ ) |virtual| :ref:`🔗` -Llamado justo después de que se cree la sesión de OpenXR. +Called right after the OpenXR session is created. + +\ **Note:** This virtual method will be called on the main thread, however, it will be called *before* OpenXR becomes involved in rendering, so it is safe to write to data that will be used by the render thread. .. rst-class:: classref-item-separator @@ -359,7 +399,9 @@ Llamado justo después de que se cree la sesión de OpenXR. |void| **_on_session_destroyed**\ (\ ) |virtual| :ref:`🔗` -Llamado justo antes de que se destruya la sesión de OpenXR. +Called right before the OpenXR session is destroyed. + +\ **Note:** This virtual method will be called on the main thread, however, it will be called *after* OpenXR is done being involved in rendering, so it is safe to write to data that was used by the render thread. .. rst-class:: classref-item-separator @@ -487,15 +529,41 @@ Llamado cuando una capa de composición creada a través de :ref:`OpenXRComposit ---- +.. _class_OpenXRExtensionWrapper_private_method__prepare_view_configuration: + +.. rst-class:: classref-method + +|void| **_prepare_view_configuration**\ (\ view_count\: :ref:`int`\ ) |virtual| :ref:`🔗` + +Called before :ref:`_set_view_configuration_and_get_next_pointer()` to allow the extension to reserve data for the given number of views. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRExtensionWrapper_private_method__print_view_configuration_info: + +.. rst-class:: classref-method + +|void| **_print_view_configuration_info**\ (\ view\: :ref:`int`\ ) |virtual| |const| :ref:`🔗` + +Called to allow an extension to print additional information about its view configuration, if applicable. This will only be called if verbose output is enabled. + +.. rst-class:: classref-item-separator + +---- + .. _class_OpenXRExtensionWrapper_private_method__set_android_surface_swapchain_create_info_and_get_next_pointer: .. rst-class:: classref-method :ref:`int` **_set_android_surface_swapchain_create_info_and_get_next_pointer**\ (\ property_values\: :ref:`Dictionary`, next_pointer\: ``void*``\ ) |virtual| :ref:`🔗` -Añade estructuras de datos adicionales a las swapchains de superficie de Android creadas por :ref:`OpenXRCompositionLayer`. +Add additional data structures to Android surface swapchains created by :ref:`OpenXRCompositionLayer`. -\ ``property_values`` contiene los valores de las propiedades devueltas por :ref:`_get_viewport_composition_layer_extension_properties()`. +\ ``property_values`` contains the values of the properties returned by :ref:`_get_viewport_composition_layer_extension_properties()`. + +\ **Note:** This virtual method will be called on the render thread. .. rst-class:: classref-item-separator @@ -507,9 +575,11 @@ Añade estructuras de datos adicionales a las swapchains de superficie de Androi :ref:`int` **_set_frame_end_info_and_get_next_pointer**\ (\ next_pointer\: ``void*``\ ) |virtual| :ref:`🔗` -Añade estructuras de datos adicionales a ``XrFrameEndInfo``. +Add additional data structures to ``XrFrameEndInfo``. -Esto sólo se llamará si la extensión se ha registrado previamente con :ref:`OpenXRAPIExtension.register_frame_info_extension()`. +This will only be called if the extension previously registered itself with :ref:`OpenXRAPIExtension.register_frame_info_extension()`. + +\ **Note:** This virtual method will be called on the render thread. Additionally, the data it returns will be used shortly after this method is called, so it needs to remain valid until the next time :ref:`_on_pre_render()` runs. .. rst-class:: classref-item-separator @@ -521,9 +591,11 @@ Esto sólo se llamará si la extensión se ha registrado previamente con :ref:`O :ref:`int` **_set_frame_wait_info_and_get_next_pointer**\ (\ next_pointer\: ``void*``\ ) |virtual| :ref:`🔗` -Añade estructuras de datos adicionales a ``XrFrameWaitInfo``. +Add additional data structures to ``XrFrameWaitInfo``. -Esto sólo se llamará si la extensión se ha registrado previamente con :ref:`OpenXRAPIExtension.register_frame_info_extension()`. +This will only be called if the extension previously registered itself with :ref:`OpenXRAPIExtension.register_frame_info_extension()`. + +\ **Note:** This virtual method will be called on the render thread. .. rst-class:: classref-item-separator @@ -535,7 +607,7 @@ Esto sólo se llamará si la extensión se ha registrado previamente con :ref:`O :ref:`int` **_set_hand_joint_locations_and_get_next_pointer**\ (\ hand_index\: :ref:`int`, next_pointer\: ``void*``\ ) |virtual| :ref:`🔗` -Añade estructuras de datos adicionales cuando se crea cada rastreador de mano. +Add additional data structures when each hand tracker is created. .. rst-class:: classref-item-separator @@ -545,9 +617,9 @@ Añade estructuras de datos adicionales cuando se crea cada rastreador de mano. .. rst-class:: classref-method -:ref:`int` **_set_instance_create_info_and_get_next_pointer**\ (\ next_pointer\: ``void*``\ ) |virtual| :ref:`🔗` +:ref:`int` **_set_instance_create_info_and_get_next_pointer**\ (\ xr_version\: :ref:`int`, next_pointer\: ``void*``\ ) |virtual| :ref:`🔗` -Añade estructuras de datos adicionales cuando se crea la instancia de OpenXR. +Add additional data structures when the OpenXR instance is created. ``xr_version`` specifies the OpenXR version we're instantiating. .. rst-class:: classref-item-separator @@ -559,7 +631,9 @@ Añade estructuras de datos adicionales cuando se crea la instancia de OpenXR. :ref:`int` **_set_projection_views_and_get_next_pointer**\ (\ view_index\: :ref:`int`, next_pointer\: ``void*``\ ) |virtual| :ref:`🔗` -Añade estructuras de datos adicionales a la vista de proyección del ``view_index`` dado. +Add additional data structures to the projection view of the given ``view_index``. + +\ **Note:** This virtual method will be called on the render thread. Additionally, the data it returns will be used shortly after this method is called, so it needs to remain valid until the next time :ref:`_on_pre_render()` runs. .. rst-class:: classref-item-separator @@ -571,7 +645,7 @@ Añade estructuras de datos adicionales a la vista de proyección del ``view_ind :ref:`int` **_set_reference_space_create_info_and_get_next_pointer**\ (\ reference_space_type\: :ref:`int`, next_pointer\: ``void*``\ ) |virtual| :ref:`🔗` -Añade estructuras de datos adicionales a ``XrReferenceSpaceCreateInfo``. +Add additional data structures to ``XrReferenceSpaceCreateInfo``. .. rst-class:: classref-item-separator @@ -583,7 +657,7 @@ Añade estructuras de datos adicionales a ``XrReferenceSpaceCreateInfo``. :ref:`int` **_set_session_create_and_get_next_pointer**\ (\ next_pointer\: ``void*``\ ) |virtual| :ref:`🔗` -Añade estructuras de datos adicionales cuando se crea la sesión de OpenXR. +Add additional data structures when the OpenXR session is created. .. rst-class:: classref-item-separator @@ -595,7 +669,7 @@ Añade estructuras de datos adicionales cuando se crea la sesión de OpenXR. :ref:`int` **_set_swapchain_create_info_and_get_next_pointer**\ (\ next_pointer\: ``void*``\ ) |virtual| :ref:`🔗` -Adds additional data structures when creating OpenXR swapchains. +Add additional data structures when creating OpenXR swapchains. .. rst-class:: classref-item-separator @@ -607,7 +681,19 @@ Adds additional data structures when creating OpenXR swapchains. :ref:`int` **_set_system_properties_and_get_next_pointer**\ (\ next_pointer\: ``void*``\ ) |virtual| :ref:`🔗` -Añade estructuras de datos adicionales al consultar las capacidades del sistema OpenXR. +Add additional data structures when querying OpenXR system abilities. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRExtensionWrapper_private_method__set_view_configuration_and_get_next_pointer: + +.. rst-class:: classref-method + +:ref:`int` **_set_view_configuration_and_get_next_pointer**\ (\ view\: :ref:`int`, next_pointer\: ``void*``\ ) |virtual| :ref:`🔗` + +Add additional data structures when querying OpenXR view configuration. .. rst-class:: classref-item-separator @@ -619,9 +705,11 @@ Añade estructuras de datos adicionales al consultar las capacidades del sistema :ref:`int` **_set_view_locate_info_and_get_next_pointer**\ (\ next_pointer\: ``void*``\ ) |virtual| :ref:`🔗` -Añade estructuras de datos adicionales a ``XrViewLocateInfo``. +Add additional data structures to ``XrViewLocateInfo``. -Esto solo se llamará si la extensión se registró previamente con :ref:`OpenXRAPIExtension.register_frame_info_extension()`. +This will only be called if the extension previously registered itself with :ref:`OpenXRAPIExtension.register_frame_info_extension()`. + +\ **Note:** This virtual method will be called on the render thread. Additionally, the data it returns will be used shortly after this method is called, so it needs to remain valid until the next time :ref:`_on_pre_render()` runs. .. rst-class:: classref-item-separator @@ -633,11 +721,13 @@ Esto solo se llamará si la extensión se registró previamente con :ref:`OpenXR :ref:`int` **_set_viewport_composition_layer_and_get_next_pointer**\ (\ layer\: ``const void*``, property_values\: :ref:`Dictionary`, next_pointer\: ``void*``\ ) |virtual| :ref:`🔗` -Añade estructuras de datos adicionales a las capas de composición creadas por :ref:`OpenXRCompositionLayer`. +Add additional data structures to composition layers created by :ref:`OpenXRCompositionLayer`. -\ ``property_values`` contiene los valores de las propiedades devueltas por :ref:`_get_viewport_composition_layer_extension_properties()`. +\ ``property_values`` contains the values of the properties returned by :ref:`_get_viewport_composition_layer_extension_properties()`. -\ ``layer`` es un puntero a una estructura ``XrCompositionLayerBaseHeader``. +\ ``layer`` is a pointer to an ``XrCompositionLayerBaseHeader`` struct. + +\ **Note:** This virtual method will be called on the render thread. Additionally, the data it returns will be used shortly after this method is called, so it needs to remain valid until the next time :ref:`_on_pre_render()` runs. .. rst-class:: classref-item-separator @@ -661,7 +751,9 @@ Devuelve la :ref:`OpenXRAPIExtension` creada, que se p |void| **register_extension_wrapper**\ (\ ) :ref:`🔗` -Registra la extensión. Esto debería ocurrir en el nivel de inicialización del módulo central. +Registers the extension. This should happen at core module initialization level. + +\ **Note:** This cannot be called once OpenXR has been initialized. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_openxrframesynthesisextension.rst b/classes/es/class_openxrframesynthesisextension.rst new file mode 100644 index 0000000000..35166e702a --- /dev/null +++ b/classes/es/class_openxrframesynthesisextension.rst @@ -0,0 +1,123 @@ +:github_url: hide + +.. _class_OpenXRFrameSynthesisExtension: + +OpenXRFrameSynthesisExtension +============================= + +**Hereda:** :ref:`OpenXRExtensionWrapper` **<** :ref:`Object` + +The OpenXR Frame synthesis extension allows for advanced reprojection at low(er) framerates. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +This class implements the `OpenXR Frame synthesis extension `__. When enabled in the project settings and supported by the XR runtime in use, frame synthesis uses advanced reprojection techniques to inject additional frames so that your XR experience hits the full frame rate of the device. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +-------------------------+------------------------------------------------------------------------------------------------+-----------+ + | :ref:`bool` | :ref:`enabled` | ``false`` | + +-------------------------+------------------------------------------------------------------------------------------------+-----------+ + | :ref:`bool` | :ref:`relax_frame_interval` | ``false`` | + +-------------------------+------------------------------------------------------------------------------------------------+-----------+ + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------+--------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_available`\ (\ ) |const| | + +-------------------------+--------------------------------------------------------------------------------------------+ + | |void| | :ref:`skip_next_frame`\ (\ ) | + +-------------------------+--------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_OpenXRFrameSynthesisExtension_property_enabled: + +.. rst-class:: classref-property + +:ref:`bool` **enabled** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_enabled**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_enabled**\ (\ ) + +Enable frame synthesis. When ``true`` motion vector and depth data is provided to the XR runtime. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRFrameSynthesisExtension_property_relax_frame_interval: + +.. rst-class:: classref-property + +:ref:`bool` **relax_frame_interval** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_relax_frame_interval**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **get_relax_frame_interval**\ (\ ) + +If ``true`` this informs the XR runtime we will be providing frames at a greatly reduced rate. Enable this when you expect your application to run at low framerates and wish to inject multiple reprojected frames. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRFrameSynthesisExtension_method_is_available: + +.. rst-class:: classref-method + +:ref:`bool` **is_available**\ (\ ) |const| :ref:`🔗` + +Returns ``true`` if frame synthesis is enabled in the project settings and the current XR runtime supports frame synthesis. The value returned will only be valid once OpenXR has been initialized. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRFrameSynthesisExtension_method_skip_next_frame: + +.. rst-class:: classref-method + +|void| **skip_next_frame**\ (\ ) :ref:`🔗` + +Queues the next frame to be skipped when supplying motion vector and depth data. Call this after teleporting your player or a similar action has moved the player to prevent incorrect reprojection results due to this movement. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrinteractionprofilemetadata.rst b/classes/es/class_openxrinteractionprofilemetadata.rst index 565c5f43d3..9f5915a7bf 100644 --- a/classes/es/class_openxrinteractionprofilemetadata.rst +++ b/classes/es/class_openxrinteractionprofilemetadata.rst @@ -24,15 +24,17 @@ Métodos .. table:: :widths: auto - +--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`register_interaction_profile`\ (\ display_name\: :ref:`String`, openxr_path\: :ref:`String`, openxr_extension_name\: :ref:`String`\ ) | - +--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`register_io_path`\ (\ interaction_profile\: :ref:`String`, display_name\: :ref:`String`, toplevel_path\: :ref:`String`, openxr_path\: :ref:`String`, openxr_extension_name\: :ref:`String`, action_type\: :ref:`ActionType`\ ) | - +--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`register_profile_rename`\ (\ old_name\: :ref:`String`, new_name\: :ref:`String`\ ) | - +--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`register_top_level_path`\ (\ display_name\: :ref:`String`, openxr_path\: :ref:`String`, openxr_extension_name\: :ref:`String`\ ) | - +--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`register_interaction_profile`\ (\ display_name\: :ref:`String`, openxr_path\: :ref:`String`, openxr_extension_names\: :ref:`String`\ ) | + +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`register_io_path`\ (\ interaction_profile\: :ref:`String`, display_name\: :ref:`String`, toplevel_path\: :ref:`String`, openxr_path\: :ref:`String`, openxr_extension_names\: :ref:`String`, action_type\: :ref:`ActionType`\ ) | + +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`register_path_rename`\ (\ old_name\: :ref:`String`, new_name\: :ref:`String`\ ) | + +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`register_profile_rename`\ (\ old_name\: :ref:`String`, new_name\: :ref:`String`\ ) | + +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`register_top_level_path`\ (\ display_name\: :ref:`String`, openxr_path\: :ref:`String`, openxr_extension_names\: :ref:`String`\ ) | + +--------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -47,11 +49,11 @@ Descripciones de Métodos .. rst-class:: classref-method -|void| **register_interaction_profile**\ (\ display_name\: :ref:`String`, openxr_path\: :ref:`String`, openxr_extension_name\: :ref:`String`\ ) :ref:`🔗` +|void| **register_interaction_profile**\ (\ display_name\: :ref:`String`, openxr_path\: :ref:`String`, openxr_extension_names\: :ref:`String`\ ) :ref:`🔗` -Registra un perfil de interacción usando su designación OpenXR (p. ej. ``/interaction_profiles/khr/simple_controller`` es el perfil del perfil de controlador simple de OpenXR). +Registers an interaction profile using its OpenXR designation (e.g. ``/interaction_profiles/khr/simple_controller`` is the profile for OpenXR's simple controller profile). -\ ``display_name`` es la descripción que se muestra al usuario. ``openxr_path`` es la ruta del perfil de interacción que se está registrando. ``openxr_extension_name`` restringe opcionalmente este perfil a la extensión dada que está habilitada/disponible. Si la extensión no está disponible, el perfil y todas las entradas relacionadas utilizadas en un mapa de acciones se filtran. +\ ``display_name`` is the description shown to the user. ``openxr_path`` is the interaction profile path being registered. ``openxr_extension_names`` optionally restricts this profile to the given extension being enabled/available. If the extension is not available, the profile and all related entries used in an action map are filtered out. .. rst-class:: classref-item-separator @@ -61,9 +63,21 @@ Registra un perfil de interacción usando su designación OpenXR (p. ej. ``/inte .. rst-class:: classref-method -|void| **register_io_path**\ (\ interaction_profile\: :ref:`String`, display_name\: :ref:`String`, toplevel_path\: :ref:`String`, openxr_path\: :ref:`String`, openxr_extension_name\: :ref:`String`, action_type\: :ref:`ActionType`\ ) :ref:`🔗` +|void| **register_io_path**\ (\ interaction_profile\: :ref:`String`, display_name\: :ref:`String`, toplevel_path\: :ref:`String`, openxr_path\: :ref:`String`, openxr_extension_names\: :ref:`String`, action_type\: :ref:`ActionType`\ ) :ref:`🔗` -Registra una ruta de entrada/salida para el ``interaction_profile`` dado. El perfil debe haberse registrado previamente usando :ref:`register_interaction_profile()`. ``display_name`` es la descripción que se muestra al usuario. ``toplevel_path`` especifica la ruta de enlace a la que se puede enlazar esta entrada/salida (p. ej. ``/user/hand/left`` o ``/user/hand/right``). ``openxr_path`` es la entrada/salida de acción que se está registrando (p. ej. ``/user/hand/left/input/aim/pose``). ``openxr_extension_name`` restringe esta entrada/salida a una extensión habilitada/disponible, esto no necesita repetir la extensión en el perfil pero se relaciona con la extensión superpuesta (p. ej. ``XR_EXT_palm_pose`` que introduce rutas de entrada ``…/input/palm_ext/pose``). ``action_type`` define el tipo de entrada o salida proporcionada por OpenXR. +Registers an input/output path for the given ``interaction_profile``. The profile should previously have been registered using :ref:`register_interaction_profile()`. ``display_name`` is the description shown to the user. ``toplevel_path`` specifies the bind path this input/output can be bound to (e.g. ``/user/hand/left`` or ``/user/hand/right``). ``openxr_path`` is the action input/output being registered (e.g. ``/user/hand/left/input/aim/pose``). ``openxr_extension_names`` restricts this input/output to an enabled/available extension, this doesn't need to repeat the extension on the profile but relates to overlapping extension (e.g. ``XR_EXT_palm_pose`` that introduces ``…/input/palm_ext/pose`` input paths). ``action_type`` defines the type of input or output provided by OpenXR. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRInteractionProfileMetadata_method_register_path_rename: + +.. rst-class:: classref-method + +|void| **register_path_rename**\ (\ old_name\: :ref:`String`, new_name\: :ref:`String`\ ) :ref:`🔗` + +Allows for renaming old input/output paths to new paths in order to load and process older action maps. .. rst-class:: classref-item-separator @@ -75,7 +89,7 @@ Registra una ruta de entrada/salida para el ``interaction_profile`` dado. El per |void| **register_profile_rename**\ (\ old_name\: :ref:`String`, new_name\: :ref:`String`\ ) :ref:`🔗` -Permite renombrar rutas de perfiles de interacción antiguos a rutas nuevas para mantener la compatibilidad con versiones anteriores de los mapas de acciones. +Allows for renaming old interaction profile paths to new paths in order to load and process older action maps. .. rst-class:: classref-item-separator @@ -85,13 +99,13 @@ Permite renombrar rutas de perfiles de interacción antiguos a rutas nuevas para .. rst-class:: classref-method -|void| **register_top_level_path**\ (\ display_name\: :ref:`String`, openxr_path\: :ref:`String`, openxr_extension_name\: :ref:`String`\ ) :ref:`🔗` +|void| **register_top_level_path**\ (\ display_name\: :ref:`String`, openxr_path\: :ref:`String`, openxr_extension_names\: :ref:`String`\ ) :ref:`🔗` -Registra una ruta de nivel superior a la que se pueden enlazar perfiles. Por ejemplo, ``/user/hand/left`` se refiere al punto de enlace para la mano izquierda del jugador. Las extensiones pueden registrar rutas adicionales de nivel superior, por ejemplo, una extensión de chaleco háptico podría registrar ``/user/body/vest``. +Registers a top level path to which profiles can be bound. For instance ``/user/hand/left`` refers to the bind point for the player's left hand. Extensions can register additional top level paths, for instance a haptic vest extension might register ``/user/body/vest``. -\ ``display_name`` es el nombre que se muestra al usuario. ``openxr_path`` es la ruta de nivel superior que se está registrando. ``openxr_extension_name`` es opcional y garantiza que la ruta de nivel superior solo se utilice si la extensión especificada está disponible/habilitada. +\ ``display_name`` is the name shown to the user. ``openxr_path`` is the top level path being registered. ``openxr_extension_names`` is optional and ensures the top level path is only used if the specified extension is available/enabled. -Cuando una ruta de nivel superior termina siendo enlazada por OpenXR, se instancia un :ref:`XRPositionalTracker` para gestionar el estado del dispositivo. +When a top level path ends up being bound by OpenXR, an :ref:`XRPositionalTracker` is instantiated to manage the state of the device. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_openxrinterface.rst b/classes/es/class_openxrinterface.rst index 7a7b1cc2d8..ab26bf2e4b 100644 --- a/classes/es/class_openxrinterface.rst +++ b/classes/es/class_openxrinterface.rst @@ -325,7 +325,7 @@ La sesión está a punto de perderse. :ref:`session_loss_pending` **SESSION_STATE_EXITING** = ``8`` -La instancia de OpenXR está a punto de ser destruida y estamos saliendo. :ref:`instance_exiting` se emite cuando cambiamos a este estado. +The OpenXR instance is about to be destroyed and we're exiting. :ref:`instance_exiting` is emitted when we change to this state. .. rst-class:: classref-item-separator @@ -876,9 +876,9 @@ La frecuencia de actualización de la pantalla para el HMD actual. Solo funciona - |void| **set_foveation_dynamic**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **get_foveation_dynamic**\ (\ ) -Activa el ajuste dinámico de foveación, la interfaz debe inicializarse antes de que esto sea accesible. Si está habilitada, la foveación se ajustará automáticamente entre baja y :ref:`foveation_level`. +If ``true``, enables dynamic foveation adjustment. The interface must be initialized before this is accessible. If enabled, foveation will automatically be adjusted between low and :ref:`foveation_level`. -\ **Nota:** Solo funciona en el renderizador de compatibilidad. +\ **Note:** Only works on the Compatibility renderer. .. rst-class:: classref-item-separator @@ -895,9 +895,9 @@ Activa el ajuste dinámico de foveación, la interfaz debe inicializarse antes d - |void| **set_foveation_level**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_foveation_level**\ (\ ) -Establece el nivel de foveación de 0 (desactivado) a 3 (alto), la interfaz debe inicializarse antes de que esto sea accesible. +The foveation level, from ``0`` (off) to ``3`` (high). The interface must be initialized before this is accessible. -\ **Nota:** Solo funciona en el renderizador de compatibilidad. +\ **Note:** Only works on the Compatibility renderer. .. rst-class:: classref-item-separator @@ -981,7 +981,7 @@ Devuelve una lista de conjuntos de acciones registrados con Godot (cargados desd :ref:`Array` **get_available_display_refresh_rates**\ (\ ) |const| :ref:`🔗` -Devuelve las frecuencias de actualización de pantalla compatibles con el HMD actual. Solo se devuelve si esta función es compatible con el tiempo de ejecución de OpenXR y después de que se haya inicializado la interfaz. +Returns a list of display refresh rates supported by the current HMD. Only returned if this feature is supported by the OpenXR runtime and after the interface has been initialized. .. rst-class:: classref-item-separator @@ -1141,9 +1141,9 @@ Devuelve las capacidades de la extensión de interacción de la mirada ocular. :ref:`bool` **is_foveation_supported**\ (\ ) |const| :ref:`🔗` -Devuelve ``true`` si la extensión de foveación de OpenXR es compatible, la interfaz debe inicializarse antes de que esto devuelva un valor válido. +Returns ``true`` if OpenXR's foveation extension is supported. The interface must be initialized before this returns a valid value. -\ **Nota:** Esta característica solo está disponible en el renderizador de compatibilidad y actualmente solo está disponible en algunos visores independientes. Para Vulkan, establece :ref:`Viewport.vrs_mode` a ``VRS_XR`` en el escritorio. +\ **Note:** When using the Vulkan rendering driver, :ref:`Viewport.vrs_mode` must be set to :ref:`Viewport.VRS_XR` to support foveation. .. rst-class:: classref-item-separator diff --git a/classes/es/class_openxrmarkertracker.rst b/classes/es/class_openxrmarkertracker.rst new file mode 100644 index 0000000000..7d564bbb58 --- /dev/null +++ b/classes/es/class_openxrmarkertracker.rst @@ -0,0 +1,146 @@ +:github_url: hide + +.. _class_OpenXRMarkerTracker: + +OpenXRMarkerTracker +=================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialEntityTracker` **<** :ref:`XRPositionalTracker` **<** :ref:`XRTracker` **<** :ref:`RefCounted` **<** :ref:`Object` + +Spatial entity tracker for our spatial entity marker tracking extension. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Spatial entity tracker for our OpenXR spatial entity marker tracking extension. These trackers identify entities in our real space detected by a visual marker such as a QRCode or Aruco code, and map their location to our virtual space. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +---------------------------------------------------------------------+--------------------------------------------------------------------+-------------------+ + | :ref:`Vector2` | :ref:`bounds_size` | ``Vector2(0, 0)`` | + +---------------------------------------------------------------------+--------------------------------------------------------------------+-------------------+ + | :ref:`int` | :ref:`marker_id` | ``0`` | + +---------------------------------------------------------------------+--------------------------------------------------------------------+-------------------+ + | :ref:`MarkerType` | :ref:`marker_type` | ``0`` | + +---------------------------------------------------------------------+--------------------------------------------------------------------+-------------------+ + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Variant` | :ref:`get_marker_data`\ (\ ) |const| | + +-------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_marker_data`\ (\ marker_data\: :ref:`Variant`\ ) | + +-------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_OpenXRMarkerTracker_property_bounds_size: + +.. rst-class:: classref-property + +:ref:`Vector2` **bounds_size** = ``Vector2(0, 0)`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_bounds_size**\ (\ value\: :ref:`Vector2`\ ) +- :ref:`Vector2` **get_bounds_size**\ (\ ) + +The bounds size for this marker. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRMarkerTracker_property_marker_id: + +.. rst-class:: classref-property + +:ref:`int` **marker_id** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_marker_id**\ (\ value\: :ref:`int`\ ) +- :ref:`int` **get_marker_id**\ (\ ) + +The marker ID for this marker, this is only returned for Aruco and April Tag markers. Call :ref:`get_marker_data()` for QRCode markers. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRMarkerTracker_property_marker_type: + +.. rst-class:: classref-property + +:ref:`MarkerType` **marker_type** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_marker_type**\ (\ value\: :ref:`MarkerType`\ ) +- :ref:`MarkerType` **get_marker_type**\ (\ ) + +The type of marker. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRMarkerTracker_method_get_marker_data: + +.. rst-class:: classref-method + +:ref:`Variant` **get_marker_data**\ (\ ) |const| :ref:`🔗` + +Returns the marker data for this marker. This can return a :ref:`String` or :ref:`PackedByteArray`. Only applicable to QR Code based markers. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRMarkerTracker_method_set_marker_data: + +.. rst-class:: classref-method + +|void| **set_marker_data**\ (\ marker_data\: :ref:`Variant`\ ) :ref:`🔗` + +Sets the marker data for this marker. + +\ **Note:** This should only be set by marker discovery logic. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrplanetracker.rst b/classes/es/class_openxrplanetracker.rst new file mode 100644 index 0000000000..ed6058a4d5 --- /dev/null +++ b/classes/es/class_openxrplanetracker.rst @@ -0,0 +1,203 @@ +:github_url: hide + +.. _class_OpenXRPlaneTracker: + +OpenXRPlaneTracker +================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialEntityTracker` **<** :ref:`XRPositionalTracker` **<** :ref:`XRTracker` **<** :ref:`RefCounted` **<** :ref:`Object` + +Spatial entity tracker for our spatial entity plane tracking extension. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Spatial entity tracker for our OpenXR spatial entity plane tracking extension. These trackers identify entities in our real space such as walls, floors, tables, etc. and map their location to our virtual space. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +-------------------------------------------------------------------------------------+---------------------------------------------------------------------------+-------------------+ + | :ref:`Vector2` | :ref:`bounds_size` | ``Vector2(0, 0)`` | + +-------------------------------------------------------------------------------------+---------------------------------------------------------------------------+-------------------+ + | :ref:`PlaneAlignment` | :ref:`plane_alignment` | ``0`` | + +-------------------------------------------------------------------------------------+---------------------------------------------------------------------------+-------------------+ + | :ref:`String` | :ref:`plane_label` | ``""`` | + +-------------------------------------------------------------------------------------+---------------------------------------------------------------------------+-------------------+ + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear_mesh_data`\ (\ ) | + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Mesh` | :ref:`get_mesh`\ (\ ) | + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Transform3D` | :ref:`get_mesh_offset`\ (\ ) |const| | + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Shape3D` | :ref:`get_shape`\ (\ thickness\: :ref:`float` = 0.01\ ) | + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_mesh_data`\ (\ origin\: :ref:`Transform3D`, vertices\: :ref:`PackedVector2Array`, indices\: :ref:`PackedInt32Array` = PackedInt32Array()\ ) | + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Señales +-------------- + +.. _class_OpenXRPlaneTracker_signal_mesh_changed: + +.. rst-class:: classref-signal + +**mesh_changed**\ (\ ) :ref:`🔗` + +Emitted when our mesh data has changed the mesh instance and collision needs to be updated. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_OpenXRPlaneTracker_property_bounds_size: + +.. rst-class:: classref-property + +:ref:`Vector2` **bounds_size** = ``Vector2(0, 0)`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_bounds_size**\ (\ value\: :ref:`Vector2`\ ) +- :ref:`Vector2` **get_bounds_size**\ (\ ) + +The bounding size of the plane. This is a 2D size. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRPlaneTracker_property_plane_alignment: + +.. rst-class:: classref-property + +:ref:`PlaneAlignment` **plane_alignment** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_plane_alignment**\ (\ value\: :ref:`PlaneAlignment`\ ) +- :ref:`PlaneAlignment` **get_plane_alignment**\ (\ ) + +The main alignment in space of this plane. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRPlaneTracker_property_plane_label: + +.. rst-class:: classref-property + +:ref:`String` **plane_label** = ``""`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_plane_label**\ (\ value\: :ref:`String`\ ) +- :ref:`String` **get_plane_label**\ (\ ) + +The semantic label for this plane. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRPlaneTracker_method_clear_mesh_data: + +.. rst-class:: classref-method + +|void| **clear_mesh_data**\ (\ ) :ref:`🔗` + +Clears the mesh data for this tracker. You should only call this if you are handling your own discovery logic. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRPlaneTracker_method_get_mesh: + +.. rst-class:: classref-method + +:ref:`Mesh` **get_mesh**\ (\ ) :ref:`🔗` + +Gets a mesh created from either the mesh data or from our bounding size for this plane. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRPlaneTracker_method_get_mesh_offset: + +.. rst-class:: classref-method + +:ref:`Transform3D` **get_mesh_offset**\ (\ ) |const| :ref:`🔗` + +Gets the transform by which to offset the mesh and collision shape from our pose to display these correctly. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRPlaneTracker_method_get_shape: + +.. rst-class:: classref-method + +:ref:`Shape3D` **get_shape**\ (\ thickness\: :ref:`float` = 0.01\ ) :ref:`🔗` + +Gets a collision shape built either from the mesh data or from our bounding size for this plane. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRPlaneTracker_method_set_mesh_data: + +.. rst-class:: classref-method + +|void| **set_mesh_data**\ (\ origin\: :ref:`Transform3D`, vertices\: :ref:`PackedVector2Array`, indices\: :ref:`PackedInt32Array` = PackedInt32Array()\ ) :ref:`🔗` + +Sets the mesh data for this plane. You should only call this if you are handling your own discovery logic. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialanchorcapability.rst b/classes/es/class_openxrspatialanchorcapability.rst new file mode 100644 index 0000000000..527353ec40 --- /dev/null +++ b/classes/es/class_openxrspatialanchorcapability.rst @@ -0,0 +1,225 @@ +:github_url: hide + +.. _class_OpenXRSpatialAnchorCapability: + +OpenXRSpatialAnchorCapability +============================= + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRExtensionWrapper` **<** :ref:`Object` + +Implementation for handling spatial entity anchor logic. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +This is an internal class that handles the OpenXR anchor spatial entity extension. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`OpenXRAnchorTracker` | :ref:`create_new_anchor`\ (\ transform\: :ref:`Transform3D`, spatial_context\: :ref:`RID` = RID()\ ) | + +-------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`OpenXRFutureResult` | :ref:`create_persistence_context`\ (\ scope\: :ref:`PersistenceScope`, user_callback\: :ref:`Callable` = Callable()\ ) | + +-------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`free_persistence_context`\ (\ persistence_context\: :ref:`RID`\ ) | + +-------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_persistence_context_handle`\ (\ persistence_context\: :ref:`RID`\ ) |const| | + +-------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_persistence_scope_supported`\ (\ scope\: :ref:`PersistenceScope`\ ) | + +-------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_spatial_anchor_supported`\ (\ ) | + +-------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_spatial_persistence_supported`\ (\ ) | + +-------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`OpenXRFutureResult` | :ref:`persist_anchor`\ (\ anchor_tracker\: :ref:`OpenXRAnchorTracker`, persistence_context\: :ref:`RID` = RID(), user_callback\: :ref:`Callable` = Callable()\ ) | + +-------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_anchor`\ (\ anchor_tracker\: :ref:`OpenXRAnchorTracker`\ ) | + +-------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`OpenXRFutureResult` | :ref:`unpersist_anchor`\ (\ anchor_tracker\: :ref:`OpenXRAnchorTracker`, persistence_context\: :ref:`RID` = RID(), user_callback\: :ref:`Callable` = Callable()\ ) | + +-------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Enumeraciones +-------------------------- + +.. _enum_OpenXRSpatialAnchorCapability_PersistenceScope: + +.. rst-class:: classref-enumeration + +enum **PersistenceScope**: :ref:`🔗` + +.. _class_OpenXRSpatialAnchorCapability_constant_PERSISTENCE_SCOPE_SYSTEM_MANAGED: + +.. rst-class:: classref-enumeration-constant + +:ref:`PersistenceScope` **PERSISTENCE_SCOPE_SYSTEM_MANAGED** = ``1`` + +Provides the application with read-only access (i.e. application cannot modify this scope) to spatial entities persisted and managed by the system. The application can use the UUID in the persistence component for this scope to correlate entities across spatial contexts and device reboots. + +.. _class_OpenXRSpatialAnchorCapability_constant_PERSISTENCE_SCOPE_LOCAL_ANCHORS: + +.. rst-class:: classref-enumeration-constant + +:ref:`PersistenceScope` **PERSISTENCE_SCOPE_LOCAL_ANCHORS** = ``1000781000`` + +Persistence operations and data access is limited to spatial anchors, on the same device, for the same user and same app (using :ref:`persist_anchor()` and :ref:`unpersist_anchor()` functions) + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialAnchorCapability_method_create_new_anchor: + +.. rst-class:: classref-method + +:ref:`OpenXRAnchorTracker` **create_new_anchor**\ (\ transform\: :ref:`Transform3D`, spatial_context\: :ref:`RID` = RID()\ ) :ref:`🔗` + +Creates a new anchor that will be tracked by the XR runtime. The ``transform`` should be a transform in the local space of your :ref:`XROrigin3D` node. If ``spatial_context`` is not specified the default will be used, this requires :ref:`ProjectSettings.xr/openxr/extensions/spatial_entity/enable_builtin_anchor_detection` to be set. The returned tracker will track the location in case our reference space changes. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialAnchorCapability_method_create_persistence_context: + +.. rst-class:: classref-method + +:ref:`OpenXRFutureResult` **create_persistence_context**\ (\ scope\: :ref:`PersistenceScope`, user_callback\: :ref:`Callable` = Callable()\ ) :ref:`🔗` + +Creates a new persistence context for storing persistent data. + +\ **Note:** This is an asynchronous method and returns an :ref:`OpenXRFutureResult` object with which to track the status, discarding this object will not cancel the creation process. On success ``user_callback`` will be called if specified. The result value for this function is the :ref:`RID` for our persistence context. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialAnchorCapability_method_free_persistence_context: + +.. rst-class:: classref-method + +|void| **free_persistence_context**\ (\ persistence_context\: :ref:`RID`\ ) :ref:`🔗` + +Frees a persistence context previously created with :ref:`create_persistence_context()`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialAnchorCapability_method_get_persistence_context_handle: + +.. rst-class:: classref-method + +:ref:`int` **get_persistence_context_handle**\ (\ persistence_context\: :ref:`RID`\ ) |const| :ref:`🔗` + +Returns the internal handle for this persistence context. + +\ **Note:** For GDExtension implementations. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialAnchorCapability_method_is_persistence_scope_supported: + +.. rst-class:: classref-method + +:ref:`bool` **is_persistence_scope_supported**\ (\ scope\: :ref:`PersistenceScope`\ ) :ref:`🔗` + +Returns ``true`` if this persistence scope is supported by our spatial anchor capability. + +\ **Note:** Only valid after an OpenXR instance has been created. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialAnchorCapability_method_is_spatial_anchor_supported: + +.. rst-class:: classref-method + +:ref:`bool` **is_spatial_anchor_supported**\ (\ ) :ref:`🔗` + +Returns ``true`` if spatial anchors are supported by the hardware. Only returns a valid value after OpenXR has been initialized. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialAnchorCapability_method_is_spatial_persistence_supported: + +.. rst-class:: classref-method + +:ref:`bool` **is_spatial_persistence_supported**\ (\ ) :ref:`🔗` + +Returns ``true`` if persistent spatial anchors are supported by the hardware. Only returns a valid value after OpenXR has been initialized. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialAnchorCapability_method_persist_anchor: + +.. rst-class:: classref-method + +:ref:`OpenXRFutureResult` **persist_anchor**\ (\ anchor_tracker\: :ref:`OpenXRAnchorTracker`, persistence_context\: :ref:`RID` = RID(), user_callback\: :ref:`Callable` = Callable()\ ) :ref:`🔗` + +Changes this anchor into a persistent anchor. This means its location will be stored on the device and the anchor will be restored the next time your application starts. If ``persistence_context`` is not specified the default will be used, this requires :ref:`ProjectSettings.xr/openxr/extensions/spatial_entity/enable_builtin_anchor_detection` to be set. + +\ **Note:** This is an asynchronous method and returns an :ref:`OpenXRFutureResult` object with which to track the status, discarding this object will not cancel the creation process. On success ``user_callback`` will be called if specified. The result value for this function is a boolean which will be set to ``true`` on successful completion. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialAnchorCapability_method_remove_anchor: + +.. rst-class:: classref-method + +|void| **remove_anchor**\ (\ anchor_tracker\: :ref:`OpenXRAnchorTracker`\ ) :ref:`🔗` + +Remove an anchor previously created with :ref:`create_new_anchor()`. If this anchor was persistent you must first call :ref:`unpersist_anchor()` and await its callback. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialAnchorCapability_method_unpersist_anchor: + +.. rst-class:: classref-method + +:ref:`OpenXRFutureResult` **unpersist_anchor**\ (\ anchor_tracker\: :ref:`OpenXRAnchorTracker`, persistence_context\: :ref:`RID` = RID(), user_callback\: :ref:`Callable` = Callable()\ ) :ref:`🔗` + +Removes the persistent data from this anchor. The runtime will not recreate the anchor when your application restarts. If ``persistence_context`` is not specified the default will be used, this requires :ref:`ProjectSettings.xr/openxr/extensions/spatial_entity/enabled` to be set. + +\ **Note:** This is an asynchronous method and returns an :ref:`OpenXRFutureResult` object with which to track the status, discarding this object will not cancel the creation process. On success ``user_callback`` will be called if specified. The result value for this function is a boolean which will be set to ``true`` on successful completion. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcapabilityconfigurationanchor.rst b/classes/es/class_openxrspatialcapabilityconfigurationanchor.rst new file mode 100644 index 0000000000..ac6a7b3e78 --- /dev/null +++ b/classes/es/class_openxrspatialcapabilityconfigurationanchor.rst @@ -0,0 +1,60 @@ +:github_url: hide + +.. _class_OpenXRSpatialCapabilityConfigurationAnchor: + +OpenXRSpatialCapabilityConfigurationAnchor +========================================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialCapabilityConfigurationBaseHeader` **<** :ref:`RefCounted` **<** :ref:`Object` + +Configuration header for spatial anchors. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Configuration header for spatial anchors. Pass this to :ref:`OpenXRSpatialEntityExtension.create_spatial_context()` to create a spatial context with spatial anchor capabilities. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedInt64Array` | :ref:`get_enabled_components`\ (\ ) |const| | + +-------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialCapabilityConfigurationAnchor_method_get_enabled_components: + +.. rst-class:: classref-method + +:ref:`PackedInt64Array` **get_enabled_components**\ (\ ) |const| :ref:`🔗` + +Returns the components enabled by this configuration. + +\ **Note:** Only valid after this configuration was used to create a spatial context. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcapabilityconfigurationapriltag.rst b/classes/es/class_openxrspatialcapabilityconfigurationapriltag.rst new file mode 100644 index 0000000000..29a2b60df2 --- /dev/null +++ b/classes/es/class_openxrspatialcapabilityconfigurationapriltag.rst @@ -0,0 +1,143 @@ +:github_url: hide + +.. _class_OpenXRSpatialCapabilityConfigurationAprilTag: + +OpenXRSpatialCapabilityConfigurationAprilTag +============================================ + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialCapabilityConfigurationBaseHeader` **<** :ref:`RefCounted` **<** :ref:`Object` + +Configuration header for April tag markers. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Configuration header for April tag markers. Pass this to :ref:`OpenXRSpatialEntityExtension.create_spatial_context()` to create a spatial context that can detect April tags. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------+-------+ + | :ref:`AprilTagDict` | :ref:`april_dict` | ``4`` | + +-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------+-------+ + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedInt64Array` | :ref:`get_enabled_components`\ (\ ) |const| | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Enumeraciones +-------------------------- + +.. _enum_OpenXRSpatialCapabilityConfigurationAprilTag_AprilTagDict: + +.. rst-class:: classref-enumeration + +enum **AprilTagDict**: :ref:`🔗` + +.. _class_OpenXRSpatialCapabilityConfigurationAprilTag_constant_APRIL_TAG_DICT_16H5: + +.. rst-class:: classref-enumeration-constant + +:ref:`AprilTagDict` **APRIL_TAG_DICT_16H5** = ``1`` + +4 by 4 bits, minimum Hamming distance between any two codes = 5, 30 codes. + +.. _class_OpenXRSpatialCapabilityConfigurationAprilTag_constant_APRIL_TAG_DICT_25H9: + +.. rst-class:: classref-enumeration-constant + +:ref:`AprilTagDict` **APRIL_TAG_DICT_25H9** = ``2`` + +5 by 5 bits, minimum Hamming distance between any two codes = 9, 35 codes. + +.. _class_OpenXRSpatialCapabilityConfigurationAprilTag_constant_APRIL_TAG_DICT_36H10: + +.. rst-class:: classref-enumeration-constant + +:ref:`AprilTagDict` **APRIL_TAG_DICT_36H10** = ``3`` + +6 by 6 bits, minimum Hamming distance between any two codes = 10, 2320 codes. + +.. _class_OpenXRSpatialCapabilityConfigurationAprilTag_constant_APRIL_TAG_DICT_36H11: + +.. rst-class:: classref-enumeration-constant + +:ref:`AprilTagDict` **APRIL_TAG_DICT_36H11** = ``4`` + +6 by 6 bits, minimum Hamming distance between any two codes = 11, 587 codes. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_OpenXRSpatialCapabilityConfigurationAprilTag_property_april_dict: + +.. rst-class:: classref-property + +:ref:`AprilTagDict` **april_dict** = ``4`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_april_dict**\ (\ value\: :ref:`AprilTagDict`\ ) +- :ref:`AprilTagDict` **get_april_dict**\ (\ ) + +Dictionary to use to decode April tags. + +\ **Note:** Must be set before using this configuration to create a spatial context. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialCapabilityConfigurationAprilTag_method_get_enabled_components: + +.. rst-class:: classref-method + +:ref:`PackedInt64Array` **get_enabled_components**\ (\ ) |const| :ref:`🔗` + +Returns the components enabled by this configuration. + +\ **Note:** Only valid after this configuration was used to create a spatial context. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcapabilityconfigurationaruco.rst b/classes/es/class_openxrspatialcapabilityconfigurationaruco.rst new file mode 100644 index 0000000000..94f163c6ad --- /dev/null +++ b/classes/es/class_openxrspatialcapabilityconfigurationaruco.rst @@ -0,0 +1,239 @@ +:github_url: hide + +.. _class_OpenXRSpatialCapabilityConfigurationAruco: + +OpenXRSpatialCapabilityConfigurationAruco +========================================= + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialCapabilityConfigurationBaseHeader` **<** :ref:`RefCounted` **<** :ref:`Object` + +Configuration header for Aruco markers. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Configuration header for Aruco markers. Pass this to :ref:`OpenXRSpatialEntityExtension.create_spatial_context()` to create a spatial context that can detect Aruco markers. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +----------------------------------------------------------------------------+----------------------------------------------------------------------------------------+--------+ + | :ref:`ArucoDict` | :ref:`aruco_dict` | ``16`` | + +----------------------------------------------------------------------------+----------------------------------------------------------------------------------------+--------+ + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedInt64Array` | :ref:`get_enabled_components`\ (\ ) |const| | + +-------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Enumeraciones +-------------------------- + +.. _enum_OpenXRSpatialCapabilityConfigurationAruco_ArucoDict: + +.. rst-class:: classref-enumeration + +enum **ArucoDict**: :ref:`🔗` + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_4X4_50: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_4X4_50** = ``1`` + +4 by 4 pixel Aruco marker dictionary with 50 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_4X4_100: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_4X4_100** = ``2`` + +4 by 4 pixel Aruco marker dictionary with 100 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_4X4_250: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_4X4_250** = ``3`` + +4 by 4 pixel Aruco marker dictionary with 250 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_4X4_1000: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_4X4_1000** = ``4`` + +4 by 4 pixel Aruco marker dictionary with 1000 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_5X5_50: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_5X5_50** = ``5`` + +5 by 5 pixel Aruco marker dictionary with 50 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_5X5_100: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_5X5_100** = ``6`` + +5 by 5 pixel Aruco marker dictionary with 100 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_5X5_250: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_5X5_250** = ``7`` + +5 by 5 pixel Aruco marker dictionary with 250 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_5X5_1000: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_5X5_1000** = ``8`` + +5 by 5 pixel Aruco marker dictionary with 1000 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_6X6_50: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_6X6_50** = ``9`` + +6 by 6 pixel Aruco marker dictionary with 50 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_6X6_100: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_6X6_100** = ``10`` + +6 by 6 pixel Aruco marker dictionary with 100 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_6X6_250: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_6X6_250** = ``11`` + +6 by 6 pixel Aruco marker dictionary with 250 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_6X6_1000: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_6X6_1000** = ``12`` + +6 by 6 pixel Aruco marker dictionary with 1000 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_7X7_50: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_7X7_50** = ``13`` + +7 by 7 pixel Aruco marker dictionary with 50 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_7X7_100: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_7X7_100** = ``14`` + +7 by 7 pixel Aruco marker dictionary with 100 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_7X7_250: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_7X7_250** = ``15`` + +7 by 7 pixel Aruco marker dictionary with 250 IDs. + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_constant_ARUCO_DICT_7X7_1000: + +.. rst-class:: classref-enumeration-constant + +:ref:`ArucoDict` **ARUCO_DICT_7X7_1000** = ``16`` + +7 by 7 pixel Aruco marker dictionary with 1000 IDs. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_property_aruco_dict: + +.. rst-class:: classref-property + +:ref:`ArucoDict` **aruco_dict** = ``16`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_aruco_dict**\ (\ value\: :ref:`ArucoDict`\ ) +- :ref:`ArucoDict` **get_aruco_dict**\ (\ ) + +Dictionary to use to decode Aruco markers. + +\ **Note:** Must be set before using this configuration to create a spatial context. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialCapabilityConfigurationAruco_method_get_enabled_components: + +.. rst-class:: classref-method + +:ref:`PackedInt64Array` **get_enabled_components**\ (\ ) |const| :ref:`🔗` + +Returns the components enabled by this configuration. + +\ **Note:** Only valid after this configuration was used to create a spatial context. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcapabilityconfigurationbaseheader.rst b/classes/es/class_openxrspatialcapabilityconfigurationbaseheader.rst new file mode 100644 index 0000000000..d21b64b2fe --- /dev/null +++ b/classes/es/class_openxrspatialcapabilityconfigurationbaseheader.rst @@ -0,0 +1,88 @@ +:github_url: hide + +.. _class_OpenXRSpatialCapabilityConfigurationBaseHeader: + +OpenXRSpatialCapabilityConfigurationBaseHeader +============================================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`RefCounted` **<** :ref:`Object` + +**Heredado por:** :ref:`OpenXRSpatialCapabilityConfigurationAnchor`, :ref:`OpenXRSpatialCapabilityConfigurationAprilTag`, :ref:`OpenXRSpatialCapabilityConfigurationAruco`, :ref:`OpenXRSpatialCapabilityConfigurationMicroQrCode`, :ref:`OpenXRSpatialCapabilityConfigurationPlaneTracking`, :ref:`OpenXRSpatialCapabilityConfigurationQrCode` + +Wrapper base class for OpenXR Spatial Capability Configuration headers. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Wrapper base class for OpenXR Spatial Capability Configuration headers. This class needs to be implemented for each capability configuration structure usable within OpenXR's spatial entities system. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`_get_configuration`\ (\ ) |virtual| | + +-------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`_has_valid_configuration`\ (\ ) |virtual| |const| | + +-------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_valid_configuration`\ (\ ) |const| | + +-------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialCapabilityConfigurationBaseHeader_private_method__get_configuration: + +.. rst-class:: classref-method + +:ref:`int` **_get_configuration**\ (\ ) |virtual| :ref:`🔗` + +Return a pointer (encoded as an ``int64_t``) to a struct holding the spatial capability configuration data. The memory for this struct should remain accessible as long as this object remains instantiated. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialCapabilityConfigurationBaseHeader_private_method__has_valid_configuration: + +.. rst-class:: classref-method + +:ref:`bool` **_has_valid_configuration**\ (\ ) |virtual| |const| :ref:`🔗` + +Return ``true`` if this object contains a valid configuration that can be retrieved when calling :ref:`_get_configuration()`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialCapabilityConfigurationBaseHeader_method_has_valid_configuration: + +.. rst-class:: classref-method + +:ref:`bool` **has_valid_configuration**\ (\ ) |const| :ref:`🔗` + +Returns ``true`` if this object contains a valid configuration that can be used when calling :ref:`OpenXRSpatialEntityExtension.create_spatial_context()`. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcapabilityconfigurationmicroqrcode.rst b/classes/es/class_openxrspatialcapabilityconfigurationmicroqrcode.rst new file mode 100644 index 0000000000..0e658e6d1b --- /dev/null +++ b/classes/es/class_openxrspatialcapabilityconfigurationmicroqrcode.rst @@ -0,0 +1,60 @@ +:github_url: hide + +.. _class_OpenXRSpatialCapabilityConfigurationMicroQrCode: + +OpenXRSpatialCapabilityConfigurationMicroQrCode +=============================================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialCapabilityConfigurationBaseHeader` **<** :ref:`RefCounted` **<** :ref:`Object` + +Configuration header for QR code markers. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Configuration header for QR code markers. Pass this to :ref:`OpenXRSpatialEntityExtension.create_spatial_context()` to create a spatial context that can detect QR code markers. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedInt64Array` | :ref:`get_enabled_components`\ (\ ) |const| | + +-------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialCapabilityConfigurationMicroQrCode_method_get_enabled_components: + +.. rst-class:: classref-method + +:ref:`PackedInt64Array` **get_enabled_components**\ (\ ) |const| :ref:`🔗` + +Returns the components enabled by this configuration. + +\ **Note:** Only valid after this configuration was used to create a spatial context. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcapabilityconfigurationplanetracking.rst b/classes/es/class_openxrspatialcapabilityconfigurationplanetracking.rst new file mode 100644 index 0000000000..0eebd2013d --- /dev/null +++ b/classes/es/class_openxrspatialcapabilityconfigurationplanetracking.rst @@ -0,0 +1,102 @@ +:github_url: hide + +.. _class_OpenXRSpatialCapabilityConfigurationPlaneTracking: + +OpenXRSpatialCapabilityConfigurationPlaneTracking +================================================= + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialCapabilityConfigurationBaseHeader` **<** :ref:`RefCounted` **<** :ref:`Object` + +Configuration header for plane tracking. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Configuration header for plane tracking. Pass this to :ref:`OpenXRSpatialEntityExtension.create_spatial_context()` to create a spatial context with plane tracking capabilities. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedInt64Array` | :ref:`get_enabled_components`\ (\ ) |const| | + +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`supports_labels`\ (\ ) | + +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`supports_mesh_2d`\ (\ ) | + +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`supports_polygons`\ (\ ) | + +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialCapabilityConfigurationPlaneTracking_method_get_enabled_components: + +.. rst-class:: classref-method + +:ref:`PackedInt64Array` **get_enabled_components**\ (\ ) |const| :ref:`🔗` + +Returns the components enabled by this configuration. + +\ **Note:** Only valid after this configuration was used to create a spatial context. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialCapabilityConfigurationPlaneTracking_method_supports_labels: + +.. rst-class:: classref-method + +:ref:`bool` **supports_labels**\ (\ ) :ref:`🔗` + +Returns ``true`` if we support the plane semantic label component (only valid after the OpenXR session has started). You can query these using the :ref:`OpenXRSpatialComponentPlaneSemanticLabelList` data object. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialCapabilityConfigurationPlaneTracking_method_supports_mesh_2d: + +.. rst-class:: classref-method + +:ref:`bool` **supports_mesh_2d**\ (\ ) :ref:`🔗` + +Returns ``true`` if we support the mesh 2D component (only valid after the OpenXR session has started). You can query these using the :ref:`OpenXRSpatialComponentMesh2DList` data object. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialCapabilityConfigurationPlaneTracking_method_supports_polygons: + +.. rst-class:: classref-method + +:ref:`bool` **supports_polygons**\ (\ ) :ref:`🔗` + +Returns ``true`` if we support the polygon 2D component (only valid after the OpenXR session has started). You can query these using the :ref:`OpenXRSpatialComponentPolygon2DList` data object. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcapabilityconfigurationqrcode.rst b/classes/es/class_openxrspatialcapabilityconfigurationqrcode.rst new file mode 100644 index 0000000000..7cac814619 --- /dev/null +++ b/classes/es/class_openxrspatialcapabilityconfigurationqrcode.rst @@ -0,0 +1,60 @@ +:github_url: hide + +.. _class_OpenXRSpatialCapabilityConfigurationQrCode: + +OpenXRSpatialCapabilityConfigurationQrCode +========================================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialCapabilityConfigurationBaseHeader` **<** :ref:`RefCounted` **<** :ref:`Object` + +Configuration header for micro QR code markers. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Configuration header for micro QR code markers. Pass this to :ref:`OpenXRSpatialEntityExtension.create_spatial_context()` to create a spatial context that can detect micro QR code markers. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedInt64Array` | :ref:`get_enabled_components`\ (\ ) |const| | + +-------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialCapabilityConfigurationQrCode_method_get_enabled_components: + +.. rst-class:: classref-method + +:ref:`PackedInt64Array` **get_enabled_components**\ (\ ) |const| :ref:`🔗` + +Returns the components enabled by this configuration. + +\ **Note:** Only valid after this configuration was used to create a spatial context. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcomponentanchorlist.rst b/classes/es/class_openxrspatialcomponentanchorlist.rst new file mode 100644 index 0000000000..758be759f1 --- /dev/null +++ b/classes/es/class_openxrspatialcomponentanchorlist.rst @@ -0,0 +1,58 @@ +:github_url: hide + +.. _class_OpenXRSpatialComponentAnchorList: + +OpenXRSpatialComponentAnchorList +================================ + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialComponentData` **<** :ref:`RefCounted` **<** :ref:`Object` + +Object for storing the queries anchor result data. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Object for storing the queries anchor result data when calling :ref:`OpenXRSpatialEntityExtension.query_snapshot()`. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +---------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Transform3D` | :ref:`get_entity_pose`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialComponentAnchorList_method_get_entity_pose: + +.. rst-class:: classref-method + +:ref:`Transform3D` **get_entity_pose**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the transform for the entity at this ``index``. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcomponentbounded2dlist.rst b/classes/es/class_openxrspatialcomponentbounded2dlist.rst new file mode 100644 index 0000000000..4928b855fd --- /dev/null +++ b/classes/es/class_openxrspatialcomponentbounded2dlist.rst @@ -0,0 +1,72 @@ +:github_url: hide + +.. _class_OpenXRSpatialComponentBounded2DList: + +OpenXRSpatialComponentBounded2DList +=================================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialComponentData` **<** :ref:`RefCounted` **<** :ref:`Object` + +Object for storing the queries bounded2d result data. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Object for storing the queries 2D bounding rectangle result data when calling :ref:`OpenXRSpatialEntityExtension.query_snapshot()`. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Transform3D` | :ref:`get_center_pose`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Vector2` | :ref:`get_size`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialComponentBounded2DList_method_get_center_pose: + +.. rst-class:: classref-method + +:ref:`Transform3D` **get_center_pose**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the center of our bounding rectangle for the entity at this ``index``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialComponentBounded2DList_method_get_size: + +.. rst-class:: classref-method + +:ref:`Vector2` **get_size**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the size of our bounding rectangle for the entity at this ``index``. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcomponentbounded3dlist.rst b/classes/es/class_openxrspatialcomponentbounded3dlist.rst new file mode 100644 index 0000000000..fba224fb8c --- /dev/null +++ b/classes/es/class_openxrspatialcomponentbounded3dlist.rst @@ -0,0 +1,72 @@ +:github_url: hide + +.. _class_OpenXRSpatialComponentBounded3DList: + +OpenXRSpatialComponentBounded3DList +=================================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialComponentData` **<** :ref:`RefCounted` **<** :ref:`Object` + +Object for storing the queries bounded3d result data. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Object for storing the queries 3d bounding box result data when calling :ref:`OpenXRSpatialEntityExtension.query_snapshot()`. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Transform3D` | :ref:`get_center_pose`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Vector3` | :ref:`get_size`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialComponentBounded3DList_method_get_center_pose: + +.. rst-class:: classref-method + +:ref:`Transform3D` **get_center_pose**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the center of our bounding box for the entity at this ``index``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialComponentBounded3DList_method_get_size: + +.. rst-class:: classref-method + +:ref:`Vector3` **get_size**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the size of our bounding box for the entity at this ``index``. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcomponentdata.rst b/classes/es/class_openxrspatialcomponentdata.rst new file mode 100644 index 0000000000..8bcc739277 --- /dev/null +++ b/classes/es/class_openxrspatialcomponentdata.rst @@ -0,0 +1,102 @@ +:github_url: hide + +.. _class_OpenXRSpatialComponentData: + +OpenXRSpatialComponentData +========================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`RefCounted` **<** :ref:`Object` + +**Heredado por:** :ref:`OpenXRSpatialComponentAnchorList`, :ref:`OpenXRSpatialComponentBounded2DList`, :ref:`OpenXRSpatialComponentBounded3DList`, :ref:`OpenXRSpatialComponentMarkerList`, :ref:`OpenXRSpatialComponentMesh2DList`, :ref:`OpenXRSpatialComponentMesh3DList`, :ref:`OpenXRSpatialComponentParentList`, :ref:`OpenXRSpatialComponentPersistenceList`, :ref:`OpenXRSpatialComponentPlaneAlignmentList`, :ref:`OpenXRSpatialComponentPlaneSemanticLabelList`, :ref:`OpenXRSpatialComponentPolygon2DList`, :ref:`OpenXRSpatialQueryResultData` + +Object for storing OpenXR spatial entity component data. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Object for storing OpenXR spatial entity component data. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`_get_component_type`\ (\ ) |virtual| |const| | + +-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`_get_structure_data`\ (\ next\: :ref:`int`\ ) |virtual| |const| | + +-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`_set_capacity`\ (\ capacity\: :ref:`int`\ ) |virtual| | + +-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_capacity`\ (\ capacity\: :ref:`int`\ ) | + +-----------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialComponentData_private_method__get_component_type: + +.. rst-class:: classref-method + +:ref:`int` **_get_component_type**\ (\ ) |virtual| |const| :ref:`🔗` + +Return the component type for the component we store data for. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialComponentData_private_method__get_structure_data: + +.. rst-class:: classref-method + +:ref:`int` **_get_structure_data**\ (\ next\: :ref:`int`\ ) |virtual| |const| :ref:`🔗` + +Return a pointer to the structure data that will be submitted along with the snapshot query. This pointer must remain valid as long as this object is instantiated. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialComponentData_private_method__set_capacity: + +.. rst-class:: classref-method + +|void| **_set_capacity**\ (\ capacity\: :ref:`int`\ ) |virtual| :ref:`🔗` + +Set the expected capacity as provided by the spatial entities query system. Buffers should be initialized with the correct storage. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialComponentData_method_set_capacity: + +.. rst-class:: classref-method + +|void| **set_capacity**\ (\ capacity\: :ref:`int`\ ) :ref:`🔗` + +Set the expected capacity as provided by the spatial entities query system. Buffers should be initialized with the correct storage. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcomponentmarkerlist.rst b/classes/es/class_openxrspatialcomponentmarkerlist.rst new file mode 100644 index 0000000000..45d167b309 --- /dev/null +++ b/classes/es/class_openxrspatialcomponentmarkerlist.rst @@ -0,0 +1,149 @@ +:github_url: hide + +.. _class_OpenXRSpatialComponentMarkerList: + +OpenXRSpatialComponentMarkerList +================================ + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialComponentData` **<** :ref:`RefCounted` **<** :ref:`Object` + +Object for storing the queries marker result data. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Object for storing the queries marker result data when calling :ref:`OpenXRSpatialEntityExtension.query_snapshot()`. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +---------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Variant` | :ref:`get_marker_data`\ (\ snapshot\: :ref:`RID`, index\: :ref:`int`\ ) |const| | + +---------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_marker_id`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`MarkerType` | :ref:`get_marker_type`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Enumeraciones +-------------------------- + +.. _enum_OpenXRSpatialComponentMarkerList_MarkerType: + +.. rst-class:: classref-enumeration + +enum **MarkerType**: :ref:`🔗` + +.. _class_OpenXRSpatialComponentMarkerList_constant_MARKER_TYPE_UNKNOWN: + +.. rst-class:: classref-enumeration-constant + +:ref:`MarkerType` **MARKER_TYPE_UNKNOWN** = ``0`` + +Unknown or unset marker type. + +.. _class_OpenXRSpatialComponentMarkerList_constant_MARKER_TYPE_QRCODE: + +.. rst-class:: classref-enumeration-constant + +:ref:`MarkerType` **MARKER_TYPE_QRCODE** = ``1`` + +Marker based on a QR code. + +.. _class_OpenXRSpatialComponentMarkerList_constant_MARKER_TYPE_MICRO_QRCODE: + +.. rst-class:: classref-enumeration-constant + +:ref:`MarkerType` **MARKER_TYPE_MICRO_QRCODE** = ``2`` + +Marker based on a micro QR code. + +.. _class_OpenXRSpatialComponentMarkerList_constant_MARKER_TYPE_ARUCO: + +.. rst-class:: classref-enumeration-constant + +:ref:`MarkerType` **MARKER_TYPE_ARUCO** = ``3`` + +Marker based on an Aruco code. + +.. _class_OpenXRSpatialComponentMarkerList_constant_MARKER_TYPE_APRIL_TAG: + +.. rst-class:: classref-enumeration-constant + +:ref:`MarkerType` **MARKER_TYPE_APRIL_TAG** = ``4`` + +Marker based on an April Tag. + +.. _class_OpenXRSpatialComponentMarkerList_constant_MARKER_TYPE_MAX: + +.. rst-class:: classref-enumeration-constant + +:ref:`MarkerType` **MARKER_TYPE_MAX** = ``5`` + +Maximum value for this enum. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialComponentMarkerList_method_get_marker_data: + +.. rst-class:: classref-method + +:ref:`Variant` **get_marker_data**\ (\ snapshot\: :ref:`RID`, index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns either a :ref:`String` or a :ref:`PackedByteArray` buffer with data for the marker at this ``index``. Only applicable for QR code markers. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialComponentMarkerList_method_get_marker_id: + +.. rst-class:: classref-method + +:ref:`int` **get_marker_id**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the marker ID for the marker at this ``index``. Only applicable for Aruco or April Tag markers. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialComponentMarkerList_method_get_marker_type: + +.. rst-class:: classref-method + +:ref:`MarkerType` **get_marker_type**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the marker type for the marker at this ``index``. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcomponentmesh2dlist.rst b/classes/es/class_openxrspatialcomponentmesh2dlist.rst new file mode 100644 index 0000000000..036a0512f0 --- /dev/null +++ b/classes/es/class_openxrspatialcomponentmesh2dlist.rst @@ -0,0 +1,86 @@ +:github_url: hide + +.. _class_OpenXRSpatialComponentMesh2DList: + +OpenXRSpatialComponentMesh2DList +================================ + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialComponentData` **<** :ref:`RefCounted` **<** :ref:`Object` + +Object for storing the queries mesh2d result data. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Object for storing the queries 2D mesh result data when calling :ref:`OpenXRSpatialEntityExtension.query_snapshot()`. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedInt32Array` | :ref:`get_indices`\ (\ snapshot\: :ref:`RID`, index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Transform3D` | :ref:`get_transform`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedVector2Array` | :ref:`get_vertices`\ (\ snapshot\: :ref:`RID`, index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialComponentMesh2DList_method_get_indices: + +.. rst-class:: classref-method + +:ref:`PackedInt32Array` **get_indices**\ (\ snapshot\: :ref:`RID`, index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the mesh indices for the entity at this ``index``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialComponentMesh2DList_method_get_transform: + +.. rst-class:: classref-method + +:ref:`Transform3D` **get_transform**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the transform for positioning our mesh for the entity at this ``index``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialComponentMesh2DList_method_get_vertices: + +.. rst-class:: classref-method + +:ref:`PackedVector2Array` **get_vertices**\ (\ snapshot\: :ref:`RID`, index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the mesh vertices for the entity at this ``index``. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcomponentmesh3dlist.rst b/classes/es/class_openxrspatialcomponentmesh3dlist.rst new file mode 100644 index 0000000000..1ea8fa9cd0 --- /dev/null +++ b/classes/es/class_openxrspatialcomponentmesh3dlist.rst @@ -0,0 +1,72 @@ +:github_url: hide + +.. _class_OpenXRSpatialComponentMesh3DList: + +OpenXRSpatialComponentMesh3DList +================================ + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialComponentData` **<** :ref:`RefCounted` **<** :ref:`Object` + +Object for storing the queries mesh3d result data. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Object for storing the queries 3d mesh result data when calling :ref:`OpenXRSpatialEntityExtension.query_snapshot()`. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Mesh` | :ref:`get_mesh`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Transform3D` | :ref:`get_transform`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialComponentMesh3DList_method_get_mesh: + +.. rst-class:: classref-method + +:ref:`Mesh` **get_mesh**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the mesh for the entity at this ``index``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialComponentMesh3DList_method_get_transform: + +.. rst-class:: classref-method + +:ref:`Transform3D` **get_transform**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the transform for positioning our mesh for the entity at this ``index``. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcomponentparentlist.rst b/classes/es/class_openxrspatialcomponentparentlist.rst new file mode 100644 index 0000000000..1950a1708d --- /dev/null +++ b/classes/es/class_openxrspatialcomponentparentlist.rst @@ -0,0 +1,58 @@ +:github_url: hide + +.. _class_OpenXRSpatialComponentParentList: + +OpenXRSpatialComponentParentList +================================ + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialComponentData` **<** :ref:`RefCounted` **<** :ref:`Object` + +Object for storing the queries parent result data. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Object for storing the queries parent result data when calling :ref:`OpenXRSpatialEntityExtension.query_snapshot()`. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-----------------------+--------------------------------------------------------------------------------------------------------------------------+ + | :ref:`RID` | :ref:`get_parent`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------+--------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialComponentParentList_method_get_parent: + +.. rst-class:: classref-method + +:ref:`RID` **get_parent**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the RID for the parent entity at this ``index``. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcomponentpersistencelist.rst b/classes/es/class_openxrspatialcomponentpersistencelist.rst new file mode 100644 index 0000000000..ee99c5801d --- /dev/null +++ b/classes/es/class_openxrspatialcomponentpersistencelist.rst @@ -0,0 +1,72 @@ +:github_url: hide + +.. _class_OpenXRSpatialComponentPersistenceList: + +OpenXRSpatialComponentPersistenceList +===================================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialComponentData` **<** :ref:`RefCounted` **<** :ref:`Object` + +Object for storing the query persistence result data. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Object for storing the query persistence result data when calling :ref:`OpenXRSpatialEntityExtension.query_snapshot()`. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_persistent_state`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_persistent_uuid`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialComponentPersistenceList_method_get_persistent_state: + +.. rst-class:: classref-method + +:ref:`int` **get_persistent_state**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the persistent state (``XrSpatialPersistenceStateEXT``) for the entity at this ``index``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialComponentPersistenceList_method_get_persistent_uuid: + +.. rst-class:: classref-method + +:ref:`String` **get_persistent_uuid**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the persistent uuid for the entity at this ``index``. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcomponentplanealignmentlist.rst b/classes/es/class_openxrspatialcomponentplanealignmentlist.rst new file mode 100644 index 0000000000..1c06be43e5 --- /dev/null +++ b/classes/es/class_openxrspatialcomponentplanealignmentlist.rst @@ -0,0 +1,105 @@ +:github_url: hide + +.. _class_OpenXRSpatialComponentPlaneAlignmentList: + +OpenXRSpatialComponentPlaneAlignmentList +======================================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialComponentData` **<** :ref:`RefCounted` **<** :ref:`Object` + +Object for storing the queries plane alignment result data. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Object for storing the queries plane alignment result data when calling :ref:`OpenXRSpatialEntityExtension.query_snapshot()`. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PlaneAlignment` | :ref:`get_plane_alignment`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Enumeraciones +-------------------------- + +.. _enum_OpenXRSpatialComponentPlaneAlignmentList_PlaneAlignment: + +.. rst-class:: classref-enumeration + +enum **PlaneAlignment**: :ref:`🔗` + +.. _class_OpenXRSpatialComponentPlaneAlignmentList_constant_PLANE_ALIGNMENT_HORIZONTAL_UPWARD: + +.. rst-class:: classref-enumeration-constant + +:ref:`PlaneAlignment` **PLANE_ALIGNMENT_HORIZONTAL_UPWARD** = ``0`` + +Plane is facing upward. + +.. _class_OpenXRSpatialComponentPlaneAlignmentList_constant_PLANE_ALIGNMENT_HORIZONTAL_DOWNWARD: + +.. rst-class:: classref-enumeration-constant + +:ref:`PlaneAlignment` **PLANE_ALIGNMENT_HORIZONTAL_DOWNWARD** = ``1`` + +Plane is facing downwards. + +.. _class_OpenXRSpatialComponentPlaneAlignmentList_constant_PLANE_ALIGNMENT_VERTICAL: + +.. rst-class:: classref-enumeration-constant + +:ref:`PlaneAlignment` **PLANE_ALIGNMENT_VERTICAL** = ``2`` + +Plane is vertically aligned. + +.. _class_OpenXRSpatialComponentPlaneAlignmentList_constant_PLANE_ALIGNMENT_ARBITRARY: + +.. rst-class:: classref-enumeration-constant + +:ref:`PlaneAlignment` **PLANE_ALIGNMENT_ARBITRARY** = ``3`` + +Plane has an arbitrary alignment. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialComponentPlaneAlignmentList_method_get_plane_alignment: + +.. rst-class:: classref-method + +:ref:`PlaneAlignment` **get_plane_alignment**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the plane alignment for the parent entity at this ``index``. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcomponentplanesemanticlabellist.rst b/classes/es/class_openxrspatialcomponentplanesemanticlabellist.rst new file mode 100644 index 0000000000..ccb53b703d --- /dev/null +++ b/classes/es/class_openxrspatialcomponentplanesemanticlabellist.rst @@ -0,0 +1,113 @@ +:github_url: hide + +.. _class_OpenXRSpatialComponentPlaneSemanticLabelList: + +OpenXRSpatialComponentPlaneSemanticLabelList +============================================ + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialComponentData` **<** :ref:`RefCounted` **<** :ref:`Object` + +Object for storing the queries plane semantic label result data. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Object for storing the queries plane semantic label result data when calling :ref:`OpenXRSpatialEntityExtension.query_snapshot()`. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PlaneSemanticLabel` | :ref:`get_plane_semantic_label`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Enumeraciones +-------------------------- + +.. _enum_OpenXRSpatialComponentPlaneSemanticLabelList_PlaneSemanticLabel: + +.. rst-class:: classref-enumeration + +enum **PlaneSemanticLabel**: :ref:`🔗` + +.. _class_OpenXRSpatialComponentPlaneSemanticLabelList_constant_PLANE_SEMANTIC_LABEL_UNCATEGORIZED: + +.. rst-class:: classref-enumeration-constant + +:ref:`PlaneSemanticLabel` **PLANE_SEMANTIC_LABEL_UNCATEGORIZED** = ``1`` + +Uncategorized plane. + +.. _class_OpenXRSpatialComponentPlaneSemanticLabelList_constant_PLANE_SEMANTIC_LABEL_FLOOR: + +.. rst-class:: classref-enumeration-constant + +:ref:`PlaneSemanticLabel` **PLANE_SEMANTIC_LABEL_FLOOR** = ``2`` + +Plane represents a floor. + +.. _class_OpenXRSpatialComponentPlaneSemanticLabelList_constant_PLANE_SEMANTIC_LABEL_WALL: + +.. rst-class:: classref-enumeration-constant + +:ref:`PlaneSemanticLabel` **PLANE_SEMANTIC_LABEL_WALL** = ``3`` + +Plane represents a wall. + +.. _class_OpenXRSpatialComponentPlaneSemanticLabelList_constant_PLANE_SEMANTIC_LABEL_CEILING: + +.. rst-class:: classref-enumeration-constant + +:ref:`PlaneSemanticLabel` **PLANE_SEMANTIC_LABEL_CEILING** = ``4`` + +Plane represents a ceiling. + +.. _class_OpenXRSpatialComponentPlaneSemanticLabelList_constant_PLANE_SEMANTIC_LABEL_TABLE: + +.. rst-class:: classref-enumeration-constant + +:ref:`PlaneSemanticLabel` **PLANE_SEMANTIC_LABEL_TABLE** = ``5`` + +Plane represents the surface of a table. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialComponentPlaneSemanticLabelList_method_get_plane_semantic_label: + +.. rst-class:: classref-method + +:ref:`PlaneSemanticLabel` **get_plane_semantic_label**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the plane semantic label for the parent entity at this ``index``. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcomponentpolygon2dlist.rst b/classes/es/class_openxrspatialcomponentpolygon2dlist.rst new file mode 100644 index 0000000000..4c8403e7fe --- /dev/null +++ b/classes/es/class_openxrspatialcomponentpolygon2dlist.rst @@ -0,0 +1,72 @@ +:github_url: hide + +.. _class_OpenXRSpatialComponentPolygon2DList: + +OpenXRSpatialComponentPolygon2DList +=================================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialComponentData` **<** :ref:`RefCounted` **<** :ref:`Object` + +Object for storing the queries polygon2d result data. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Object for storing the queries 2D polygon result data when calling :ref:`OpenXRSpatialEntityExtension.query_snapshot()`. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Transform3D` | :ref:`get_transform`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedVector2Array` | :ref:`get_vertices`\ (\ snapshot\: :ref:`RID`, index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialComponentPolygon2DList_method_get_transform: + +.. rst-class:: classref-method + +:ref:`Transform3D` **get_transform**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the transform for positioning our polygon for the entity at this ``index``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialComponentPolygon2DList_method_get_vertices: + +.. rst-class:: classref-method + +:ref:`PackedVector2Array` **get_vertices**\ (\ snapshot\: :ref:`RID`, index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the polygon vertices for the entity at this ``index``. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialcontextpersistenceconfig.rst b/classes/es/class_openxrspatialcontextpersistenceconfig.rst new file mode 100644 index 0000000000..49d2f21241 --- /dev/null +++ b/classes/es/class_openxrspatialcontextpersistenceconfig.rst @@ -0,0 +1,72 @@ +:github_url: hide + +.. _class_OpenXRSpatialContextPersistenceConfig: + +OpenXRSpatialContextPersistenceConfig +===================================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRStructureBase` **<** :ref:`RefCounted` **<** :ref:`Object` + +Configuration header for spatial persistence. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Configuration header for spatial persistence. Pass this to :ref:`OpenXRSpatialEntityExtension.create_spatial_context()` as the next parameter to create a spatial context with spatial persistence capabilities. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`add_persistence_context`\ (\ persistence_context\: :ref:`RID`\ ) | + +--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_persistence_context`\ (\ persistence_context\: :ref:`RID`\ ) | + +--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialContextPersistenceConfig_method_add_persistence_context: + +.. rst-class:: classref-method + +|void| **add_persistence_context**\ (\ persistence_context\: :ref:`RID`\ ) :ref:`🔗` + +Adds a persistence context to this configuration. You must add at least one persistence context to create a valid configuration. You can create a persistence context by calling :ref:`OpenXRSpatialAnchorCapability.create_persistence_context()`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialContextPersistenceConfig_method_remove_persistence_context: + +.. rst-class:: classref-method + +|void| **remove_persistence_context**\ (\ persistence_context\: :ref:`RID`\ ) :ref:`🔗` + +Removes a persistence context. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialentityextension.rst b/classes/es/class_openxrspatialentityextension.rst new file mode 100644 index 0000000000..f7bb6290cc --- /dev/null +++ b/classes/es/class_openxrspatialentityextension.rst @@ -0,0 +1,586 @@ +:github_url: hide + +.. _class_OpenXRSpatialEntityExtension: + +OpenXRSpatialEntityExtension +============================ + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRExtensionWrapper` **<** :ref:`Object` + +OpenXR extension that handles spatial entities. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +OpenXR extension that handles spatial entities and, when enabled, allows querying those spatial entities. This extension will also automatically manage :ref:`XRTracker` objects for static entities. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`RID` | :ref:`add_spatial_entity`\ (\ spatial_context\: :ref:`RID`, entity_id\: :ref:`int`, entity\: :ref:`int`\ ) | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`OpenXRFutureResult` | :ref:`create_spatial_context`\ (\ capability_configurations\: :ref:`Array`\[:ref:`OpenXRSpatialCapabilityConfigurationBaseHeader`\], next\: :ref:`OpenXRStructureBase` = null, user_callback\: :ref:`Callable` = Callable()\ ) | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`OpenXRFutureResult` | :ref:`discover_spatial_entities`\ (\ spatial_context\: :ref:`RID`, component_types\: :ref:`PackedInt64Array`, next\: :ref:`OpenXRStructureBase` = null, user_callback\: :ref:`Callable` = Callable()\ ) | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`RID` | :ref:`find_spatial_entity`\ (\ entity_id\: :ref:`int`\ ) | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`free_spatial_context`\ (\ spatial_context\: :ref:`RID`\ ) | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`free_spatial_entity`\ (\ entity\: :ref:`RID`\ ) | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`free_spatial_snapshot`\ (\ spatial_snapshot\: :ref:`RID`\ ) | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedFloat32Array` | :ref:`get_float_buffer`\ (\ spatial_snapshot\: :ref:`RID`, buffer_id\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_spatial_context_handle`\ (\ spatial_context\: :ref:`RID`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`get_spatial_context_ready`\ (\ spatial_context\: :ref:`RID`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`RID` | :ref:`get_spatial_entity_context`\ (\ entity\: :ref:`RID`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_spatial_entity_id`\ (\ entity\: :ref:`RID`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`RID` | :ref:`get_spatial_snapshot_context`\ (\ spatial_snapshot\: :ref:`RID`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_spatial_snapshot_handle`\ (\ spatial_snapshot\: :ref:`RID`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_string`\ (\ spatial_snapshot\: :ref:`RID`, buffer_id\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedByteArray` | :ref:`get_uint8_buffer`\ (\ spatial_snapshot\: :ref:`RID`, buffer_id\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedInt32Array` | :ref:`get_uint16_buffer`\ (\ spatial_snapshot\: :ref:`RID`, buffer_id\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedInt32Array` | :ref:`get_uint32_buffer`\ (\ spatial_snapshot\: :ref:`RID`, buffer_id\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedVector2Array` | :ref:`get_vector2_buffer`\ (\ spatial_snapshot\: :ref:`RID`, buffer_id\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedVector3Array` | :ref:`get_vector3_buffer`\ (\ spatial_snapshot\: :ref:`RID`, buffer_id\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`RID` | :ref:`make_spatial_entity`\ (\ spatial_context\: :ref:`RID`, entity_id\: :ref:`int`\ ) | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`query_snapshot`\ (\ spatial_snapshot\: :ref:`RID`, component_data\: :ref:`Array`\[:ref:`OpenXRSpatialComponentData`\], next\: :ref:`OpenXRStructureBase` = null\ ) | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`supports_capability`\ (\ capability\: :ref:`Capability`\ ) | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`supports_component_type`\ (\ capability\: :ref:`Capability`, component_type\: :ref:`ComponentType`\ ) | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`RID` | :ref:`update_spatial_entities`\ (\ spatial_context\: :ref:`RID`, entities\: :ref:`Array`\[:ref:`RID`\], component_types\: :ref:`PackedInt64Array`, next\: :ref:`OpenXRStructureBase` = null\ ) | + +-----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Señales +-------------- + +.. _class_OpenXRSpatialEntityExtension_signal_spatial_discovery_recommended: + +.. rst-class:: classref-signal + +**spatial_discovery_recommended**\ (\ spatial_context\: :ref:`RID`\ ) :ref:`🔗` + +Emitted when OpenXR recommends running a discovery query because entities managed by this spatial context have (likely) changed. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Enumeraciones +-------------------------- + +.. _enum_OpenXRSpatialEntityExtension_Capability: + +.. rst-class:: classref-enumeration + +enum **Capability**: :ref:`🔗` + +.. _class_OpenXRSpatialEntityExtension_constant_CAPABILITY_PLANE_TRACKING: + +.. rst-class:: classref-enumeration-constant + +:ref:`Capability` **CAPABILITY_PLANE_TRACKING** = ``1000741000`` + +Plane tracking capability. + +.. _class_OpenXRSpatialEntityExtension_constant_CAPABILITY_MARKER_TRACKING_QR_CODE: + +.. rst-class:: classref-enumeration-constant + +:ref:`Capability` **CAPABILITY_MARKER_TRACKING_QR_CODE** = ``1000743000`` + +QR code based marker tracking capability. + +.. _class_OpenXRSpatialEntityExtension_constant_CAPABILITY_MARKER_TRACKING_MICRO_QR_CODE: + +.. rst-class:: classref-enumeration-constant + +:ref:`Capability` **CAPABILITY_MARKER_TRACKING_MICRO_QR_CODE** = ``1000743001`` + +Micro QR code based marker tracking capability. + +.. _class_OpenXRSpatialEntityExtension_constant_CAPABILITY_MARKER_TRACKING_ARUCO_MARKER: + +.. rst-class:: classref-enumeration-constant + +:ref:`Capability` **CAPABILITY_MARKER_TRACKING_ARUCO_MARKER** = ``1000743002`` + +Aruco marker based marker tracking capability. + +.. _class_OpenXRSpatialEntityExtension_constant_CAPABILITY_MARKER_TRACKING_APRIL_TAG: + +.. rst-class:: classref-enumeration-constant + +:ref:`Capability` **CAPABILITY_MARKER_TRACKING_APRIL_TAG** = ``1000743003`` + +April tag based marker tracking capability. + +.. _class_OpenXRSpatialEntityExtension_constant_CAPABILITY_ANCHOR: + +.. rst-class:: classref-enumeration-constant + +:ref:`Capability` **CAPABILITY_ANCHOR** = ``1000762000`` + +Anchor capability. + +.. rst-class:: classref-item-separator + +---- + +.. _enum_OpenXRSpatialEntityExtension_ComponentType: + +.. rst-class:: classref-enumeration + +enum **ComponentType**: :ref:`🔗` + +.. _class_OpenXRSpatialEntityExtension_constant_COMPONENT_TYPE_BOUNDED_2D: + +.. rst-class:: classref-enumeration-constant + +:ref:`ComponentType` **COMPONENT_TYPE_BOUNDED_2D** = ``1`` + +Component that provides the 2D bounds for a spatial entity. The corresponding list structure is ``XrSpatialComponentBounded2DListEXT``; the corresponding data structure is ``XrSpatialBounded2DDataEXT``. + +.. _class_OpenXRSpatialEntityExtension_constant_COMPONENT_TYPE_BOUNDED_3D: + +.. rst-class:: classref-enumeration-constant + +:ref:`ComponentType` **COMPONENT_TYPE_BOUNDED_3D** = ``2`` + +Component that provides the 3D bounds for a spatial entity. The corresponding list structure is ``XrSpatialComponentBounded3DListEXT``; the corresponding data structure is ``XrBoxf``. + +.. _class_OpenXRSpatialEntityExtension_constant_COMPONENT_TYPE_PARENT: + +.. rst-class:: classref-enumeration-constant + +:ref:`ComponentType` **COMPONENT_TYPE_PARENT** = ``3`` + +Component that provides the XrSpatialEntityIdEXT of the parent for a spatial entity. The corresponding list structure is ``XrSpatialComponentParentListEXT``; the corresponding data structure is ``XrSpatialEntityIdEXT``. + +.. _class_OpenXRSpatialEntityExtension_constant_COMPONENT_TYPE_MESH_3D: + +.. rst-class:: classref-enumeration-constant + +:ref:`ComponentType` **COMPONENT_TYPE_MESH_3D** = ``4`` + +Component that provides a 3D mesh for a spatial entity. The corresponding list structure is ``XrSpatialComponentMesh3DListEXT``; the corresponding data structure is ``XrSpatialMeshDataEXT``. + +.. _class_OpenXRSpatialEntityExtension_constant_COMPONENT_TYPE_PLANE_ALIGNMENT: + +.. rst-class:: classref-enumeration-constant + +:ref:`ComponentType` **COMPONENT_TYPE_PLANE_ALIGNMENT** = ``1000741000`` + +Component that provides the plane alignment enum for a spatial entity. The corresponding list structure is ``XrSpatialComponentPlaneAlignmentListEXT``; the corresponding data structure is ``XrSpatialPlaneAlignmentEXT`` (Added by the ``XR_EXT_spatial_plane_tracking`` extension). + +.. _class_OpenXRSpatialEntityExtension_constant_COMPONENT_TYPE_MESH_2D: + +.. rst-class:: classref-enumeration-constant + +:ref:`ComponentType` **COMPONENT_TYPE_MESH_2D** = ``1000741001`` + +Component that provides a 2D mesh for a spatial entity. The corresponding list structure is ``XrSpatialComponentMesh2DListEXT``; the corresponding data structure is ``XrSpatialMeshDataEXT`` (Added by the ``XR_EXT_spatial_plane_tracking`` extension). + +.. _class_OpenXRSpatialEntityExtension_constant_COMPONENT_TYPE_POLYGON_2D: + +.. rst-class:: classref-enumeration-constant + +:ref:`ComponentType` **COMPONENT_TYPE_POLYGON_2D** = ``1000741002`` + +Component that provides a 2D boundary polygon for a spatial entity. The corresponding list structure is ``XrSpatialComponentPolygon2DListEXT``; the corresponding data structure is ``XrSpatialPolygon2DDataEXT`` (Added by the ``XR_EXT_spatial_plane_tracking`` extension). + +.. _class_OpenXRSpatialEntityExtension_constant_COMPONENT_TYPE_PLANE_SEMANTIC_LABEL: + +.. rst-class:: classref-enumeration-constant + +:ref:`ComponentType` **COMPONENT_TYPE_PLANE_SEMANTIC_LABEL** = ``1000741003`` + +Component that provides a semantic label for a plane. The corresponding list structure is ``XrSpatialComponentPlaneSemanticLabelListEXT``; the corresponding data structure is ``XrSpatialPlaneSemanticLabelEXT`` (Added by the ``XR_EXT_spatial_plane_tracking`` extension). + +.. _class_OpenXRSpatialEntityExtension_constant_COMPONENT_TYPE_MARKER: + +.. rst-class:: classref-enumeration-constant + +:ref:`ComponentType` **COMPONENT_TYPE_MARKER** = ``1000743000`` + +A component describing the marker type, ID and location. The corresponding list structure is ``XrSpatialComponentMarkerListEXT``; the corresponding data structure is ``XrSpatialMarkerDataEXT`` (Added by the ``XR_EXT_spatial_marker_tracking`` extension). + +.. _class_OpenXRSpatialEntityExtension_constant_COMPONENT_TYPE_ANCHOR: + +.. rst-class:: classref-enumeration-constant + +:ref:`ComponentType` **COMPONENT_TYPE_ANCHOR** = ``1000762000`` + +Component that provides the location for an anchor. The corresponding list structure is ``XrSpatialComponentAnchorListEXT``; the corresponding data structure is ``XrPosef`` (Added by the ``XR_EXT_spatial_anchor`` extension). + +.. _class_OpenXRSpatialEntityExtension_constant_COMPONENT_TYPE_PERSISTENCE: + +.. rst-class:: classref-enumeration-constant + +:ref:`ComponentType` **COMPONENT_TYPE_PERSISTENCE** = ``1000763000`` + +Component that provides the persisted UUID for a spatial entity. The corresponding list structure is ``XrSpatialComponentPersistenceListEXT; the corresponding data structure is [code]XrSpatialPersistenceDataEXT`` (Added by the ``XR_EXT_spatial_persistence`` extension). + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialEntityExtension_method_add_spatial_entity: + +.. rst-class:: classref-method + +:ref:`RID` **add_spatial_entity**\ (\ spatial_context\: :ref:`RID`, entity_id\: :ref:`int`, entity\: :ref:`int`\ ) :ref:`🔗` + +Registers an entity that was created directly on the OpenXR runtime. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_create_spatial_context: + +.. rst-class:: classref-method + +:ref:`OpenXRFutureResult` **create_spatial_context**\ (\ capability_configurations\: :ref:`Array`\[:ref:`OpenXRSpatialCapabilityConfigurationBaseHeader`\], next\: :ref:`OpenXRStructureBase` = null, user_callback\: :ref:`Callable` = Callable()\ ) :ref:`🔗` + +Creates a new spatial context that handles entities for the provided capability configurations. ``capability_configurations`` is an array of :ref:`OpenXRSpatialCapabilityConfigurationBaseHeader` with the needed capability configuration data. + +\ ``next`` is an optional parameter that can contain additional information for creating our spatial context. + +\ **Note:** This is an asynchronous method and returns an :ref:`OpenXRFutureResult` object with which to track the status, discarding this object will not cancel the creation process. On success ``user_callback`` will be called if specified. The result data for this function is the :ref:`RID` for our spatial context. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_discover_spatial_entities: + +.. rst-class:: classref-method + +:ref:`OpenXRFutureResult` **discover_spatial_entities**\ (\ spatial_context\: :ref:`RID`, component_types\: :ref:`PackedInt64Array`, next\: :ref:`OpenXRStructureBase` = null, user_callback\: :ref:`Callable` = Callable()\ ) :ref:`🔗` + +Starts a new discovery query, this will gather all objects tracked by the ``spatial_context`` that have at least one of the component types specified in ``component_types``. + +\ ``next`` is an optional parameter that can contain additional information for executing the discovery query. + +\ **Note:** This is an asynchronous method and returns an :ref:`OpenXRFutureResult` object with which to track the status, discarding this object will not cancel the discovery process. On success ``user_callback`` will be called if specified. The result data for this function is the :ref:`RID` for our snapshot. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_find_spatial_entity: + +.. rst-class:: classref-method + +:ref:`RID` **find_spatial_entity**\ (\ entity_id\: :ref:`int`\ ) :ref:`🔗` + +Returns the :ref:`RID` for the specified spatial entity ID. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_free_spatial_context: + +.. rst-class:: classref-method + +|void| **free_spatial_context**\ (\ spatial_context\: :ref:`RID`\ ) :ref:`🔗` + +Frees a spatial context previously created when calling :ref:`create_spatial_context()`. If the spatial context creation is still ongoing, the asynchronous process is cancelled. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_free_spatial_entity: + +.. rst-class:: classref-method + +|void| **free_spatial_entity**\ (\ entity\: :ref:`RID`\ ) :ref:`🔗` + +Frees an entity previously created when calling :ref:`add_spatial_entity()` or :ref:`make_spatial_entity()`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_free_spatial_snapshot: + +.. rst-class:: classref-method + +|void| **free_spatial_snapshot**\ (\ spatial_snapshot\: :ref:`RID`\ ) :ref:`🔗` + +Frees a spatial snapshot previously created when calling :ref:`discover_spatial_entities()`. If the spatial snapshot creation is still ongoing, the asynchronous process is cancelled. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_get_float_buffer: + +.. rst-class:: classref-method + +:ref:`PackedFloat32Array` **get_float_buffer**\ (\ spatial_snapshot\: :ref:`RID`, buffer_id\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns a buffer with floats from a buffer that was retrieved when taking a snapshot. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_get_spatial_context_handle: + +.. rst-class:: classref-method + +:ref:`int` **get_spatial_context_handle**\ (\ spatial_context\: :ref:`RID`\ ) |const| :ref:`🔗` + +Returns the OpenXR spatial context handle for this snapshot. + +\ **Note:** This method is intended to be used from GDExtensions that implement spatial entity capability handlers. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_get_spatial_context_ready: + +.. rst-class:: classref-method + +:ref:`bool` **get_spatial_context_ready**\ (\ spatial_context\: :ref:`RID`\ ) |const| :ref:`🔗` + +Returns ``true`` if the spatial context finished its creation and is ready to be used. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_get_spatial_entity_context: + +.. rst-class:: classref-method + +:ref:`RID` **get_spatial_entity_context**\ (\ entity\: :ref:`RID`\ ) |const| :ref:`🔗` + +Returns the spatial context for this entity. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_get_spatial_entity_id: + +.. rst-class:: classref-method + +:ref:`int` **get_spatial_entity_id**\ (\ entity\: :ref:`RID`\ ) |const| :ref:`🔗` + +Returns the internal ``XrSpatialEntityIdEXT`` associated with the entity. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_get_spatial_snapshot_context: + +.. rst-class:: classref-method + +:ref:`RID` **get_spatial_snapshot_context**\ (\ spatial_snapshot\: :ref:`RID`\ ) |const| :ref:`🔗` + +Returns the spatial context related to this spatial snapshot. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_get_spatial_snapshot_handle: + +.. rst-class:: classref-method + +:ref:`int` **get_spatial_snapshot_handle**\ (\ spatial_snapshot\: :ref:`RID`\ ) |const| :ref:`🔗` + +Returns the OpenXR spatial snapshot handle for this snapshot. + +\ **Note:** This method is intended to be used from GDExtensions that implement spatial entity capability handlers. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_get_string: + +.. rst-class:: classref-method + +:ref:`String` **get_string**\ (\ spatial_snapshot\: :ref:`RID`, buffer_id\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns a string from a buffer that was retrieved when taking a snapshot. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_get_uint8_buffer: + +.. rst-class:: classref-method + +:ref:`PackedByteArray` **get_uint8_buffer**\ (\ spatial_snapshot\: :ref:`RID`, buffer_id\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns a buffer with 8 bit ints from a buffer that was retrieved when taking a snapshot. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_get_uint16_buffer: + +.. rst-class:: classref-method + +:ref:`PackedInt32Array` **get_uint16_buffer**\ (\ spatial_snapshot\: :ref:`RID`, buffer_id\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns a buffer with 16 bit ints from a buffer that was retrieved when taking a snapshot. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_get_uint32_buffer: + +.. rst-class:: classref-method + +:ref:`PackedInt32Array` **get_uint32_buffer**\ (\ spatial_snapshot\: :ref:`RID`, buffer_id\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns a buffer with 32 bit ints from a buffer that was retrieved when taking a snapshot. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_get_vector2_buffer: + +.. rst-class:: classref-method + +:ref:`PackedVector2Array` **get_vector2_buffer**\ (\ spatial_snapshot\: :ref:`RID`, buffer_id\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns a buffer with :ref:`Vector2` entries from a buffer that was retrieved when taking a snapshot. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_get_vector3_buffer: + +.. rst-class:: classref-method + +:ref:`PackedVector3Array` **get_vector3_buffer**\ (\ spatial_snapshot\: :ref:`RID`, buffer_id\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns a buffer with :ref:`Vector3` entries from a buffer that was retrieved when taking a snapshot. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_make_spatial_entity: + +.. rst-class:: classref-method + +:ref:`RID` **make_spatial_entity**\ (\ spatial_context\: :ref:`RID`, entity_id\: :ref:`int`\ ) :ref:`🔗` + +Creates a new entity for this ``entity_id``. The ``spatial_context`` should match the context that discovered the entity. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_query_snapshot: + +.. rst-class:: classref-method + +:ref:`bool` **query_snapshot**\ (\ spatial_snapshot\: :ref:`RID`, component_data\: :ref:`Array`\[:ref:`OpenXRSpatialComponentData`\], next\: :ref:`OpenXRStructureBase` = null\ ) :ref:`🔗` + +Queries the snapshot data. This will find all entities in the snapshot that contain all requested components in ``component_data``. The objects held within ``component_data`` will then be populated with the queried data. ``component_data`` must always have an object of :ref:`OpenXRSpatialQueryResultData` as the first entry. + +\ ``next`` is an optional parameter that can contain additional information passed when setting our query conditions. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_supports_capability: + +.. rst-class:: classref-method + +:ref:`bool` **supports_capability**\ (\ capability\: :ref:`Capability`\ ) :ref:`🔗` + +Returns ``true`` if this spatial entity ``capability`` is supported by the hardware used. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_supports_component_type: + +.. rst-class:: classref-method + +:ref:`bool` **supports_component_type**\ (\ capability\: :ref:`Capability`, component_type\: :ref:`ComponentType`\ ) :ref:`🔗` + +Returns ``true`` if this ``capability`` supports the ``component_type``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityExtension_method_update_spatial_entities: + +.. rst-class:: classref-method + +:ref:`RID` **update_spatial_entities**\ (\ spatial_context\: :ref:`RID`, entities\: :ref:`Array`\[:ref:`RID`\], component_types\: :ref:`PackedInt64Array`, next\: :ref:`OpenXRStructureBase` = null\ ) :ref:`🔗` + +Performs a snapshot for a limited number of entities. This is NOT an asynchronous method and will return the snapshot immediately. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialentitytracker.rst b/classes/es/class_openxrspatialentitytracker.rst new file mode 100644 index 0000000000..4fba072bd0 --- /dev/null +++ b/classes/es/class_openxrspatialentitytracker.rst @@ -0,0 +1,144 @@ +:github_url: hide + +.. _class_OpenXRSpatialEntityTracker: + +OpenXRSpatialEntityTracker +========================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`XRPositionalTracker` **<** :ref:`XRTracker` **<** :ref:`RefCounted` **<** :ref:`Object` + +**Heredado por:** :ref:`OpenXRAnchorTracker`, :ref:`OpenXRMarkerTracker`, :ref:`OpenXRPlaneTracker` + +Base class for Positional trackers managed by OpenXR's spatial entity extensions. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +These are trackers created and managed by OpenXR's spatial entity extensions that give access to specific data related to OpenXR's spatial entities. They will always be of type ``TRACKER_ANCHOR``. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +---------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | :ref:`RID` | :ref:`entity` | ``RID()`` | + +---------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | :ref:`EntityTrackingState` | :ref:`spatial_tracking_state` | ``2`` | + +---------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + | :ref:`TrackerType` | type | ``8`` (overrides :ref:`XRTracker`) | + +---------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------+-------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Señales +-------------- + +.. _class_OpenXRSpatialEntityTracker_signal_spatial_tracking_state_changed: + +.. rst-class:: classref-signal + +**spatial_tracking_state_changed**\ (\ spatial_tracking_state\: :ref:`int`\ ) :ref:`🔗` + +.. container:: contribute + + There is currently no description for this signal. Please help us by `contributing one `__! + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Enumeraciones +-------------------------- + +.. _enum_OpenXRSpatialEntityTracker_EntityTrackingState: + +.. rst-class:: classref-enumeration + +enum **EntityTrackingState**: :ref:`🔗` + +.. _class_OpenXRSpatialEntityTracker_constant_ENTITY_TRACKING_STATE_STOPPED: + +.. rst-class:: classref-enumeration-constant + +:ref:`EntityTrackingState` **ENTITY_TRACKING_STATE_STOPPED** = ``1`` + +This anchor has stopped tracking. + +.. _class_OpenXRSpatialEntityTracker_constant_ENTITY_TRACKING_STATE_PAUSED: + +.. rst-class:: classref-enumeration-constant + +:ref:`EntityTrackingState` **ENTITY_TRACKING_STATE_PAUSED** = ``2`` + +Tracking is currently paused. + +.. _class_OpenXRSpatialEntityTracker_constant_ENTITY_TRACKING_STATE_TRACKING: + +.. rst-class:: classref-enumeration-constant + +:ref:`EntityTrackingState` **ENTITY_TRACKING_STATE_TRACKING** = ``3`` + +This anchor is currently being tracked. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_OpenXRSpatialEntityTracker_property_entity: + +.. rst-class:: classref-property + +:ref:`RID` **entity** = ``RID()`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_entity**\ (\ value\: :ref:`RID`\ ) +- :ref:`RID` **get_entity**\ (\ ) + +The spatial entity associated with this tracker. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialEntityTracker_property_spatial_tracking_state: + +.. rst-class:: classref-property + +:ref:`EntityTrackingState` **spatial_tracking_state** = ``2`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_spatial_tracking_state**\ (\ value\: :ref:`EntityTrackingState`\ ) +- :ref:`EntityTrackingState` **get_spatial_tracking_state**\ (\ ) + +The spatial tracking state for this tracker. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialmarkertrackingcapability.rst b/classes/es/class_openxrspatialmarkertrackingcapability.rst new file mode 100644 index 0000000000..281094a562 --- /dev/null +++ b/classes/es/class_openxrspatialmarkertrackingcapability.rst @@ -0,0 +1,100 @@ +:github_url: hide + +.. _class_OpenXRSpatialMarkerTrackingCapability: + +OpenXRSpatialMarkerTrackingCapability +===================================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRExtensionWrapper` **<** :ref:`Object` + +Implementation for handling spatial entity marker tracking logic. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +This class handles the OpenXR marker tracking spatial entity extension. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------+----------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_april_tag_supported`\ (\ ) | + +-------------------------+----------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_aruco_supported`\ (\ ) | + +-------------------------+----------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_micro_qrcode_supported`\ (\ ) | + +-------------------------+----------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_qrcode_supported`\ (\ ) | + +-------------------------+----------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialMarkerTrackingCapability_method_is_april_tag_supported: + +.. rst-class:: classref-method + +:ref:`bool` **is_april_tag_supported**\ (\ ) :ref:`🔗` + +Returns ``true`` if April tag marker tracking is supported by the current device. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialMarkerTrackingCapability_method_is_aruco_supported: + +.. rst-class:: classref-method + +:ref:`bool` **is_aruco_supported**\ (\ ) :ref:`🔗` + +Returns ``true`` if Aruco marker tracking is supported by the current device. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialMarkerTrackingCapability_method_is_micro_qrcode_supported: + +.. rst-class:: classref-method + +:ref:`bool` **is_micro_qrcode_supported**\ (\ ) :ref:`🔗` + +Returns ``true`` if micro QR code marker tracking is supported by the current device. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialMarkerTrackingCapability_method_is_qrcode_supported: + +.. rst-class:: classref-method + +:ref:`bool` **is_qrcode_supported**\ (\ ) :ref:`🔗` + +Returns ``true`` if QR code marker tracking is supported by the current device. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialplanetrackingcapability.rst b/classes/es/class_openxrspatialplanetrackingcapability.rst new file mode 100644 index 0000000000..130a42f9ee --- /dev/null +++ b/classes/es/class_openxrspatialplanetrackingcapability.rst @@ -0,0 +1,58 @@ +:github_url: hide + +.. _class_OpenXRSpatialPlaneTrackingCapability: + +OpenXRSpatialPlaneTrackingCapability +==================================== + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRExtensionWrapper` **<** :ref:`Object` + +Implementation for handling spatial entity plane tracking logic. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +This class handles the OpenXR plane tracking spatial entity extension. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------+-------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_supported`\ (\ ) | + +-------------------------+-------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialPlaneTrackingCapability_method_is_supported: + +.. rst-class:: classref-method + +:ref:`bool` **is_supported**\ (\ ) :ref:`🔗` + +Returns ``true`` if plane tracking is supported by the current device. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrspatialqueryresultdata.rst b/classes/es/class_openxrspatialqueryresultdata.rst new file mode 100644 index 0000000000..b88be974b2 --- /dev/null +++ b/classes/es/class_openxrspatialqueryresultdata.rst @@ -0,0 +1,86 @@ +:github_url: hide + +.. _class_OpenXRSpatialQueryResultData: + +OpenXRSpatialQueryResultData +============================ + +**Experimental:** This class may be changed or removed in future versions. + +**Hereda:** :ref:`OpenXRSpatialComponentData` **<** :ref:`RefCounted` **<** :ref:`Object` + +Object for storing the main query result data. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Object for storing the main query result data when calling :ref:`OpenXRSpatialEntityExtension.query_snapshot()`. This must always be the first component requested. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_capacity`\ (\ ) |const| | + +---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_entity_id`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`EntityTrackingState` | :ref:`get_entity_state`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRSpatialQueryResultData_method_get_capacity: + +.. rst-class:: classref-method + +:ref:`int` **get_capacity**\ (\ ) |const| :ref:`🔗` + +Returns the number of entities that were retrieved. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialQueryResultData_method_get_entity_id: + +.. rst-class:: classref-method + +:ref:`int` **get_entity_id**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the entity id (``XrSpatialEntityIdEXT``) for the entity at this ``index``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRSpatialQueryResultData_method_get_entity_state: + +.. rst-class:: classref-method + +:ref:`EntityTrackingState` **get_entity_state**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the entity state for the entity at this ``index``. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_openxrstructurebase.rst b/classes/es/class_openxrstructurebase.rst new file mode 100644 index 0000000000..a0faf93337 --- /dev/null +++ b/classes/es/class_openxrstructurebase.rst @@ -0,0 +1,108 @@ +:github_url: hide + +.. _class_OpenXRStructureBase: + +OpenXRStructureBase +=================== + +**Hereda:** :ref:`RefCounted` **<** :ref:`Object` + +**Heredado por:** :ref:`OpenXRSpatialContextPersistenceConfig` + +Object for storing OpenXR structure data. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +Object for storing OpenXR structure data that is passed when calling into OpenXR APIs. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +-------------------------------------------------------+------------------------------------------------------+ + | :ref:`OpenXRStructureBase` | :ref:`next` | + +-------------------------------------------------------+------------------------------------------------------+ + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-----------------------+------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`_get_header`\ (\ next\: :ref:`int`\ ) |virtual| | + +-----------------------+------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_structure_type`\ (\ ) | + +-----------------------+------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_OpenXRStructureBase_property_next: + +.. rst-class:: classref-property + +:ref:`OpenXRStructureBase` **next** :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_next**\ (\ value\: :ref:`OpenXRStructureBase`\ ) +- :ref:`OpenXRStructureBase` **get_next**\ (\ ) + +Setting another structure object here chains these structures together to extend the API functionality. Consult the OpenXR documentation for which structures can be used with a given API call. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_OpenXRStructureBase_private_method__get_header: + +.. rst-class:: classref-method + +:ref:`int` **_get_header**\ (\ next\: :ref:`int`\ ) |virtual| :ref:`🔗` + +.. container:: contribute + + There is currently no description for this method. Please help us by `contributing one `__! + +.. rst-class:: classref-item-separator + +---- + +.. _class_OpenXRStructureBase_method_get_structure_type: + +.. rst-class:: classref-method + +:ref:`int` **get_structure_type**\ (\ ) :ref:`🔗` + +Returns the structure type (OpenXR ``XrStructureType``) used for this structure. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_optimizedtranslation.rst b/classes/es/class_optimizedtranslation.rst index 4946ad035c..1926fc4125 100644 --- a/classes/es/class_optimizedtranslation.rst +++ b/classes/es/class_optimizedtranslation.rst @@ -7,14 +7,16 @@ OptimizedTranslation **Hereda:** :ref:`Translation` **<** :ref:`Resource` **<** :ref:`RefCounted` **<** :ref:`Object` -Una traducción optimizada, utilizada por defecto para las traducciones CSV. +An optimized translation. .. rst-class:: classref-introduction-group Descripción ---------------------- -Una traducción optimizada, utilizada por defecto para las traducciones CSV. Utiliza traducciones comprimidas en tiempo real, lo que resulta en diccionarios muy pequeños. +An optimized translation. Uses real-time compressed translations, which results in very small dictionaries. + +This class does not store the untranslated strings for optimization purposes. Therefore, :ref:`Translation.get_message_list()` always returns an empty array, and :ref:`Translation.get_message_count()` always returns ``0``. .. rst-class:: classref-reftable-group @@ -43,9 +45,11 @@ Descripciones de Métodos |void| **generate**\ (\ from\: :ref:`Translation`\ ) :ref:`🔗` -Genera y establece una traducción optimizada desde el recurso :ref:`Translation` dado. +Generates and sets an optimized translation from the given :ref:`Translation` resource. -\ **Nota:** Este método está diseñado para ser utilizado en el editor. No hace nada cuando se llama desde un proyecto exportado. +\ **Note:** Messages in ``from`` should not use context or plural forms. + +\ **Note:** This method is intended to be used in the editor. It does nothing when called from an exported project. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_os.rst b/classes/es/class_os.rst index b0bf8054f8..a995fab9c0 100644 --- a/classes/es/class_os.rst +++ b/classes/es/class_os.rst @@ -739,7 +739,13 @@ Not to be confused with :ref:`get_user_data_dir()` **get_cmdline_args**\ (\ ) :ref:`🔗` -Returns the command-line arguments passed to the engine. +Returns the command-line arguments passed to the engine, excluding arguments processed by the engine, such as ``--headless`` and ``--fullscreen``. + +:: + + # Godot has been executed with the following command: + # godot --headless --verbose --scene my_scene.tscn --custom + OS.get_cmdline_args() # Returns ["--scene", "my_scene.tscn", "--custom"] Command-line arguments can be written in any form, including both ``--key value`` and ``--key=value`` forms so they can be properly parsed, as long as custom command-line arguments do not conflict with engine arguments. @@ -801,12 +807,12 @@ Returns the command-line user arguments passed to the engine. User arguments are :: # Godot has been executed with the following command: - # godot --fullscreen -- --level=2 --hardcore + # godot --fullscreen --custom -- --level=2 --hardcore - OS.get_cmdline_args() # Returns ["--fullscreen", "--level=2", "--hardcore"] + OS.get_cmdline_args() # Returns ["--custom"] OS.get_cmdline_user_args() # Returns ["--level=2", "--hardcore"] -To get all passed arguments, use :ref:`get_cmdline_args()`. +To get arguments passed before ``--`` or ``++``, use :ref:`get_cmdline_args()`. .. rst-class:: classref-item-separator diff --git a/classes/es/class_packedbytearray.rst b/classes/es/class_packedbytearray.rst index 830719b6ba..91b35f7d01 100644 --- a/classes/es/class_packedbytearray.rst +++ b/classes/es/class_packedbytearray.rst @@ -51,7 +51,7 @@ Métodos +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedByteArray`\ ) | +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`int`, before\: :ref:`bool` = true\ ) | + | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`int`, before\: :ref:`bool` = true\ ) |const| | +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`bswap16`\ (\ offset\: :ref:`int` = 0, count\: :ref:`int` = -1\ ) | +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -95,7 +95,7 @@ Métodos +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedByteArray` | :ref:`decompress_dynamic`\ (\ max_output_size\: :ref:`int`, compression_mode\: :ref:`int` = 0\ ) |const| | +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedByteArray` | :ref:`duplicate`\ (\ ) | + | :ref:`PackedByteArray` | :ref:`duplicate`\ (\ ) |const| | +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`encode_double`\ (\ byte_offset\: :ref:`int`, value\: :ref:`float`\ ) | +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -278,7 +278,7 @@ Añade un **PackedByteArray** al final de este array. .. rst-class:: classref-method -:ref:`int` **bsearch**\ (\ value\: :ref:`int`, before\: :ref:`bool` = true\ ) :ref:`🔗` +:ref:`int` **bsearch**\ (\ value\: :ref:`int`, before\: :ref:`bool` = true\ ) |const| :ref:`🔗` Encuentra el índice de un valor existente (o el índice de inserción que mantiene el orden de clasificación, si el valor aún no está presente en el array) utilizando la búsqueda binaria. Opcionalmente, se puede pasar un especificador ``before``. Si es ``false``, el índice devuelto viene después de todas las entradas existentes del valor en el array. @@ -552,7 +552,7 @@ GZIP has a maximal compression ratio of 1032:1, meaning it's very possible for a .. rst-class:: classref-method -:ref:`PackedByteArray` **duplicate**\ (\ ) :ref:`🔗` +:ref:`PackedByteArray` **duplicate**\ (\ ) |const| :ref:`🔗` Creates a copy of the array, and returns it. @@ -746,9 +746,9 @@ Busca un valor en el array y devuelve su índice o ``-1`` si no lo encuentra. Op :ref:`int` **get**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve el byte en el ``index`` dado en el array. Si ``index`` está fuera de los límites o es negativo, este método falla y devuelve ``0``. +Returns the byte at the given ``index`` in the array. If ``index`` is out-of-bounds or negative, this method fails and returns ``0``. -Este método es similar (pero no idéntico) al operador ``[]``. Principalmente, cuando este método falla, no pausa la ejecución del proyecto si se ejecuta desde el editor. +This method is similar (but not identical) to the ``[]`` operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor. .. rst-class:: classref-item-separator diff --git a/classes/es/class_packedcolorarray.rst b/classes/es/class_packedcolorarray.rst index 4de59f6477..a0cc450127 100644 --- a/classes/es/class_packedcolorarray.rst +++ b/classes/es/class_packedcolorarray.rst @@ -46,53 +46,53 @@ Métodos .. table:: :widths: auto - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`Color`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedColorArray`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`Color`, before\: :ref:`bool` = true\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear`\ (\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`count`\ (\ value\: :ref:`Color`\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedColorArray` | :ref:`duplicate`\ (\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`Color`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`fill`\ (\ value\: :ref:`Color`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`find`\ (\ value\: :ref:`Color`, from\: :ref:`int` = 0\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Color` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`Color`\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`Color`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`Color`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`reverse`\ (\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`Color`, from\: :ref:`int` = -1\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`Color`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`size`\ (\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedColorArray` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`sort`\ (\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`Color`\ ) | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedColorArray`\ ) | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`Color`, before\: :ref:`bool` = true\ ) |const| | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear`\ (\ ) | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`count`\ (\ value\: :ref:`Color`\ ) |const| | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedColorArray` | :ref:`duplicate`\ (\ ) |const| | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`Color`\ ) | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`fill`\ (\ value\: :ref:`Color`\ ) | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`find`\ (\ value\: :ref:`Color`, from\: :ref:`int` = 0\ ) |const| | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Color` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`Color`\ ) |const| | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`Color`\ ) | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`Color`\ ) | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`reverse`\ (\ ) | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`Color`, from\: :ref:`int` = -1\ ) |const| | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`Color`\ ) | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`size`\ (\ ) |const| | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedColorArray` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`sort`\ (\ ) | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -192,7 +192,7 @@ Añade un **PackedColorArray** al final de este array. .. rst-class:: classref-method -:ref:`int` **bsearch**\ (\ value\: :ref:`Color`, before\: :ref:`bool` = true\ ) :ref:`🔗` +:ref:`int` **bsearch**\ (\ value\: :ref:`Color`, before\: :ref:`bool` = true\ ) |const| :ref:`🔗` Encuentra el índice de un valor existente (o el índice de inserción que mantiene el orden de clasificación, si el valor aún no está presente en el array) utilizando la búsqueda binaria. Opcionalmente, se puede pasar un especificador ``before``. Si es ``false``, el índice devuelto viene después de todas las entradas existentes del valor en el array. @@ -230,7 +230,7 @@ Devuelve el numer de veces que un elemento es encuentra en el array. .. rst-class:: classref-method -:ref:`PackedColorArray` **duplicate**\ (\ ) :ref:`🔗` +:ref:`PackedColorArray` **duplicate**\ (\ ) |const| :ref:`🔗` Creates a copy of the array, and returns it. @@ -280,7 +280,7 @@ Busca un valor en el array y devuelve su índice o ``-1`` si no lo encuentra. Op :ref:`Color` **get**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Returns the :ref:`Color` at the given ``index`` in the array. If ``index`` out-of-bounds or negative, this method fails and returns ``Color(0, 0, 0, 1)``. +Returns the :ref:`Color` at the given ``index`` in the array. If ``index`` is out-of-bounds or negative, this method fails and returns ``Color(0, 0, 0, 1)``. This method is similar (but not identical) to the ``[]`` operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor. diff --git a/classes/es/class_packedfloat32array.rst b/classes/es/class_packedfloat32array.rst index ce0e158e10..87d514ecfd 100644 --- a/classes/es/class_packedfloat32array.rst +++ b/classes/es/class_packedfloat32array.rst @@ -46,53 +46,53 @@ Métodos .. table:: :widths: auto - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`float`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedFloat32Array`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`float`, before\: :ref:`bool` = true\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear`\ (\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`count`\ (\ value\: :ref:`float`\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedFloat32Array` | :ref:`duplicate`\ (\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`float`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`fill`\ (\ value\: :ref:`float`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`find`\ (\ value\: :ref:`float`, from\: :ref:`int` = 0\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`float`\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`float`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`float`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`reverse`\ (\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`float`, from\: :ref:`int` = -1\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`float`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`size`\ (\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedFloat32Array` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`sort`\ (\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`float`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedFloat32Array`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`float`, before\: :ref:`bool` = true\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear`\ (\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`count`\ (\ value\: :ref:`float`\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedFloat32Array` | :ref:`duplicate`\ (\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`float`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`fill`\ (\ value\: :ref:`float`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`find`\ (\ value\: :ref:`float`, from\: :ref:`int` = 0\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`float`\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`float`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`float`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`reverse`\ (\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`float`, from\: :ref:`int` = -1\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`float`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`size`\ (\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedFloat32Array` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`sort`\ (\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -186,7 +186,7 @@ Añade un **PackedFloat32Array** al final de este array. .. rst-class:: classref-method -:ref:`int` **bsearch**\ (\ value\: :ref:`float`, before\: :ref:`bool` = true\ ) :ref:`🔗` +:ref:`int` **bsearch**\ (\ value\: :ref:`float`, before\: :ref:`bool` = true\ ) |const| :ref:`🔗` Encuentra el índice de un valor existente (o el índice de inserción que mantiene el orden de clasificación, si el valor aún no está presente en el array) utilizando la búsqueda binaria. Opcionalmente, se puede pasar un especificador ``before``. Si es ``false``, el índice devuelto aparece después de todas las entradas existentes del valor en el array. @@ -228,7 +228,7 @@ Devuelve el número de veces que un elemento está en el array. .. rst-class:: classref-method -:ref:`PackedFloat32Array` **duplicate**\ (\ ) :ref:`🔗` +:ref:`PackedFloat32Array` **duplicate**\ (\ ) |const| :ref:`🔗` Creates a copy of the array, and returns it. @@ -282,9 +282,9 @@ Busca un valor en el array y devuelve su índice o ``-1`` si no lo encuentra. Op :ref:`float` **get**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve el float de 32 bits en el ``index`` dado en el array. Si ``index`` está fuera de los límites o es negativo, este método falla y devuelve ``0.0``. +Returns the 32-bit float at the given ``index`` in the array. If ``index`` is out-of-bounds or negative, this method fails and returns ``0.0``. -Este método es similar (pero no idéntico) al operador ``[]``. Lo más notable es que, cuando este método falla, no pausa la ejecución del proyecto si se ejecuta desde el editor. +This method is similar (but not identical) to the ``[]`` operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor. .. rst-class:: classref-item-separator diff --git a/classes/es/class_packedfloat64array.rst b/classes/es/class_packedfloat64array.rst index ecf1bbeed4..8e746645cc 100644 --- a/classes/es/class_packedfloat64array.rst +++ b/classes/es/class_packedfloat64array.rst @@ -48,53 +48,53 @@ Métodos .. table:: :widths: auto - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`float`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedFloat64Array`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`float`, before\: :ref:`bool` = true\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear`\ (\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`count`\ (\ value\: :ref:`float`\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedFloat64Array` | :ref:`duplicate`\ (\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`float`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`fill`\ (\ value\: :ref:`float`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`find`\ (\ value\: :ref:`float`, from\: :ref:`int` = 0\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`float`\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`float`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`float`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`reverse`\ (\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`float`, from\: :ref:`int` = -1\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`float`\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`size`\ (\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedFloat64Array` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`sort`\ (\ ) | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | - +-----------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`float`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedFloat64Array`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`float`, before\: :ref:`bool` = true\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear`\ (\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`count`\ (\ value\: :ref:`float`\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedFloat64Array` | :ref:`duplicate`\ (\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`float`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`fill`\ (\ value\: :ref:`float`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`find`\ (\ value\: :ref:`float`, from\: :ref:`int` = 0\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`float`\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`float`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`float`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`reverse`\ (\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`float`, from\: :ref:`int` = -1\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`float`\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`size`\ (\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedFloat64Array` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`sort`\ (\ ) | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | + +-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -188,7 +188,7 @@ Añade un **PackedFloat64Array** al final de este array. .. rst-class:: classref-method -:ref:`int` **bsearch**\ (\ value\: :ref:`float`, before\: :ref:`bool` = true\ ) :ref:`🔗` +:ref:`int` **bsearch**\ (\ value\: :ref:`float`, before\: :ref:`bool` = true\ ) |const| :ref:`🔗` Encuentra el índice de un valor existente (o el índice de inserción que mantiene el orden de clasificación, si el valor aún no está presente en el array) utilizando la búsqueda binaria. Opcionalmente, se puede pasar un especificador ``before``. Si es ``false``, el índice devuelto aparece después de todas las entradas existentes del valor en el array. @@ -230,7 +230,7 @@ Devuelve el número de veces que un elemento está en el array. .. rst-class:: classref-method -:ref:`PackedFloat64Array` **duplicate**\ (\ ) :ref:`🔗` +:ref:`PackedFloat64Array` **duplicate**\ (\ ) |const| :ref:`🔗` Creates a copy of the array, and returns it. @@ -284,9 +284,9 @@ Busca un valor en el array y devuelve su índice o ``-1`` si no lo encuentra. Op :ref:`float` **get**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve el float de 64 bits en el ``index`` dado en el array. Si ``index`` está fuera de los límites o es negativo, este método falla y devuelve ``0.0``. +Returns the 64-bit float at the given ``index`` in the array. If ``index`` is out-of-bounds or negative, this method fails and returns ``0.0``. -Este método es similar (pero no idéntico) al operador ``[]``. Lo más notable es que, cuando este método falla, no pausa la ejecución del proyecto si se ejecuta desde el editor. +This method is similar (but not identical) to the ``[]`` operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor. .. rst-class:: classref-item-separator diff --git a/classes/es/class_packedint32array.rst b/classes/es/class_packedint32array.rst index 46e3348428..0ee2a55171 100644 --- a/classes/es/class_packedint32array.rst +++ b/classes/es/class_packedint32array.rst @@ -46,53 +46,53 @@ Métodos .. table:: :widths: auto - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedInt32Array`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`int`, before\: :ref:`bool` = true\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear`\ (\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`count`\ (\ value\: :ref:`int`\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedInt32Array` | :ref:`duplicate`\ (\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`fill`\ (\ value\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`find`\ (\ value\: :ref:`int`, from\: :ref:`int` = 0\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`int`\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`reverse`\ (\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`int`, from\: :ref:`int` = -1\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`size`\ (\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedInt32Array` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`sort`\ (\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedInt32Array`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`int`, before\: :ref:`bool` = true\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear`\ (\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`count`\ (\ value\: :ref:`int`\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedInt32Array` | :ref:`duplicate`\ (\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`fill`\ (\ value\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`find`\ (\ value\: :ref:`int`, from\: :ref:`int` = 0\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`int`\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`reverse`\ (\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`int`, from\: :ref:`int` = -1\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`size`\ (\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedInt32Array` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`sort`\ (\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -186,7 +186,7 @@ Añade un **PackedInt32Array** al final de este array. .. rst-class:: classref-method -:ref:`int` **bsearch**\ (\ value\: :ref:`int`, before\: :ref:`bool` = true\ ) :ref:`🔗` +:ref:`int` **bsearch**\ (\ value\: :ref:`int`, before\: :ref:`bool` = true\ ) |const| :ref:`🔗` Encuentra el índice de un valor existente (o el índice de inserción que mantiene el orden de clasificación, si el valor aún no está presente en el array) utilizando la búsqueda binaria. Opcionalmente, se puede pasar un especificador ``before``. Si es ``false``, el índice devuelto viene después de todas las entradas existentes del valor en el array. @@ -224,7 +224,7 @@ Devuelve el numer de veces que un elemento es encuentra en el array. .. rst-class:: classref-method -:ref:`PackedInt32Array` **duplicate**\ (\ ) :ref:`🔗` +:ref:`PackedInt32Array` **duplicate**\ (\ ) |const| :ref:`🔗` Creates a copy of the array, and returns it. @@ -274,9 +274,9 @@ Busca un valor en el array y devuelve su índice o ``-1`` si no lo encuentra. Op :ref:`int` **get**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve el entero de 32 bits en el ``index`` dado en el array. Si ``index`` está fuera de los límites o es negativo, este método falla y devuelve ``0``. +Returns the 32-bit integer at the given ``index`` in the array. If ``index`` is out-of-bounds or negative, this method fails and returns ``0``. -Este método es similar (pero no idéntico) al operador ``[]``. Lo más notable es que, cuando este método falla, no pausa la ejecución del proyecto si se ejecuta desde el editor. +This method is similar (but not identical) to the ``[]`` operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor. .. rst-class:: classref-item-separator diff --git a/classes/es/class_packedint64array.rst b/classes/es/class_packedint64array.rst index 758734485f..35a4ab61cf 100644 --- a/classes/es/class_packedint64array.rst +++ b/classes/es/class_packedint64array.rst @@ -48,53 +48,53 @@ Métodos .. table:: :widths: auto - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedInt64Array`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`int`, before\: :ref:`bool` = true\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear`\ (\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`count`\ (\ value\: :ref:`int`\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedInt64Array` | :ref:`duplicate`\ (\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`fill`\ (\ value\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`find`\ (\ value\: :ref:`int`, from\: :ref:`int` = 0\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`int`\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`reverse`\ (\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`int`, from\: :ref:`int` = -1\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`int`\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`size`\ (\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedInt64Array` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`sort`\ (\ ) | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | - +-------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+ + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedInt64Array`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`int`, before\: :ref:`bool` = true\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear`\ (\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`count`\ (\ value\: :ref:`int`\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedInt64Array` | :ref:`duplicate`\ (\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`fill`\ (\ value\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`find`\ (\ value\: :ref:`int`, from\: :ref:`int` = 0\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`int`\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`reverse`\ (\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`int`, from\: :ref:`int` = -1\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`int`\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`size`\ (\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedInt64Array` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`sort`\ (\ ) | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | + +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -188,7 +188,7 @@ Appends a **PackedInt64Array** at the end of this array. .. rst-class:: classref-method -:ref:`int` **bsearch**\ (\ value\: :ref:`int`, before\: :ref:`bool` = true\ ) :ref:`🔗` +:ref:`int` **bsearch**\ (\ value\: :ref:`int`, before\: :ref:`bool` = true\ ) |const| :ref:`🔗` Encuentra el índice de un valor existente (o el índice de inserción que mantiene el orden de clasificación, si el valor aún no está presente en el array) utilizando la búsqueda binaria. Opcionalmente, se puede pasar un especificador ``before``. Si es ``false``, el índice devuelto viene después de todas las entradas existentes del valor en el array. @@ -226,7 +226,7 @@ Devuelve el numer de veces que un elemento es encuentra en el array. .. rst-class:: classref-method -:ref:`PackedInt64Array` **duplicate**\ (\ ) :ref:`🔗` +:ref:`PackedInt64Array` **duplicate**\ (\ ) |const| :ref:`🔗` Creates a copy of the array, and returns it. @@ -276,7 +276,7 @@ Busca un valor en el array y devuelve su índice o ``-1`` si no lo encuentra. Op :ref:`int` **get**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Returns the 64-bit integer at the given ``index`` in the array. If ``index`` out-of-bounds or negative, this method fails and returns ``0``. +Returns the 64-bit integer at the given ``index`` in the array. If ``index`` is out-of-bounds or negative, this method fails and returns ``0``. This method is similar (but not identical) to the ``[]`` operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor. diff --git a/classes/es/class_packedstringarray.rst b/classes/es/class_packedstringarray.rst index e14333851b..9ee091766d 100644 --- a/classes/es/class_packedstringarray.rst +++ b/classes/es/class_packedstringarray.rst @@ -61,53 +61,53 @@ Métodos .. table:: :widths: auto - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`String`\ ) | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedStringArray`\ ) | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`String`, before\: :ref:`bool` = true\ ) | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear`\ (\ ) | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`count`\ (\ value\: :ref:`String`\ ) |const| | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`duplicate`\ (\ ) | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`String`\ ) | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`fill`\ (\ value\: :ref:`String`\ ) | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`find`\ (\ value\: :ref:`String`, from\: :ref:`int` = 0\ ) |const| | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`String`\ ) |const| | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`String`\ ) | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`String`\ ) | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`reverse`\ (\ ) | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`String`, from\: :ref:`int` = -1\ ) |const| | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`String`\ ) | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`size`\ (\ ) |const| | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`sort`\ (\ ) | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | - +---------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`String`\ ) | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedStringArray`\ ) | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`String`, before\: :ref:`bool` = true\ ) |const| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear`\ (\ ) | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`count`\ (\ value\: :ref:`String`\ ) |const| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`duplicate`\ (\ ) |const| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`String`\ ) | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`fill`\ (\ value\: :ref:`String`\ ) | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`find`\ (\ value\: :ref:`String`, from\: :ref:`int` = 0\ ) |const| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`String`\ ) |const| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`String`\ ) | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`String`\ ) | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`reverse`\ (\ ) | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`String`, from\: :ref:`int` = -1\ ) |const| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`String`\ ) | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`size`\ (\ ) |const| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`sort`\ (\ ) | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | + +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -201,7 +201,7 @@ Añade un **PackedStringArray** al final de este array. .. rst-class:: classref-method -:ref:`int` **bsearch**\ (\ value\: :ref:`String`, before\: :ref:`bool` = true\ ) :ref:`🔗` +:ref:`int` **bsearch**\ (\ value\: :ref:`String`, before\: :ref:`bool` = true\ ) |const| :ref:`🔗` Encuentra el índice de un valor existente (o el índice de inserción que mantiene el orden de clasificación, si el valor aún no está presente en el array) utilizando la búsqueda binaria. Opcionalmente, se puede pasar un especificador ``before``. Si es ``false``, el índice devuelto viene después de todas las entradas existentes del valor en el array. @@ -239,7 +239,7 @@ Devuelve el numer de veces que un elemento es encuentra en el array. .. rst-class:: classref-method -:ref:`PackedStringArray` **duplicate**\ (\ ) :ref:`🔗` +:ref:`PackedStringArray` **duplicate**\ (\ ) |const| :ref:`🔗` Creates a copy of the array, and returns it. @@ -289,9 +289,9 @@ Busca un valor en el array y devuelve su índice o ``-1`` si no lo encuentra. Op :ref:`String` **get**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Returns the :ref:`String` at the given ``index`` in the array. Returns an empty string and prints an error if the access is out of bounds. Negative indices are not supported; they will always consider the value to be out of bounds and return an empty string. +Returns the :ref:`String` at the given ``index`` in the array. If ``index`` is out-of-bounds or negative, this method fails and returns an empty string. -This is similar to using the ``[]`` operator (``array[index]``), except that operator supports negative indices and causes a debugger break if out-of-bounds access is performed. +This method is similar (but not identical) to the ``[]`` operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor. .. rst-class:: classref-item-separator diff --git a/classes/es/class_packedvector2array.rst b/classes/es/class_packedvector2array.rst index 99f773c9dc..11ffa50920 100644 --- a/classes/es/class_packedvector2array.rst +++ b/classes/es/class_packedvector2array.rst @@ -53,53 +53,53 @@ Métodos .. table:: :widths: auto - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`Vector2`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedVector2Array`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`Vector2`, before\: :ref:`bool` = true\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear`\ (\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`count`\ (\ value\: :ref:`Vector2`\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedVector2Array` | :ref:`duplicate`\ (\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`Vector2`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`fill`\ (\ value\: :ref:`Vector2`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`find`\ (\ value\: :ref:`Vector2`, from\: :ref:`int` = 0\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Vector2` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`Vector2`\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`Vector2`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`Vector2`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`reverse`\ (\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`Vector2`, from\: :ref:`int` = -1\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`Vector2`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`size`\ (\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedVector2Array` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`sort`\ (\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`Vector2`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedVector2Array`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`Vector2`, before\: :ref:`bool` = true\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear`\ (\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`count`\ (\ value\: :ref:`Vector2`\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedVector2Array` | :ref:`duplicate`\ (\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`Vector2`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`fill`\ (\ value\: :ref:`Vector2`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`find`\ (\ value\: :ref:`Vector2`, from\: :ref:`int` = 0\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Vector2` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`Vector2`\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`Vector2`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`Vector2`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`reverse`\ (\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`Vector2`, from\: :ref:`int` = -1\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`Vector2`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`size`\ (\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedVector2Array` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`sort`\ (\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -201,7 +201,7 @@ Añade un **PackedVector2Array** al final de este array. .. rst-class:: classref-method -:ref:`int` **bsearch**\ (\ value\: :ref:`Vector2`, before\: :ref:`bool` = true\ ) :ref:`🔗` +:ref:`int` **bsearch**\ (\ value\: :ref:`Vector2`, before\: :ref:`bool` = true\ ) |const| :ref:`🔗` Finds the index of an existing value (or the insertion index that maintains sorting order, if the value is not yet present in the array) using binary search. Optionally, a ``before`` specifier can be passed. If ``false``, the returned index comes after all existing entries of the value in the array. @@ -243,7 +243,7 @@ Returns the number of times an element is in the array. .. rst-class:: classref-method -:ref:`PackedVector2Array` **duplicate**\ (\ ) :ref:`🔗` +:ref:`PackedVector2Array` **duplicate**\ (\ ) |const| :ref:`🔗` Creates a copy of the array, and returns it. @@ -297,7 +297,7 @@ Searches the array for a value and returns its index or ``-1`` if not found. Opt :ref:`Vector2` **get**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Returns the :ref:`Vector2` at the given ``index`` in the array. If ``index`` out-of-bounds or negative, this method fails and returns ``Vector2(0, 0)``. +Returns the :ref:`Vector2` at the given ``index`` in the array. If ``index`` is out-of-bounds or negative, this method fails and returns ``Vector2(0, 0)``. This method is similar (but not identical) to the ``[]`` operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor. diff --git a/classes/es/class_packedvector3array.rst b/classes/es/class_packedvector3array.rst index 9c5a82fafa..766594805e 100644 --- a/classes/es/class_packedvector3array.rst +++ b/classes/es/class_packedvector3array.rst @@ -46,53 +46,53 @@ Métodos .. table:: :widths: auto - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`Vector3`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedVector3Array`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`Vector3`, before\: :ref:`bool` = true\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear`\ (\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`count`\ (\ value\: :ref:`Vector3`\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedVector3Array` | :ref:`duplicate`\ (\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`Vector3`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`fill`\ (\ value\: :ref:`Vector3`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`find`\ (\ value\: :ref:`Vector3`, from\: :ref:`int` = 0\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Vector3` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`Vector3`\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`Vector3`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`Vector3`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`reverse`\ (\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`Vector3`, from\: :ref:`int` = -1\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`Vector3`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`size`\ (\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedVector3Array` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`sort`\ (\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`Vector3`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedVector3Array`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`Vector3`, before\: :ref:`bool` = true\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear`\ (\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`count`\ (\ value\: :ref:`Vector3`\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedVector3Array` | :ref:`duplicate`\ (\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`Vector3`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`fill`\ (\ value\: :ref:`Vector3`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`find`\ (\ value\: :ref:`Vector3`, from\: :ref:`int` = 0\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Vector3` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`Vector3`\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`Vector3`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`Vector3`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`reverse`\ (\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`Vector3`, from\: :ref:`int` = -1\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`Vector3`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`size`\ (\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedVector3Array` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`sort`\ (\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -194,7 +194,7 @@ Añade un **PackedVector3Array** al final de este array. .. rst-class:: classref-method -:ref:`int` **bsearch**\ (\ value\: :ref:`Vector3`, before\: :ref:`bool` = true\ ) :ref:`🔗` +:ref:`int` **bsearch**\ (\ value\: :ref:`Vector3`, before\: :ref:`bool` = true\ ) |const| :ref:`🔗` Finds the index of an existing value (or the insertion index that maintains sorting order, if the value is not yet present in the array) using binary search. Optionally, a ``before`` specifier can be passed. If ``false``, the returned index comes after all existing entries of the value in the array. @@ -236,7 +236,7 @@ Returns the number of times an element is in the array. .. rst-class:: classref-method -:ref:`PackedVector3Array` **duplicate**\ (\ ) :ref:`🔗` +:ref:`PackedVector3Array` **duplicate**\ (\ ) |const| :ref:`🔗` Creates a copy of the array, and returns it. @@ -290,9 +290,9 @@ Searches the array for a value and returns its index or ``-1`` if not found. Opt :ref:`Vector3` **get**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve el :ref:`Vector3` en el ``index`` dado en el array. Si ``index`` está fuera de los límites o es negativo, este método falla y devuelve ``Vector3(0, 0, 0)``. +Returns the :ref:`Vector3` at the given ``index`` in the array. If ``index`` is out-of-bounds or negative, this method fails and returns ``Vector3(0, 0, 0)``. -Este método es similar (pero no idéntico) al operador ``[]``. En particular, cuando este método falla, no pausa la ejecución del proyecto si se ejecuta desde el editor. +This method is similar (but not identical) to the ``[]`` operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor. .. rst-class:: classref-item-separator diff --git a/classes/es/class_packedvector4array.rst b/classes/es/class_packedvector4array.rst index 643f0bc4dd..6f7df3d667 100644 --- a/classes/es/class_packedvector4array.rst +++ b/classes/es/class_packedvector4array.rst @@ -46,53 +46,53 @@ Métodos .. table:: :widths: auto - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`Vector4`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedVector4Array`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`Vector4`, before\: :ref:`bool` = true\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear`\ (\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`count`\ (\ value\: :ref:`Vector4`\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedVector4Array` | :ref:`duplicate`\ (\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`Vector4`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`fill`\ (\ value\: :ref:`Vector4`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`find`\ (\ value\: :ref:`Vector4`, from\: :ref:`int` = 0\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Vector4` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`Vector4`\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`Vector4`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`Vector4`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`reverse`\ (\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`Vector4`, from\: :ref:`int` = -1\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`Vector4`\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`size`\ (\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedVector4Array` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`sort`\ (\ ) | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | - +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+ + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`append`\ (\ value\: :ref:`Vector4`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`append_array`\ (\ array\: :ref:`PackedVector4Array`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`bsearch`\ (\ value\: :ref:`Vector4`, before\: :ref:`bool` = true\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear`\ (\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`count`\ (\ value\: :ref:`Vector4`\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedVector4Array` | :ref:`duplicate`\ (\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`erase`\ (\ value\: :ref:`Vector4`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`fill`\ (\ value\: :ref:`Vector4`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`find`\ (\ value\: :ref:`Vector4`, from\: :ref:`int` = 0\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Vector4` | :ref:`get`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has`\ (\ value\: :ref:`Vector4`\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`insert`\ (\ at_index\: :ref:`int`, value\: :ref:`Vector4`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_empty`\ (\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`push_back`\ (\ value\: :ref:`Vector4`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_at`\ (\ index\: :ref:`int`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`resize`\ (\ new_size\: :ref:`int`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`reverse`\ (\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`rfind`\ (\ value\: :ref:`Vector4`, from\: :ref:`int` = -1\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set`\ (\ index\: :ref:`int`, value\: :ref:`Vector4`\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`size`\ (\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedVector4Array` | :ref:`slice`\ (\ begin\: :ref:`int`, end\: :ref:`int` = 2147483647\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`sort`\ (\ ) | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedByteArray` | :ref:`to_byte_array`\ (\ ) |const| | + +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -192,7 +192,7 @@ Añade un **PackedVector4Array** al final de este array. .. rst-class:: classref-method -:ref:`int` **bsearch**\ (\ value\: :ref:`Vector4`, before\: :ref:`bool` = true\ ) :ref:`🔗` +:ref:`int` **bsearch**\ (\ value\: :ref:`Vector4`, before\: :ref:`bool` = true\ ) |const| :ref:`🔗` Finds the index of an existing value (or the insertion index that maintains sorting order, if the value is not yet present in the array) using binary search. Optionally, a ``before`` specifier can be passed. If ``false``, the returned index comes after all existing entries of the value in the array. @@ -234,7 +234,7 @@ Returns the number of times an element is in the array. .. rst-class:: classref-method -:ref:`PackedVector4Array` **duplicate**\ (\ ) :ref:`🔗` +:ref:`PackedVector4Array` **duplicate**\ (\ ) |const| :ref:`🔗` Creates a copy of the array, and returns it. @@ -288,7 +288,7 @@ Searches the array for a value and returns its index or ``-1`` if not found. Opt :ref:`Vector4` **get**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Returns the :ref:`Vector4` at the given ``index`` in the array. If ``index`` out-of-bounds or negative, this method fails and returns ``Vector4(0, 0, 0, 0)``. +Returns the :ref:`Vector4` at the given ``index`` in the array. If ``index`` is out-of-bounds or negative, this method fails and returns ``Vector4(0, 0, 0, 0)``. This method is similar (but not identical) to the ``[]`` operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor. diff --git a/classes/es/class_particleprocessmaterial.rst b/classes/es/class_particleprocessmaterial.rst index 64586be4dc..bf9194e33a 100644 --- a/classes/es/class_particleprocessmaterial.rst +++ b/classes/es/class_particleprocessmaterial.rst @@ -704,7 +704,7 @@ Descripciones de Propiedades The alpha value of each particle's color will be multiplied by this :ref:`CurveTexture` over its lifetime. -\ **Note:** :ref:`alpha_curve` multiplies the particle mesh's vertex colors. To have a visible effect on a :ref:`BaseMaterial3D`, :ref:`BaseMaterial3D.vertex_color_use_as_albedo` *must* be ``true``. For a :ref:`ShaderMaterial`, ``ALBEDO *= COLOR.rgb;`` must be inserted in the shader's ``fragment()`` function. Otherwise, :ref:`alpha_curve` will have no visible effect. +\ **Note:** :ref:`alpha_curve` multiplies the particle mesh's vertex colors. To have a visible effect on a :ref:`BaseMaterial3D`, :ref:`BaseMaterial3D.vertex_color_use_as_albedo` *must* be ``true``. For a :ref:`ShaderMaterial`, ``ALPHA *= COLOR.a;`` must be inserted in the shader's ``fragment()`` function. Otherwise, :ref:`alpha_curve` will have no visible effect. .. rst-class:: classref-item-separator diff --git a/classes/es/class_path3d.rst b/classes/es/class_path3d.rst index d29627426b..b48826da2e 100644 --- a/classes/es/class_path3d.rst +++ b/classes/es/class_path3d.rst @@ -98,9 +98,7 @@ Una :ref:`Curve3D` que describe el camino. - |void| **set_debug_custom_color**\ (\ value\: :ref:`Color`\ ) - :ref:`Color` **get_debug_custom_color**\ (\ ) -El color personalizado que se usará para dibujar la forma en el editor. - -Si se establece en ``Color(0.0, 0.0, 0.0)`` (por defecto), se usa el color definido en EditorSettings. +The custom color used to draw the path in the editor. If set to :ref:`Color.BLACK` (as by default), the color set in :ref:`ProjectSettings.debug/shapes/paths/geometry_color` is used. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_performance.rst b/classes/es/class_performance.rst index dde6062730..8a04b3312f 100644 --- a/classes/es/class_performance.rst +++ b/classes/es/class_performance.rst @@ -32,21 +32,23 @@ Métodos .. table:: :widths: auto - +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`add_custom_monitor`\ (\ id\: :ref:`StringName`, callable\: :ref:`Callable`, arguments\: :ref:`Array` = []\ ) | - +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Variant` | :ref:`get_custom_monitor`\ (\ id\: :ref:`StringName`\ ) | - +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`StringName`\] | :ref:`get_custom_monitor_names`\ (\ ) | - +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get_monitor`\ (\ monitor\: :ref:`Monitor`\ ) |const| | - +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_monitor_modification_time`\ (\ ) | - +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has_custom_monitor`\ (\ id\: :ref:`StringName`\ ) | - +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`remove_custom_monitor`\ (\ id\: :ref:`StringName`\ ) | - +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`add_custom_monitor`\ (\ id\: :ref:`StringName`, callable\: :ref:`Callable`, arguments\: :ref:`Array` = [], type\: :ref:`MonitorType` = 0\ ) | + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Variant` | :ref:`get_custom_monitor`\ (\ id\: :ref:`StringName`\ ) | + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Array`\[:ref:`StringName`\] | :ref:`get_custom_monitor_names`\ (\ ) | + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedInt32Array` | :ref:`get_custom_monitor_types`\ (\ ) | + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_monitor`\ (\ monitor\: :ref:`Monitor`\ ) |const| | + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_monitor_modification_time`\ (\ ) | + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_custom_monitor`\ (\ id\: :ref:`StringName`\ ) | + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_custom_monitor`\ (\ id\: :ref:`StringName`\ ) | + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -149,7 +151,9 @@ Número de nodos actualmente instanciados en el árbol de escenas. Esto también :ref:`Monitor` **OBJECT_ORPHAN_NODE_COUNT** = ``10`` -Número de nodos huérfanos, es decir, nodos que no están engendrados en un nodo del árbol de escenas. *Cuanto más bajo, mejor.* +Number of orphan nodes, i.e. nodes which are not parented to a node of the scene tree. *Lower is better.*\ + +\ **Note:** This is only available in debug mode and will always return ``0`` when used in a project exported in release mode. .. _class_Performance_constant_RENDER_TOTAL_OBJECTS_IN_FRAME: @@ -261,7 +265,7 @@ Output latency of the :ref:`AudioServer`. Equivalent to calli :ref:`Monitor` **NAVIGATION_ACTIVE_MAPS** = ``24`` -Number of active navigation maps in :ref:`NavigationServer2D` and :ref:`NavigationServer3D`. This also includes the two empty default navigation maps created by World2D and World3D. +Number of active navigation maps in :ref:`NavigationServer2D` and :ref:`NavigationServer3D`. This also includes the empty default navigation maps created by :ref:`World2D` and :ref:`World3D` instances. .. _class_Performance_constant_NAVIGATION_REGION_COUNT: @@ -381,7 +385,7 @@ Number of pipeline compilations that were triggered to optimize the current scen :ref:`Monitor` **NAVIGATION_2D_ACTIVE_MAPS** = ``39`` -Number of active navigation maps in the :ref:`NavigationServer2D`. This also includes the two empty default navigation maps created by World2D. +Number of active navigation maps in the :ref:`NavigationServer2D`. This also includes the empty default navigation maps created by :ref:`World2D` instances. .. _class_Performance_constant_NAVIGATION_2D_REGION_COUNT: @@ -461,7 +465,7 @@ Número de obstáculos de navegación activos en el :ref:`NavigationServer2D` **NAVIGATION_3D_ACTIVE_MAPS** = ``49`` -Número de mapas de navegación activos en el :ref:`NavigationServer3D`. Esto también incluye los dos mapas de navegación predeterminados vacíos creados por World3D. +Number of active navigation maps in the :ref:`NavigationServer3D`. This also includes the empty default navigation maps created by :ref:`World3D` instances. .. _class_Performance_constant_NAVIGATION_3D_REGION_COUNT: @@ -543,6 +547,48 @@ Número de obstáculos de navegación activos en el :ref:`NavigationServer3D`. +.. rst-class:: classref-item-separator + +---- + +.. _enum_Performance_MonitorType: + +.. rst-class:: classref-enumeration + +enum **MonitorType**: :ref:`🔗` + +.. _class_Performance_constant_MONITOR_TYPE_QUANTITY: + +.. rst-class:: classref-enumeration-constant + +:ref:`MonitorType` **MONITOR_TYPE_QUANTITY** = ``0`` + +Monitor output is formatted as an integer value. + +.. _class_Performance_constant_MONITOR_TYPE_MEMORY: + +.. rst-class:: classref-enumeration-constant + +:ref:`MonitorType` **MONITOR_TYPE_MEMORY** = ``1`` + +Monitor output is formatted as computer memory. Submitted values should represent a number of bytes. + +.. _class_Performance_constant_MONITOR_TYPE_TIME: + +.. rst-class:: classref-enumeration-constant + +:ref:`MonitorType` **MONITOR_TYPE_TIME** = ``2`` + +Monitor output is formatted as time in milliseconds. Submitted values should represent a time in seconds (not milliseconds). + +.. _class_Performance_constant_MONITOR_TYPE_PERCENTAGE: + +.. rst-class:: classref-enumeration-constant + +:ref:`MonitorType` **MONITOR_TYPE_PERCENTAGE** = ``3`` + +Monitor output is formatted as a percentage. Submitted values should represent a fractional value rather than the percentage directly, e.g. ``0.5`` for ``50.00%``. + .. rst-class:: classref-section-separator ---- @@ -556,7 +602,7 @@ Descripciones de Métodos .. rst-class:: classref-method -|void| **add_custom_monitor**\ (\ id\: :ref:`StringName`, callable\: :ref:`Callable`, arguments\: :ref:`Array` = []\ ) :ref:`🔗` +|void| **add_custom_monitor**\ (\ id\: :ref:`StringName`, callable\: :ref:`Callable`, arguments\: :ref:`Array` = [], type\: :ref:`MonitorType` = 0\ ) :ref:`🔗` Adds a custom monitor with the name ``id``. You can specify the category of the monitor using slash delimiters in ``id`` (for example: ``"Game/NumberOfNPCs"``). If there is more than one slash delimiter, then the default category is used. The default category is ``"Custom"``. Prints an error if given ``id`` is already present. @@ -644,6 +690,18 @@ Returns the names of active custom monitors in an :ref:`Array`. ---- +.. _class_Performance_method_get_custom_monitor_types: + +.. rst-class:: classref-method + +:ref:`PackedInt32Array` **get_custom_monitor_types**\ (\ ) :ref:`🔗` + +Returns the :ref:`MonitorType` values of active custom monitors in an :ref:`Array`. + +.. rst-class:: classref-item-separator + +---- + .. _class_Performance_method_get_monitor: .. rst-class:: classref-method diff --git a/classes/es/class_physicalbone3d.rst b/classes/es/class_physicalbone3d.rst index 0e22a960f8..e759e9b1d9 100644 --- a/classes/es/class_physicalbone3d.rst +++ b/classes/es/class_physicalbone3d.rst @@ -21,6 +21,13 @@ El nodo **PhysicalBone3D** es un cuerpo físico que se puede utilizar para hacer \ **Nota:** Para detectar huesos físicos con raycasts, la propiedad :ref:`SkeletonModifier3D.active` del padre :ref:`PhysicalBoneSimulator3D` debe ser ``true`` y el hueso del :ref:`Skeleton3D` debe ser asignado al **PhysicalBone3D** correctamente; esto significa que :ref:`get_bone_id()` debe devolver un ID válido (``>= 0``). +.. rst-class:: classref-introduction-group + +Tutoriales +-------------------- + +- :doc:`Ragdoll System <../tutorials/physics/ragdoll_system>` + .. rst-class:: classref-reftable-group Propiedades diff --git a/classes/es/class_physicsserver3d.rst b/classes/es/class_physicsserver3d.rst index 17cfb4eecc..b13cb71d8e 100644 --- a/classes/es/class_physicsserver3d.rst +++ b/classes/es/class_physicsserver3d.rst @@ -1159,7 +1159,7 @@ enum **ShapeType**: :ref:`🔗` :ref:`ShapeType` **SHAPE_WORLD_BOUNDARY** = ``0`` -La :ref:`Shape3D` es una :ref:`WorldBoundaryShape3D`. +Constant for creating a world boundary shape (used by the :ref:`WorldBoundaryShape3D` resource). .. _class_PhysicsServer3D_constant_SHAPE_SEPARATION_RAY: @@ -1167,7 +1167,7 @@ La :ref:`Shape3D` es una :ref:`WorldBoundaryShape3D` **SHAPE_SEPARATION_RAY** = ``1`` -La :ref:`Shape3D` es un :ref:`SeparationRayShape3D`. +Constant for creating a separation ray shape (used by the :ref:`SeparationRayShape3D` resource). .. _class_PhysicsServer3D_constant_SHAPE_SPHERE: @@ -1175,7 +1175,7 @@ La :ref:`Shape3D` es un :ref:`SeparationRayShape3D` **SHAPE_SPHERE** = ``2`` -La :ref:`Shape3D` es una :ref:`SphereShape3D`. +Constant for creating a sphere shape (used by the :ref:`SphereShape3D` resource). .. _class_PhysicsServer3D_constant_SHAPE_BOX: @@ -1183,7 +1183,7 @@ La :ref:`Shape3D` es una :ref:`SphereShape3D :ref:`ShapeType` **SHAPE_BOX** = ``3`` -La :ref:`Shape3D` es una :ref:`BoxShape3D`. +Constant for creating a box shape (used by the :ref:`BoxShape3D` resource). .. _class_PhysicsServer3D_constant_SHAPE_CAPSULE: @@ -1191,7 +1191,7 @@ La :ref:`Shape3D` es una :ref:`BoxShape3D`. :ref:`ShapeType` **SHAPE_CAPSULE** = ``4`` -La :ref:`Shape3D` es una :ref:`CapsuleShape3D`. +Constant for creating a capsule shape (used by the :ref:`CapsuleShape3D` resource). .. _class_PhysicsServer3D_constant_SHAPE_CYLINDER: @@ -1199,7 +1199,7 @@ La :ref:`Shape3D` es una :ref:`CapsuleShape3D` **SHAPE_CYLINDER** = ``5`` -La :ref:`Shape3D` es una :ref:`CylinderShape3D`. +Constant for creating a cylinder shape (used by the :ref:`CylinderShape3D` resource). .. _class_PhysicsServer3D_constant_SHAPE_CONVEX_POLYGON: @@ -1207,7 +1207,7 @@ La :ref:`Shape3D` es una :ref:`CylinderShape3D` **SHAPE_CONVEX_POLYGON** = ``6`` -La :ref:`Shape3D` es una :ref:`ConvexPolygonShape3D`. +Constant for creating a convex polygon shape (used by the :ref:`ConvexPolygonShape3D` resource). .. _class_PhysicsServer3D_constant_SHAPE_CONCAVE_POLYGON: @@ -1215,7 +1215,7 @@ La :ref:`Shape3D` es una :ref:`ConvexPolygonShape3D` **SHAPE_CONCAVE_POLYGON** = ``7`` -La :ref:`Shape3D` es una :ref:`ConcavePolygonShape3D`. +Constant for creating a concave polygon (trimesh) shape (used by the :ref:`ConcavePolygonShape3D` resource). .. _class_PhysicsServer3D_constant_SHAPE_HEIGHTMAP: @@ -1223,7 +1223,7 @@ La :ref:`Shape3D` es una :ref:`ConcavePolygonShape3D` **SHAPE_HEIGHTMAP** = ``8`` -El :ref:`Shape3D` es una :ref:`HeightMapShape3D`. +Constant for creating a heightmap shape (used by the :ref:`HeightMapShape3D` resource). .. _class_PhysicsServer3D_constant_SHAPE_SOFT_BODY: @@ -1231,7 +1231,7 @@ El :ref:`Shape3D` es una :ref:`HeightMapShape3D` **SHAPE_SOFT_BODY** = ``9`` -The :ref:`Shape3D` is used internally for a soft body. Any attempt to create this kind of shape results in an error. +Constant used internally for a soft body shape. Any attempt to create this kind of shape results in an error. .. _class_PhysicsServer3D_constant_SHAPE_CUSTOM: @@ -1239,7 +1239,7 @@ The :ref:`Shape3D` is used internally for a soft body. Any attemp :ref:`ShapeType` **SHAPE_CUSTOM** = ``10`` -Esta constante es utilizada internamente por el motor. Cualquier intento de crear este tipo de forma resulta en un error. +Constant used internally for a custom shape. Any attempt to create this kind of shape results in an error when using Godot Physics or Jolt Physics. .. rst-class:: classref-item-separator @@ -2932,9 +2932,7 @@ Devuelve ``true`` si una colisión resultaría de moverse a lo largo de un vecto :ref:`RID` **box_shape_create**\ (\ ) :ref:`🔗` -.. container:: contribute - - There is currently no description for this method. Please help us by `contributing one `__! +Creates a 3D box shape in the physics server, and returns the :ref:`RID` that identifies it. Use :ref:`shape_set_data()` to set the box's half-extents. .. rst-class:: classref-item-separator @@ -2946,9 +2944,7 @@ Devuelve ``true`` si una colisión resultaría de moverse a lo largo de un vecto :ref:`RID` **capsule_shape_create**\ (\ ) :ref:`🔗` -.. container:: contribute - - There is currently no description for this method. Please help us by `contributing one `__! +Creates a 3D capsule shape in the physics server, and returns the :ref:`RID` that identifies it. Use :ref:`shape_set_data()` to set the capsule's height and radius. .. rst-class:: classref-item-separator @@ -2960,9 +2956,7 @@ Devuelve ``true`` si una colisión resultaría de moverse a lo largo de un vecto :ref:`RID` **concave_polygon_shape_create**\ (\ ) :ref:`🔗` -.. container:: contribute - - There is currently no description for this method. Please help us by `contributing one `__! +Creates a 3D concave polygon shape in the physics server, and returns the :ref:`RID` that identifies it. Use :ref:`shape_set_data()` to set the concave polygon's triangles. .. rst-class:: classref-item-separator @@ -2998,9 +2992,7 @@ Establece un parámetro de la articulación de cono y torsión (cone twist). :ref:`RID` **convex_polygon_shape_create**\ (\ ) :ref:`🔗` -.. container:: contribute - - There is currently no description for this method. Please help us by `contributing one `__! +Creates a 3D convex polygon shape in the physics server, and returns the :ref:`RID` that identifies it. Use :ref:`shape_set_data()` to set the convex polygon's points. .. rst-class:: classref-item-separator @@ -3012,9 +3004,9 @@ Establece un parámetro de la articulación de cono y torsión (cone twist). :ref:`RID` **custom_shape_create**\ (\ ) :ref:`🔗` -.. container:: contribute +Creates a custom shape in the physics server, and returns the :ref:`RID` that identifies it. Use :ref:`shape_set_data()` to set the shape's data. - There is currently no description for this method. Please help us by `contributing one `__! +\ **Note:** Custom shapes are not supported by the built-in physics servers, so calling this method always produces an error when using Godot Physics or Jolt Physics. Custom physics servers implemented as GDExtensions may support a custom shape. .. rst-class:: classref-item-separator @@ -3026,9 +3018,7 @@ Establece un parámetro de la articulación de cono y torsión (cone twist). :ref:`RID` **cylinder_shape_create**\ (\ ) :ref:`🔗` -.. container:: contribute - - There is currently no description for this method. Please help us by `contributing one `__! +Creates a 3D cylinder shape in the physics server, and returns the :ref:`RID` that identifies it. Use :ref:`shape_set_data()` to set the cylinder's height and radius. .. rst-class:: classref-item-separator @@ -3112,9 +3102,7 @@ Devuelve el valor de un estado del motor de física especificado por ``process_i :ref:`RID` **heightmap_shape_create**\ (\ ) :ref:`🔗` -.. container:: contribute - - There is currently no description for this method. Please help us by `contributing one `__! +Creates a 3D heightmap shape in the physics server, and returns the :ref:`RID` that identifies it. Use :ref:`shape_set_data()` to set the heightmap's data. .. rst-class:: classref-item-separator @@ -3402,9 +3390,7 @@ Sets a pin joint parameter. :ref:`RID` **separation_ray_shape_create**\ (\ ) :ref:`🔗` -.. container:: contribute - - There is currently no description for this method. Please help us by `contributing one `__! +Creates a 3D separation ray shape in the physics server, and returns the :ref:`RID` that identifies it. Use :ref:`shape_set_data()` to set the shape's ``length`` and ``slide_on_slope`` properties. .. rst-class:: classref-item-separator @@ -3428,7 +3414,7 @@ Activa o desactiva el motor de física 3D. :ref:`Variant` **shape_get_data**\ (\ shape\: :ref:`RID`\ ) |const| :ref:`🔗` -Devuelve los datos de la forma. +Returns the shape data that configures the shape, such as the half-extents of a box or the triangles of a concave (trimesh) shape. See :ref:`shape_set_data()` for the precise format of this data in each case. .. rst-class:: classref-item-separator @@ -3454,7 +3440,7 @@ Returns the collision margin for the shape. :ref:`ShapeType` **shape_get_type**\ (\ shape\: :ref:`RID`\ ) |const| :ref:`🔗` -Devuelve el tipo de forma. +Devuelve el tipo de la forma. .. rst-class:: classref-item-separator @@ -3466,7 +3452,29 @@ Devuelve el tipo de forma. |void| **shape_set_data**\ (\ shape\: :ref:`RID`, data\: :ref:`Variant`\ ) :ref:`🔗` -Establece los datos de forma que definen su forma y tamaño. Los datos que se pasarán dependen del tipo de forma creada :ref:`shape_get_type()`. +Sets the shape data that configures the shape. The ``data`` to be passed depends on the shape's type (see :ref:`shape_get_type()`): + +- :ref:`SHAPE_WORLD_BOUNDARY`: a :ref:`Plane`, + +- :ref:`SHAPE_SEPARATION_RAY`: a dictionary containing the key ``"length"`` with a :ref:`float` value and the key ``"slide_on_slope"`` with a :ref:`bool` value, + +- :ref:`SHAPE_SPHERE`: a :ref:`float` that is the radius of the sphere, + +- :ref:`SHAPE_BOX`: a :ref:`Vector3` containing the half-extents of the box, + +- :ref:`SHAPE_CAPSULE`: a dictionary containing the keys ``"height"`` and ``"radius"`` with :ref:`float` values, + +- :ref:`SHAPE_CYLINDER`: a dictionary containing the keys ``"height"`` and ``"radius"`` with :ref:`float` values, + +- :ref:`SHAPE_CONVEX_POLYGON`: a :ref:`PackedVector3Array` of points defining a convex polygon (the shape will be the convex hull of the points), + +- :ref:`SHAPE_CONCAVE_POLYGON`: a dictionary containing the key ``"faces"`` with a :ref:`PackedVector3Array` value (with a length divisible by 3, so that each 3-tuple of points forms a face) and the key ``"backface_collision"`` with a :ref:`bool` value, + +- :ref:`SHAPE_HEIGHTMAP`: a dictionary containing the keys ``"width"`` and ``"depth"`` with :ref:`int` values, and the key ``"heights"`` with a value that is a packed array of :ref:`float`\ s of length ``width * depth`` (that is a :ref:`PackedFloat32Array`, or a :ref:`PackedFloat64Array` if Godot was compiled with the ``precision=double`` option), and optionally the keys ``"min_height"`` and ``"max_height"`` with :ref:`float` values, + +- :ref:`SHAPE_SOFT_BODY`: the input ``data`` is ignored and this method has no effect, + +- :ref:`SHAPE_CUSTOM`: the input ``data`` is interpreted by a custom physics server, if it supports custom shapes. .. rst-class:: classref-item-separator @@ -4068,9 +4076,7 @@ Establece el valor de un parámetro espacial. Una lista de los parámetros dispo :ref:`RID` **sphere_shape_create**\ (\ ) :ref:`🔗` -.. container:: contribute - - There is currently no description for this method. Please help us by `contributing one `__! +Creates a 3D sphere shape in the physics server, and returns the :ref:`RID` that identifies it. Use :ref:`shape_set_data()` to set the sphere's radius. .. rst-class:: classref-item-separator @@ -4082,9 +4088,7 @@ Establece el valor de un parámetro espacial. Una lista de los parámetros dispo :ref:`RID` **world_boundary_shape_create**\ (\ ) :ref:`🔗` -.. container:: contribute - - There is currently no description for this method. Please help us by `contributing one `__! +Creates a 3D world boundary shape in the physics server, and returns the :ref:`RID` that identifies it. Use :ref:`shape_set_data()` to set the shape's normal direction and distance properties. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_popup.rst b/classes/es/class_popup.rst index 4a444cabe0..fc35600c2c 100644 --- a/classes/es/class_popup.rst +++ b/classes/es/class_popup.rst @@ -16,7 +16,9 @@ Clase base para ventanas y paneles contextuales con posición fija. Descripción ---------------------- -**Popup** es una clase base para ventanas y paneles contextuales con posición fija. Es modal por defecto (véase :ref:`Window.popup_window`) y proporciona métodos para implementar un comportamiento de popup personalizado. +**Popup** is a base class for contextual windows and panels with fixed position. It's a modal by default (see :ref:`Window.popup_window`) and provides methods for implementing custom popup behavior. + +\ **Note:** **Popup** is invisible by default. To make it visible, call one of the ``popup_*`` methods from :ref:`Window` on the node, such as :ref:`Window.popup_centered_clamped()`. .. rst-class:: classref-reftable-group diff --git a/classes/es/class_popupmenu.rst b/classes/es/class_popupmenu.rst index 79bc42b14d..81ed78166c 100644 --- a/classes/es/class_popupmenu.rst +++ b/classes/es/class_popupmenu.rst @@ -14,15 +14,17 @@ Una ventana modal utilizada para mostrar una lista de opciones. Descripción ---------------------- -**PopupMenu** es una ventana modal utilizada para mostrar una lista de opciones. Util para barras de harramientas y menús contextuales. +**PopupMenu** is a modal window used to display a list of options. Useful for toolbars and context menus. -El tamaño de un **PopupMenu** puede ser limitado utilizando :ref:`Window.max_size`. Si la altura de la lista de items es mayor que la maxima altura de **PopupMenu**, un :ref:`ScrollContainer` dentro del popup va a permitir al usuario desplazarse por el contenido. Si no se configura un tamaño maximo, o si esta seteado a ``0``, la altura de el **PopupMenu** será limitada por su padre rect. +The size of a **PopupMenu** can be limited by using :ref:`Window.max_size`. If the height of the list of items is larger than the maximum height of the **PopupMenu**, a :ref:`ScrollContainer` within the popup will allow the user to scroll the contents. If no maximum size is set, or if it is set to ``0``, the **PopupMenu** height will be limited by its parent rect. -Todos los métodos ``set_*`` permiten índices negativos, ej: ``-1`` para acceder al último item, ``-2`` para seleccionar el ante-ultimo item, y asi sucesivamente. +All ``set_*`` methods allow negative item indices, i.e. ``-1`` to access the last item, ``-2`` to select the second-to-last item, and so on. -\ **Búsqueda Incremental** Como :ref:`ItemList` y :ref:`Tree`, **PopupMenu** soporta busqueda dentro de la lista mientras el control este focalizado. Presiona una tecla que coincida con la primera letra del nombre de un item para seleccionasr el primer item que empiece con la letra dada. Luego de ese punto, hay dos formas para hacer una busqueda incremental: 1) Presione la misma tecla nuevamente antes de que termine el tiempo de espera para seleccionar el siguiente item que comience con la misma letra. 2) Presione teclas que coincidan con el resto de la palabra antes de finalizar el tiempo de espera para coincidir el resto de la palabra a coincidir para seleccionar el item en cuestion directamente. Ambas de estas acciones van a reiniciar al prinvicpio de la lista si el tiempo de espera finalizó desde que el ultimo tipeo fue registrado. Puedes ajustar la duracion del tiempo de espera cambiando :ref:`ProjectSettings.gui/timers/incremental_search_max_interval_msec`. +\ **Incremental search:** Like :ref:`ItemList` and :ref:`Tree`, **PopupMenu** supports searching within the list while the control is focused. Press a key that matches the first letter of an item's name to select the first item starting with the given letter. After that point, there are two ways to perform incremental search: 1) Press the same key again before the timeout duration to select the next item starting with the same letter. 2) Press letter keys that match the rest of the word before the timeout duration to match to select the item in question directly. Both of these actions will be reset to the beginning of the list if the timeout duration has passed since the last keystroke was registered. You can adjust the timeout duration by changing :ref:`ProjectSettings.gui/timers/incremental_search_max_interval_msec`. -\ **Nota:** Los valores de ID usados para items estan limitados a 32 bits, no 64 bits completos del :ref:`int`. Esto tiene un rango desde ``-2^32`` hasta ``2^32 - 1``, esto es desde ``-2147483648`` hasta ``2147483647``. +\ **Note:** **PopupMenu** is invisible by default. To make it visible, call one of the ``popup_*`` methods from :ref:`Window` on the node, such as :ref:`Window.popup_centered_clamped()`. + +\ **Note:** The ID values used for items are limited to 32 bits, not full 64 bits of :ref:`int`. This has a range of ``-2^32`` to ``2^32 - 1``, i.e. ``-2147483648`` to ``2147483647``. .. rst-class:: classref-reftable-group @@ -45,7 +47,7 @@ Propiedades +-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`prefer_native_menu` | ``false`` | +-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`submenu_popup_delay` | ``0.3`` | + | :ref:`float` | :ref:`submenu_popup_delay` | ``0.2`` | +-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ | :ref:`SystemMenus` | :ref:`system_menu_id` | ``0`` | +-------------------------------------------------+----------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------+ @@ -233,6 +235,8 @@ Propiedades del Tema +-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`Color` | :ref:`font_separator_outline_color` | ``Color(0, 0, 0, 1)`` | +-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+ + | :ref:`int` | :ref:`gutter_compact` | ``1`` | + +-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`int` | :ref:`h_separation` | ``4`` | +-----------------------------------+-----------------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`int` | :ref:`icon_max_width` | ``0`` | @@ -315,9 +319,9 @@ Emitida cuando el usuario navega a un elemento de algún ``id`` utilizando la ac **id_pressed**\ (\ id\: :ref:`int`\ ) :ref:`🔗` -Emitida cuando se pulsa un elemento de algún ``id`` o se activa su acelerador. +Emitted when an item of some ``id`` is pressed. Also emitted when its accelerator is activated on macOS. -\ **Nota:** Si ``id`` es negativo (ya sea explícitamente o debido a un desbordamiento), esto devolverá el índice correspondiente en su lugar. +\ **Note:** If ``id`` is negative (either explicitly or due to overflow), this will return the corresponding index instead. .. rst-class:: classref-item-separator @@ -329,7 +333,7 @@ Emitida cuando se pulsa un elemento de algún ``id`` o se activa su acelerador. **index_pressed**\ (\ index\: :ref:`int`\ ) :ref:`🔗` -Emitida cuando se pulsa un elemento de algún ``index`` o se activa su acelerador. +Emitted when an item of some ``index`` is pressed. Also emitted when its accelerator is activated on macOS. .. rst-class:: classref-item-separator @@ -460,14 +464,16 @@ Si es ``true``, :ref:`MenuBar` usará el menú nativo cuando sea .. rst-class:: classref-property -:ref:`float` **submenu_popup_delay** = ``0.3`` :ref:`🔗` +:ref:`float` **submenu_popup_delay** = ``0.2`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_submenu_popup_delay**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_submenu_popup_delay**\ (\ ) -Establece el tiempo de demora en segundos para que el elemento del submenú aparezca al pasar el ratón por encima. Si el menú emergente se añade como un hijo de otro (actuando como un submenú), heredará el tiempo de retardo del elemento de menú superior. +Sets the delay time in seconds for the submenu item to popup on mouse hovering. If the popup menu is added as a child of another (acting as a submenu), it will inherit the delay time of the parent menu item. + +\ **Note:** If the mouse is exiting a submenu item with an open submenu and enters a different submenu item, the submenu popup delay time is affected by the direction of the mouse movement toward the open submenu. If the mouse is moving toward the submenu, the open submenu will wait approximately ``0.5`` seconds before closing, which then allows the hovered submenu item to open. This additional delay allows the mouse time to move to the open submenu across other menu items without prematurely closing. If the mouse is not moving toward the open submenu, for example in a downward direction, the open submenu will close immediately. .. rst-class:: classref-item-separator @@ -1313,7 +1319,7 @@ Establece el desplazamiento horizontal del elemento en el ``index`` dado. |void| **set_item_language**\ (\ index\: :ref:`int`, language\: :ref:`String`\ ) :ref:`🔗` -Establece el código de idioma del texto del elemento utilizado para los algoritmos de ajuste de línea y modelado de texto, si se deja vacío se utiliza la configuración regional actual. +Sets the language code of the text for the item at the given index to ``language``. This is used for line-breaking and text shaping algorithms. If ``language`` is empty, the current locale is used. .. rst-class:: classref-item-separator @@ -1554,6 +1560,18 @@ El tinte del contorno del texto del separador etiquetado. ---- +.. _class_PopupMenu_theme_constant_gutter_compact: + +.. rst-class:: classref-themeproperty + +:ref:`int` **gutter_compact** = ``1`` :ref:`🔗` + +If not ``0``, the icon gutter will be merged with the checkbox gutter when possible. This acts as a boolean. + +.. rst-class:: classref-item-separator + +---- + .. _class_PopupMenu_theme_constant_h_separation: .. rst-class:: classref-themeproperty diff --git a/classes/es/class_portablecompressedtexture2d.rst b/classes/es/class_portablecompressedtexture2d.rst index ed804fe5ac..e4aeb3e771 100644 --- a/classes/es/class_portablecompressedtexture2d.rst +++ b/classes/es/class_portablecompressedtexture2d.rst @@ -181,11 +181,9 @@ Descripciones de Propiedades - |void| **set_keep_compressed_buffer**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_keeping_compressed_buffer**\ (\ ) -When running on the editor, this class will keep the source compressed data in memory. Otherwise, the source compressed data is lost after loading and the resource can't be re saved. +If ``true``, when running in the editor, this texture will keep the source-compressed data in memory, allowing the data to persist after loading. Otherwise, the source-compressed data is lost after loading and the texture can't be re-saved. -This flag allows to keep the compressed data in memory if you intend it to persist after loading. - -\ **Note:** This must be set before :ref:`create_from_image()` to take effect. +\ **Note:** This property must be set before :ref:`create_from_image()` for this to work. .. rst-class:: classref-item-separator @@ -202,7 +200,7 @@ This flag allows to keep the compressed data in memory if you intend it to persi - |void| **set_size_override**\ (\ value\: :ref:`Vector2`\ ) - :ref:`Vector2` **get_size_override**\ (\ ) -Allow overriding the texture size (for 2D only). +Allows overriding the texture's size (for 2D only). .. rst-class:: classref-section-separator @@ -259,7 +257,7 @@ Return the image format used (valid after initialized). :ref:`bool` **is_keeping_all_compressed_buffers**\ (\ ) |static| :ref:`🔗` -Return whether the flag is overridden for all textures of this type. +Returns ``true`` if the flag is overridden for all textures of this type. .. rst-class:: classref-item-separator @@ -273,7 +271,7 @@ Return whether the flag is overridden for all textures of this type. Sets the compressor parameters for Basis Universal compression. See also the settings in :ref:`ResourceImporterTexture`. -\ **Note:** This must be set before :ref:`create_from_image()` to take effect. +\ **Note:** This method must be called before :ref:`create_from_image()` for this to work. .. rst-class:: classref-item-separator @@ -285,7 +283,7 @@ Sets the compressor parameters for Basis Universal compression. See also the set |void| **set_keep_all_compressed_buffers**\ (\ keep\: :ref:`bool`\ ) |static| :ref:`🔗` -Overrides the flag globally for all textures of this type. This is used primarily by the editor. +If ``keep`` is ``true``, overrides the flag globally for all textures of this type. This is used primarily by the editor. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_projectsettings.rst b/classes/es/class_projectsettings.rst index 6ea8ff8850..38b61f783f 100644 --- a/classes/es/class_projectsettings.rst +++ b/classes/es/class_projectsettings.rst @@ -48,20 +48,22 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`accessibility/general/updates_per_second` | ``60`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`animation/compatibility/default_parent_skeleton_in_mesh_instance_3d` | ``false`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`animation/warnings/check_angle_interpolation_type_conflicting` | ``true`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`animation/warnings/check_invalid_track_paths` | ``true`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`Color` | :ref:`application/boot_splash/bg_color` | ``Color(0.14, 0.14, 0.14, 1)`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`application/boot_splash/fullsize` | ``true`` | - +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`application/boot_splash/image` | ``""`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`application/boot_splash/minimum_display_time` | ``0`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`application/boot_splash/show_image` | ``true`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`application/boot_splash/stretch_mode` | ``1`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`application/boot_splash/use_filter` | ``true`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`application/config/auto_accept_quit` | ``true`` | @@ -70,6 +72,8 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`application/config/description` | ``""`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`application/config/disable_project_settings_override` | ``false`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`application/config/icon` | ``""`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`application/config/macos_native_icon` | ``""`` | @@ -190,14 +194,14 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`debug/gdscript/warnings/deprecated_keyword` | ``1`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`Dictionary` | :ref:`debug/gdscript/warnings/directory_rules` | ``{ "res://addons": 0 }`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`debug/gdscript/warnings/empty_file` | ``1`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`debug/gdscript/warnings/enable` | ``true`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`debug/gdscript/warnings/enum_variable_without_default` | ``1`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`debug/gdscript/warnings/exclude_addons` | ``true`` | - +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`debug/gdscript/warnings/get_node_default_without_onready` | ``2`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`debug/gdscript/warnings/incompatible_ternary` | ``1`` | @@ -212,6 +216,8 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`debug/gdscript/warnings/integer_division` | ``1`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`debug/gdscript/warnings/missing_await` | ``0`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`debug/gdscript/warnings/missing_tool` | ``1`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`debug/gdscript/warnings/narrowing_conversion` | ``1`` | @@ -528,6 +534,8 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`editor/import/use_multiple_threads` | ``true`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`editor/movie_writer/audio_bit_depth` | ``16`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`editor/movie_writer/disable_vsync` | ``false`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`editor/movie_writer/fps` | ``60`` | @@ -582,6 +590,10 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`gui/common/default_scroll_deadzone` | ``0`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`gui/common/drag_threshold` | ``10`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`gui/common/show_focus_state_on_pointer_event` | ``1`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`gui/common/snap_controls_to_pixels` | ``true`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`gui/common/swap_cancel_ok` | ``0`` | @@ -624,6 +636,10 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`Dictionary` | :ref:`input/ui_cancel` | | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`Dictionary` | :ref:`input/ui_close_dialog` | | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`Dictionary` | :ref:`input/ui_close_dialog.macos` | | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`Dictionary` | :ref:`input/ui_colorpicker_delete_preset` | | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`Dictionary` | :ref:`input/ui_copy` | | @@ -634,6 +650,14 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`Dictionary` | :ref:`input/ui_end` | | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`Dictionary` | :ref:`input/ui_filedialog_delete` | | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`Dictionary` | :ref:`input/ui_filedialog_find` | | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`Dictionary` | :ref:`input/ui_filedialog_focus_path` | | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`Dictionary` | :ref:`input/ui_filedialog_focus_path.macos` | | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`Dictionary` | :ref:`input/ui_filedialog_refresh` | | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`Dictionary` | :ref:`input/ui_filedialog_show_hidden` | | @@ -1262,6 +1286,8 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`navigation/2d/merge_rasterizer_cell_scale` | ``1.0`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`navigation/2d/navigation_engine` | ``"DEFAULT"`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`navigation/2d/use_edge_connections` | ``true`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`navigation/2d/warnings/navmesh_cell_size_mismatch` | ``true`` | @@ -1280,6 +1306,8 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`navigation/3d/merge_rasterizer_cell_scale` | ``1.0`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`navigation/3d/navigation_engine` | ``"DEFAULT"`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`navigation/3d/use_edge_connections` | ``true`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`navigation/3d/warnings/navmesh_cell_size_mismatch` | ``true`` | @@ -1314,6 +1342,8 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`network/limits/tcp/connect_timeout_seconds` | ``30`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`network/limits/unix/connect_timeout_seconds` | ``30`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`network/limits/webrtc/max_channel_in_buffer_kb` | ``64`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`network/tls/certificate_bundle_override` | ``""`` | @@ -1506,7 +1536,7 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`rendering/environment/glow/upscale_mode.mobile` | ``0`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rendering/environment/screen_space_reflection/roughness_quality` | ``1`` | + | :ref:`bool` | :ref:`rendering/environment/screen_space_reflection/half_size` | ``true`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`rendering/environment/ssao/adaptive_target` | ``0.5`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ @@ -1682,7 +1712,7 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`rendering/reflections/sky_reflections/ggx_samples.mobile` | ``16`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rendering/reflections/sky_reflections/roughness_layers` | ``8`` | + | :ref:`int` | :ref:`rendering/reflections/sky_reflections/roughness_layers` | ``7`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`rendering/reflections/sky_reflections/texture_array_reflections` | ``true`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ @@ -1696,13 +1726,11 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`rendering/renderer/rendering_method.web` | ``"gl_compatibility"`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rendering/rendering_device/d3d12/agility_sdk_version` | ``613`` | + | :ref:`int` | :ref:`rendering/rendering_device/d3d12/agility_sdk_version` | ``618`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rendering/rendering_device/d3d12/max_misc_descriptors_per_frame` | ``512`` | + | :ref:`int` | :ref:`rendering/rendering_device/d3d12/max_resource_descriptors` | ``65536`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rendering/rendering_device/d3d12/max_resource_descriptors_per_frame` | ``16384`` | - +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`rendering/rendering_device/d3d12/max_sampler_descriptors_per_frame` | ``1024`` | + | :ref:`int` | :ref:`rendering/rendering_device/d3d12/max_sampler_descriptors` | ``1024`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`rendering/rendering_device/driver` | ``"vulkan"`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ @@ -1830,6 +1858,8 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`xr/openxr/extensions/eye_gaze_interaction` | ``false`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`xr/openxr/extensions/frame_synthesis` | ``false`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`xr/openxr/extensions/hand_interaction_profile` | ``false`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`xr/openxr/extensions/hand_tracking` | ``false`` | @@ -1840,6 +1870,26 @@ Propiedades +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`xr/openxr/extensions/render_model` | ``false`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`xr/openxr/extensions/spatial_entity/april_tag_dict` | ``"3"`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`xr/openxr/extensions/spatial_entity/aruco_dict` | ``"15"`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`xr/openxr/extensions/spatial_entity/enable_builtin_anchor_detection` | ``false`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`xr/openxr/extensions/spatial_entity/enable_builtin_marker_tracking` | ``false`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`xr/openxr/extensions/spatial_entity/enable_builtin_plane_detection` | ``false`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`xr/openxr/extensions/spatial_entity/enable_marker_tracking` | ``false`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`xr/openxr/extensions/spatial_entity/enable_persistent_anchors` | ``false`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`xr/openxr/extensions/spatial_entity/enable_plane_tracking` | ``false`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`xr/openxr/extensions/spatial_entity/enable_spatial_anchors` | ``false`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`xr/openxr/extensions/spatial_entity/enabled` | ``false`` | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`xr/openxr/form_factor` | ``"0"`` | +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`xr/openxr/foveation_dynamic` | ``false`` | @@ -1868,8 +1918,12 @@ Métodos +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`add_property_info`\ (\ hint\: :ref:`Dictionary`\ ) | +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`check_changed_settings_in_group`\ (\ setting_prefix\: :ref:`String`\ ) |const| | + +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`clear`\ (\ name\: :ref:`String`\ ) | +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`get_changed_settings`\ (\ ) |const| | + +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Array`\[:ref:`Dictionary`\] | :ref:`get_global_class_list`\ (\ ) | +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_order`\ (\ name\: :ref:`String`\ ) |const| | @@ -1945,7 +1999,7 @@ Accessibility support mode: - **Disabled** (``2``): Accessibility support is fully disabled. -\ **Note:** Accessibility debugging tools, such as Accessibility Insights for Windows, Accessibility Inspector (macOS), or AT-SPI Browser (Linux/BSD) do not count as assistive apps. To test your project with these tools, use **Always Active**. +\ **Note:** Accessibility debugging tools, such as Accessibility Insights for Windows, Accessibility Inspector (macOS), or AT-SPI Browser (Linux/BSD), do not count as assistive apps. To test your project with these tools, use **Always Active**. .. rst-class:: classref-item-separator @@ -1963,6 +2017,20 @@ Número de actualizaciones por segundo de la información de accesibilidad. ---- +.. _class_ProjectSettings_property_animation/compatibility/default_parent_skeleton_in_mesh_instance_3d: + +.. rst-class:: classref-property + +:ref:`bool` **animation/compatibility/default_parent_skeleton_in_mesh_instance_3d** = ``false`` :ref:`🔗` + +If ``true``, :ref:`MeshInstance3D.skeleton` will point to the parent node (``..``) by default, which was the behavior before Godot 4.6. It's recommended to keep this setting disabled unless the old behavior is needed for compatibility. + +\ **Note:** If you disable this option in an existing project, it's strongly recommended to use the ``Project > Tools > Upgrade Project Files...`` option to ensure existing scenes do not break. + +.. rst-class:: classref-item-separator + +---- + .. _class_ProjectSettings_property_animation/warnings/check_angle_interpolation_type_conflicting: .. rst-class:: classref-property @@ -1999,18 +2067,6 @@ Color de fondo para la imagen de arranque. ---- -.. _class_ProjectSettings_property_application/boot_splash/fullsize: - -.. rst-class:: classref-property - -:ref:`bool` **application/boot_splash/fullsize** = ``true`` :ref:`🔗` - -If ``true``, scale the boot splash image to the full window size (preserving the aspect ratio) when the engine starts. If ``false``, the engine will leave it at the default pixel size. - -.. rst-class:: classref-item-separator - ----- - .. _class_ProjectSettings_property_application/boot_splash/image: .. rst-class:: classref-property @@ -2053,6 +2109,18 @@ If ``true``, displays the image specified in :ref:`application/boot_splash/image ---- +.. _class_ProjectSettings_property_application/boot_splash/stretch_mode: + +.. rst-class:: classref-property + +:ref:`int` **application/boot_splash/stretch_mode** = ``1`` :ref:`🔗` + +Specifies how the splash image will be stretched. For the original size without stretching, set to disabled. See :ref:`SplashStretchMode` constants for more information. + +.. rst-class:: classref-item-separator + +---- + .. _class_ProjectSettings_property_application/boot_splash/use_filter: .. rst-class:: classref-property @@ -2105,6 +2173,18 @@ The project's description, displayed as a tooltip in the Project Manager when ho ---- +.. _class_ProjectSettings_property_application/config/disable_project_settings_override: + +.. rst-class:: classref-property + +:ref:`bool` **application/config/disable_project_settings_override** = ``false`` :ref:`🔗` + +If ``true``, disables loading of project settings overrides (file defined in :ref:`application/config/project_settings_override` and ``res://override.cfg``) and related CLI arguments. + +.. rst-class:: classref-item-separator + +---- + .. _class_ProjectSettings_property_application/config/icon: .. rst-class:: classref-property @@ -2149,7 +2229,9 @@ The project's name. It is used both by the Project Manager and by exporters. The :ref:`Dictionary` **application/config/name_localized** = ``{}`` :ref:`🔗` -El nombre del proyecto en otros idiomas. El SO usa este ajuste para traducir el nombre de la aplicación en Android, iOS y macOS. +Translations of the project's name. This setting is used by OS tools to translate application name on Android, iOS and macOS. + +\ **Note:** When left empty, the application name is translated using the project translations. .. rst-class:: classref-item-separator @@ -2415,9 +2497,9 @@ Maximum number of frames per second allowed. A value of ``0`` means "no limit". Limiting the FPS can be useful to reduce system power consumption, which reduces heat and noise emissions (and improves battery life on mobile devices). -If :ref:`display/window/vsync/vsync_mode` is set to ``Enabled`` or ``Adaptive``, it takes precedence and the forced FPS number cannot exceed the monitor's refresh rate. +If :ref:`display/window/vsync/vsync_mode` is set to ``Enabled`` or ``Adaptive``, it takes precedence and the forced FPS number cannot exceed the monitor's refresh rate. See also :ref:`DisplayServer.screen_get_refresh_rate()`. -If :ref:`display/window/vsync/vsync_mode` is ``Enabled``, on monitors with variable refresh rate enabled (G-Sync/FreeSync), using an FPS limit a few frames lower than the monitor's refresh rate will `reduce input lag while avoiding tearing `__. +If :ref:`display/window/vsync/vsync_mode` is ``Enabled``, on monitors with variable refresh rate enabled (G-Sync/FreeSync), using an FPS limit slightly lower than the monitor's refresh rate will `reduce input lag while avoiding tearing `__. At higher refresh rates, the difference between the FPS limit and the monitor refresh rate should be increased to ensure frames to account for timing inaccuracies. The optimal formula for the FPS limit value in this scenario is ``r - (r * r) / 3600.0``, where ``r`` is the monitor's refresh rate. If :ref:`display/window/vsync/vsync_mode` is ``Disabled``, limiting the FPS to a high value that can be consistently reached on the system can reduce input lag compared to an uncapped framerate. Since this works by ensuring the GPU load is lower than 100%, this latency reduction is only effective in GPU-bottlenecked scenarios, not CPU-bottlenecked scenarios. @@ -2663,9 +2745,9 @@ Sets the `AVAudioSessionCategory ` **audio/general/text_to_speech** = ``false`` :ref:`🔗` -If ``true``, text-to-speech support is enabled on startup, otherwise it is enabled first time TTS method is used, see :ref:`DisplayServer.tts_get_voices()` and :ref:`DisplayServer.tts_speak()`. +If ``true``, text-to-speech support is enabled on startup, otherwise it is enabled the first time any TTS method is used. See also :ref:`DisplayServer.tts_get_voices()` and :ref:`DisplayServer.tts_speak()`. -\ **Note:** Enabling TTS can cause addition idle CPU usage and interfere with the sleep mode, so consider disabling it if TTS is not used. +\ **Note:** Enabling TTS can cause additional idle CPU usage and interfere with the sleep mode, so consider disabling it if TTS is not used. .. rst-class:: classref-item-separator @@ -2837,7 +2919,7 @@ If the ``--log-file `` :doc:`command line argument <../tutorials/editor/co :ref:`int` **debug/gdscript/warnings/assert_always_false** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando una llamada a ``assert`` siempre se evalúa como ``false``. +When set to **Warn** or **Error**, produces a warning or an error respectively when an ``assert`` call always evaluates to ``false``. .. rst-class:: classref-item-separator @@ -2849,7 +2931,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/assert_always_true** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando una llamada a ``assert`` siempre se evalúa como ``true``. +When set to **Warn** or **Error**, produces a warning or an error respectively when an ``assert`` call always evaluates to ``true``. .. rst-class:: classref-item-separator @@ -2861,7 +2943,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/confusable_capture_reassignment** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando se reasigna una variable local capturada por una lambda, ya que esto no modifica la variable local externa. +When set to **Warn** or **Error**, produces a warning or an error respectively when a local variable captured by a lambda is reassigned, since this does not modify the outer local variable. .. rst-class:: classref-item-separator @@ -2873,7 +2955,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/confusable_identifier** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando un identificador contiene caracteres que pueden confundirse con otra cosa, como al mezclar diferentes alfabetos. +When set to **Warn** or **Error**, produces a warning or an error respectively when an identifier contains characters that can be confused with something else, like when mixing different alphabets. .. rst-class:: classref-item-separator @@ -2885,7 +2967,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/confusable_local_declaration** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando un identificador declarado en el bloque anidado tiene el mismo nombre que un identificador declarado más abajo en el bloque padre. +When set to **Warn** or **Error**, produces a warning or an error respectively when an identifier declared in the nested block has the same name as an identifier declared below in the parent block. .. rst-class:: classref-item-separator @@ -2897,7 +2979,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/confusable_local_usage** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando se utiliza un identificador que será sombreado más abajo en el bloque. +When set to **Warn** or **Error**, produces a warning or an error respectively when an identifier that will be shadowed below in the block is used. .. rst-class:: classref-item-separator @@ -2909,9 +2991,27 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/deprecated_keyword** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando se utilizan palabras clave obsoletas. +When set to **Warn** or **Error**, produces a warning or an error respectively when deprecated keywords are used. -\ **Nota:** Actualmente no hay palabras clave obsoletas, por lo que esta advertencia nunca se produce. +\ **Note:** There are currently no deprecated keywords, so this warning is never produced. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_debug/gdscript/warnings/directory_rules: + +.. rst-class:: classref-property + +:ref:`Dictionary` **debug/gdscript/warnings/directory_rules** = ``{ "res://addons": 0 }`` :ref:`🔗` + +The rules for including or excluding scripts when generating warnings, as a dictionary. Each rule is an entry consisting of a directory path (key) and a decision (value). When trying to generate a warning, the GDScript parser chooses the most specific rule, i.e. the most nested directory containing the script. If the decision is **Exclude**, warnings are not generated for this script. If the decision is **Include** or the script doesn't satisfy any of the rules, the warning configuration specified in the Project Settings is applied. + +It is recommended to include your own addons/libraries, either project-specific or actively being developed at the moment. Third-party or project-agnostic addons/libraries should be excluded, as they may be incompatible with the project's warning configuration. + +\ **Note:** It is not recommended to remove or change the rule for ``"res://addons"`` as the project's warning configuration may break third-party addons. Instead, consider including individual addons, if necessary. + +\ **Note:** The editor does not check whether the specified paths are existing directories. It also does not automatically update these paths when directories are moved. .. rst-class:: classref-item-separator @@ -2923,7 +3023,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/empty_file** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando se analiza un archivo vacío. +When set to **Warn** or **Error**, produces a warning or an error respectively when an empty file is parsed. .. rst-class:: classref-item-separator @@ -2947,19 +3047,7 @@ Si es ``true``, habilita advertencias específicas de GDScript (véase la config :ref:`int` **debug/gdscript/warnings/enum_variable_without_default** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando una variable tiene un tipo de enum pero no un valor predeterminado explícito, pero solo si el enum no contiene ``0`` como un valor válido. - -.. rst-class:: classref-item-separator - ----- - -.. _class_ProjectSettings_property_debug/gdscript/warnings/exclude_addons: - -.. rst-class:: classref-property - -:ref:`bool` **debug/gdscript/warnings/exclude_addons** = ``true`` :ref:`🔗` - -Si es ``true``, los scripts de la carpeta ``res://addons`` no generarán advertencias. +When set to **Warn** or **Error**, produces a warning or an error respectively when a variable has an enum type but no explicit default value, but only if the enum does not contain ``0`` as a valid value. .. rst-class:: classref-item-separator @@ -2971,7 +3059,7 @@ Si es ``true``, los scripts de la carpeta ``res://addons`` no generarán adverte :ref:`int` **debug/gdscript/warnings/get_node_default_without_onready** = ``2`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando :ref:`Node.get_node()` (o la forma abreviada ``$``) se utiliza como valor predeterminado de una variable de clase sin la anotación ``@onready``. +When set to **Warn** or **Error**, produces a warning or an error respectively when :ref:`Node.get_node()` (or the shorthand ``$``) is used as default value of a class variable without the ``@onready`` annotation. .. rst-class:: classref-item-separator @@ -2983,7 +3071,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/incompatible_ternary** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando un operador ternario puede emitir valores con tipos incompatibles. +When set to **Warn** or **Error**, produces a warning or an error respectively when a ternary operator may emit values with incompatible types. .. rst-class:: classref-item-separator @@ -2995,7 +3083,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/inference_on_variant** = ``2`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando un tipo estático inferido utiliza una :ref:`Variant` como valor inicial, lo que hace que el tipo estático también sea Variant. +When set to **Warn** or **Error**, produces a warning or an error respectively when a static inferred type uses a :ref:`Variant` as initial value, which makes the static type to also be Variant. .. rst-class:: classref-item-separator @@ -3007,9 +3095,9 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/inferred_declaration** = ``0`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando una variable, constante o parámetro tiene un tipo estático inferido implícitamente. En GDScript, la inferencia de tipos se realiza declarando una variable con ``:=`` en lugar de ``=`` y omitiendo el especificador de tipo. Por ejemplo, ``var x := 1`` *inferirá* el tipo :ref:`int`, mientras que ``var x: int = 1`` declara explícitamente la variable como :ref:`int`. +When set to **Warn** or **Error**, produces a warning or an error respectively when a variable, constant, or parameter has an implicitly inferred static type. In GDScript, type inference is performed by declaring a variable with ``:=`` instead of ``=`` and leaving out the type specifier. For example, ``var x := 1`` will *infer* the :ref:`int` type, while ``var x: int = 1`` explicitly declares the variable as :ref:`int`. -\ **Nota:** Se recomienda esta advertencia *además* de :ref:`debug/gdscript/warnings/untyped_declaration` si quieres especificar siempre el tipo explícitamente. Tener el nivel de advertencia ``INFERRED_DECLARATION`` más alto que el nivel de advertencia ``UNTYPED_DECLARATION`` tiene poco sentido y no se recomienda. +\ **Note:** This warning is recommended *in addition* to :ref:`debug/gdscript/warnings/untyped_declaration` if you want to always specify the type explicitly. Having ``INFERRED_DECLARATION`` warning level higher than ``UNTYPED_DECLARATION`` warning level makes little sense and is not recommended. .. rst-class:: classref-item-separator @@ -3021,7 +3109,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/int_as_enum_without_cast** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente al intentar usar un entero como un enum sin una conversión explícita. +When set to **Warn** or **Error**, produces a warning or an error respectively when trying to use an integer as an enum without an explicit cast. .. rst-class:: classref-item-separator @@ -3033,7 +3121,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/int_as_enum_without_match** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente al intentar usar un entero como un enum cuando no hay un miembro enum coincidente para ese valor numérico. +When set to **Warn** or **Error**, produces a warning or an error respectively when trying to use an integer as an enum when there is no matching enum member for that numeric value. .. rst-class:: classref-item-separator @@ -3045,7 +3133,19 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/integer_division** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente al dividir un entero por otro entero (la parte decimal se descartará). +When set to **Warn** or **Error**, produces a warning or an error respectively when dividing an integer by another integer (the decimal part will be discarded). + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_debug/gdscript/warnings/missing_await: + +.. rst-class:: classref-property + +:ref:`int` **debug/gdscript/warnings/missing_await** = ``0`` :ref:`🔗` + +When set to **Warn** or **Error**, produces a warning or an error respectively when calling a coroutine without ``await``. .. rst-class:: classref-item-separator @@ -3057,7 +3157,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/missing_tool** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando el script de la clase base tiene la anotación ``@tool``, pero el script de la clase actual no la tiene. +When set to **Warn** or **Error**, produces a warning or an error respectively when the base class script has the ``@tool`` annotation, but the current class script does not have it. .. rst-class:: classref-item-separator @@ -3069,7 +3169,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/narrowing_conversion** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, se produce una advertencia o un error, respectivamente, al pasar un valor de punto flotante a una función que espera un entero (se convertirá y perderá precisión). +When set to **Warn** or **Error**, produces a warning or an error respectively when passing a floating-point value to a function that expects an integer (it will be converted and lose precision). .. rst-class:: classref-item-separator @@ -3081,7 +3181,7 @@ Cuando se establece en ``warn`` o ``error``, se produce una advertencia o un err :ref:`int` **debug/gdscript/warnings/native_method_override** = ``2`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, se produce una advertencia o un error, respectivamente, cuando un método en el script reemplaza un método nativo, porque puede que no se comporte como se espera. +When set to **Warn** or **Error**, produces a warning or an error respectively when a method in the script overrides a native method, because it may not behave as expected. .. rst-class:: classref-item-separator @@ -3093,7 +3193,7 @@ Cuando se establece en ``warn`` o ``error``, se produce una advertencia o un err :ref:`int` **debug/gdscript/warnings/onready_with_export** = ``2`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error, respectivamente, cuando la anotación ``@onready`` se utiliza junto con la anotación ``@export``, ya que puede que no se comporte como se espera. +When set to **Warn** or **Error**, produces a warning or an error respectively when the ``@onready`` annotation is used together with the ``@export`` annotation, since it may not behave as expected. .. rst-class:: classref-item-separator @@ -3105,7 +3205,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error, :ref:`int` **debug/gdscript/warnings/redundant_await** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error, respectivamente, cuando una función que no es una corrutina se llama con await. +When set to **Warn** or **Error**, produces a warning or an error respectively when a function that is not a coroutine is called with await. .. rst-class:: classref-item-separator @@ -3117,7 +3217,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error, :ref:`int` **debug/gdscript/warnings/redundant_static_unload** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error, respectivamente, cuando la anotación ``@static_unload`` se utiliza en un script sin ninguna variable estática. +When set to **Warn** or **Error**, produces a warning or an error respectively when the ``@static_unload`` annotation is used in a script without any static variables. .. rst-class:: classref-item-separator @@ -3141,7 +3241,7 @@ Cuando está activado, el uso de una propiedad, enumeración o función que ha s :ref:`int` **debug/gdscript/warnings/return_value_discarded** = ``0`` :ref:`🔗` -Si está establecido como ``warn`` o ``error``, produce una advertencia o un error respectivamente al llamar a una función sin utilizar su valor de retorno (asignándolo a una variable o utilizándolo como argumento de la función). Esos valores de retorno se utilizan a veces para denotar posibles errores mediante el uso del enum :ref:`Error`. +When set to **Warn** or **Error**, produces a warning or an error respectively when calling a function without using its return value (by assigning it to a variable or using it as a function argument). These return values are sometimes used to indicate possible errors using the :ref:`Error` enum. .. rst-class:: classref-item-separator @@ -3153,7 +3253,7 @@ Si está establecido como ``warn`` o ``error``, produce una advertencia o un err :ref:`int` **debug/gdscript/warnings/shadowed_global_identifier** = ``1`` :ref:`🔗` -When set to ``warn`` or ``error``, produces a warning or an error respectively when defining a local or member variable, signal, or enum that would have the same name as a built-in function or global class name, thus shadowing it. +When set to **Warn** or **Error**, produces a warning or an error respectively when defining a local or member variable, signal, or enum that would have the same name as a built-in function or global class name, thus shadowing it. .. rst-class:: classref-item-separator @@ -3165,7 +3265,7 @@ When set to ``warn`` or ``error``, produces a warning or an error respectively w :ref:`int` **debug/gdscript/warnings/shadowed_variable** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando una variable local o una constante local ensombrece a un miembro declarado en la clase actual. +When set to **Warn** or **Error**, produces a warning or an error respectively when a local variable or local constant shadows a member declared in the current class. .. rst-class:: classref-item-separator @@ -3177,7 +3277,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/shadowed_variable_base_class** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando una variable local o una constante local ensombrece a un miembro declarado en una clase base. +When set to **Warn** or **Error**, produces a warning or an error respectively when a local variable or local constant shadows a member declared in a base class. .. rst-class:: classref-item-separator @@ -3189,7 +3289,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/standalone_expression** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente al llamar a una expresión que puede no tener efecto en el código circundante, como escribir ``2 + 2`` como una declaración. +When set to **Warn** or **Error**, produces a warning or an error respectively when calling an expression that may have no effect on the surrounding code, such as writing ``2 + 2`` as a statement. .. rst-class:: classref-item-separator @@ -3201,7 +3301,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/standalone_ternary** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente al llamar a una expresión ternaria que puede no tener efecto en el código circundante, como escribir ``42 if active else 0`` como una declaración. +When set to **Warn** or **Error**, produces a warning or an error respectively when calling a ternary expression that may have no effect on the surrounding code, such as writing ``42 if active else 0`` as a statement. .. rst-class:: classref-item-separator @@ -3213,7 +3313,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/static_called_on_instance** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente al llamar a un método estático desde una instancia de una clase en lugar de la clase directamente. +When set to **Warn** or **Error**, produces a warning or an error respectively when calling a static method from an instance of a class instead of from the class directly. .. rst-class:: classref-item-separator @@ -3225,7 +3325,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/unassigned_variable** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, se produce una advertencia o un error respectivamente al usar una variable que no ha sido asignada previamente. +When set to **Warn** or **Error**, produces a warning or an error respectively when using a variable that wasn't previously assigned. .. rst-class:: classref-item-separator @@ -3237,7 +3337,7 @@ Cuando se establece en ``warn`` o ``error``, se produce una advertencia o un err :ref:`int` **debug/gdscript/warnings/unassigned_variable_op_assign** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, se produce una advertencia o un error respectivamente al asignar una variable usando un operador de asignación como ``+=`` si la variable no ha sido asignada previamente. +When set to **Warn** or **Error**, produces a warning or an error respectively when assigning a variable using an assignment operator like ``+=`` if the variable wasn't previously assigned. .. rst-class:: classref-item-separator @@ -3249,7 +3349,7 @@ Cuando se establece en ``warn`` o ``error``, se produce una advertencia o un err :ref:`int` **debug/gdscript/warnings/unreachable_code** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando se detecta código inalcanzable (como después de una sentencia ``return`` que siempre se ejecutará). +When set to **Warn** or **Error**, produces a warning or an error respectively when unreachable code is detected (such as after a ``return`` statement that will always be executed). .. rst-class:: classref-item-separator @@ -3261,7 +3361,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/unreachable_pattern** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando se detecta un patrón de ``match`` inalcanzable. +When set to **Warn** or **Error**, produces a warning or an error respectively when an unreachable ``match`` pattern is detected. .. rst-class:: classref-item-separator @@ -3273,7 +3373,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/unsafe_call_argument** = ``0`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente al usar una expresión cuyo tipo puede no ser compatible con el parámetro de función esperado. +When set to **Warn** or **Error**, produces a warning or an error respectively when using an expression whose type may not be compatible with the function parameter expected. .. rst-class:: classref-item-separator @@ -3285,7 +3385,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/unsafe_cast** = ``0`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando un valor :ref:`Variant` es convertido a un no-Variant. +When set to **Warn** or **Error**, produces a warning or an error respectively when a :ref:`Variant` value is cast to a non-Variant. .. rst-class:: classref-item-separator @@ -3297,7 +3397,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/unsafe_method_access** = ``0`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente al llamar a un método cuya presencia no está garantizada en tiempo de compilación en la clase. +When set to **Warn** or **Error**, produces a warning or an error respectively when calling a method whose presence is not guaranteed at compile-time in the class. .. rst-class:: classref-item-separator @@ -3309,7 +3409,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/unsafe_property_access** = ``0`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente al acceder a una propiedad cuya presencia no está garantizada en tiempo de compilación en la clase. +When set to **Warn** or **Error**, produces a warning or an error respectively when accessing a property whose presence is not guaranteed at compile-time in the class. .. rst-class:: classref-item-separator @@ -3321,7 +3421,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/unsafe_void_return** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente al devolver una llamada desde una función ``void`` cuando no se puede garantizar que dicha llamada sea también ``void``. +When set to **Warn** or **Error**, produces a warning or an error respectively when returning a call from a ``void`` function when such call cannot be guaranteed to be also ``void``. .. rst-class:: classref-item-separator @@ -3333,9 +3433,9 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/untyped_declaration** = ``0`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando una variable o parámetro no tiene un tipo estático, o si una función no tiene un tipo de retorno estático. +When set to **Warn** or **Error**, produces a warning or an error respectively when a variable or parameter has no static type, or if a function has no static return type. -\ **Nota:** Se recomienda esta advertencia junto con :ref:`EditorSettings.text_editor/completion/add_type_hints` para ayudar a lograr la seguridad de tipos. +\ **Note:** This warning is recommended together with :ref:`EditorSettings.text_editor/completion/add_type_hints` to help achieve type safety. .. rst-class:: classref-item-separator @@ -3347,7 +3447,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/unused_local_constant** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando una constante local nunca es utilizada. +When set to **Warn** or **Error**, produces a warning or an error respectively when a local constant is never used. .. rst-class:: classref-item-separator @@ -3359,7 +3459,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/unused_parameter** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando un parámetro de función nunca es utilizado. +When set to **Warn** or **Error**, produces a warning or an error respectively when a function parameter is never used. .. rst-class:: classref-item-separator @@ -3371,7 +3471,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/unused_private_class_variable** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando una variable miembro privada nunca es utilizada. +When set to **Warn** or **Error**, produces a warning or an error respectively when a private member variable is never used. .. rst-class:: classref-item-separator @@ -3383,7 +3483,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/unused_signal** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando una señal es declarada pero nunca se usa explícitamente en la clase. +When set to **Warn** or **Error**, produces a warning or an error respectively when a signal is declared but never explicitly used in the class. .. rst-class:: classref-item-separator @@ -3395,7 +3495,7 @@ Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error :ref:`int` **debug/gdscript/warnings/unused_variable** = ``1`` :ref:`🔗` -Cuando se establece en ``warn`` o ``error``, produce una advertencia o un error respectivamente cuando una variable local no es utilizada. +When set to **Warn** or **Error**, produces a warning or an error respectively when a local variable is unused. .. rst-class:: classref-item-separator @@ -4675,15 +4775,19 @@ Main window initial position (in virtual desktop coordinates), this setting is u :ref:`int` **display/window/size/initial_position_type** = ``1`` :ref:`🔗` -Posición inicial de la ventana principal. +Main window initial position. -\ ``0`` - "Absoluta", :ref:`display/window/size/initial_position` se utiliza para establecer la posición de la ventana. +\ ``0`` - "Absolute", :ref:`display/window/size/initial_position` is used to set window position. -\ ``1`` - "Centro de la pantalla principal". +\ ``1`` - "Primary Screen Center". -\ ``2`` - "Centro de otra pantalla", :ref:`display/window/size/initial_screen` se utiliza para establecer la pantalla. +\ ``3`` - "Other Screen Center", :ref:`display/window/size/initial_screen` is used to set the screen. -\ **Nota:** Este ajuste solo afecta al proyecto exportado, o cuando el proyecto se ejecuta desde la línea de comandos. En el editor, se utiliza el valor de :ref:`EditorSettings.run/window_placement/rect` en su lugar. +\ ``4`` - "Center of Screen With Mouse Pointer". + +\ ``5`` - "Center of Screen With Keyboard Focus". + +\ **Note:** This setting only affects the exported project, or when the project is run from the command line. In the editor, the value of :ref:`EditorSettings.run/window_placement/rect` is used instead. .. rst-class:: classref-item-separator @@ -4861,9 +4965,17 @@ En plataformas de escritorio, sobrescribe el ancho inicial de la ventana del jue :ref:`String` **display/window/stretch/aspect** = ``"keep"`` :ref:`🔗` -.. container:: contribute +Defines how the aspect ratio of the base size is preserved when stretching to fit the resolution of the window or screen. - There is currently no description for this property. Please help us by `contributing one `__! +\ ``"ignore"``: Ignore the aspect ratio when stretching the screen. This means that the original resolution will be stretched to exactly fill the screen, even if it's wider or narrower. This may result in non-uniform stretching: things looking wider or taller than designed. + +\ ``"keep"``: Keep aspect ratio when stretching the screen. This means that the viewport retains its original size regardless of the screen resolution, and black bars will be added to the top/bottom of the screen ("letterboxing") or the sides ("pillarboxing"). + +\ ``"keep_width"``: Keep aspect ratio when stretching the screen. If the screen is wider than the base size, black bars are added at the left and right (pillarboxing). But if the screen is taller than the base resolution, the viewport will be grown in the vertical direction (and more content will be visible at the bottom). You can also think of this as "Expand Vertically". + +\ ``"keep_height"``: Keep aspect ratio when stretching the screen. If the screen is taller than the base size, black bars are added at the top and bottom (letterboxing). But if the screen is wider than the base resolution, the viewport will be grown in the horizontal direction (and more content will be visible to the right). You can also think of this as "Expand Horizontally". + +\ ``"expand"``: Keep aspect ratio when stretching the screen, but keep neither the base width nor height. Depending on the screen aspect ratio, the viewport will either be larger in the horizontal direction (if the screen is wider than the base size) or in the vertical direction (if the screen is taller than the original size). .. rst-class:: classref-item-separator @@ -4877,11 +4989,11 @@ En plataformas de escritorio, sobrescribe el ancho inicial de la ventana del jue Defines how the base size is stretched to fit the resolution of the window or screen. -\ **"disabled"**: No stretching happens. One unit in the scene corresponds to one pixel on the screen. In this mode, :ref:`display/window/stretch/aspect` has no effect. Recommended for non-game applications. +\ ``"disabled"``: No stretching happens. One unit in the scene corresponds to one pixel on the screen. In this mode, :ref:`display/window/stretch/aspect` has no effect. Recommended for non-game applications. -\ **"canvas_items"**: The base size specified in width and height in the project settings is stretched to cover the whole screen (taking :ref:`display/window/stretch/aspect` into account). This means that everything is rendered directly at the target resolution. 3D is unaffected, while in 2D, there is no longer a 1:1 correspondence between sprite pixels and screen pixels, which may result in scaling artifacts. Recommended for most games that don't use a pixel art aesthetic, although it is possible to use this stretch mode for pixel art games too (especially in 3D). +\ ``"canvas_items"``: The base size specified in width and height in the project settings is stretched to cover the whole screen (taking :ref:`display/window/stretch/aspect` into account). This means that everything is rendered directly at the target resolution. 3D is unaffected, while in 2D, there is no longer a 1:1 correspondence between sprite pixels and screen pixels, which may result in scaling artifacts. Recommended for most games that don't use a pixel art aesthetic, although it is possible to use this stretch mode for pixel art games too (especially in 3D). -\ **"viewport"**: The size of the root :ref:`Viewport` is set precisely to the base size specified in the Project Settings' Display section. The scene is rendered to this viewport first. Finally, this viewport is scaled to fit the screen (taking :ref:`display/window/stretch/aspect` into account). Recommended for games that use a pixel art aesthetic. +\ ``"viewport"``: The size of the root :ref:`Viewport` is set precisely to the base size specified in the Project Settings' Display section. The scene is rendered to this viewport first. Finally, this viewport is scaled to fit the screen (taking :ref:`display/window/stretch/aspect` into account). Recommended for games that use a pixel art aesthetic. .. rst-class:: classref-item-separator @@ -4905,13 +5017,13 @@ El multiplicador del factor de escala a utilizar para los elementos 2D. Esto mul :ref:`String` **display/window/stretch/scale_mode** = ``"fractional"`` :ref:`🔗` -La política a utilizar para determinar el factor de escala final para los elementos 2D. Esto afecta a cómo se aplica :ref:`display/window/stretch/scale`, además del factor de escala automático determinado por :ref:`display/window/stretch/mode`. +The policy to use to determine the final scale factor for 2D elements. This affects how :ref:`display/window/stretch/scale` is applied, in addition to the automatic scale factor determined by :ref:`display/window/stretch/mode`. -\ **"fractional"**: El factor de escala no se modificará. +\ ``"fractional"``: The scale factor will not be modified. -\ **"integer"**: El factor de escala se redondeará a un valor entero, lo que significa que el tamaño de la pantalla siempre será un múltiplo entero del tamaño base del viewport. Esto proporciona una apariencia nítida de pixel art. +\ ``"integer"``: The scale factor will be floored to an integer value, which means that the screen size will always be an integer multiple of the base viewport size. This provides a crisp pixel art appearance. -\ **Nota:** Cuando se utiliza el escalado entero con un modo de estiramiento, el cambio de tamaño de la ventana para que sea más pequeña que el tamaño base del viewport recortará el contenido. Considera la posibilidad de evitarlo configurando :ref:`Window.min_size` con el mismo valor que el tamaño base del viewport definido en :ref:`display/window/size/viewport_width` y :ref:`display/window/size/viewport_height`. +\ **Note:** When using integer scaling with a stretch mode, resizing the window to be smaller than the base viewport size will clip the contents. Consider preventing that by setting :ref:`Window.min_size` to the same value as the base viewport size defined in :ref:`display/window/size/viewport_width` and :ref:`display/window/size/viewport_height`. .. rst-class:: classref-item-separator @@ -4927,7 +5039,7 @@ If ``true``, subwindows are embedded in the main window (this is also called sin If ``false``, subwindows are created as separate windows (this is also called multi-window mode). This allows them to be moved outside the main window and use native operating system window decorations. -This is equivalent to :ref:`EditorSettings.interface/editor/single_window_mode` in the editor, except the setting's value is inverted. +This is equivalent to :ref:`EditorSettings.interface/editor/single_window_mode` in the editor. .. rst-class:: classref-item-separator @@ -5047,6 +5159,18 @@ Si es ``true``, la importación de recursos se ejecuta en múltiples hilos. ---- +.. _class_ProjectSettings_property_editor/movie_writer/audio_bit_depth: + +.. rst-class:: classref-property + +:ref:`int` **editor/movie_writer/audio_bit_depth** = ``16`` :ref:`🔗` + +Number of bits per audio sample written to the ``.avi`` file. Only 16 and 32-bit are supported. + +.. rst-class:: classref-item-separator + +---- + .. _class_ProjectSettings_property_editor/movie_writer/disable_vsync: .. rst-class:: classref-property @@ -5407,6 +5531,36 @@ Valor por defecto para :ref:`ScrollContainer.scroll_deadzone` **gui/common/drag_threshold** = ``10`` :ref:`🔗` + +The minimum distance the mouse cursor must move while pressed before a drag operation begins in the default viewport. For custom viewports see :ref:`Viewport.gui_drag_threshold`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_gui/common/show_focus_state_on_pointer_event: + +.. rst-class:: classref-property + +:ref:`int` **gui/common/show_focus_state_on_pointer_event** = ``1`` :ref:`🔗` + +Determines whether a :ref:`Control` should visually indicate focus when said focus is gained using a mouse or touch input. + +- **Never** (``0``) show the focused state for mouse/touch input. + +- **Control Supports Keyboard Input** (``1``) shows the focused state even when gained via mouse/touch input (similar to how browsers handle focus). + +- **Always** (``2``) show the focused state, even if said focus was gained via mouse/touch input. + +.. rst-class:: classref-item-separator + +---- + .. _class_ProjectSettings_property_gui/common/snap_controls_to_pixels: .. rst-class:: classref-property @@ -5425,13 +5579,15 @@ Si es ``true``, ajusta los vértices del nodo :ref:`Control` al p :ref:`int` **gui/common/swap_cancel_ok** = ``0`` :ref:`🔗` -How to position the Cancel and OK buttons in the project's :ref:`AcceptDialog`\ s. Different platforms have different standard behaviors for this, which can be overridden using this setting. +How to position the Cancel and OK buttons in the project's :ref:`AcceptDialog` windows. Different platforms have different conventions for this, which can be overridden through this setting. -- **Auto** (``0``) follows the platform convention: OK first on Windows, KDE, and LXQt, Cancel first on macOS and other Linux desktop environments. :ref:`DisplayServer.get_swap_cancel_ok()` can be used to query whether buttons are swapped at run-time. +- **Auto** follows the platform convention: OK first on Windows, KDE, and LXQt; Cancel first on macOS and other Linux desktop environments. -- **Cancel First** (``1``) forces the ordering Cancel/OK. +- **Cancel First** forces the Cancel/OK ordering. -- **OK First** (``2``) forces the ordering OK/Cancel. +- **OK First** forces the OK/Cancel ordering. + +To check if these buttons are swapped at runtime, use :ref:`DisplayServer.get_swap_cancel_ok()`. \ **Note:** This doesn't affect native dialogs such as the ones spawned by :ref:`DisplayServer.dialog_show()`. @@ -5457,7 +5613,7 @@ Maximum undo/redo history size for :ref:`TextEdit` fields. :ref:`bool` **gui/fonts/dynamic_fonts/use_oversampling** = ``true`` :ref:`🔗` -If set to ``true`` and :ref:`display/window/stretch/mode` is set to **"canvas_items"**, font and :ref:`DPITexture` oversampling is enabled in the main window. Use :ref:`Viewport.oversampling` to control oversampling in other viewports and windows. +If set to ``true`` and :ref:`display/window/stretch/mode` is set to ``"canvas_items"``, font and :ref:`DPITexture` oversampling is enabled in the main window. Use :ref:`Viewport.oversampling` to control oversampling in other viewports and windows. .. rst-class:: classref-item-separator @@ -5689,6 +5845,32 @@ Default :ref:`InputEventAction` to start or end a drag-a ---- +.. _class_ProjectSettings_property_input/ui_close_dialog: + +.. rst-class:: classref-property + +:ref:`Dictionary` **input/ui_close_dialog** :ref:`🔗` + +Default :ref:`InputEventAction` to close a dialog window. + +\ **Note:** Default ``ui_*`` actions cannot be removed as they are necessary for the internal logic of several :ref:`Control`\ s. The events assigned to the action can however be modified. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_input/ui_close_dialog.macos: + +.. rst-class:: classref-property + +:ref:`Dictionary` **input/ui_close_dialog.macos** :ref:`🔗` + +macOS specific override for the shortcut to close a dialog window. + +.. rst-class:: classref-item-separator + +---- + .. _class_ProjectSettings_property_input/ui_colorpicker_delete_preset: .. rst-class:: classref-property @@ -5759,6 +5941,60 @@ Default :ref:`InputEventAction` to cut a selection to th ---- +.. _class_ProjectSettings_property_input/ui_filedialog_delete: + +.. rst-class:: classref-property + +:ref:`Dictionary` **input/ui_filedialog_delete** :ref:`🔗` + +Default :ref:`InputEventAction` to delete the selected file in a :ref:`FileDialog`. + +\ **Note:** Default ``ui_*`` actions cannot be removed as they are necessary for the internal logic of several :ref:`Control`\ s. The events assigned to the action can however be modified. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_input/ui_filedialog_find: + +.. rst-class:: classref-property + +:ref:`Dictionary` **input/ui_filedialog_find** :ref:`🔗` + +Default :ref:`InputEventAction` to open file filter in a :ref:`FileDialog`. + +\ **Note:** Default ``ui_*`` actions cannot be removed as they are necessary for the internal logic of several :ref:`Control`\ s. The events assigned to the action can however be modified. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_input/ui_filedialog_focus_path: + +.. rst-class:: classref-property + +:ref:`Dictionary` **input/ui_filedialog_focus_path** :ref:`🔗` + +Default :ref:`InputEventAction` to focus path edit field in a :ref:`FileDialog`. + +\ **Note:** Default ``ui_*`` actions cannot be removed as they are necessary for the internal logic of several :ref:`Control`\ s. The events assigned to the action can however be modified. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_input/ui_filedialog_focus_path.macos: + +.. rst-class:: classref-property + +:ref:`Dictionary` **input/ui_filedialog_focus_path.macos** :ref:`🔗` + +macOS specific override for the shortcut to focus path edit field in :ref:`FileDialog`. + +.. rst-class:: classref-item-separator + +---- + .. _class_ProjectSettings_property_input/ui_filedialog_refresh: .. rst-class:: classref-property @@ -9703,6 +9939,26 @@ Default merge rasterizer cell scale for 2D navigation maps. See :ref:`Navigation ---- +.. _class_ProjectSettings_property_navigation/2d/navigation_engine: + +.. rst-class:: classref-property + +:ref:`String` **navigation/2d/navigation_engine** = ``"DEFAULT"`` :ref:`🔗` + +Sets which navigation engine to use for 2D navigation. + +\ **DEFAULT** is equivalent to **GodotNavigation2D**, but may change in future releases. Select an explicit implementation if you want to ensure that your project stays on the same engine. + +\ **GodotNavigation2D** is Godot's internal 2D navigation engine. + +\ **Dummy** is a 2D navigation server that does nothing and returns only dummy values, effectively disabling all 2D navigation functionality. + +Third-party modules can add other navigation engines to select with this setting. + +.. rst-class:: classref-item-separator + +---- + .. _class_ProjectSettings_property_navigation/2d/use_edge_connections: .. rst-class:: classref-property @@ -9811,6 +10067,26 @@ Default merge rasterizer cell scale for 3D navigation maps. See :ref:`Navigation ---- +.. _class_ProjectSettings_property_navigation/3d/navigation_engine: + +.. rst-class:: classref-property + +:ref:`String` **navigation/3d/navigation_engine** = ``"DEFAULT"`` :ref:`🔗` + +Sets which navigation engine to use for 3D navigation. + +\ **DEFAULT** is equivalent to **GodotNavigation3D**, but may change in future releases. Select an explicit implementation if you want to ensure that your project stays on the same engine. + +\ **GodotNavigation3D** is Godot's internal 3D navigation engine. + +\ **Dummy** is a 3D navigation server that does nothing and returns only dummy values, effectively disabling all 3D navigation functionality. + +Third-party modules can add other navigation engines to select with this setting. + +.. rst-class:: classref-item-separator + +---- + .. _class_ProjectSettings_property_navigation/3d/use_edge_connections: .. rst-class:: classref-property @@ -10015,6 +10291,18 @@ Tiempo de espera (en segundos) para los intentos de conexión usando TCP. ---- +.. _class_ProjectSettings_property_network/limits/unix/connect_timeout_seconds: + +.. rst-class:: classref-property + +:ref:`int` **network/limits/unix/connect_timeout_seconds** = ``30`` :ref:`🔗` + +Timeout (in seconds) for connection attempts using UNIX domain socket. + +.. rst-class:: classref-item-separator + +---- + .. _class_ProjectSettings_property_network/limits/webrtc/max_channel_in_buffer_kb: .. rst-class:: classref-property @@ -10033,7 +10321,7 @@ Tamaño máximo (en kiB) para el búfer de entrada :ref:`WebRTCDataChannel` **network/tls/certificate_bundle_override** = ``""`` :ref:`🔗` -The CA certificates bundle to use for TLS connections. If this is set to a non-empty value, this will *override* Godot's default `Mozilla certificate bundle `__. If left empty, the default certificate bundle will be used. +The CA certificates bundle to use for TLS connections. If this is set to a non-empty value, this will *override* Godot's default `Mozilla certificate bundle `__. If left empty, the default certificate bundle will be used. If in doubt, leave this setting empty. @@ -10407,7 +10695,7 @@ Sets which physics engine to use for 3D physics. \ **GodotPhysics3D** is Godot's internal 3D physics engine. -\ **Jolt Physics** is an alternative physics engine that is generally faster and more reliable than **GodotPhysics3D**. As it was recently implemented, it is currently considered experimental and its behavior may change in future releases. +\ **Jolt Physics** is an alternative physics engine that is generally faster and more reliable than **GodotPhysics3D**. Jolt Physics is the default for projects created starting in Godot 4.6. \ **Dummy** is a 3D physics server that does nothing and returns only dummy values, effectively disabling all 3D physics functionality. @@ -11229,11 +11517,11 @@ Establece la sensibilidad a los bordes al usar SMAA para el antialiasing. Los va :ref:`bool` **rendering/anti_aliasing/quality/use_debanding** = ``false`` :ref:`🔗` -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. +If ``true``, uses a fast dithering filter just before transforming floating point color values to integer color values to make banding significantly less visible. Debanding is applied at different steps of the rendering process depending on the rendering method and :ref:`rendering/viewport/hdr_2d` setting. 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. -\ **Note:** This property is only read when the project starts. To set debanding at runtime, set :ref:`Viewport.use_debanding` on the root :ref:`Viewport` instead, or use :ref:`RenderingServer.viewport_set_use_debanding()`. +\ **Note:** This property is only read when the project starts and configures :ref:`RenderingServer.material_set_use_debanding()` and :ref:`Viewport.use_debanding` of the root :ref:`Viewport`. When :ref:`rendering/viewport/hdr_2d` is disabled, you should additionally set the :ref:`Viewport.use_debanding` of other viewports in your project. To set debanding at run-time, the property that should be set depends on the renderer: Forward+ only uses :ref:`Viewport.use_debanding` and Mobile uses both :ref:`RenderingServer.material_set_use_debanding()` and :ref:`Viewport.use_debanding`. .. rst-class:: classref-item-separator @@ -11423,13 +11711,13 @@ Lower-end override for :ref:`rendering/environment/glow/upscale_mode` **rendering/environment/screen_space_reflection/roughness_quality** = ``1`` :ref:`🔗` +:ref:`bool` **rendering/environment/screen_space_reflection/half_size** = ``true`` :ref:`🔗` -Sets the quality for rough screen-space reflections. Turning off will make all screen space reflections sharp, while higher values make rough reflections look better. +If ``true``, screen-space reflections will be rendered at half size and then upscaled before being added to the scene. This is faster but may look pixelated or cause flickering. If ``false``, screen-space reflections will be rendered at full size. .. rst-class:: classref-item-separator @@ -12617,7 +12905,7 @@ Lower-end override for :ref:`rendering/reflections/sky_reflections/ggx_samples` **rendering/reflections/sky_reflections/roughness_layers** = ``8`` :ref:`🔗` +:ref:`int` **rendering/reflections/sky_reflections/roughness_layers** = ``7`` :ref:`🔗` Limits the number of layers to use in radiance maps when using importance sampling. A lower number will be slightly faster and take up less VRAM. @@ -12675,7 +12963,7 @@ Sets the renderer that will be used by the project. Options are: \ **mobile** (Mobile): Modern renderer designed for mobile devices. Has a lower base overhead than Forward+, but does not scale as well to large scenes with many elements. -\ **gl_compatibility** (Compatibility): Low-end renderer designed for older devices. Based on the limitations of the OpenGL 3.3 / OpenGL ES 3.0 / WebGL 2 APIs. +\ **gl_compatibility** (Compatibility): Low-end renderer designed for older devices. Based on the limitations of the OpenGL 3.3 / OpenGL ES 3.0 / WebGL 2 APIs. Lighting calculations are performed on nonlinear sRGB-encoded color data, which produces inaccurate results that may look acceptable for some games. This can be overridden using the ``--rendering-method `` command line argument. @@ -12713,51 +13001,37 @@ Sobrescritura para :ref:`rendering/renderer/rendering_method` **rendering/rendering_device/d3d12/agility_sdk_version** = ``613`` :ref:`🔗` +:ref:`int` **rendering/rendering_device/d3d12/agility_sdk_version** = ``618`` :ref:`🔗` -Version code of the `Direct3D 12 Agility SDK `__ to use (``D3D12SDKVersion``). This must match the *minor* version that is installed next to the editor binary and in the export templates directory for the current editor version. For example, if you have ``1.613.3`` installed, you need to input ``613`` here. +Version code of the `Direct3D 12 Agility SDK `__ to use (``D3D12SDKVersion``). This must match the *minor* version that is installed next to the editor binary and in the export templates directory for the current editor version. For example, if you have ``1.618.5`` installed, you need to input ``618`` here. .. rst-class:: classref-item-separator ---- -.. _class_ProjectSettings_property_rendering/rendering_device/d3d12/max_misc_descriptors_per_frame: +.. _class_ProjectSettings_property_rendering/rendering_device/d3d12/max_resource_descriptors: .. rst-class:: classref-property -:ref:`int` **rendering/rendering_device/d3d12/max_misc_descriptors_per_frame** = ``512`` :ref:`🔗` +:ref:`int` **rendering/rendering_device/d3d12/max_resource_descriptors** = ``65536`` :ref:`🔗` -El número de entradas en el bloque de descriptores misceláneos que el controlador de renderizado Direct3D 12 usa cada fotograma, utilizado para varias operaciones como limpiar una textura. +The number of entries in the resource descriptor heap the Direct3D 12 rendering driver uses for most rendering operations. -Dependiendo de la complejidad de las escenas, este valor puede ser reducido o puede necesitar aumentarse. +Depending on the complexity of scenes, this value may be lowered or may need to be raised. .. rst-class:: classref-item-separator ---- -.. _class_ProjectSettings_property_rendering/rendering_device/d3d12/max_resource_descriptors_per_frame: +.. _class_ProjectSettings_property_rendering/rendering_device/d3d12/max_sampler_descriptors: .. rst-class:: classref-property -:ref:`int` **rendering/rendering_device/d3d12/max_resource_descriptors_per_frame** = ``16384`` :ref:`🔗` +:ref:`int` **rendering/rendering_device/d3d12/max_sampler_descriptors** = ``1024`` :ref:`🔗` -El número de entradas en el bloque de descriptores de recursos que el controlador de renderizado Direct3D 12 usa cada fotograma, utilizado para la mayoría de las operaciones de renderizado. +The number of entries in the sampler descriptor heap the Direct3D 12 rendering driver uses for most rendering operations. -Dependiendo de la complejidad de las escenas, este valor puede ser reducido o puede necesitar aumentarse. - -.. rst-class:: classref-item-separator - ----- - -.. _class_ProjectSettings_property_rendering/rendering_device/d3d12/max_sampler_descriptors_per_frame: - -.. rst-class:: classref-property - -:ref:`int` **rendering/rendering_device/d3d12/max_sampler_descriptors_per_frame** = ``1024`` :ref:`🔗` - -El número de entradas en el bloque de descriptores de sampler que el controlador de renderizado Direct3D 12 usa cada fotograma, utilizado para la mayoría de las operaciones de renderizado. - -Dependiendo de la complejidad de las escenas, este valor puede ser reducido o puede necesitar aumentarse. +Depending on the complexity of scenes, this value may be lowered or may need to be raised. .. rst-class:: classref-item-separator @@ -12885,13 +13159,15 @@ Solo se admite una opción: :ref:`String` **rendering/rendering_device/driver.windows** = ``"vulkan"`` :ref:`🔗` -Sobrescritura de Windows para :ref:`rendering/rendering_device/driver`. +Windows override for :ref:`rendering/rendering_device/driver`. -Se admiten dos opciones: +Two options are supported: -- ``vulkan`` (predeterminado), Vulkan de controladores nativos. Si :ref:`rendering/rendering_device/fallback_to_vulkan` está habilitado, se utiliza como alternativa si Direct3D 12 no es compatible. +- ``vulkan`` (default), Vulkan from native drivers. If :ref:`rendering/rendering_device/fallback_to_vulkan` is enabled, this is used as a fallback if Direct3D 12 is not supported. -- ``d3d12``, Direct3D 12 de controladores nativos. Si :ref:`rendering/rendering_device/fallback_to_d3d12` está habilitado, se utiliza como alternativa si Vulkan no es compatible. +- ``d3d12``, Direct3D 12 from native drivers. If :ref:`rendering/rendering_device/fallback_to_d3d12` is enabled, this is used as a fallback if Vulkan is not supported. + +\ **Note:** Starting with Godot 4.6, new projects are configured by default to use ``d3d12`` on Windows. Projects created before Godot 4.6 keep ``vulkan`` for compatibility reasons, but it is recommended to switch them manually to ``d3d12``. .. rst-class:: classref-item-separator @@ -12903,9 +13179,9 @@ Se admiten dos opciones: :ref:`bool` **rendering/rendering_device/fallback_to_d3d12** = ``true`` :ref:`🔗` -Si es ``true``, el renderizador Forward recurrirá a Direct3D 12 si Vulkan no es compatible. La alternativa siempre se intenta independientemente de esta configuración si la compatibilidad con el controlador Vulkan se deshabilitó en tiempo de compilación. +If ``true``, the Forward+ renderer will fall back to Direct3D 12 if Vulkan is not supported. The fallback is always attempted regardless of this setting if Vulkan driver support was disabled at compile time. -\ **Nota:** Esta configuración solo se implementa en Windows. +\ **Note:** This setting is implemented only on Windows. .. rst-class:: classref-item-separator @@ -12917,9 +13193,9 @@ Si es ``true``, el renderizador Forward recurrirá a Direct3D 12 si Vulkan no es :ref:`bool` **rendering/rendering_device/fallback_to_opengl3** = ``true`` :ref:`🔗` -Si es ``true``, el renderizador Forward recurrirá a OpenGL 3 si Direct3D 12, Metal y Vulkan no son compatibles. +If ``true``, the Forward+ renderer will fall back to OpenGL 3 if Direct3D 12, Metal, and Vulkan are not supported. -\ **Nota:** Esta configuración se implementa en Windows, Android, macOS, iOS y Linux/X11. +\ **Note:** This setting is implemented on Windows, Android, macOS, iOS, and Linux/X11. .. rst-class:: classref-item-separator @@ -12931,9 +13207,9 @@ Si es ``true``, el renderizador Forward recurrirá a OpenGL 3 si Direct3D 12, Me :ref:`bool` **rendering/rendering_device/fallback_to_vulkan** = ``true`` :ref:`🔗` -Si es ``true``, el renderizador Forward recurrirá a Vulkan si Direct3D 12 (en Windows) o Metal (en macOS x86_64) no son compatibles. El recurso siempre se intenta independientemente de este ajuste si la compatibilidad del controlador de Direct3D 12 (Windows) o Metal (macOS) se desactivó en el momento de la compilación. +If ``true``, the Forward+ renderer will fall back to Vulkan if Direct3D 12 (on Windows) or Metal (on macOS x86_64) are not supported. The fallback is always attempted regardless of this setting if Direct3D 12 (Windows) or Metal (macOS) driver support was disabled at compile time. -\ **Nota:** Este ajuste se implementa en Windows y macOS. +\ **Note:** This setting is implemented on Windows and macOS. .. rst-class:: classref-item-separator @@ -13057,7 +13333,7 @@ Use double-buffering with :ref:`DisplayServer.VSYNC_ENABLED`__, an interactive interface that simulates presentation to better understand how it is affected by different variables under various conditions. -\ **Note:** This property is only read when the project starts. There is currently no way to change this value at run-time. +\ **Note:** Changes to this setting will only be applied on startup or when the swapchain is recreated (e.g. when setting the V-Sync mode). \ **Note:** Some platforms may restrict the actual value. @@ -13403,7 +13679,7 @@ If ``true``, the texture importer will import lossless textures using the PNG fo :ref:`bool` **rendering/textures/vram_compression/cache_gpu_compressor** = ``true`` :ref:`🔗` -If ``true``, the GPU texture compressor will cache the local RenderingDevice and its resources (shaders and pipelines), allowing for faster subsequent imports at a memory cost. +If ``true``, the GPU texture compressor will cache the local RenderingDevice and its resources (shaders and pipelines), making subsequent imports faster at the cost of increased memory usage. .. rst-class:: classref-item-separator @@ -13487,11 +13763,9 @@ The default compression factor for lossless WebP. Decompression speed is mostly :ref:`bool` **rendering/viewport/hdr_2d** = ``false`` :ref:`🔗` -If ``true``, enables :ref:`Viewport.use_hdr_2d` on the root viewport. 2D rendering will use a high dynamic range (HDR) format framebuffer matching the bit depth of the 3D framebuffer. When using the Forward+ or Compatibility renderer, this will be an ``RGBA16`` framebuffer. When using the Mobile renderer, it will be an ``RGB10_A2`` framebuffer. +If ``true``, enables :ref:`Viewport.use_hdr_2d` on the root Viewport. 2D rendering will use a high dynamic range (HDR) ``RGBA16`` format framebuffer. Additionally, 2D rendering will be performed on linear values and will be converted using the appropriate transfer function immediately before blitting to the screen. -Additionally, 2D rendering will take place in linear color space and will be converted to sRGB space immediately before blitting to the screen (if the Viewport is attached to the screen). - -Practically speaking, this means that the end result of the Viewport will not be clamped to the ``0-1`` range and can be used in 3D rendering without color space adjustments. This allows 2D rendering to take advantage of effects requiring high dynamic range (e.g. 2D glow) as well as substantially improves the appearance of effects requiring highly detailed gradients. +Practically speaking, this means that the end result of the Viewport will not be clamped to the ``0-1`` range and can be used in 3D rendering without color encoding adjustments. This allows 2D rendering to take advantage of effects requiring high dynamic range (e.g. 2D glow) as well as substantially improves the appearance of effects requiring highly detailed gradients. \ **Note:** This property is only read when the project starts. To toggle HDR 2D at runtime, set :ref:`Viewport.use_hdr_2d` on the root :ref:`Viewport`. @@ -13568,7 +13842,7 @@ The ratio of :ref:`WorkerThreadPool`'s threads that will :ref:`int` **threading/worker_pool/max_threads** = ``-1`` :ref:`🔗` -Número máximo de hilos a ser usados por :ref:`WorkerThreadPool`. Un valor de ``-1`` significa ``1`` en la Web, o el número de núcleos de CPU *lógicos* disponibles en otras plataformas (véase :ref:`OS.get_processor_count()`). +Maximum number of threads to be used by :ref:`WorkerThreadPool`. On Web, a value of ``-1`` means ``1``. On other platforms, it means all *logical* CPU cores available (see :ref:`OS.get_processor_count()`). .. rst-class:: classref-item-separator @@ -13670,6 +13944,20 @@ Especifica si se debe habilitar el seguimiento ocular para este proyecto. Depend ---- +.. _class_ProjectSettings_property_xr/openxr/extensions/frame_synthesis: + +.. rst-class:: classref-property + +:ref:`bool` **xr/openxr/extensions/frame_synthesis** = ``false`` :ref:`🔗` + +If ``true`` the frame synthesis extension will be activated if supported by the platform. + +\ **Note:** This feature should not be enabled in conjunction with Application Space Warp, if supported this replaces ASW. + +.. rst-class:: classref-item-separator + +---- + .. _class_ProjectSettings_property_xr/openxr/extensions/hand_interaction_profile: .. rst-class:: classref-property @@ -13738,6 +14026,142 @@ If ``true`` we enable the render model extension if available. ---- +.. _class_ProjectSettings_property_xr/openxr/extensions/spatial_entity/april_tag_dict: + +.. rst-class:: classref-property + +:ref:`int` **xr/openxr/extensions/spatial_entity/april_tag_dict** = ``"3"`` :ref:`🔗` + +The April Tag marker types the built-in marker tracking is set to recognize (if April Tag marker tracking is available and enabled). + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_xr/openxr/extensions/spatial_entity/aruco_dict: + +.. rst-class:: classref-property + +:ref:`int` **xr/openxr/extensions/spatial_entity/aruco_dict** = ``"15"`` :ref:`🔗` + +The ArUco marker types the built-in marker tracking is set to recognize (if ArUco marker tracking is available and enabled). + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_xr/openxr/extensions/spatial_entity/enable_builtin_anchor_detection: + +.. rst-class:: classref-property + +:ref:`bool` **xr/openxr/extensions/spatial_entity/enable_builtin_anchor_detection** = ``false`` :ref:`🔗` + +If ``true``, we enable the built-in logic for handling anchors. Godot will query (persistent) anchors and manage :ref:`OpenXRAnchorTracker` instances for you. If disabled you'll need to create your own spatial and persistence context and perform your own discovery queries. + +\ **Note:** This functionality requires that spatial anchors are supported and enabled. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_xr/openxr/extensions/spatial_entity/enable_builtin_marker_tracking: + +.. rst-class:: classref-property + +:ref:`bool` **xr/openxr/extensions/spatial_entity/enable_builtin_marker_tracking** = ``false`` :ref:`🔗` + +If ``true``, we enable the built-in logic for handling marker tracking. Godot will query markers and manage :ref:`OpenXRMarkerTracker` instances for you. If disabled you'll need to create your own spatial context and perform your own discovery queries. + +\ **Note:** This functionality requires that marker tracking is supported and enabled. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_xr/openxr/extensions/spatial_entity/enable_builtin_plane_detection: + +.. rst-class:: classref-property + +:ref:`bool` **xr/openxr/extensions/spatial_entity/enable_builtin_plane_detection** = ``false`` :ref:`🔗` + +If ``true``, we enable the built-in logic for handling plane detection. Godot will query detected planes (walls, floors, ceilings, etc.) and manage :ref:`OpenXRPlaneTracker` instances for you. If disabled you'll need to create your own spatial context and perform your own discovery queries. + +\ **Note:** This functionality requires that plane tracking is supported and enabled. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_xr/openxr/extensions/spatial_entity/enable_marker_tracking: + +.. rst-class:: classref-property + +:ref:`bool` **xr/openxr/extensions/spatial_entity/enable_marker_tracking** = ``false`` :ref:`🔗` + +If ``true``, support for the marker tracking extension is requested. If supported, you will be able to query information about markers detected by the XR runtime, e.g. QR codes, aruca markers and april tags. + +\ **Note:** This requires that the OpenXR spatial entities and marker tracking extensions are supported by the XR runtime. If not supported this setting will be ignored. :ref:`xr/openxr/extensions/spatial_entity/enabled` must be enabled for this setting to be used. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_xr/openxr/extensions/spatial_entity/enable_persistent_anchors: + +.. rst-class:: classref-property + +:ref:`bool` **xr/openxr/extensions/spatial_entity/enable_persistent_anchors** = ``false`` :ref:`🔗` + +If ``true``, support for the persistent anchors extension is requested. If supported, you will be able to store spatial anchors and they will be restored on application startup. + +\ **Note:** This requires that the OpenXR spatial entities, spatial anchors, and spatial persistence extensions are supported by the XR runtime. If not supported this setting will be ignored. :ref:`xr/openxr/extensions/spatial_entity/enabled` and :ref:`xr/openxr/extensions/spatial_entity/enable_spatial_anchors` must be enabled for this setting to be used. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_xr/openxr/extensions/spatial_entity/enable_plane_tracking: + +.. rst-class:: classref-property + +:ref:`bool` **xr/openxr/extensions/spatial_entity/enable_plane_tracking** = ``false`` :ref:`🔗` + +If ``true``, support for the plane tracking extension is requested. If supported, you will be able to query information about planes detected by the XR runtime, e.g. walls, floors, etc. + +\ **Note:** This requires that the OpenXR spatial entities and plane tracking extensions are supported by the XR runtime. If not supported this setting will be ignored. :ref:`xr/openxr/extensions/spatial_entity/enabled` must be enabled for this setting to be used. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_xr/openxr/extensions/spatial_entity/enable_spatial_anchors: + +.. rst-class:: classref-property + +:ref:`bool` **xr/openxr/extensions/spatial_entity/enable_spatial_anchors** = ``false`` :ref:`🔗` + +If ``true``, support for the spatial anchors extension is requested. If supported, you will be able to register anchor locations in the real world that the XR runtime will adjust as needed and/or potentially share with other headsets. + +\ **Note:** This requires that the OpenXR spatial entities and spatial anchors extensions are supported by the XR runtime. If not supported this setting will be ignored. :ref:`xr/openxr/extensions/spatial_entity/enabled` must be enabled for this setting to be used. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ProjectSettings_property_xr/openxr/extensions/spatial_entity/enabled: + +.. rst-class:: classref-property + +:ref:`bool` **xr/openxr/extensions/spatial_entity/enabled** = ``false`` :ref:`🔗` + +If ``true``, support for the spatial entity extension is requested. If supported, you will be able to access spatial information about the real environment around you. What information is available is dependent on additional extensions. + +\ **Note:** This requires that the OpenXR spatial entities extension is supported by the XR runtime. If not supported this setting will be ignored. + +.. rst-class:: classref-item-separator + +---- + .. _class_ProjectSettings_property_xr/openxr/form_factor: .. rst-class:: classref-property @@ -13768,9 +14192,9 @@ Si es ``true`` y la foveación es compatible, ajustará automáticamente el nive :ref:`int` **xr/openxr/foveation_level** = ``"0"`` :ref:`🔗` -Nivel de foveación aplicado si es compatible: 0 = desactivado, 1 = bajo, 2 = medio, 3 = alto. +Applied foveation level if supported. -\ **Nota:** En plataformas distintas de Android, si :ref:`rendering/anti_aliasing/quality/msaa_3d` está habilitado, esta característica se deshabilitará. +\ **Note:** On platforms other than Android, if :ref:`rendering/anti_aliasing/quality/msaa_3d` is enabled, this feature will be disabled. .. rst-class:: classref-item-separator @@ -13893,6 +14317,18 @@ Adds a custom property info to a property. The dictionary must contain: ---- +.. _class_ProjectSettings_method_check_changed_settings_in_group: + +.. rst-class:: classref-method + +:ref:`bool` **check_changed_settings_in_group**\ (\ setting_prefix\: :ref:`String`\ ) |const| :ref:`🔗` + +Comprueba si existe algún ajuste con el prefijo ``setting_prefix`` en el conjunto de ajustes modificados. Véase también :ref:`get_changed_settings()`. + +.. rst-class:: classref-item-separator + +---- + .. _class_ProjectSettings_method_clear: .. rst-class:: classref-method @@ -13905,6 +14341,18 @@ Despeja toda la configuración (no recomendado, puede romper cosas). ---- +.. _class_ProjectSettings_method_get_changed_settings: + +.. rst-class:: classref-method + +:ref:`PackedStringArray` **get_changed_settings**\ (\ ) |const| :ref:`🔗` + +Gets an array of the settings which have been changed since the last save. Note that internally ``changed_settings`` is cleared after a successful save, so generally the most appropriate place to use this method is when processing :ref:`settings_changed`. + +.. rst-class:: classref-item-separator + +---- + .. _class_ProjectSettings_method_get_global_class_list: .. rst-class:: classref-method diff --git a/classes/es/class_range.rst b/classes/es/class_range.rst index a0c3e58f58..fc88b876fd 100644 --- a/classes/es/class_range.rst +++ b/classes/es/class_range.rst @@ -255,7 +255,7 @@ If ``true``, :ref:`value` will always be rounded to - |void| **set_step**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_step**\ (\ ) -If greater than 0, :ref:`value` will always be rounded to a multiple of this property's value above :ref:`min_value`. For example, if :ref:`min_value` is ``0.1`` and step is 0.2, then :ref:`value` is limited to ``0.1``, ``0.3``, ``0.5``, and so on. If :ref:`rounded` is also ``true``, :ref:`value` will first be rounded to a multiple of this property's value, then rounded to the nearest integer. +If greater than ``0.0``, :ref:`value` will always be rounded to a multiple of this property's value above :ref:`min_value`. For example, if :ref:`min_value` is ``0.1`` and step is ``0.2``, then :ref:`value` is limited to ``0.1``, ``0.3``, ``0.5``, and so on. If :ref:`rounded` is also ``true``, :ref:`value` will first be rounded to a multiple of this property's value, then rounded to the nearest integer. .. rst-class:: classref-item-separator diff --git a/classes/es/class_rdvertexattribute.rst b/classes/es/class_rdvertexattribute.rst index 2e027c6477..226a453a09 100644 --- a/classes/es/class_rdvertexattribute.rst +++ b/classes/es/class_rdvertexattribute.rst @@ -24,17 +24,19 @@ Propiedades .. table:: :widths: auto - +--------------------------------------------------------------+--------------------------------------------------------------+---------+ - | :ref:`DataFormat` | :ref:`format` | ``232`` | - +--------------------------------------------------------------+--------------------------------------------------------------+---------+ - | :ref:`VertexFrequency` | :ref:`frequency` | ``0`` | - +--------------------------------------------------------------+--------------------------------------------------------------+---------+ - | :ref:`int` | :ref:`location` | ``0`` | - +--------------------------------------------------------------+--------------------------------------------------------------+---------+ - | :ref:`int` | :ref:`offset` | ``0`` | - +--------------------------------------------------------------+--------------------------------------------------------------+---------+ - | :ref:`int` | :ref:`stride` | ``0`` | - +--------------------------------------------------------------+--------------------------------------------------------------+---------+ + +--------------------------------------------------------------+--------------------------------------------------------------+----------------+ + | :ref:`int` | :ref:`binding` | ``4294967295`` | + +--------------------------------------------------------------+--------------------------------------------------------------+----------------+ + | :ref:`DataFormat` | :ref:`format` | ``232`` | + +--------------------------------------------------------------+--------------------------------------------------------------+----------------+ + | :ref:`VertexFrequency` | :ref:`frequency` | ``0`` | + +--------------------------------------------------------------+--------------------------------------------------------------+----------------+ + | :ref:`int` | :ref:`location` | ``0`` | + +--------------------------------------------------------------+--------------------------------------------------------------+----------------+ + | :ref:`int` | :ref:`offset` | ``0`` | + +--------------------------------------------------------------+--------------------------------------------------------------+----------------+ + | :ref:`int` | :ref:`stride` | ``0`` | + +--------------------------------------------------------------+--------------------------------------------------------------+----------------+ .. rst-class:: classref-section-separator @@ -45,6 +47,25 @@ Propiedades Descripciones de Propiedades -------------------------------------------------------- +.. _class_RDVertexAttribute_property_binding: + +.. rst-class:: classref-property + +:ref:`int` **binding** = ``4294967295`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_binding**\ (\ value\: :ref:`int`\ ) +- :ref:`int` **get_binding**\ (\ ) + +The index of the buffer in the vertex buffer array to bind this vertex attribute. When set to ``-1``, it defaults to the index of the attribute. + +\ **Note:** You cannot mix binding explicitly assigned attributes with implicitly assigned ones (i.e. ``-1``). Either all attributes must have their binding set to ``-1``, or all must have explicit bindings. + +.. rst-class:: classref-item-separator + +---- + .. _class_RDVertexAttribute_property_format: .. rst-class:: classref-property diff --git a/classes/es/class_refcounted.rst b/classes/es/class_refcounted.rst index 3811030c62..44e311cc0a 100644 --- a/classes/es/class_refcounted.rst +++ b/classes/es/class_refcounted.rst @@ -7,7 +7,7 @@ RefCounted **Hereda:** :ref:`Object` -**Heredado por:** :ref:`AESContext`, :ref:`AStar2D`, :ref:`AStar3D`, :ref:`AStarGrid2D`, :ref:`AudioEffectInstance`, :ref:`AudioSample`, :ref:`AudioSamplePlayback`, :ref:`AudioStreamPlayback`, :ref:`CameraFeed`, :ref:`CharFXTransform`, :ref:`ConfigFile`, :ref:`Crypto`, :ref:`DirAccess`, :ref:`DTLSServer`, :ref:`EditorContextMenuPlugin`, :ref:`EditorDebuggerPlugin`, :ref:`EditorDebuggerSession`, :ref:`EditorExportPlatform`, :ref:`EditorExportPlugin`, :ref:`EditorExportPreset`, :ref:`EditorFeatureProfile`, :ref:`EditorFileSystemImportFormatSupportQuery`, :ref:`EditorInspectorPlugin`, :ref:`EditorResourceConversionPlugin`, :ref:`EditorResourcePreviewGenerator`, :ref:`EditorResourceTooltipPlugin`, :ref:`EditorSceneFormatImporter`, :ref:`EditorScenePostImport`, :ref:`EditorScenePostImportPlugin`, :ref:`EditorScript`, :ref:`EditorTranslationParserPlugin`, :ref:`EncodedObjectAsID`, :ref:`ENetConnection`, :ref:`EngineProfiler`, :ref:`Expression`, :ref:`FileAccess`, :ref:`GLTFObjectModelProperty`, :ref:`HashingContext`, :ref:`HMACContext`, :ref:`HTTPClient`, :ref:`ImageFormatLoader`, :ref:`JavaClass`, :ref:`JavaObject`, :ref:`JavaScriptObject`, :ref:`KinematicCollision2D`, :ref:`KinematicCollision3D`, :ref:`Lightmapper`, :ref:`Logger`, :ref:`MeshConvexDecompositionSettings`, :ref:`MeshDataTool`, :ref:`MultiplayerAPI`, :ref:`Mutex`, :ref:`NavigationPathQueryParameters2D`, :ref:`NavigationPathQueryParameters3D`, :ref:`NavigationPathQueryResult2D`, :ref:`NavigationPathQueryResult3D`, :ref:`Node3DGizmo`, :ref:`OggPacketSequencePlayback`, :ref:`OpenXRAPIExtension`, :ref:`OpenXRFutureResult`, :ref:`PackedDataContainerRef`, :ref:`PacketPeer`, :ref:`PCKPacker`, :ref:`PhysicsPointQueryParameters2D`, :ref:`PhysicsPointQueryParameters3D`, :ref:`PhysicsRayQueryParameters2D`, :ref:`PhysicsRayQueryParameters3D`, :ref:`PhysicsShapeQueryParameters2D`, :ref:`PhysicsShapeQueryParameters3D`, :ref:`PhysicsTestMotionParameters2D`, :ref:`PhysicsTestMotionParameters3D`, :ref:`PhysicsTestMotionResult2D`, :ref:`PhysicsTestMotionResult3D`, :ref:`RandomNumberGenerator`, :ref:`RDAttachmentFormat`, :ref:`RDFramebufferPass`, :ref:`RDPipelineColorBlendState`, :ref:`RDPipelineColorBlendStateAttachment`, :ref:`RDPipelineDepthStencilState`, :ref:`RDPipelineMultisampleState`, :ref:`RDPipelineRasterizationState`, :ref:`RDPipelineSpecializationConstant`, :ref:`RDSamplerState`, :ref:`RDShaderSource`, :ref:`RDTextureFormat`, :ref:`RDTextureView`, :ref:`RDUniform`, :ref:`RDVertexAttribute`, :ref:`RegEx`, :ref:`RegExMatch`, :ref:`RenderSceneBuffers`, :ref:`RenderSceneBuffersConfiguration`, :ref:`Resource`, :ref:`ResourceFormatLoader`, :ref:`ResourceFormatSaver`, :ref:`ResourceImporter`, :ref:`SceneState`, :ref:`SceneTreeTimer`, :ref:`ScriptBacktrace`, :ref:`Semaphore`, :ref:`SkinReference`, :ref:`StreamPeer`, :ref:`SurfaceTool`, :ref:`TCPServer`, :ref:`TextLine`, :ref:`TextParagraph`, :ref:`TextServer`, :ref:`Thread`, :ref:`TLSOptions`, :ref:`TranslationDomain`, :ref:`TriangleMesh`, :ref:`Tween`, :ref:`Tweener`, :ref:`UDPServer`, :ref:`UPNP`, :ref:`UPNPDevice`, :ref:`WeakRef`, :ref:`WebRTCPeerConnection`, :ref:`XMLParser`, :ref:`XRInterface`, :ref:`XRPose`, :ref:`XRTracker`, :ref:`ZIPPacker`, :ref:`ZIPReader` +**Heredado por:** :ref:`AESContext`, :ref:`AStar2D`, :ref:`AStar3D`, :ref:`AStarGrid2D`, :ref:`AudioEffectInstance`, :ref:`AudioSample`, :ref:`AudioSamplePlayback`, :ref:`AudioStreamPlayback`, :ref:`CameraFeed`, :ref:`CharFXTransform`, :ref:`ConfigFile`, :ref:`Crypto`, :ref:`DirAccess`, :ref:`DTLSServer`, :ref:`EditorContextMenuPlugin`, :ref:`EditorDebuggerPlugin`, :ref:`EditorDebuggerSession`, :ref:`EditorExportPlatform`, :ref:`EditorExportPlugin`, :ref:`EditorExportPreset`, :ref:`EditorFeatureProfile`, :ref:`EditorFileSystemImportFormatSupportQuery`, :ref:`EditorInspectorPlugin`, :ref:`EditorResourceConversionPlugin`, :ref:`EditorResourcePreviewGenerator`, :ref:`EditorResourceTooltipPlugin`, :ref:`EditorSceneFormatImporter`, :ref:`EditorScenePostImport`, :ref:`EditorScenePostImportPlugin`, :ref:`EditorScript`, :ref:`EditorTranslationParserPlugin`, :ref:`EncodedObjectAsID`, :ref:`ENetConnection`, :ref:`EngineProfiler`, :ref:`Expression`, :ref:`FileAccess`, :ref:`GLTFObjectModelProperty`, :ref:`HashingContext`, :ref:`HMACContext`, :ref:`HTTPClient`, :ref:`ImageFormatLoader`, :ref:`JavaClass`, :ref:`JavaObject`, :ref:`JavaScriptObject`, :ref:`KinematicCollision2D`, :ref:`KinematicCollision3D`, :ref:`Lightmapper`, :ref:`Logger`, :ref:`MeshConvexDecompositionSettings`, :ref:`MeshDataTool`, :ref:`MultiplayerAPI`, :ref:`Mutex`, :ref:`NavigationPathQueryParameters2D`, :ref:`NavigationPathQueryParameters3D`, :ref:`NavigationPathQueryResult2D`, :ref:`NavigationPathQueryResult3D`, :ref:`Node3DGizmo`, :ref:`OggPacketSequencePlayback`, :ref:`OpenXRAPIExtension`, :ref:`OpenXRFutureResult`, :ref:`OpenXRSpatialCapabilityConfigurationBaseHeader`, :ref:`OpenXRSpatialComponentData`, :ref:`OpenXRStructureBase`, :ref:`PackedDataContainerRef`, :ref:`PacketPeer`, :ref:`PCKPacker`, :ref:`PhysicsPointQueryParameters2D`, :ref:`PhysicsPointQueryParameters3D`, :ref:`PhysicsRayQueryParameters2D`, :ref:`PhysicsRayQueryParameters3D`, :ref:`PhysicsShapeQueryParameters2D`, :ref:`PhysicsShapeQueryParameters3D`, :ref:`PhysicsTestMotionParameters2D`, :ref:`PhysicsTestMotionParameters3D`, :ref:`PhysicsTestMotionResult2D`, :ref:`PhysicsTestMotionResult3D`, :ref:`RandomNumberGenerator`, :ref:`RDAttachmentFormat`, :ref:`RDFramebufferPass`, :ref:`RDPipelineColorBlendState`, :ref:`RDPipelineColorBlendStateAttachment`, :ref:`RDPipelineDepthStencilState`, :ref:`RDPipelineMultisampleState`, :ref:`RDPipelineRasterizationState`, :ref:`RDPipelineSpecializationConstant`, :ref:`RDSamplerState`, :ref:`RDShaderSource`, :ref:`RDTextureFormat`, :ref:`RDTextureView`, :ref:`RDUniform`, :ref:`RDVertexAttribute`, :ref:`RegEx`, :ref:`RegExMatch`, :ref:`RenderSceneBuffers`, :ref:`RenderSceneBuffersConfiguration`, :ref:`Resource`, :ref:`ResourceFormatLoader`, :ref:`ResourceFormatSaver`, :ref:`ResourceImporter`, :ref:`SceneState`, :ref:`SceneTreeTimer`, :ref:`ScriptBacktrace`, :ref:`Semaphore`, :ref:`SkinReference`, :ref:`SocketServer`, :ref:`StreamPeer`, :ref:`SurfaceTool`, :ref:`TextLine`, :ref:`TextParagraph`, :ref:`TextServer`, :ref:`Thread`, :ref:`TLSOptions`, :ref:`TranslationDomain`, :ref:`TriangleMesh`, :ref:`Tween`, :ref:`Tweener`, :ref:`UDPServer`, :ref:`UPNP`, :ref:`UPNPDevice`, :ref:`WeakRef`, :ref:`WebRTCPeerConnection`, :ref:`XMLParser`, :ref:`XRInterface`, :ref:`XRPose`, :ref:`XRTracker`, :ref:`ZIPPacker`, :ref:`ZIPReader` Clase base para los objetos contados como referencia. diff --git a/classes/es/class_renderingdevice.rst b/classes/es/class_renderingdevice.rst index 7bb3d16224..12aa533121 100644 --- a/classes/es/class_renderingdevice.rst +++ b/classes/es/class_renderingdevice.rst @@ -98,6 +98,8 @@ Métodos +------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_list_bind_vertex_array`\ (\ draw_list\: :ref:`int`, vertex_array\: :ref:`RID`\ ) | +------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`draw_list_bind_vertex_buffers_format`\ (\ draw_list\: :ref:`int`, vertex_format\: :ref:`int`, vertex_count\: :ref:`int`, vertex_buffers\: :ref:`Array`\[:ref:`RID`\], offsets\: :ref:`PackedInt64Array` = PackedInt64Array()\ ) | + +------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_list_disable_scissor`\ (\ draw_list\: :ref:`int`\ ) | +------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_list_draw`\ (\ draw_list\: :ref:`int`, use_indices\: :ref:`bool`, instances\: :ref:`int`, procedural_vertex_count\: :ref:`int` = 0\ ) | @@ -390,10 +392,12 @@ Objeto de entrada de la API de gráficos de más alto nivel (``rid`` ignorado). :ref:`DriverResource` **DRIVER_RESOURCE_COMMAND_QUEUE** = ``3`` -La cola de comandos principal de gráficos-cálculo (``rid`` ignorado). +The main graphics-compute command queue (``rid`` parameter is ignored). - Vulkan: ``VkQueue``. +- D3D12: ``ID3D12CommandQueue``. + - Metal: ``MTLCommandQueue``. .. _class_RenderingDevice_constant_DRIVER_RESOURCE_QUEUE_FAMILY: @@ -414,6 +418,8 @@ La familia específica a la que pertenece la cola principal (``rid`` ignorado). - Vulkan: ``VkImage``. +- D3D12: ``ID3D12Resource``. + .. _class_RenderingDevice_constant_DRIVER_RESOURCE_TEXTURE_VIEW: .. rst-class:: classref-enumeration-constant @@ -746,7 +752,7 @@ Formato de datos de canal rojo de 8 bits por canal, entero con signo. Los valore :ref:`DataFormat` **DATA_FORMAT_R8_SRGB** = ``14`` -Formato de datos de canal rojo de 8 bits por canal, de punto flotante sin signo con valor normalizado y codificación sRGB no lineal. Los valores están en el rango ``[0.0, 1.0]``. +8-bit-per-channel unsigned floating-point red channel data format with normalized value and nonlinear sRGB encoding. Values are in the ``[0.0, 1.0]`` range. .. _class_RenderingDevice_constant_DATA_FORMAT_R8G8_UNORM: @@ -802,7 +808,7 @@ Formato de datos de canal rojo/verde de 8 bits por canal, entero con signo. Los :ref:`DataFormat` **DATA_FORMAT_R8G8_SRGB** = ``21`` -Formato de datos de canal rojo/verde de 8 bits por canal, de punto flotante sin signo con valor normalizado y codificación sRGB no lineal. Los valores están en el rango ``[0.0, 1.0]``. +8-bit-per-channel unsigned floating-point red/green channel data format with normalized value and nonlinear sRGB encoding. Values are in the ``[0.0, 1.0]`` range. .. _class_RenderingDevice_constant_DATA_FORMAT_R8G8B8_UNORM: @@ -858,7 +864,7 @@ Formato de datos de canal rojo/verde/azul de entero con signo de 8 bits por cana :ref:`DataFormat` **DATA_FORMAT_R8G8B8_SRGB** = ``28`` -Formato de datos de canal rojo/verde/azul de punto flotante sin signo de 8 bits por canal con valor normalizado y codificación sRGB no lineal. Los valores están en el rango ``[0.0, 1.0]``. +8-bit-per-channel unsigned floating-point red/green/blue channel data format with normalized value and nonlinear sRGB encoding. Values are in the ``[0.0, 1.0]`` range. .. _class_RenderingDevice_constant_DATA_FORMAT_B8G8R8_UNORM: @@ -914,7 +920,7 @@ Formato de datos de canal azul/verde/rojo de enteros con signo de 8 bits por can :ref:`DataFormat` **DATA_FORMAT_B8G8R8_SRGB** = ``35`` -Formato de datos azul/verde/rojo de punto flotante sin signo de 8 bits por canal con valor normalizado y codificación sRGB no lineal. Los valores están en el rango ``[0.0, 1.0]``. +8-bit-per-channel unsigned floating-point blue/green/red data format with normalized value and nonlinear sRGB encoding. Values are in the ``[0.0, 1.0]`` range. .. _class_RenderingDevice_constant_DATA_FORMAT_R8G8B8A8_UNORM: @@ -970,7 +976,7 @@ Formato de datos de canal rojo/verde/azul/alfa de entero con signo de 8 bits por :ref:`DataFormat` **DATA_FORMAT_R8G8B8A8_SRGB** = ``42`` -Formato de datos de canal rojo/verde/azul/alfa de punto flotante sin signo de 8 bits por canal con valor normalizado y codificación sRGB no lineal. Los valores están en el rango ``[0.0, 1.0]``. +8-bit-per-channel unsigned floating-point red/green/blue/alpha channel data format with normalized value and nonlinear sRGB encoding. Values are in the ``[0.0, 1.0]`` range. .. _class_RenderingDevice_constant_DATA_FORMAT_B8G8R8A8_UNORM: @@ -1026,7 +1032,7 @@ Formato de datos de canal azul/verde/rojo/alfa de entero con signo de 8 bits por :ref:`DataFormat` **DATA_FORMAT_B8G8R8A8_SRGB** = ``49`` -Formato de datos de canal azul/verde/rojo/alfa de punto flotante sin signo de 8 bits por canal con valor normalizado y codificación sRGB no lineal. Los valores están en el rango ``[0.0, 1.0]``. +8-bit-per-channel unsigned floating-point blue/green/red/alpha channel data format with normalized value and nonlinear sRGB encoding. Values are in the ``[0.0, 1.0]`` range. .. _class_RenderingDevice_constant_DATA_FORMAT_A8B8G8R8_UNORM_PACK32: @@ -1082,7 +1088,7 @@ Formato de datos de canal alfa/rojo/verde/azul de entero con signo de 8 bits por :ref:`DataFormat` **DATA_FORMAT_A8B8G8R8_SRGB_PACK32** = ``56`` -Formato de datos de canal alfa/rojo/verde/azul de 8 bits por canal de punto flotante sin signo con valor normalizado y codificación sRGB no lineal, empaquetado en 32 bits. Los valores están en el rango ``[0.0, 1.0]``. +8-bit-per-channel unsigned floating-point alpha/red/green/blue channel data format with normalized value and nonlinear sRGB encoding, packed in 32 bits. Values are in the ``[0.0, 1.0]`` range. .. _class_RenderingDevice_constant_DATA_FORMAT_A2R10G10B10_UNORM_PACK32: @@ -1682,7 +1688,7 @@ Formato de datos de canal rojo/verde/azul sin signo comprimido en VRAM con valor :ref:`DataFormat` **DATA_FORMAT_BC1_RGB_SRGB_BLOCK** = ``131`` -Formato de datos de canal rojo/verde/azul sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal. Los valores están en el rango ``[0.0, 1.0]``. La precisión del formato es de 5 bits del canal rojo, 6 bits del canal verde y 5 bits del canal azul. Usando compresión de textura BC1 (también conocida como S3TC DXT1). +VRAM-compressed unsigned red/green/blue channel data format with normalized value and nonlinear sRGB encoding. Values are in the ``[0.0, 1.0]`` range. The format's precision is 5 bits of red channel, 6 bits of green channel, and 5 bits of blue channel. Using BC1 texture compression (also known as S3TC DXT1). .. _class_RenderingDevice_constant_DATA_FORMAT_BC1_RGBA_UNORM_BLOCK: @@ -1698,7 +1704,7 @@ Formato de datos de canal rojo/verde/azul/alfa sin signo comprimido en VRAM con :ref:`DataFormat` **DATA_FORMAT_BC1_RGBA_SRGB_BLOCK** = ``133`` -Formato de datos de canal rojo/verde/azul/alfa sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal. Los valores están en el rango ``[0.0, 1.0]``. La precisión del formato es de 5 bits del canal rojo, 6 bits del canal verde, 5 bits del canal azul y 1 bit del canal alfa. Usando compresión de textura BC1 (también conocida como S3TC DXT1). +VRAM-compressed unsigned red/green/blue/alpha channel data format with normalized value and nonlinear sRGB encoding. Values are in the ``[0.0, 1.0]`` range. The format's precision is 5 bits of red channel, 6 bits of green channel, 5 bits of blue channel, and 1 bit of alpha channel. Using BC1 texture compression (also known as S3TC DXT1). .. _class_RenderingDevice_constant_DATA_FORMAT_BC2_UNORM_BLOCK: @@ -1714,7 +1720,7 @@ Formato de datos de canal rojo/verde/azul/alfa sin signo comprimido en VRAM con :ref:`DataFormat` **DATA_FORMAT_BC2_SRGB_BLOCK** = ``135`` -Formato de datos de canal rojo/verde/azul/alfa sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal. Los valores están en el rango ``[0.0, 1.0]``. La precisión del formato es de 5 bits del canal rojo, 6 bits del canal verde, 5 bits del canal azul y 4 bits del canal alfa. Utiliza la compresión de texturas BC2 (también conocida como S3TC DXT3). +VRAM-compressed unsigned red/green/blue/alpha channel data format with normalized value and nonlinear sRGB encoding. Values are in the ``[0.0, 1.0]`` range. The format's precision is 5 bits of red channel, 6 bits of green channel, 5 bits of blue channel, and 4 bits of alpha channel. Using BC2 texture compression (also known as S3TC DXT3). .. _class_RenderingDevice_constant_DATA_FORMAT_BC3_UNORM_BLOCK: @@ -1730,7 +1736,7 @@ Formato de datos de canal rojo/verde/azul/alfa sin signo comprimido en VRAM con :ref:`DataFormat` **DATA_FORMAT_BC3_SRGB_BLOCK** = ``137`` -Formato de datos de canal rojo/verde/azul/alfa sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal. Los valores están en el rango ``[0.0, 1.0]``. La precisión del formato es de 5 bits del canal rojo, 6 bits del canal verde, 5 bits del canal azul y 8 bits del canal alfa. Utiliza la compresión de texturas BC3 (también conocida como S3TC DXT5). +VRAM-compressed unsigned red/green/blue/alpha channel data format with normalized value and nonlinear sRGB encoding. Values are in the ``[0.0, 1.0]`` range. The format's precision is 5 bits of red channel, 6 bits of green channel, 5 bits of blue channel, and 8 bits of alpha channel. Using BC3 texture compression (also known as S3TC DXT5). .. _class_RenderingDevice_constant_DATA_FORMAT_BC4_UNORM_BLOCK: @@ -1794,7 +1800,7 @@ Formato de datos de canal rojo/verde/azul/alfa sin signo comprimido en VRAM con :ref:`DataFormat` **DATA_FORMAT_BC7_SRGB_BLOCK** = ``145`` -Formato de datos de canal rojo/verde/azul/alfa sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal. Los valores están en el rango ``[0.0, 1.0]``. La precisión del formato está entre 4 y 7 bits para los canales rojo/verde/azul y entre 0 y 8 bits para el canal alfa. También conocido como BPTC LDR. +VRAM-compressed unsigned red/green/blue/alpha channel data format with normalized value and nonlinear sRGB encoding. Values are in the ``[0.0, 1.0]`` range. The format's precision is between 4 and 7 bits for the red/green/blue channels and between 0 and 8 bits for the alpha channel. Also known as BPTC LDR. .. _class_RenderingDevice_constant_DATA_FORMAT_ETC2_R8G8B8_UNORM_BLOCK: @@ -1810,7 +1816,7 @@ Formato de datos de canal rojo/verde/azul sin signo comprimido en VRAM con valor :ref:`DataFormat` **DATA_FORMAT_ETC2_R8G8B8_SRGB_BLOCK** = ``147`` -Formato de datos de canal rojo/verde/azul sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal. Los valores están en el rango ``[0.0, 1.0]``. Utiliza compresión de texturas ETC2. +VRAM-compressed unsigned red/green/blue channel data format with normalized value and nonlinear sRGB encoding. Values are in the ``[0.0, 1.0]`` range. Using ETC2 texture compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ETC2_R8G8B8A1_UNORM_BLOCK: @@ -1826,7 +1832,7 @@ Formato de datos de canal rojo/verde/azul/alfa sin signo comprimido en VRAM con :ref:`DataFormat` **DATA_FORMAT_ETC2_R8G8B8A1_SRGB_BLOCK** = ``149`` -Formato de datos de canal rojo/verde/azul/alfa sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal. Los valores están en el rango ``[0.0, 1.0]``. Rojo/verde/azul utilizan 8 bits de precisión cada uno, con alfa utilizando 1 bit de precisión. Utiliza la compresión de texturas ETC2. +VRAM-compressed unsigned red/green/blue/alpha channel data format with normalized value and nonlinear sRGB encoding. Values are in the ``[0.0, 1.0]`` range. Red/green/blue use 8 bit of precision each, with alpha using 1 bit of precision. Using ETC2 texture compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ETC2_R8G8B8A8_UNORM_BLOCK: @@ -1842,7 +1848,7 @@ Formato de datos de canal rojo/verde/azul/alfa sin signo comprimido en VRAM con :ref:`DataFormat` **DATA_FORMAT_ETC2_R8G8B8A8_SRGB_BLOCK** = ``151`` -Formato de datos de canal rojo/verde/azul/alfa sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal. Los valores están en el rango ``[0.0, 1.0]``. Rojo/verde/azul utilizan 8 bits de precisión cada uno, con alfa utilizando 8 bits de precisión. Utiliza la compresión de texturas ETC2. +VRAM-compressed unsigned red/green/blue/alpha channel data format with normalized value and nonlinear sRGB encoding. Values are in the ``[0.0, 1.0]`` range. Red/green/blue use 8 bits of precision each, with alpha using 8 bits of precision. Using ETC2 texture compression. .. _class_RenderingDevice_constant_DATA_FORMAT_EAC_R11_UNORM_BLOCK: @@ -1890,7 +1896,7 @@ Formato de datos de punto flotante sin signo comprimido en VRAM con valor normal :ref:`DataFormat` **DATA_FORMAT_ASTC_4x4_SRGB_BLOCK** = ``157`` -Formato de datos de punto flotante sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal, empaquetado en bloques de 4×4 (máxima calidad). Los valores están en el rango ``[0.0, 1.0]``. Utiliza la compresión ASTC. +VRAM-compressed unsigned floating-point data format with normalized value and nonlinear sRGB encoding, packed in 4×4 blocks (highest quality). Values are in the ``[0.0, 1.0]`` range. Using ASTC compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ASTC_5x4_UNORM_BLOCK: @@ -1906,7 +1912,7 @@ Formato de datos de punto flotante sin signo comprimido en VRAM con valor normal :ref:`DataFormat` **DATA_FORMAT_ASTC_5x4_SRGB_BLOCK** = ``159`` -Formato de datos de punto flotante sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal, empaquetado en bloques de 5×4. Los valores están en el rango ``[0.0, 1.0]``. Utiliza la compresión ASTC. +VRAM-compressed unsigned floating-point data format with normalized value and nonlinear sRGB encoding, packed in 5×4 blocks. Values are in the ``[0.0, 1.0]`` range. Using ASTC compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ASTC_5x5_UNORM_BLOCK: @@ -1922,7 +1928,7 @@ Formato de datos de punto flotante sin signo comprimido en VRAM con valor normal :ref:`DataFormat` **DATA_FORMAT_ASTC_5x5_SRGB_BLOCK** = ``161`` -Formato de datos de punto flotante sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal, empaquetado en bloques de 5×5. Los valores están en el rango ``[0.0, 1.0]``. Utiliza la compresión ASTC. +VRAM-compressed unsigned floating-point data format with normalized value and nonlinear sRGB encoding, packed in 5×5 blocks. Values are in the ``[0.0, 1.0]`` range. Using ASTC compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ASTC_6x5_UNORM_BLOCK: @@ -1938,7 +1944,7 @@ Formato de datos de punto flotante sin signo comprimido en VRAM con valor normal :ref:`DataFormat` **DATA_FORMAT_ASTC_6x5_SRGB_BLOCK** = ``163`` -Formato de datos de punto flotante sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal, empaquetado en bloques de 6×5. Los valores están en el rango ``[0.0, 1.0]``. Utiliza la compresión ASTC. +VRAM-compressed unsigned floating-point data format with normalized value and nonlinear sRGB encoding, packed in 6×5 blocks. Values are in the ``[0.0, 1.0]`` range. Using ASTC compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ASTC_6x6_UNORM_BLOCK: @@ -1954,7 +1960,7 @@ Formato de datos de punto flotante sin signo comprimido en VRAM con valor normal :ref:`DataFormat` **DATA_FORMAT_ASTC_6x6_SRGB_BLOCK** = ``165`` -Formato de datos de punto flotante sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal, empaquetado en bloques de 6×6. Los valores están en el rango ``[0.0, 1.0]``. Utiliza la compresión ASTC. +VRAM-compressed unsigned floating-point data format with normalized value and nonlinear sRGB encoding, packed in 6×6 blocks. Values are in the ``[0.0, 1.0]`` range. Using ASTC compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ASTC_8x5_UNORM_BLOCK: @@ -1970,7 +1976,7 @@ Formato de datos de punto flotante sin signo comprimido en VRAM con valor normal :ref:`DataFormat` **DATA_FORMAT_ASTC_8x5_SRGB_BLOCK** = ``167`` -Formato de datos de punto flotante sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal, empaquetado en bloques de 8×5. Los valores están en el rango ``[0.0, 1.0]``. Utiliza la compresión ASTC. +VRAM-compressed unsigned floating-point data format with normalized value and nonlinear sRGB encoding, packed in 8×5 blocks. Values are in the ``[0.0, 1.0]`` range. Using ASTC compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ASTC_8x6_UNORM_BLOCK: @@ -1986,7 +1992,7 @@ Formato de datos de punto flotante sin signo comprimido en VRAM con valor normal :ref:`DataFormat` **DATA_FORMAT_ASTC_8x6_SRGB_BLOCK** = ``169`` -Formato de datos de punto flotante sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal, empaquetado en bloques de 8×6. Los valores están en el rango ``[0.0, 1.0]``. Utiliza la compresión ASTC. +VRAM-compressed unsigned floating-point data format with normalized value and nonlinear sRGB encoding, packed in 8×6 blocks. Values are in the ``[0.0, 1.0]`` range. Using ASTC compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ASTC_8x8_UNORM_BLOCK: @@ -2002,7 +2008,7 @@ Formato de datos de punto flotante sin signo comprimido en VRAM con valor normal :ref:`DataFormat` **DATA_FORMAT_ASTC_8x8_SRGB_BLOCK** = ``171`` -Formato de datos de punto flotante sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal, empaquetado en bloques de 8×8. Los valores están en el rango ``[0.0, 1.0]``. Utiliza la compresión ASTC. +VRAM-compressed unsigned floating-point data format with normalized value and nonlinear sRGB encoding, packed in 8×8 blocks. Values are in the ``[0.0, 1.0]`` range. Using ASTC compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ASTC_10x5_UNORM_BLOCK: @@ -2018,7 +2024,7 @@ Formato de datos de punto flotante sin signo comprimido en VRAM con valor normal :ref:`DataFormat` **DATA_FORMAT_ASTC_10x5_SRGB_BLOCK** = ``173`` -Formato de datos de punto flotante sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal, empaquetado en bloques de 10×5. Los valores están en el rango ``[0.0, 1.0]``. Utiliza la compresión ASTC. +VRAM-compressed unsigned floating-point data format with normalized value and nonlinear sRGB encoding, packed in 10×5 blocks. Values are in the ``[0.0, 1.0]`` range. Using ASTC compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ASTC_10x6_UNORM_BLOCK: @@ -2034,7 +2040,7 @@ Formato de datos de punto flotante sin signo comprimido en VRAM con valor normal :ref:`DataFormat` **DATA_FORMAT_ASTC_10x6_SRGB_BLOCK** = ``175`` -Formato de datos de punto flotante sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal, empaquetado en bloques de 10×6. Los valores están en el rango ``[0.0, 1.0]``. Utiliza la compresión ASTC. +VRAM-compressed unsigned floating-point data format with normalized value and nonlinear sRGB encoding, packed in 10×6 blocks. Values are in the ``[0.0, 1.0]`` range. Using ASTC compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ASTC_10x8_UNORM_BLOCK: @@ -2050,7 +2056,7 @@ Formato de datos de punto flotante sin signo comprimido en VRAM con valor normal :ref:`DataFormat` **DATA_FORMAT_ASTC_10x8_SRGB_BLOCK** = ``177`` -Formato de datos de punto flotante sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal, empaquetado en bloques de 10×8. Los valores están en el rango ``[0.0, 1.0]``. Utiliza la compresión ASTC. +VRAM-compressed unsigned floating-point data format with normalized value and nonlinear sRGB encoding, packed in 10×8 blocks. Values are in the ``[0.0, 1.0]`` range. Using ASTC compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ASTC_10x10_UNORM_BLOCK: @@ -2066,7 +2072,7 @@ Formato de datos de punto flotante sin signo comprimido en VRAM con valor normal :ref:`DataFormat` **DATA_FORMAT_ASTC_10x10_SRGB_BLOCK** = ``179`` -Formato de datos de punto flotante sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal, empaquetado en bloques de 10×10. Los valores están en el rango ``[0.0, 1.0]``. Utiliza la compresión ASTC. +VRAM-compressed unsigned floating-point data format with normalized value and nonlinear sRGB encoding, packed in 10×10 blocks. Values are in the ``[0.0, 1.0]`` range. Using ASTC compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ASTC_12x10_UNORM_BLOCK: @@ -2082,7 +2088,7 @@ Formato de datos de punto flotante sin signo comprimido en VRAM con valor normal :ref:`DataFormat` **DATA_FORMAT_ASTC_12x10_SRGB_BLOCK** = ``181`` -Formato de datos de punto flotante sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal, empaquetado en bloques de 12×10. Los valores están en el rango ``[0.0, 1.0]``. Utiliza la compresión ASTC. +VRAM-compressed unsigned floating-point data format with normalized value and nonlinear sRGB encoding, packed in 12×10 blocks. Values are in the ``[0.0, 1.0]`` range. Using ASTC compression. .. _class_RenderingDevice_constant_DATA_FORMAT_ASTC_12x12_UNORM_BLOCK: @@ -2098,7 +2104,7 @@ Formato de datos de punto flotante sin signo comprimido en VRAM con valor normal :ref:`DataFormat` **DATA_FORMAT_ASTC_12x12_SRGB_BLOCK** = ``183`` -Formato de datos de punto flotante sin signo comprimido en VRAM con valor normalizado y codificación sRGB no lineal, empaquetado en bloques de 12 (calidad más baja). Los valores están en el rango ``[0.0, 1.0]``. Utiliza la compresión ASTC. +VRAM-compressed unsigned floating-point data format with normalized value and nonlinear sRGB encoding, packed in 12 blocks (lowest quality). Values are in the ``[0.0, 1.0]`` range. Using ASTC compression. .. _class_RenderingDevice_constant_DATA_FORMAT_G8B8G8R8_422_UNORM: @@ -2796,6 +2802,14 @@ Texture can be used as a color attachment in a framebuffer. Texture can be used as a depth/stencil attachment in a framebuffer. +.. _class_RenderingDevice_constant_TEXTURE_USAGE_DEPTH_RESOLVE_ATTACHMENT_BIT: + +.. rst-class:: classref-enumeration-constant + +:ref:`TextureUsageBits` **TEXTURE_USAGE_DEPTH_RESOLVE_ATTACHMENT_BIT** = ``4096`` + +Texture can be used as a depth/stencil resolve attachment in a framebuffer. + .. _class_RenderingDevice_constant_TEXTURE_USAGE_STORAGE_BIT: .. rst-class:: classref-enumeration-constant @@ -3313,11 +3327,35 @@ Uniforme de `búfer de almacenamiento ` **UNIFORM_TYPE_UNIFORM_BUFFER_DYNAMIC** = ``10`` + +Same as UNIFORM_TYPE_UNIFORM_BUFFER but for buffers created with BUFFER_CREATION_DYNAMIC_PERSISTENT_BIT. + +\ **Note:** This flag is not available to GD users due to being too dangerous (i.e. wrong usage can result in visual glitches). + +It's exposed in case GD users receive a buffer created with such flag from Godot. + +.. _class_RenderingDevice_constant_UNIFORM_TYPE_STORAGE_BUFFER_DYNAMIC: + +.. rst-class:: classref-enumeration-constant + +:ref:`UniformType` **UNIFORM_TYPE_STORAGE_BUFFER_DYNAMIC** = ``11`` + +Same as UNIFORM_TYPE_STORAGE_BUFFER but for buffers created with BUFFER_CREATION_DYNAMIC_PERSISTENT_BIT. + +\ **Note:** This flag is not available to GD users due to being too dangerous (i.e. wrong usage can result in visual glitches). + +It's exposed in case GD users receive a buffer created with such flag from Godot. + .. _class_RenderingDevice_constant_UNIFORM_TYPE_MAX: .. rst-class:: classref-enumeration-constant -:ref:`UniformType` **UNIFORM_TYPE_MAX** = ``10`` +:ref:`UniformType` **UNIFORM_TYPE_MAX** = ``12`` Representa el tamaño del enum :ref:`UniformType`. @@ -5478,9 +5516,11 @@ Establece los datos constantes de inserción en ``buffer`` para la ``compute_lis :ref:`RID` **compute_pipeline_create**\ (\ shader\: :ref:`RID`, specialization_constants\: :ref:`Array`\[:ref:`RDPipelineSpecializationConstant`\] = []\ ) :ref:`🔗` -Crea un nuevo pipeline de cómputo. Se puede acceder a él con el RID que se devuelve. +Creates a new compute pipeline. It can be accessed with the RID that is returned. -Una vez que hayas terminado con tu RID, querrás liberarlo usando el método :ref:`free_rid()` de RenderingDevice. +Once finished with your RID, you will want to free the RID using the RenderingDevice's :ref:`free_rid()` method. + +This will be freed automatically when the ``shader`` is freed. .. rst-class:: classref-item-separator @@ -5671,6 +5711,18 @@ Vincula ``vertex_array`` a la ``draw_list`` especificada. ---- +.. _class_RenderingDevice_method_draw_list_bind_vertex_buffers_format: + +.. rst-class:: classref-method + +|void| **draw_list_bind_vertex_buffers_format**\ (\ draw_list\: :ref:`int`, vertex_format\: :ref:`int`, vertex_count\: :ref:`int`, vertex_buffers\: :ref:`Array`\[:ref:`RID`\], offsets\: :ref:`PackedInt64Array` = PackedInt64Array()\ ) :ref:`🔗` + +Binds a set of ``vertex_buffers`` directly to the specified ``draw_list`` using ``vertex_format`` without creating a vertex array RID. Provide the number of vertices in ``vertex_count``; optional per-buffer byte ``offsets`` may also be supplied. + +.. rst-class:: classref-item-separator + +---- + .. _class_RenderingDevice_method_draw_list_disable_scissor: .. rst-class:: classref-method @@ -5793,6 +5845,8 @@ Creates a new framebuffer. It can be accessed with the RID that is returned. Once finished with your RID, you will want to free the RID using the RenderingDevice's :ref:`free_rid()` method. +This will be freed automatically when any of the ``textures`` is freed. + .. rst-class:: classref-item-separator ---- @@ -5821,6 +5875,8 @@ Creates a new multipass framebuffer. It can be accessed with the RID that is ret Once finished with your RID, you will want to free the RID using the RenderingDevice's :ref:`free_rid()` method. +This will be freed automatically when any of the ``textures`` is freed. + .. rst-class:: classref-item-separator ---- @@ -6285,6 +6341,8 @@ Creates a new index array. It can be accessed with the RID that is returned. Once finished with your RID, you will want to free the RID using the RenderingDevice's :ref:`free_rid()` method. +This will be freed automatically when the ``index_buffer`` is freed. + .. rst-class:: classref-item-separator ---- @@ -6327,6 +6385,8 @@ Creates a new render pipeline. It can be accessed with the RID that is returned. Once finished with your RID, you will want to free the RID using the RenderingDevice's :ref:`free_rid()` method. +This will be freed automatically when the ``shader`` is freed. + .. rst-class:: classref-item-separator ---- @@ -6639,6 +6699,8 @@ Returns an RID for an existing ``image`` (``VkImage``) with the given ``type``, Creates a shared texture using the specified ``view`` and the texture information from ``with_texture``. +This will be freed automatically when the ``with_texture`` is freed. + .. rst-class:: classref-item-separator ---- @@ -6655,6 +6717,8 @@ For 2D textures (which only have one layer), ``layer`` must be ``0``. \ **Note:** Layer slicing is only supported for 2D texture arrays, not 3D textures or cubemaps. +This will be freed automatically when the ``with_texture`` is freed. + .. rst-class:: classref-item-separator ---- @@ -6862,6 +6926,8 @@ Creates a new uniform set. It can be accessed with the RID that is returned. Once finished with your RID, you will want to free the RID using the RenderingDevice's :ref:`free_rid()` method. +This will be freed automatically when the ``shader`` or any of the RIDs in the ``uniforms`` is freed. + .. rst-class:: classref-item-separator ---- @@ -6884,7 +6950,11 @@ Checks if the ``uniform_set`` is valid, i.e. is owned. :ref:`RID` **vertex_array_create**\ (\ vertex_count\: :ref:`int`, vertex_format\: :ref:`int`, src_buffers\: :ref:`Array`\[:ref:`RID`\], offsets\: :ref:`PackedInt64Array` = PackedInt64Array()\ ) :ref:`🔗` -Crea un array de vértices basado en los búferes especificados. Opcionalmente, se pueden definir ``offsets`` (en bytes) para cada búfer. +Creates a vertex array based on the specified buffers. Optionally, ``offsets`` (in bytes) may be defined for each buffer. + +Once finished with your RID, you will want to free the RID using the RenderingDevice's :ref:`free_rid()` method. + +This will be freed automatically when any of the ``src_buffers`` is freed. .. rst-class:: classref-item-separator diff --git a/classes/es/class_renderingserver.rst b/classes/es/class_renderingserver.rst index d8ac437990..59d1c63120 100644 --- a/classes/es/class_renderingserver.rst +++ b/classes/es/class_renderingserver.rst @@ -104,6 +104,8 @@ Métodos +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`canvas_item_add_clip_ignore`\ (\ item\: :ref:`RID`, ignore\: :ref:`bool`\ ) | +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`canvas_item_add_ellipse`\ (\ item\: :ref:`RID`, pos\: :ref:`Vector2`, major\: :ref:`float`, minor\: :ref:`float`, color\: :ref:`Color`, antialiased\: :ref:`bool` = false\ ) | + +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`canvas_item_add_lcd_texture_rect_region`\ (\ item\: :ref:`RID`, rect\: :ref:`Rect2`, texture\: :ref:`RID`, src_rect\: :ref:`Rect2`, modulate\: :ref:`Color`\ ) | +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`canvas_item_add_line`\ (\ item\: :ref:`RID`, from\: :ref:`Vector2`, to\: :ref:`Vector2`, color\: :ref:`Color`, width\: :ref:`float` = -1.0, antialiased\: :ref:`bool` = false\ ) | @@ -384,10 +386,14 @@ Métodos +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`environment_set_ssr`\ (\ env\: :ref:`RID`, enable\: :ref:`bool`, max_steps\: :ref:`int`, fade_in\: :ref:`float`, fade_out\: :ref:`float`, depth_tolerance\: :ref:`float`\ ) | +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`environment_set_ssr_half_size`\ (\ half_size\: :ref:`bool`\ ) | + +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`environment_set_ssr_roughness_quality`\ (\ quality\: :ref:`EnvironmentSSRRoughnessQuality`\ ) | +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`environment_set_tonemap`\ (\ env\: :ref:`RID`, tone_mapper\: :ref:`EnvironmentToneMapper`, exposure\: :ref:`float`, white\: :ref:`float`\ ) | +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`environment_set_tonemap_agx_contrast`\ (\ env\: :ref:`RID`, agx_contrast\: :ref:`float`\ ) | + +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`environment_set_volumetric_fog`\ (\ env\: :ref:`RID`, enable\: :ref:`bool`, density\: :ref:`float`, albedo\: :ref:`Color`, emission\: :ref:`Color`, emission_energy\: :ref:`float`, anisotropy\: :ref:`float`, length\: :ref:`float`, p_detail_spread\: :ref:`float`, gi_inject\: :ref:`float`, temporal_reprojection\: :ref:`bool`, temporal_reprojection_amount\: :ref:`float`, ambient_inject\: :ref:`float`, sky_affect\: :ref:`float`\ ) | +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`environment_set_volumetric_fog_filter_active`\ (\ active\: :ref:`bool`\ ) | @@ -594,6 +600,8 @@ Métodos +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`material_set_shader`\ (\ shader_material\: :ref:`RID`, shader\: :ref:`RID`\ ) | +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`material_set_use_debanding`\ (\ enable\: :ref:`bool`\ ) | + +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`mesh_add_surface`\ (\ mesh\: :ref:`RID`, surface\: :ref:`Dictionary`\ ) | +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`mesh_add_surface_from_arrays`\ (\ mesh\: :ref:`RID`, primitive\: :ref:`PrimitiveType`, arrays\: :ref:`Array`, blend_shapes\: :ref:`Array` = [], lods\: :ref:`Dictionary` = {}, compress_format\: |bitfield|\[:ref:`ArrayFormat`\] = 0\ ) | @@ -688,6 +696,8 @@ Métodos +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`multimesh_instance_set_transform_2d`\ (\ multimesh\: :ref:`RID`, index\: :ref:`int`, transform\: :ref:`Transform2D`\ ) | +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`multimesh_instances_reset_physics_interpolation`\ (\ multimesh\: :ref:`RID`\ ) | + +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`multimesh_set_buffer`\ (\ multimesh\: :ref:`RID`, buffer\: :ref:`PackedFloat32Array`\ ) | +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`multimesh_set_buffer_interpolated`\ (\ multimesh\: :ref:`RID`, buffer\: :ref:`PackedFloat32Array`, buffer_previous\: :ref:`PackedFloat32Array`\ ) | @@ -854,6 +864,8 @@ Métodos +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_boot_image`\ (\ image\: :ref:`Image`, color\: :ref:`Color`, scale\: :ref:`bool`, use_filter\: :ref:`bool` = true\ ) | +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_boot_image_with_stretch`\ (\ image\: :ref:`Image`, color\: :ref:`Color`, stretch_mode\: :ref:`SplashStretchMode`, use_filter\: :ref:`bool` = true\ ) | + +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_debug_generate_wireframes`\ (\ generate\: :ref:`bool`\ ) | +----------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_default_clear_color`\ (\ color\: :ref:`Color`\ ) | @@ -3699,9 +3711,11 @@ Dibuja los datos de la cascada SDFGI. Esta es la estructura de datos que se util :ref:`ViewportDebugDraw` **VIEWPORT_DEBUG_DRAW_SDFGI_PROBES** = ``17`` -Dibuja los datos de la sonda SDFGI. Esta es la estructura de datos que se utiliza para dar iluminación indirecta a los objetos dinámicos que se mueven dentro de la escena. +Draws SDFGI probe data. This is the data structure that is used to give indirect lighting dynamic objects moving within the scene. -\ **Nota:** Solo se admite cuando se utiliza el método de renderizado Forward+. +When in the editor, left-clicking a probe will display additional bright dots that show its occlusion information. A white dot means the light is not occluded at all at the dot's position, while a red dot means the light is fully occluded. Intermediate values are possible. + +\ **Note:** Only supported when using the Forward+ rendering method. .. _class_RenderingServer_constant_VIEWPORT_DEBUG_DRAW_GI_BUFFER: @@ -4301,9 +4315,7 @@ Utiliza una curva de mapeo de tonos similar a la de una película de alto contra :ref:`EnvironmentToneMapper` **ENV_TONE_MAPPER_AGX** = ``4`` -Utiliza una curva de mapeo de tonos similar a la de una película y desatura los valores brillantes para una apariencia más realista. Mejor que otros mapeadores de tonos para mantener el tono de los colores a medida que se vuelven más brillantes. La opción de mapeo de tonos más lenta. - -\ **Nota:** :ref:`Environment.tonemap_white` se fija en un valor de ``16.29``, lo que hace que :ref:`ENV_TONE_MAPPER_AGX` no sea adecuado para su uso con el método de renderizado Mobile. +Uses an adjustable film-like tonemapping curve and desaturates bright values for a more realistic appearance. Better than other tonemappers at maintaining the hue of colors as they become brighter. The slowest tonemapping option. .. rst-class:: classref-item-separator @@ -5887,6 +5899,64 @@ Representa el tamaño del enum :ref:`PipelineSource` + +.. _class_RenderingServer_constant_SPLASH_STRETCH_MODE_DISABLED: + +.. rst-class:: classref-enumeration-constant + +:ref:`SplashStretchMode` **SPLASH_STRETCH_MODE_DISABLED** = ``0`` + +No stretching is applied. + +.. _class_RenderingServer_constant_SPLASH_STRETCH_MODE_KEEP: + +.. rst-class:: classref-enumeration-constant + +:ref:`SplashStretchMode` **SPLASH_STRETCH_MODE_KEEP** = ``1`` + +Stretches image to fullscreen while preserving aspect ratio. + +.. _class_RenderingServer_constant_SPLASH_STRETCH_MODE_KEEP_WIDTH: + +.. rst-class:: classref-enumeration-constant + +:ref:`SplashStretchMode` **SPLASH_STRETCH_MODE_KEEP_WIDTH** = ``2`` + +Stretches the height of the image based on the width of the screen. + +.. _class_RenderingServer_constant_SPLASH_STRETCH_MODE_KEEP_HEIGHT: + +.. rst-class:: classref-enumeration-constant + +:ref:`SplashStretchMode` **SPLASH_STRETCH_MODE_KEEP_HEIGHT** = ``3`` + +Stretches the width of the image based on the height of the screen. + +.. _class_RenderingServer_constant_SPLASH_STRETCH_MODE_COVER: + +.. rst-class:: classref-enumeration-constant + +:ref:`SplashStretchMode` **SPLASH_STRETCH_MODE_COVER** = ``4`` + +Stretches the image to cover the entire screen while preserving aspect ratio. + +.. _class_RenderingServer_constant_SPLASH_STRETCH_MODE_IGNORE: + +.. rst-class:: classref-enumeration-constant + +:ref:`SplashStretchMode` **SPLASH_STRETCH_MODE_IGNORE** = ``5`` + +Stretches the image to cover the entire screen but doesn't preserve aspect ratio. + +.. rst-class:: classref-item-separator + +---- + .. _enum_RenderingServer_Features: .. rst-class:: classref-enumeration @@ -6409,6 +6479,18 @@ Si ``ignore`` es ``true``, ignora el recorte en los elementos dibujados con este ---- +.. _class_RenderingServer_method_canvas_item_add_ellipse: + +.. rst-class:: classref-method + +|void| **canvas_item_add_ellipse**\ (\ item\: :ref:`RID`, pos\: :ref:`Vector2`, major\: :ref:`float`, minor\: :ref:`float`, color\: :ref:`Color`, antialiased\: :ref:`bool` = false\ ) :ref:`🔗` + +Draws an ellipse with semi-major axis ``major`` and semi-minor axis ``minor`` on the :ref:`CanvasItem` pointed to by the ``item`` :ref:`RID`. See also :ref:`CanvasItem.draw_ellipse()`. + +.. rst-class:: classref-item-separator + +---- + .. _class_RenderingServer_method_canvas_item_add_lcd_texture_rect_region: .. rst-class:: classref-method @@ -7879,7 +7961,7 @@ Establece el filtro ``quality`` para las sombras de la luz direccional en 3D. Mi Generates and returns an :ref:`Image` containing the radiance map for the specified ``environment`` RID's sky. This supports built-in sky material and custom sky shaders. If ``bake_irradiance`` is ``true``, the irradiance map is saved instead of the radiance map. The radiance map is used to render reflected light, while the irradiance map is used to render ambient light. See also :ref:`sky_bake_panorama()`. -\ **Note:** The image is saved in linear color space without any tonemapping performed, which means it will look too dark if viewed directly in an image editor. +\ **Note:** The image is saved using linear encoding without any tonemapping performed, which means it will look too dark if viewed directly in an image editor. \ **Note:** ``size`` should be a 2:1 aspect ratio for the generated panorama to have square pixels. For radiance maps, there is no point in using a height greater than :ref:`Sky.radiance_size`, as it won't increase detail. Irradiance maps only contain low-frequency data, so there is usually no point in going past a size of 128×64 pixels when saving an irradiance map. @@ -8169,15 +8251,25 @@ Sets the variables to be used with the screen-space reflections (SSR) post-proce ---- +.. _class_RenderingServer_method_environment_set_ssr_half_size: + +.. rst-class:: classref-method + +|void| **environment_set_ssr_half_size**\ (\ half_size\: :ref:`bool`\ ) :ref:`🔗` + +Sets whether screen-space reflections will be rendered at full or half size. Half size is faster, but may look pixelated or cause flickering. + +.. rst-class:: classref-item-separator + +---- + .. _class_RenderingServer_method_environment_set_ssr_roughness_quality: .. rst-class:: classref-method |void| **environment_set_ssr_roughness_quality**\ (\ quality\: :ref:`EnvironmentSSRRoughnessQuality`\ ) :ref:`🔗` -.. container:: contribute - - There is currently no description for this method. Please help us by `contributing one `__! +**Obsoleto:** This option no longer does anything. .. rst-class:: classref-item-separator @@ -8195,6 +8287,18 @@ Establece las variables que se utilizarán con el efecto de post-proceso "tonema ---- +.. _class_RenderingServer_method_environment_set_tonemap_agx_contrast: + +.. rst-class:: classref-method + +|void| **environment_set_tonemap_agx_contrast**\ (\ env\: :ref:`RID`, agx_contrast\: :ref:`float`\ ) :ref:`🔗` + +See :ref:`Environment.tonemap_agx_contrast` for more details. + +.. rst-class:: classref-item-separator + +---- + .. _class_RenderingServer_method_environment_set_volumetric_fog: .. rst-class:: classref-method @@ -9539,6 +9643,22 @@ Establece un shader como el shader de un material. ---- +.. _class_RenderingServer_method_material_set_use_debanding: + +.. rst-class:: classref-method + +|void| **material_set_use_debanding**\ (\ enable\: :ref:`bool`\ ) :ref:`🔗` + +When using the Mobile renderer, :ref:`material_set_use_debanding()` can be used to enable or disable the debanding feature of 3D materials (:ref:`BaseMaterial3D` and :ref:`ShaderMaterial`). + +\ :ref:`material_set_use_debanding()` has no effect when using the Compatibility or Forward+ renderer. In Forward+, :ref:`Viewport` debanding can be used instead. + +See also :ref:`ProjectSettings.rendering/anti_aliasing/quality/use_debanding` and :ref:`viewport_set_use_debanding()`. + +.. rst-class:: classref-item-separator + +---- + .. _class_RenderingServer_method_mesh_add_surface: .. rst-class:: classref-method @@ -10156,6 +10276,20 @@ Establece el :ref:`Transform2D` para este caso. Para su uso c ---- +.. _class_RenderingServer_method_multimesh_instances_reset_physics_interpolation: + +.. rst-class:: classref-method + +|void| **multimesh_instances_reset_physics_interpolation**\ (\ multimesh\: :ref:`RID`\ ) :ref:`🔗` + +Prevents physics interpolation for all instances during the current physics tick. + +This is useful when moving all instances to new locations, to give instantaneous changes rather than interpolation from the previous locations. + +.. rst-class:: classref-item-separator + +---- + .. _class_RenderingServer_method_multimesh_set_buffer: .. rst-class:: classref-method @@ -11089,7 +11223,9 @@ Establece la máscara de reflexión de renderizado para esta sonda de reflexión |void| **reflection_probe_set_resolution**\ (\ probe\: :ref:`RID`, resolution\: :ref:`int`\ ) :ref:`🔗` -Establece la resolución que se utilizará al renderizar la sonda de reflexión especificada. La ``resolution`` se especifica para cada cara del mapa de cubos: por ejemplo, especificar ``512`` asignará 6 caras de 512×512 cada una (más mipmaps para los niveles de rugosidad). +**Obsoleto:** This method has not done anything since Godot 3. + +Obsoleto. Este método no hace nada. .. rst-class:: classref-item-separator @@ -11213,7 +11349,21 @@ Sets the screen-space roughness limiter parameters, such as whether it should be |void| **set_boot_image**\ (\ image\: :ref:`Image`, color\: :ref:`Color`, scale\: :ref:`bool`, use_filter\: :ref:`bool` = true\ ) :ref:`🔗` -Sets a boot image. The color defines the background color. If ``scale`` is ``true``, the image will be scaled to fit the screen size. If ``use_filter`` is ``true``, the image will be scaled with linear interpolation. If ``use_filter`` is ``false``, the image will be scaled with nearest-neighbor interpolation. +**Obsoleto:** Use :ref:`set_boot_image_with_stretch()` instead. + +Sets a boot image. The ``color`` defines the background color. The value of ``scale`` indicates if the image will be scaled to fit the screen size. If ``use_filter`` is ``true``, the image will be scaled with linear interpolation. If ``use_filter`` is ``false``, the image will be scaled with nearest-neighbor interpolation. + +.. rst-class:: classref-item-separator + +---- + +.. _class_RenderingServer_method_set_boot_image_with_stretch: + +.. rst-class:: classref-method + +|void| **set_boot_image_with_stretch**\ (\ image\: :ref:`Image`, color\: :ref:`Color`, stretch_mode\: :ref:`SplashStretchMode`, use_filter\: :ref:`bool` = true\ ) :ref:`🔗` + +Sets a boot image. The ``color`` defines the background color. The value of ``stretch_mode`` indicates how the image will be stretched (see :ref:`SplashStretchMode` for possible values). If ``use_filter`` is ``true``, the image will be scaled with linear interpolation. If ``use_filter`` is ``false``, the image will be scaled with nearest-neighbor interpolation. .. rst-class:: classref-item-separator @@ -11447,7 +11597,7 @@ Devuelve el número de huesos asignados a este esqueleto. Generates and returns an :ref:`Image` containing the radiance map for the specified ``sky`` RID. This supports built-in sky material and custom sky shaders. If ``bake_irradiance`` is ``true``, the irradiance map is saved instead of the radiance map. The radiance map is used to render reflected light, while the irradiance map is used to render ambient light. See also :ref:`environment_bake_panorama()`. -\ **Note:** The image is saved in linear color space without any tonemapping performed, which means it will look too dark if viewed directly in an image editor. ``energy`` values above ``1.0`` can be used to brighten the resulting image. +\ **Note:** The image is saved using linear encoding without any tonemapping performed, which means it will look too dark if viewed directly in an image editor. ``energy`` values above ``1.0`` can be used to brighten the resulting image. \ **Note:** ``size`` should be a 2:1 aspect ratio for the generated panorama to have square pixels. For radiance maps, there is no point in using a height greater than :ref:`Sky.radiance_size`, as it won't increase detail. Irradiance maps only contain low-frequency data, so there is usually no point in going past a size of 128×64 pixels when saving an irradiance map. @@ -11715,9 +11865,9 @@ Actualiza los datos de la textura especificada por la :ref:`RID` ``te :ref:`RID` **texture_create_from_native_handle**\ (\ type\: :ref:`TextureType`, format\: :ref:`Format`, native_handle\: :ref:`int`, width\: :ref:`int`, height\: :ref:`int`, depth\: :ref:`int`, layers\: :ref:`int` = 1, layered_type\: :ref:`TextureLayeredType` = 0\ ) :ref:`🔗` -Crea una textura basada en un identificador nativo que se creó fuera del renderizador de Godot. +Creates a texture based on a native handle that was created outside of Godot's renderer. -\ **Nota:** Si solo usas el renderizador del dispositivo de renderizado, se recomienda usar :ref:`RenderingDevice.texture_create_from_extension()` junto con :ref:`texture_rd_create()`, en lugar de este método. Te dará mucho más control sobre el formato y el uso de la textura. +\ **Note:** If using only the rendering device renderer, it's recommend to use :ref:`RenderingDevice.texture_create_from_extension()` together with :ref:`texture_rd_create()`, rather than this method. This way, the texture's format and usage can be controlled more effectively. .. rst-class:: classref-item-separator @@ -11743,6 +11893,8 @@ Devuelve el formato de la textura. Returns the internal graphics handle for this texture object. For use when communicating with third-party APIs mostly with GDExtension. +\ ``srgb`` should be ``true`` when the texture uses nonlinear sRGB encoding and ``false`` when the texture uses linear encoding. + \ **Note:** This function returns a ``uint64_t`` which internally maps to a ``GLuint`` (OpenGL) or ``VkImage`` (Vulkan). .. rst-class:: classref-item-separator @@ -11769,7 +11921,9 @@ Returns the internal graphics handle for this texture object. For use when commu :ref:`RID` **texture_get_rd_texture**\ (\ texture\: :ref:`RID`, srgb\: :ref:`bool` = false\ ) |const| :ref:`🔗` -Devuelve una :ref:`RID` de textura que puede ser usada con :ref:`RenderingDevice`. +Returns a texture :ref:`RID` that can be used with :ref:`RenderingDevice`. + +\ ``srgb`` should be ``true`` when the texture uses nonlinear sRGB encoding and ``false`` when the texture uses linear encoding. .. rst-class:: classref-item-separator @@ -11809,7 +11963,11 @@ Este método no hace nada. :ref:`RID` **texture_rd_create**\ (\ rd_texture\: :ref:`RID`, layer_type\: :ref:`TextureLayeredType` = 0\ ) :ref:`🔗` -Crea un nuevo objeto de textura basado en una textura creada directamente en el :ref:`RenderingDevice`. Si la textura contiene capas, se usa ``layer_type`` para definir el tipo de capa. +Creates a new texture object based on a texture created directly on the :ref:`RenderingDevice`. If the texture contains layers, ``layer_type`` is used to define the layer type. + +Once finished with your RID, you will want to free the RID using the RenderingServer's :ref:`free_rid()` method. + +\ **Note:** The RenderingServer's :ref:`free_rid()` won't free the underlying ``rd_texture``, you will want to free the ``rd_texture`` using :ref:`RenderingDevice.free_rid()`. .. rst-class:: classref-item-separator @@ -12486,11 +12644,9 @@ Equivalent to :ref:`Viewport.use_debanding`, enabled\: :ref:`bool`\ ) :ref:`🔗` -If ``true``, 2D rendering will use a high dynamic range (HDR) format framebuffer matching the bit depth of the 3D framebuffer. When using the Forward+ or Compatibility renderer, this will be an ``RGBA16`` framebuffer. When using the Mobile renderer, it will be an ``RGB10_A2`` framebuffer. +If ``true``, 2D rendering will use a high dynamic range (HDR) ``RGBA16`` format framebuffer. Additionally, 2D rendering will be performed on linear values and will be converted using the appropriate transfer function immediately before blitting to the screen (if the Viewport is attached to the screen). -Additionally, 2D rendering will take place in linear color space and will be converted to sRGB space immediately before blitting to the screen (if the Viewport is attached to the screen). - -Practically speaking, this means that the end result of the Viewport will not be clamped to the ``0-1`` range and can be used in 3D rendering without color space adjustments. This allows 2D rendering to take advantage of effects requiring high dynamic range (e.g. 2D glow) as well as substantially improves the appearance of effects requiring highly detailed gradients. This setting has the same effect as :ref:`Viewport.use_hdr_2d`. +Practically speaking, this means that the end result of the Viewport will not be clamped to the ``0-1`` range and can be used in 3D rendering without color encoding adjustments. This allows 2D rendering to take advantage of effects requiring high dynamic range (e.g. 2D glow) as well as substantially improves the appearance of effects requiring highly detailed gradients. This setting has the same effect as :ref:`Viewport.use_hdr_2d`. .. rst-class:: classref-item-separator diff --git a/classes/es/class_resource.rst b/classes/es/class_resource.rst index 15e8371278..2f5744ce54 100644 --- a/classes/es/class_resource.rst +++ b/classes/es/class_resource.rst @@ -7,7 +7,7 @@ Resource **Hereda:** :ref:`RefCounted` **<** :ref:`Object` -**Heredado por:** :ref:`Animation`, :ref:`AnimationLibrary`, :ref:`AnimationNode`, :ref:`AnimationNodeStateMachinePlayback`, :ref:`AnimationNodeStateMachineTransition`, :ref:`AudioBusLayout`, :ref:`AudioEffect`, :ref:`AudioStream`, :ref:`BitMap`, :ref:`BoneMap`, :ref:`ButtonGroup`, :ref:`CameraAttributes`, :ref:`ColorPalette`, :ref:`Compositor`, :ref:`CompositorEffect`, :ref:`CryptoKey`, :ref:`Curve`, :ref:`Curve2D`, :ref:`Curve3D`, :ref:`EditorNode3DGizmoPlugin`, :ref:`EditorSettings`, :ref:`Environment`, :ref:`FoldableGroup`, :ref:`Font`, :ref:`GDExtension`, :ref:`GLTFAccessor`, :ref:`GLTFAnimation`, :ref:`GLTFBufferView`, :ref:`GLTFCamera`, :ref:`GLTFDocument`, :ref:`GLTFDocumentExtension`, :ref:`GLTFLight`, :ref:`GLTFMesh`, :ref:`GLTFNode`, :ref:`GLTFPhysicsBody`, :ref:`GLTFPhysicsShape`, :ref:`GLTFSkeleton`, :ref:`GLTFSkin`, :ref:`GLTFSpecGloss`, :ref:`GLTFState`, :ref:`GLTFTexture`, :ref:`GLTFTextureSampler`, :ref:`Gradient`, :ref:`Image`, :ref:`ImporterMesh`, :ref:`InputEvent`, :ref:`JSON`, :ref:`LabelSettings`, :ref:`LightmapGIData`, :ref:`Material`, :ref:`Mesh`, :ref:`MeshLibrary`, :ref:`MissingResource`, :ref:`MultiMesh`, :ref:`NavigationMesh`, :ref:`NavigationMeshSourceGeometryData2D`, :ref:`NavigationMeshSourceGeometryData3D`, :ref:`NavigationPolygon`, :ref:`Noise`, :ref:`Occluder3D`, :ref:`OccluderPolygon2D`, :ref:`OggPacketSequence`, :ref:`OpenXRAction`, :ref:`OpenXRActionMap`, :ref:`OpenXRActionSet`, :ref:`OpenXRBindingModifier`, :ref:`OpenXRHapticBase`, :ref:`OpenXRInteractionProfile`, :ref:`OpenXRIPBinding`, :ref:`PackedDataContainer`, :ref:`PackedScene`, :ref:`PhysicsMaterial`, :ref:`PolygonPathFinder`, :ref:`RDShaderFile`, :ref:`RDShaderSPIRV`, :ref:`RichTextEffect`, :ref:`SceneReplicationConfig`, :ref:`Script`, :ref:`Shader`, :ref:`ShaderInclude`, :ref:`Shape2D`, :ref:`Shape3D`, :ref:`Shortcut`, :ref:`SkeletonModification2D`, :ref:`SkeletonModificationStack2D`, :ref:`SkeletonProfile`, :ref:`Skin`, :ref:`Sky`, :ref:`SpriteFrames`, :ref:`StyleBox`, :ref:`SyntaxHighlighter`, :ref:`Texture`, :ref:`Theme`, :ref:`TileMapPattern`, :ref:`TileSet`, :ref:`TileSetSource`, :ref:`Translation`, :ref:`VideoStream`, :ref:`VideoStreamPlayback`, :ref:`VisualShaderNode`, :ref:`VoxelGIData`, :ref:`World2D`, :ref:`World3D`, :ref:`X509Certificate` +**Heredado por:** :ref:`Animation`, :ref:`AnimationLibrary`, :ref:`AnimationNode`, :ref:`AnimationNodeStateMachinePlayback`, :ref:`AnimationNodeStateMachineTransition`, :ref:`AudioBusLayout`, :ref:`AudioEffect`, :ref:`AudioStream`, :ref:`BitMap`, :ref:`BoneMap`, :ref:`ButtonGroup`, :ref:`CameraAttributes`, :ref:`ColorPalette`, :ref:`Compositor`, :ref:`CompositorEffect`, :ref:`CryptoKey`, :ref:`Curve`, :ref:`Curve2D`, :ref:`Curve3D`, :ref:`EditorNode3DGizmoPlugin`, :ref:`EditorSettings`, :ref:`Environment`, :ref:`FoldableGroup`, :ref:`Font`, :ref:`GDExtension`, :ref:`GLTFAccessor`, :ref:`GLTFAnimation`, :ref:`GLTFBufferView`, :ref:`GLTFCamera`, :ref:`GLTFDocument`, :ref:`GLTFDocumentExtension`, :ref:`GLTFLight`, :ref:`GLTFMesh`, :ref:`GLTFNode`, :ref:`GLTFPhysicsBody`, :ref:`GLTFPhysicsShape`, :ref:`GLTFSkeleton`, :ref:`GLTFSkin`, :ref:`GLTFSpecGloss`, :ref:`GLTFState`, :ref:`GLTFTexture`, :ref:`GLTFTextureSampler`, :ref:`Gradient`, :ref:`Image`, :ref:`ImporterMesh`, :ref:`InputEvent`, :ref:`JointLimitation3D`, :ref:`JSON`, :ref:`LabelSettings`, :ref:`LightmapGIData`, :ref:`Material`, :ref:`Mesh`, :ref:`MeshLibrary`, :ref:`MissingResource`, :ref:`MultiMesh`, :ref:`NavigationMesh`, :ref:`NavigationMeshSourceGeometryData2D`, :ref:`NavigationMeshSourceGeometryData3D`, :ref:`NavigationPolygon`, :ref:`Noise`, :ref:`Occluder3D`, :ref:`OccluderPolygon2D`, :ref:`OggPacketSequence`, :ref:`OpenXRAction`, :ref:`OpenXRActionMap`, :ref:`OpenXRActionSet`, :ref:`OpenXRBindingModifier`, :ref:`OpenXRHapticBase`, :ref:`OpenXRInteractionProfile`, :ref:`OpenXRIPBinding`, :ref:`PackedDataContainer`, :ref:`PackedScene`, :ref:`PhysicsMaterial`, :ref:`PolygonPathFinder`, :ref:`RDShaderFile`, :ref:`RDShaderSPIRV`, :ref:`RichTextEffect`, :ref:`SceneReplicationConfig`, :ref:`Script`, :ref:`Shader`, :ref:`ShaderInclude`, :ref:`Shape2D`, :ref:`Shape3D`, :ref:`Shortcut`, :ref:`SkeletonModification2D`, :ref:`SkeletonModificationStack2D`, :ref:`SkeletonProfile`, :ref:`Skin`, :ref:`Sky`, :ref:`SpriteFrames`, :ref:`StyleBox`, :ref:`SyntaxHighlighter`, :ref:`Texture`, :ref:`Theme`, :ref:`TileMapPattern`, :ref:`TileSet`, :ref:`TileSetSource`, :ref:`Translation`, :ref:`VideoStream`, :ref:`VideoStreamPlayback`, :ref:`VisualShaderNode`, :ref:`VoxelGIData`, :ref:`World2D`, :ref:`World3D`, :ref:`X509Certificate` Clase base para objetos serializables. @@ -352,9 +352,7 @@ Se aplican las siguientes excepciones: :ref:`Resource` **duplicate_deep**\ (\ deep_subresources_mode\: :ref:`DeepDuplicateMode` = 1\ ) |const| :ref:`🔗` -Duplica este recurso, profundamente, como :ref:`duplicate()`\ ``(true)``, con un control adicional sobre cómo se manejan los subrecursos. - -\ ``deep_subresources_mode`` debe ser uno de los valores de :ref:`DeepDuplicateMode`. +Duplicates this resource, deeply, like :ref:`duplicate()` when passing ``true``, with extra control over how subresources are handled. .. rst-class:: classref-item-separator diff --git a/classes/es/class_resourceformatloader.rst b/classes/es/class_resourceformatloader.rst index 2ee1a9c687..57fe110088 100644 --- a/classes/es/class_resourceformatloader.rst +++ b/classes/es/class_resourceformatloader.rst @@ -28,29 +28,29 @@ Métodos .. table:: :widths: auto - +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_exists`\ (\ path\: :ref:`String`\ ) |virtual| |const| | - +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`_get_classes_used`\ (\ path\: :ref:`String`\ ) |virtual| |const| | - +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`_get_dependencies`\ (\ path\: :ref:`String`, add_types\: :ref:`bool`\ ) |virtual| |const| | - +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`_get_recognized_extensions`\ (\ ) |virtual| |const| | - +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`_get_resource_script_class`\ (\ path\: :ref:`String`\ ) |virtual| |const| | - +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`_get_resource_type`\ (\ path\: :ref:`String`\ ) |virtual| |const| | - +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`_get_resource_uid`\ (\ path\: :ref:`String`\ ) |virtual| |const| | - +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_handles_type`\ (\ type\: :ref:`StringName`\ ) |virtual| |const| | - +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Variant` | :ref:`_load`\ (\ path\: :ref:`String`, original_path\: :ref:`String`, use_sub_threads\: :ref:`bool`, cache_mode\: :ref:`int`\ ) |virtual| |const| | - +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_recognize_path`\ (\ path\: :ref:`String`, type\: :ref:`StringName`\ ) |virtual| |const| | - +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Error` | :ref:`_rename_dependencies`\ (\ path\: :ref:`String`, renames\: :ref:`Dictionary`\ ) |virtual| |const| | - +---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`_exists`\ (\ path\: :ref:`String`\ ) |virtual| |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`_get_classes_used`\ (\ path\: :ref:`String`\ ) |virtual| |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`_get_dependencies`\ (\ path\: :ref:`String`, add_types\: :ref:`bool`\ ) |virtual| |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`_get_recognized_extensions`\ (\ ) |virtual| |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`_get_resource_script_class`\ (\ path\: :ref:`String`\ ) |virtual| |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`_get_resource_type`\ (\ path\: :ref:`String`\ ) |virtual| |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`_get_resource_uid`\ (\ path\: :ref:`String`\ ) |virtual| |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`_handles_type`\ (\ type\: :ref:`StringName`\ ) |virtual| |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Variant` | :ref:`_load`\ (\ path\: :ref:`String`, original_path\: :ref:`String`, use_sub_threads\: :ref:`bool`, cache_mode\: :ref:`int`\ ) |virtual| |required| |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`_recognize_path`\ (\ path\: :ref:`String`, type\: :ref:`StringName`\ ) |virtual| |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`_rename_dependencies`\ (\ path\: :ref:`String`, renames\: :ref:`Dictionary`\ ) |virtual| |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -242,7 +242,7 @@ Dice qué clase de recursos puede cargar este cargador. .. rst-class:: classref-method -:ref:`Variant` **_load**\ (\ path\: :ref:`String`, original_path\: :ref:`String`, use_sub_threads\: :ref:`bool`, cache_mode\: :ref:`int`\ ) |virtual| |const| :ref:`🔗` +:ref:`Variant` **_load**\ (\ path\: :ref:`String`, original_path\: :ref:`String`, use_sub_threads\: :ref:`bool`, cache_mode\: :ref:`int`\ ) |virtual| |required| |const| :ref:`🔗` Carga un recurso cuando el motor encuentra que este cargador es compatible. Si el recurso cargado es el resultado de una importación, ``original_path`` se dirigirá al archivo fuente. Devuelve un objeto :ref:`Resource` en caso de éxito, o una constante :ref:`Error` en caso de fracaso. diff --git a/classes/es/class_resourceimportercsvtranslation.rst b/classes/es/class_resourceimportercsvtranslation.rst index 1a1f3750fc..42acdd506f 100644 --- a/classes/es/class_resourceimportercsvtranslation.rst +++ b/classes/es/class_resourceimportercsvtranslation.rst @@ -7,24 +7,46 @@ ResourceImporterCSVTranslation **Hereda:** :ref:`ResourceImporter` **<** :ref:`RefCounted` **<** :ref:`Object` -Importa valores separados por comas +Imports comma-separated values as :ref:`Translation`\ s. .. rst-class:: classref-introduction-group Descripción ---------------------- -Los valores separados por comas son un formato de almacenamiento de tablas de texto plano. La simplicidad del formato lo hace fácil de editar en cualquier editor de texto o software de hojas de cálculo. Esto lo convierte en una opción común para la localización de juegos. +Comma-separated values are a plain text table storage format. The format's simplicity makes it easy to edit in any text editor or spreadsheet software. This makes it a common choice for game localization. -\ **Ejemplo de archivo CSV:**\ +In the CSV file used for translation, the first column contains string identifiers, and the first row serves as the header. The first column's header can be any value. The remaining headers indicate the locale for that column. Columns whose headers begin with an underscore (``_``) will be ignored. + +\ **Example CSV file:**\ .. code:: text keys,en,es,ja - GREET,"Hello, friend!","¡Hola, amigo!",こんにちは - ASK,How are you?,¿Cómo estás?,元気ですか + GREET,"Hello, friend!","Hola, amigo!",こんにちは + ASK,How are you?,Cómo está?,元気ですか BYE,Goodbye,Adiós,さようなら - QUOTE,"""Hello"" said the man.","""Hola,"" dijo el hombre.",「こんにちは」男は言いました + QUOTE,"""Hello"" said the man.","""Hola"" dijo el hombre.",「こんにちは」男は言いました + +Although keys in the first column typically use uppercase string identifiers, it is not uncommon to directly use strings appearing in the game as keys. To avoid string ambiguity, you can use a special ``?context`` column to specify the context to use with :ref:`Object.tr()`. + +.. code:: text + + en,?context,fr,ja,zh + Letter,Alphabet,Lettre,字母,字母 + Letter,Message,Courrier,手紙,信件 + +To set the plural form of a string to use with :ref:`Object.tr_n()`, add a special ``?plural`` column. After setting the plural form of the source string in this column, you can add additional rows to provide translations for more plural forms. The first column and all special columns in these plural form rows must be empty. + +Godot includes built-in plural rules for some languages. You can also customize them using a special ``?pluralrule`` row. See `GNU gettext `__ for examples and more info. + +.. code:: text + + en,?plural,fr,ru,zh,_Comment + ?pluralrule,,nplurals=2; plural=(n >= 2);,,,Customize the plural rule for French + There is %d apple,There are %d apples,Il y a %d pomme,Есть %d яблоко,那里有%d个苹果, + ,,Il y a %d pommes,Есть %d яблока,, + ,,,Есть %d яблок,, .. rst-class:: classref-introduction-group @@ -41,11 +63,15 @@ Propiedades .. table:: :widths: auto - +-------------------------+---------------------------------------------------------------------------+----------+ - | :ref:`bool` | :ref:`compress` | ``true`` | - +-------------------------+---------------------------------------------------------------------------+----------+ - | :ref:`int` | :ref:`delimiter` | ``0`` | - +-------------------------+---------------------------------------------------------------------------+----------+ + +-------------------------+---------------------------------------------------------------------------------------------------+-----------+ + | :ref:`int` | :ref:`compress` | ``1`` | + +-------------------------+---------------------------------------------------------------------------------------------------+-----------+ + | :ref:`int` | :ref:`delimiter` | ``0`` | + +-------------------------+---------------------------------------------------------------------------------------------------+-----------+ + | :ref:`bool` | :ref:`unescape_keys` | ``false`` | + +-------------------------+---------------------------------------------------------------------------------------------------+-----------+ + | :ref:`bool` | :ref:`unescape_translations` | ``true`` | + +-------------------------+---------------------------------------------------------------------------------------------------+-----------+ .. rst-class:: classref-section-separator @@ -60,9 +86,11 @@ Descripciones de Propiedades .. rst-class:: classref-property -:ref:`bool` **compress** = ``true`` :ref:`🔗` +:ref:`int` **compress** = ``1`` :ref:`🔗` -Si es ``true``, crea una :ref:`OptimizedTranslation` en lugar de una :ref:`Translation`. Esto hace que el archivo resultante sea más pequeño a costa de una pequeña sobrecarga de CPU. +- **Disabled**: Creates a :ref:`Translation`. + +- **Auto**: Creates an :ref:`OptimizedTranslation` when possible. This makes the resulting file smaller at the cost of a small CPU overhead. Falls back to :ref:`Translation` for translations with context or plural forms. .. rst-class:: classref-item-separator @@ -76,6 +104,30 @@ Si es ``true``, crea una :ref:`OptimizedTranslation` El delimitador a usar en el archivo CSV. El valor por defecto coincide con la convención común de CSV. Los valores separados por tabuladores a veces se denominan archivos TSV. +.. rst-class:: classref-item-separator + +---- + +.. _class_ResourceImporterCSVTranslation_property_unescape_keys: + +.. rst-class:: classref-property + +:ref:`bool` **unescape_keys** = ``false`` :ref:`🔗` + +If ``true``, message keys in the CSV file are unescaped using :ref:`String.c_unescape()` during the import process. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ResourceImporterCSVTranslation_property_unescape_translations: + +.. rst-class:: classref-property + +:ref:`bool` **unescape_translations** = ``true`` :ref:`🔗` + +If ``true``, message translations in the CSV file are unescaped using :ref:`String.c_unescape()` during the import process. + .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` diff --git a/classes/es/class_resourceimporterdynamicfont.rst b/classes/es/class_resourceimporterdynamicfont.rst index 090e6e0ea7..f05cedfebc 100644 --- a/classes/es/class_resourceimporterdynamicfont.rst +++ b/classes/es/class_resourceimporterdynamicfont.rst @@ -184,13 +184,13 @@ Activar :ref:`generate_mipmaps` **hinting** = ``1`` :ref:`🔗` -El modo de hinting a utilizar. Esto controla la agresividad con la que los bordes de los glifos deben ajustarse a los píxeles al rasterizar la fuente. Dependiendo de las preferencias personales, puede que prefieras usar un modo de hinting sobre el otro. Los modos de hinting distintos de **Ninguno** sólo son efectivos si la fuente contiene datos de hinting (ver :ref:`force_autohinter`). +The hinting mode to use. This controls how aggressively glyph edges should be snapped to pixels when rasterizing the font. Depending on personal preference, you may prefer using one hinting mode over the other. Hinting modes other than **None** are only effective if the font contains hinting data (see :ref:`force_autohinter`). -\ **Ninguno:** Apariencia más suave, que puede hacer que la fuente se vea borrosa en tamaños pequeños. +\ **None:** Smoothest appearance, which can make the font look blurry at small sizes. -\ **Ligero:** Resultado nítido al ajustar los bordes de los glifos a los píxeles sólo en el eje Y. +\ **Light:** Sharp result by snapping glyph edges to pixels on the Y axis only. -\ **Completo:** El más nítido al ajustar los bordes de los glifos a los píxeles en los ejes X e Y. +\ **Normal:** Sharpest by snapping glyph edges to pixels on both X and Y axes. .. rst-class:: classref-item-separator diff --git a/classes/es/class_resourceimporterimagefont.rst b/classes/es/class_resourceimporterimagefont.rst index d5f1b15842..ddd94a0bb3 100644 --- a/classes/es/class_resourceimporterimagefont.rst +++ b/classes/es/class_resourceimporterimagefont.rst @@ -96,13 +96,13 @@ Margen aplicado alrededor de cada glifo importado. Si tu imagen de fuente contie :ref:`PackedStringArray` **character_ranges** = ``PackedStringArray()`` :ref:`🔗` -Los rangos de caracteres a importar desde la imagen de la fuente. Este es un array que mapea cada posición en la imagen (en coordenadas de tile, no píxeles). El atlas de la fuente se recorre de izquierda a derecha y de arriba a abajo. Los caracteres se pueden especificar con números decimales (127), números hexadecimales (``0x007f``, o ``U+007f``) o entre comillas simples (``'~'``). Los rangos se pueden especificar con un guión entre caracteres. +The character ranges to import from the font image. This is an array that maps each position on the image (in tile coordinates, not pixels). The font atlas is traversed from left to right and top to bottom. Characters can be specified with decimal numbers (126), hexadecimal numbers (``0x007e`` or ``U+007e``), or between single quotes (``'~'``). Ranges can be specified with a hyphen between characters. -Por ejemplo, ``0-127`` representa el rango ASCII completo. También se puede escribir como ``0x0000-0x007f`` (o ``U+0000-U+007f``). Como otro ejemplo, ``' '-'~'`` es equivalente a ``32-127`` y representa el rango de caracteres ASCII imprimibles (visibles). +For example, ``0-127`` represents the full ASCII range. It can also be written as ``0x0000-0x007f`` (or ``U+0000-U+007f``). As another example, ``' '-'~'`` is equivalent to ``32-126`` and represents the range of printable (visible) ASCII characters. -Para cualquier rango, el avance y el desplazamiento del carácter se pueden personalizar añadiendo tres valores enteros separados por espacios (avance adicional, desplazamiento x, desplazamiento y) al final. Por ejemplo, ``'a'-'b' 4 5 2`` establece el avance a ``char_width + 4`` y el desplazamiento a ``Vector2(5, 2)`` para ambos caracteres `a` y `b`. +For any range, the character advance and offset can be customized by appending three space-separated integer values (additional advance, x offset, y offset) to the end. For example ``'a'-'b' 4 5 2`` sets the advance to ``char_width + 4`` and offset to ``Vector2(5, 2)`` for both `a` and `b` characters. -\ **Nota:** El número total de caracteres no debe exceder el número de :ref:`columns` multiplicado por :ref:`rows`. De lo contrario, la importación de la fuente fallará. +\ **Note:** The overall number of characters must not exceed the number of :ref:`columns` multiplied by :ref:`rows`. Otherwise, the font will fail to import. **Note:** The returned array is *copied* and any changes to it will not update the original property value. See :ref:`PackedStringArray` for more details. diff --git a/classes/es/class_resourceimporterlayeredtexture.rst b/classes/es/class_resourceimporterlayeredtexture.rst index 01f0a7422f..25ff0497e5 100644 --- a/classes/es/class_resourceimporterlayeredtexture.rst +++ b/classes/es/class_resourceimporterlayeredtexture.rst @@ -68,13 +68,13 @@ Descripciones de Propiedades :ref:`int` **compress/channel_pack** = ``0`` :ref:`🔗` -Controla cómo se deben usar los canales de color en la textura importada. +Controls how color channels should be used in the imported texture. -\ **Compatible con sRGB:**, evita que se utilice el formato de color RG, ya que no es compatible con el color sRGB. +\ **sRGB Friendly:**, prevents the R and RG color formats from being used, as they do not support nonlinear sRGB encoding. -\ **Optimizado:**, permite usar el formato de color RG si la textura no usa el canal azul. Esto reduce el uso de memoria si el canal azul de la textura puede ser descartado (todos los píxeles deben tener un valor azul de ``0``). +\ **Optimized:**, allows the RG color format to be used if the texture does not use the blue channel. This reduces memory usage if the texture's blue channel can be discarded (all pixels must have a blue value of ``0``). -\ **Mapa de normales (Canales RG):** Esto fuerza a que todas las capas de la textura se importen con el formato de color RG, conservando únicamente los canales rojo y verde. La compresión RGTC (Compresión de Textura Rojo-Verde) es capaz de preservar mucho mejor sus detalles, utilizando la misma cantidad de memoria que una textura estándar RGBA comprimida en VRAM. Esto sólo tiene efecto en texturas con los modos de compresión VRAM Comprimido o Basis Universal. Este modo sólo está disponible en texturas en capas (:ref:`Cubemap`, :ref:`CubemapArray`, :ref:`Texture2DArray` y :ref:`Texture3D`). +\ **Normal Map (RG Channels):** This forces all layers from the texture to be imported with the RG color format, with only the red and green channels preserved. RGTC (Red-Green Texture Compression) compression is able to preserve its detail much better, while using the same amount of memory as a standard RGBA VRAM-compressed texture. This only has an effect on textures with the VRAM Compressed or Basis Universal compression modes. This mode is only available in layered textures (:ref:`Cubemap`, :ref:`CubemapArray`, :ref:`Texture2DArray` and :ref:`Texture3D`). .. rst-class:: classref-item-separator diff --git a/classes/es/class_resourceimportertexture.rst b/classes/es/class_resourceimportertexture.rst index cb2844f462..88d5e52cb9 100644 --- a/classes/es/class_resourceimportertexture.rst +++ b/classes/es/class_resourceimportertexture.rst @@ -100,11 +100,11 @@ Descripciones de Propiedades :ref:`int` **compress/channel_pack** = ``0`` :ref:`🔗` -Controla cómo se deben usar los canales de color en la textura importada. +Controls how color channels should be used in the imported texture. -\ **Compatible con sRGB:** Evita que se use el formato de color RG, ya que no es compatible con el color sRGB. +\ **sRGB Friendly:** Prevents the R and RG color formats from being used, as they do not support nonlinear sRGB encoding. -\ **Optimizado:** Permite que se use el formato de color RG si la textura no usa el canal azul. Esto reduce el uso de memoria si el canal azul de la textura se puede descartar (todos los píxeles deben tener un valor azul de ``0``). +\ **Optimized:** Allows the RG color format to be used if the texture does not use the blue channel. This reduces memory usage if the texture's blue channel can be discarded (all pixels must have a blue value of ``0``). .. rst-class:: classref-item-separator @@ -454,9 +454,9 @@ Se recomienda dejar esto habilitado (como está por defecto), a menos que esto c :ref:`bool` **process/hdr_as_srgb** = ``false`` :ref:`🔗` -Algunas imágenes HDR que puedes encontrar en línea pueden estar dañadas y contener datos de color sRGB (en lugar de datos de color lineal). Se aconseja no utilizar esos archivos. Si absolutamente tienes que hacerlo, habilitar :ref:`process/hdr_as_srgb` hará que se vean correctas. +Some HDR images you can find online may be broken and contain data that is encoded using the nonlinear sRGB transfer function (instead of using linear encoding). It is advised not to use those files. If you absolutely have to, enabling :ref:`process/hdr_as_srgb` will make them look correct. -\ **Advertencia:** Habilitar :ref:`process/hdr_as_srgb` en imágenes HDR bien formateadas hará que la imagen resultante se vea demasiado oscura, así que déjalo en ``false`` si no estás seguro. +\ **Warning:** Enabling :ref:`process/hdr_as_srgb` on well-formatted HDR images will cause the resulting image to look too dark, so leave this on ``false`` if unsure. .. rst-class:: classref-item-separator diff --git a/classes/es/class_resourceloader.rst b/classes/es/class_resourceloader.rst index e574ef12d4..828362eaba 100644 --- a/classes/es/class_resourceloader.rst +++ b/classes/es/class_resourceloader.rst @@ -27,6 +27,8 @@ Utiliza las muchas clases :ref:`ResourceFormatLoader Tutoriales -------------------- +- `Threaded Loading Demo `__ + - `Demo de Prueba de Sistema Operativo `__ .. rst-class:: classref-reftable-group diff --git a/classes/es/class_resourceuid.rst b/classes/es/class_resourceuid.rst index 1f5c7c99e2..d2de4301ed 100644 --- a/classes/es/class_resourceuid.rst +++ b/classes/es/class_resourceuid.rst @@ -126,7 +126,7 @@ Como :ref:`create_id()`, pero el UID se inic :ref:`String` **ensure_path**\ (\ path_or_uid\: :ref:`String`\ ) |static| :ref:`🔗` -Devuelve una ruta, convirtiendo ``path_or_uid`` si es necesario. Imprime un error si se proporciona un UID no válido. +Returns a path, converting ``path_or_uid`` if necessary. Fails and returns an empty string if an invalid UID is provided. .. rst-class:: classref-item-separator diff --git a/classes/es/class_richtextlabel.rst b/classes/es/class_richtextlabel.rst index 2a6e20b955..dac5406009 100644 --- a/classes/es/class_richtextlabel.rst +++ b/classes/es/class_richtextlabel.rst @@ -789,7 +789,7 @@ Si es ``true``, la etiqueta subraya las etiquetas de sugerencia como ``[hint=des - |void| **set_horizontal_alignment**\ (\ value\: :ref:`HorizontalAlignment`\ ) - :ref:`HorizontalAlignment` **get_horizontal_alignment**\ (\ ) -Controla la alineación horizontal del texto. Admite izquierda, centro, derecha y relleno, o justificar. +Controla la alineación horizontal del texto. Admite izquierda, centro, derecha y relleno (también conocido como justificar). .. rst-class:: classref-item-separator @@ -823,7 +823,7 @@ Reglas de alineación de relleno de línea. - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_language**\ (\ ) -Código de idioma utilizado para los algoritmos de salto de línea y forma del texto, si se deja vacío se utiliza la configuración regional actual. +Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead. .. rst-class:: classref-item-separator @@ -2077,7 +2077,7 @@ Añade una etiqueta ``[p]`` a la pila de etiquetas. |void| **push_strikethrough**\ (\ color\: :ref:`Color` = Color(0, 0, 0, 0)\ ) :ref:`🔗` -Añade una etiqueta ``[s]`` a la pila de etiquetas. Si el valor alfa de ``color`` es cero, se utiliza el color de fuente actual con el alfa multiplicado por :ref:`strikethrough_alpha`. +Adds a ``[s]`` tag to the tag stack. If ``color``'s alpha value is ``0.0``, the current font's color with its alpha multiplied by :ref:`strikethrough_alpha` is used. .. rst-class:: classref-item-separator @@ -2101,7 +2101,7 @@ Añade una etiqueta ``[table=columns,inline_align]`` a la pila de etiquetas. Uti |void| **push_underline**\ (\ color\: :ref:`Color` = Color(0, 0, 0, 0)\ ) :ref:`🔗` -Añade una etiqueta ``[u]`` a la pila de etiquetas. Si el valor alfa de ``color`` es cero, se utiliza el color de fuente actual con el alfa multiplicado por :ref:`underline_alpha`. +Adds a ``[u]`` tag to the tag stack. If ``color``'s alpha value is ``0.0``, the current font's color with its alpha multiplied by :ref:`underline_alpha` is used. .. rst-class:: classref-item-separator diff --git a/classes/es/class_rigidbody2d.rst b/classes/es/class_rigidbody2d.rst index 8104c50df3..56482ae0f2 100644 --- a/classes/es/class_rigidbody2d.rst +++ b/classes/es/class_rigidbody2d.rst @@ -562,7 +562,7 @@ If ``true``, the body is frozen. Gravity and forces are not applied anymore. See :ref:`freeze_mode` to set the body's behavior when frozen. -For a body that is always frozen, use :ref:`StaticBody2D` or :ref:`AnimatableBody2D` instead. +\ **Note:** For a body that is always frozen, use :ref:`StaticBody2D` or :ref:`AnimatableBody2D` instead. .. rst-class:: classref-item-separator @@ -579,9 +579,9 @@ For a body that is always frozen, use :ref:`StaticBody2D` or - |void| **set_freeze_mode**\ (\ value\: :ref:`FreezeMode`\ ) - :ref:`FreezeMode` **get_freeze_mode**\ (\ ) -The body's freeze mode. Can be used to set the body's behavior when :ref:`freeze` is enabled. +The body's freeze mode. Determines the body's behavior when :ref:`freeze` is ``true``. -For a body that is always frozen, use :ref:`StaticBody2D` or :ref:`AnimatableBody2D` instead. +\ **Note:** For a body that is always frozen, use :ref:`StaticBody2D` or :ref:`AnimatableBody2D` instead. .. rst-class:: classref-item-separator diff --git a/classes/es/class_rigidbody3d.rst b/classes/es/class_rigidbody3d.rst index e0eaac3168..e2272d2b07 100644 --- a/classes/es/class_rigidbody3d.rst +++ b/classes/es/class_rigidbody3d.rst @@ -530,7 +530,7 @@ If ``true``, the body is frozen. Gravity and forces are not applied anymore. See :ref:`freeze_mode` to set the body's behavior when frozen. -For a body that is always frozen, use :ref:`StaticBody3D` or :ref:`AnimatableBody3D` instead. +\ **Note:** For a body that is always frozen, use :ref:`StaticBody3D` or :ref:`AnimatableBody3D` instead. .. rst-class:: classref-item-separator @@ -547,9 +547,9 @@ For a body that is always frozen, use :ref:`StaticBody3D` or - |void| **set_freeze_mode**\ (\ value\: :ref:`FreezeMode`\ ) - :ref:`FreezeMode` **get_freeze_mode**\ (\ ) -The body's freeze mode. Can be used to set the body's behavior when :ref:`freeze` is enabled. +The body's freeze mode. Determines the body's behavior when :ref:`freeze` is ``true``. -For a body that is always frozen, use :ref:`StaticBody3D` or :ref:`AnimatableBody3D` instead. +\ **Note:** For a body that is always frozen, use :ref:`StaticBody3D` or :ref:`AnimatableBody3D` instead. .. rst-class:: classref-item-separator diff --git a/classes/es/class_scenetree.rst b/classes/es/class_scenetree.rst index f15ef76f45..bde0e2ff6b 100644 --- a/classes/es/class_scenetree.rst +++ b/classes/es/class_scenetree.rst @@ -76,6 +76,8 @@ Métodos +--------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Error` | :ref:`change_scene_to_file`\ (\ path\: :ref:`String`\ ) | +--------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`change_scene_to_node`\ (\ node\: :ref:`Node`\ ) | + +--------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Error` | :ref:`change_scene_to_packed`\ (\ packed_scene\: :ref:`PackedScene`\ ) | +--------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`SceneTreeTimer` | :ref:`create_timer`\ (\ time_sec\: :ref:`float`, process_always\: :ref:`bool` = true, process_in_physics\: :ref:`bool` = false, ignore_time_scale\: :ref:`bool` = false\ ) | @@ -563,7 +565,33 @@ Changes the running scene to the one at the given ``path``, after loading it int Returns :ref:`@GlobalScope.OK` on success, :ref:`@GlobalScope.ERR_CANT_OPEN` if the ``path`` cannot be loaded into a :ref:`PackedScene`, or :ref:`@GlobalScope.ERR_CANT_CREATE` if that scene cannot be instantiated. -\ **Note:** See :ref:`change_scene_to_packed()` for details on the order of operations. +\ **Note:** See :ref:`change_scene_to_node()` for details on the order of operations. + +.. rst-class:: classref-item-separator + +---- + +.. _class_SceneTree_method_change_scene_to_node: + +.. rst-class:: classref-method + +:ref:`Error` **change_scene_to_node**\ (\ node\: :ref:`Node`\ ) :ref:`🔗` + +Changes the running scene to the provided :ref:`Node`. Useful when you want to set up the new scene before changing. + +Returns :ref:`@GlobalScope.OK` on success, :ref:`@GlobalScope.ERR_INVALID_PARAMETER` if the ``node`` is ``null``, or :ref:`@GlobalScope.ERR_UNCONFIGURED` if the ``node`` is already inside the scene tree. + +\ **Note:** Operations happen in the following order when :ref:`change_scene_to_node()` is called: + +1. The current scene node is immediately removed from the tree. From that point, :ref:`Node.get_tree()` called on the current (outgoing) scene will return ``null``. :ref:`current_scene` will be ``null`` too, because the new scene is not available yet. + +2. At the end of the frame, the formerly current scene, already removed from the tree, will be deleted (freed from memory) and then the new scene node will be added to the tree. :ref:`Node.get_tree()` and :ref:`current_scene` will be back to working as usual. + +This ensures that both scenes aren't running at the same time, while still freeing the previous scene in a safe way similar to :ref:`Node.queue_free()`. + +If you want to reliably access the new scene, await the :ref:`scene_changed` signal. + +\ **Warning:** After using this method, the **SceneTree** will take ownership of the node and will free it automatically when changing scene again. Any references you had to that node will become invalid. .. rst-class:: classref-item-separator @@ -579,15 +607,7 @@ Changes the running scene to a new instance of the given :ref:`PackedScene` on success, :ref:`@GlobalScope.ERR_CANT_CREATE` if the scene cannot be instantiated, or :ref:`@GlobalScope.ERR_INVALID_PARAMETER` if the scene is invalid. -\ **Note:** Operations happen in the following order when :ref:`change_scene_to_packed()` is called: - -1. The current scene node is immediately removed from the tree. From that point, :ref:`Node.get_tree()` called on the current (outgoing) scene will return ``null``. :ref:`current_scene` will be ``null``, too, because the new scene is not available yet. - -2. At the end of the frame, the formerly current scene, already removed from the tree, will be deleted (freed from memory) and then the new scene will be instantiated and added to the tree. :ref:`Node.get_tree()` and :ref:`current_scene` will be back to working as usual. - -This ensures that both scenes aren't running at the same time, while still freeing the previous scene in a safe way similar to :ref:`Node.queue_free()`. - -If you want to reliably access the new scene, await the :ref:`scene_changed` signal. +\ **Note:** See :ref:`change_scene_to_node()` for details on the order of operations. .. rst-class:: classref-item-separator diff --git a/classes/es/class_script.rst b/classes/es/class_script.rst index f506ca3610..ee86b5d2d9 100644 --- a/classes/es/class_script.rst +++ b/classes/es/class_script.rst @@ -253,9 +253,9 @@ Devuelve la lista de propiedades en este **Script**. :ref:`Array`\[:ref:`Dictionary`\] **get_script_signal_list**\ (\ ) :ref:`🔗` -Devuelve la lista de señales de usuario definidas en este **Script**. +Returns the list of signals defined in this **Script**. -\ **Nota:** Los diccionarios devueltos por este método tienen un formato idéntico a los devueltos por :ref:`Object.get_signal_list()`. +\ **Note:** The dictionaries returned by this method are formatted identically to those returned by :ref:`Object.get_signal_list()`. .. rst-class:: classref-item-separator diff --git a/classes/es/class_scriptlanguageextension.rst b/classes/es/class_scriptlanguageextension.rst index 6e2ddaa956..b913f7cbf8 100644 --- a/classes/es/class_scriptlanguageextension.rst +++ b/classes/es/class_scriptlanguageextension.rst @@ -90,7 +90,7 @@ Métodos +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`_handles_global_class_type`\ (\ type\: :ref:`String`\ ) |virtual| |required| |const| | +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_has_named_classes`\ (\ ) |virtual| |required| |const| | + | :ref:`bool` | :ref:`_has_named_classes`\ (\ ) |virtual| |const| | +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_init`\ (\ ) |virtual| |required| | +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -981,7 +981,7 @@ Devuelve la línea donde se define la función en el código, o ``-1`` si la fun .. rst-class:: classref-method -:ref:`bool` **_has_named_classes**\ (\ ) |virtual| |required| |const| :ref:`🔗` +:ref:`bool` **_has_named_classes**\ (\ ) |virtual| |const| :ref:`🔗` **Obsoleto:** This method is not called by the engine. diff --git a/classes/es/class_scrollcontainer.rst b/classes/es/class_scrollcontainer.rst index a5e11ccee2..02b3a33fde 100644 --- a/classes/es/class_scrollcontainer.rst +++ b/classes/es/class_scrollcontainer.rst @@ -33,27 +33,31 @@ Propiedades .. table:: :widths: auto - +----------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`bool` | clip_contents | ``true`` (overrides :ref:`Control`) | - +----------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`draw_focus_border` | ``false`` | - +----------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`follow_focus` | ``false`` | - +----------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`ScrollMode` | :ref:`horizontal_scroll_mode` | ``1`` | - +----------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`int` | :ref:`scroll_deadzone` | ``0`` | - +----------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`int` | :ref:`scroll_horizontal` | ``0`` | - +----------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`float` | :ref:`scroll_horizontal_custom_step` | ``-1.0`` | - +----------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`int` | :ref:`scroll_vertical` | ``0`` | - +----------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`float` | :ref:`scroll_vertical_custom_step` | ``-1.0`` | - +----------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`ScrollMode` | :ref:`vertical_scroll_mode` | ``1`` | - +----------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + +------------------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | clip_contents | ``true`` (overrides :ref:`Control`) | + +------------------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`draw_focus_border` | ``false`` | + +------------------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`follow_focus` | ``false`` | + +------------------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`ScrollMode` | :ref:`horizontal_scroll_mode` | ``1`` | + +------------------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`int` | :ref:`scroll_deadzone` | ``0`` | + +------------------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`ScrollHintMode` | :ref:`scroll_hint_mode` | ``0`` | + +------------------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`int` | :ref:`scroll_horizontal` | ``0`` | + +------------------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`float` | :ref:`scroll_horizontal_custom_step` | ``-1.0`` | + +------------------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`int` | :ref:`scroll_vertical` | ``0`` | + +------------------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`float` | :ref:`scroll_vertical_custom_step` | ``-1.0`` | + +------------------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`tile_scroll_hint` | ``false`` | + +------------------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`ScrollMode` | :ref:`vertical_scroll_mode` | ``1`` | + +------------------------------------------------------------+----------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -79,11 +83,19 @@ Propiedades del Tema .. table:: :widths: auto - +---------------------------------+-------------------------------------------------------+ - | :ref:`StyleBox` | :ref:`focus` | - +---------------------------------+-------------------------------------------------------+ - | :ref:`StyleBox` | :ref:`panel` | - +---------------------------------+-------------------------------------------------------+ + +-----------------------------------+--------------------------------------------------------------------------------------------+-------+ + | :ref:`int` | :ref:`scrollbar_h_separation` | ``0`` | + +-----------------------------------+--------------------------------------------------------------------------------------------+-------+ + | :ref:`int` | :ref:`scrollbar_v_separation` | ``0`` | + +-----------------------------------+--------------------------------------------------------------------------------------------+-------+ + | :ref:`Texture2D` | :ref:`scroll_hint_horizontal` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+-------+ + | :ref:`Texture2D` | :ref:`scroll_hint_vertical` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+-------+ + | :ref:`StyleBox` | :ref:`focus` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+-------+ + | :ref:`StyleBox` | :ref:`panel` | | + +-----------------------------------+--------------------------------------------------------------------------------------------+-------+ .. rst-class:: classref-section-separator @@ -173,6 +185,48 @@ Desplazamiento activado, la barra de desplazamiento estará oculta. Combina :ref:`SCROLL_MODE_AUTO` y :ref:`SCROLL_MODE_SHOW_ALWAYS`. La barra de desplazamiento solo es visible si es necesario, pero el tamaño del contenido se ajusta como si siempre estuviera visible. Es útil para asegurar que el tamaño del contenido se mantenga igual independientemente de si la barra de desplazamiento está visible. +.. rst-class:: classref-item-separator + +---- + +.. _enum_ScrollContainer_ScrollHintMode: + +.. rst-class:: classref-enumeration + +enum **ScrollHintMode**: :ref:`🔗` + +.. _class_ScrollContainer_constant_SCROLL_HINT_MODE_DISABLED: + +.. rst-class:: classref-enumeration-constant + +:ref:`ScrollHintMode` **SCROLL_HINT_MODE_DISABLED** = ``0`` + +Scroll hints will never be shown. + +.. _class_ScrollContainer_constant_SCROLL_HINT_MODE_ALL: + +.. rst-class:: classref-enumeration-constant + +:ref:`ScrollHintMode` **SCROLL_HINT_MODE_ALL** = ``1`` + +Scroll hints will be shown at the top and bottom (if vertical), or left and right (if horizontal). + +.. _class_ScrollContainer_constant_SCROLL_HINT_MODE_TOP_AND_LEFT: + +.. rst-class:: classref-enumeration-constant + +:ref:`ScrollHintMode` **SCROLL_HINT_MODE_TOP_AND_LEFT** = ``2`` + +Scroll hints will be shown at the top (if vertical), or the left (if horizontal). + +.. _class_ScrollContainer_constant_SCROLL_HINT_MODE_BOTTOM_AND_RIGHT: + +.. rst-class:: classref-enumeration-constant + +:ref:`ScrollHintMode` **SCROLL_HINT_MODE_BOTTOM_AND_RIGHT** = ``3`` + +Scroll hints will be shown at the bottom (if horizontal), or the right (if horizontal). + .. rst-class:: classref-section-separator ---- @@ -250,6 +304,25 @@ Zona muerta para el desplazamiento táctil. Una zona muerta más baja hace que e ---- +.. _class_ScrollContainer_property_scroll_hint_mode: + +.. rst-class:: classref-property + +:ref:`ScrollHintMode` **scroll_hint_mode** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_scroll_hint_mode**\ (\ value\: :ref:`ScrollHintMode`\ ) +- :ref:`ScrollHintMode` **get_scroll_hint_mode**\ (\ ) + +The way which scroll hints (indicators that show that the content can still be scrolled in a certain direction) will be shown. + +\ **Note:** Hints won't be shown if the content can be scrolled both vertically and horizontally. + +.. rst-class:: classref-item-separator + +---- + .. _class_ScrollContainer_property_scroll_horizontal: .. rst-class:: classref-property @@ -332,6 +405,23 @@ Reemplaza el :ref:`ScrollBar.custom_step` ---- +.. _class_ScrollContainer_property_tile_scroll_hint: + +.. rst-class:: classref-property + +:ref:`bool` **tile_scroll_hint** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_tile_scroll_hint**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_scroll_hint_tiled**\ (\ ) + +If ``true``, the scroll hint texture will be tiled instead of stretched. See :ref:`scroll_hint_mode`. + +.. rst-class:: classref-item-separator + +---- + .. _class_ScrollContainer_property_vertical_scroll_mode: .. rst-class:: classref-property @@ -407,6 +497,54 @@ Devuelve la barra de desplazamiento vertical :ref:`VScrollBar` Descripciones de las propiedades del tema ---------------------------------------------------------------------------------- +.. _class_ScrollContainer_theme_constant_scrollbar_h_separation: + +.. rst-class:: classref-themeproperty + +:ref:`int` **scrollbar_h_separation** = ``0`` :ref:`🔗` + +The space between the ScrollContainer's vertical scroll bar and its content, in pixels. No space will be added when the content's minimum size is larger than the ScrollContainer's size. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ScrollContainer_theme_constant_scrollbar_v_separation: + +.. rst-class:: classref-themeproperty + +:ref:`int` **scrollbar_v_separation** = ``0`` :ref:`🔗` + +The space between the ScrollContainer's horizontal scroll bar and its content, in pixels. No space will be added when the content's minimum size is larger than the ScrollContainer's size. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ScrollContainer_theme_icon_scroll_hint_horizontal: + +.. rst-class:: classref-themeproperty + +:ref:`Texture2D` **scroll_hint_horizontal** :ref:`🔗` + +The indicator that will be shown when the content can still be scrolled horizontally. See :ref:`scroll_hint_mode`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ScrollContainer_theme_icon_scroll_hint_vertical: + +.. rst-class:: classref-themeproperty + +:ref:`Texture2D` **scroll_hint_vertical** :ref:`🔗` + +The indicator that will be shown when the content can still be scrolled vertically. See :ref:`scroll_hint_mode`. + +.. rst-class:: classref-item-separator + +---- + .. _class_ScrollContainer_theme_style_focus: .. rst-class:: classref-themeproperty diff --git a/classes/es/class_skeleton3d.rst b/classes/es/class_skeleton3d.rst index 6b2b1b7fda..6c1f41fc36 100644 --- a/classes/es/class_skeleton3d.rst +++ b/classes/es/class_skeleton3d.rst @@ -566,7 +566,7 @@ Devuelve la transformación de reposo global para ``bone_idx``. :ref:`Variant` **get_bone_meta**\ (\ bone_idx\: :ref:`int`, key\: :ref:`StringName`\ ) |const| :ref:`🔗` -Devuelve los metadatos para el hueso en el índice ``bone_idx`` con la ``key``. +Returns the metadata with the given ``key`` for the bone at index ``bone_idx``. .. rst-class:: classref-item-separator @@ -720,7 +720,7 @@ La versión del Skeleton no se serializa: úsese sólo dentro de una única inst :ref:`bool` **has_bone_meta**\ (\ bone_idx\: :ref:`int`, key\: :ref:`StringName`\ ) |const| :ref:`🔗` -Returns ``true`` if the bone at index ``bone_idx`` has metadata with the key ``key``. +Returns ``true`` if the bone at index ``bone_idx`` has metadata with the given ``key``. .. rst-class:: classref-item-separator @@ -898,7 +898,7 @@ Sets the global pose transform, ``pose``, for the bone at ``bone_idx``. |void| **set_bone_meta**\ (\ bone_idx\: :ref:`int`, key\: :ref:`StringName`, value\: :ref:`Variant`\ ) :ref:`🔗` -Establece los metadatos para el hueso en el índice ``bone_idx``, asignando el valor ``value`` a la clave ``key``. +Sets the metadata with the given ``key`` to ``value`` for the bone at index ``bone_idx``. .. rst-class:: classref-item-separator diff --git a/classes/es/class_skeletonmodifier3d.rst b/classes/es/class_skeletonmodifier3d.rst index bf4a8f84c9..5c3f8db4bc 100644 --- a/classes/es/class_skeletonmodifier3d.rst +++ b/classes/es/class_skeletonmodifier3d.rst @@ -7,7 +7,7 @@ SkeletonModifier3D **Hereda:** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` -**Heredado por:** :ref:`BoneConstraint3D`, :ref:`LookAtModifier3D`, :ref:`ModifierBoneTarget3D`, :ref:`PhysicalBoneSimulator3D`, :ref:`RetargetModifier3D`, :ref:`SkeletonIK3D`, :ref:`SpringBoneSimulator3D`, :ref:`XRBodyModifier3D`, :ref:`XRHandModifier3D` +**Heredado por:** :ref:`BoneConstraint3D`, :ref:`BoneTwistDisperser3D`, :ref:`IKModifier3D`, :ref:`LimitAngularVelocityModifier3D`, :ref:`LookAtModifier3D`, :ref:`ModifierBoneTarget3D`, :ref:`PhysicalBoneSimulator3D`, :ref:`RetargetModifier3D`, :ref:`SkeletonIK3D`, :ref:`SpringBoneSimulator3D`, :ref:`XRBodyModifier3D`, :ref:`XRHandModifier3D` Un nodo que puede modificar los huesos de un Skeleton3D. @@ -145,6 +145,196 @@ Valor enumerado para el eje +Z. Valor enumerado para el eje -Z. +.. rst-class:: classref-item-separator + +---- + +.. _enum_SkeletonModifier3D_BoneDirection: + +.. rst-class:: classref-enumeration + +enum **BoneDirection**: :ref:`🔗` + +.. _class_SkeletonModifier3D_constant_BONE_DIRECTION_PLUS_X: + +.. rst-class:: classref-enumeration-constant + +:ref:`BoneDirection` **BONE_DIRECTION_PLUS_X** = ``0`` + +Valor enumerado para el eje +X. + +.. _class_SkeletonModifier3D_constant_BONE_DIRECTION_MINUS_X: + +.. rst-class:: classref-enumeration-constant + +:ref:`BoneDirection` **BONE_DIRECTION_MINUS_X** = ``1`` + +Valor enumerado para el eje -X. + +.. _class_SkeletonModifier3D_constant_BONE_DIRECTION_PLUS_Y: + +.. rst-class:: classref-enumeration-constant + +:ref:`BoneDirection` **BONE_DIRECTION_PLUS_Y** = ``2`` + +Valor enumerado para el eje +Y. + +.. _class_SkeletonModifier3D_constant_BONE_DIRECTION_MINUS_Y: + +.. rst-class:: classref-enumeration-constant + +:ref:`BoneDirection` **BONE_DIRECTION_MINUS_Y** = ``3`` + +Valor enumerado para el eje -Y. + +.. _class_SkeletonModifier3D_constant_BONE_DIRECTION_PLUS_Z: + +.. rst-class:: classref-enumeration-constant + +:ref:`BoneDirection` **BONE_DIRECTION_PLUS_Z** = ``4`` + +Valor enumerado para el eje +Z. + +.. _class_SkeletonModifier3D_constant_BONE_DIRECTION_MINUS_Z: + +.. rst-class:: classref-enumeration-constant + +:ref:`BoneDirection` **BONE_DIRECTION_MINUS_Z** = ``5`` + +Valor enumerado para el eje -Z. + +.. _class_SkeletonModifier3D_constant_BONE_DIRECTION_FROM_PARENT: + +.. rst-class:: classref-enumeration-constant + +:ref:`BoneDirection` **BONE_DIRECTION_FROM_PARENT** = ``6`` + +Valor enumerado para el eje desde un hueso padre hasta el hueso hijo. + +.. rst-class:: classref-item-separator + +---- + +.. _enum_SkeletonModifier3D_SecondaryDirection: + +.. rst-class:: classref-enumeration + +enum **SecondaryDirection**: :ref:`🔗` + +.. _class_SkeletonModifier3D_constant_SECONDARY_DIRECTION_NONE: + +.. rst-class:: classref-enumeration-constant + +:ref:`SecondaryDirection` **SECONDARY_DIRECTION_NONE** = ``0`` + +Enumerated value for the case when the axis is undefined. + +.. _class_SkeletonModifier3D_constant_SECONDARY_DIRECTION_PLUS_X: + +.. rst-class:: classref-enumeration-constant + +:ref:`SecondaryDirection` **SECONDARY_DIRECTION_PLUS_X** = ``1`` + +Valor enumerado para el eje +X. + +.. _class_SkeletonModifier3D_constant_SECONDARY_DIRECTION_MINUS_X: + +.. rst-class:: classref-enumeration-constant + +:ref:`SecondaryDirection` **SECONDARY_DIRECTION_MINUS_X** = ``2`` + +Valor enumerado para el eje -X. + +.. _class_SkeletonModifier3D_constant_SECONDARY_DIRECTION_PLUS_Y: + +.. rst-class:: classref-enumeration-constant + +:ref:`SecondaryDirection` **SECONDARY_DIRECTION_PLUS_Y** = ``3`` + +Valor enumerado para el eje +Y. + +.. _class_SkeletonModifier3D_constant_SECONDARY_DIRECTION_MINUS_Y: + +.. rst-class:: classref-enumeration-constant + +:ref:`SecondaryDirection` **SECONDARY_DIRECTION_MINUS_Y** = ``4`` + +Valor enumerado para el eje -Y. + +.. _class_SkeletonModifier3D_constant_SECONDARY_DIRECTION_PLUS_Z: + +.. rst-class:: classref-enumeration-constant + +:ref:`SecondaryDirection` **SECONDARY_DIRECTION_PLUS_Z** = ``5`` + +Valor enumerado para el eje +Z. + +.. _class_SkeletonModifier3D_constant_SECONDARY_DIRECTION_MINUS_Z: + +.. rst-class:: classref-enumeration-constant + +:ref:`SecondaryDirection` **SECONDARY_DIRECTION_MINUS_Z** = ``6`` + +Valor enumerado para el eje -Z. + +.. _class_SkeletonModifier3D_constant_SECONDARY_DIRECTION_CUSTOM: + +.. rst-class:: classref-enumeration-constant + +:ref:`SecondaryDirection` **SECONDARY_DIRECTION_CUSTOM** = ``7`` + +Enumerated value for an optional axis. + +.. rst-class:: classref-item-separator + +---- + +.. _enum_SkeletonModifier3D_RotationAxis: + +.. rst-class:: classref-enumeration + +enum **RotationAxis**: :ref:`🔗` + +.. _class_SkeletonModifier3D_constant_ROTATION_AXIS_X: + +.. rst-class:: classref-enumeration-constant + +:ref:`RotationAxis` **ROTATION_AXIS_X** = ``0`` + +Valor enumerado para la rotación del eje X. + +.. _class_SkeletonModifier3D_constant_ROTATION_AXIS_Y: + +.. rst-class:: classref-enumeration-constant + +:ref:`RotationAxis` **ROTATION_AXIS_Y** = ``1`` + +Valor enumerado para la rotación del eje Y. + +.. _class_SkeletonModifier3D_constant_ROTATION_AXIS_Z: + +.. rst-class:: classref-enumeration-constant + +:ref:`RotationAxis` **ROTATION_AXIS_Z** = ``2`` + +Valor enumerado para la rotación del eje Z. + +.. _class_SkeletonModifier3D_constant_ROTATION_AXIS_ALL: + +.. rst-class:: classref-enumeration-constant + +:ref:`RotationAxis` **ROTATION_AXIS_ALL** = ``3`` + +Valor enumerado para la rotación sin restricciones. + +.. _class_SkeletonModifier3D_constant_ROTATION_AXIS_CUSTOM: + +.. rst-class:: classref-enumeration-constant + +:ref:`RotationAxis` **ROTATION_AXIS_CUSTOM** = ``4`` + +Enumerated value for an optional rotation axis. + .. rst-class:: classref-section-separator ---- @@ -245,7 +435,7 @@ Se llama a este método cuando el esqueleto cambia. |void| **_validate_bone_names**\ (\ ) |virtual| :ref:`🔗` -Se llama a este método cuando el nombre y el índice del hueso necesitan ser validados, como el momento de entrar en el árbol o cambiar el esqueleto. +Called when bone names and indices need to be validated, such as when entering the scene tree or changing skeleton. .. rst-class:: classref-item-separator @@ -257,7 +447,7 @@ Se llama a este método cuando el nombre y el índice del hueso necesitan ser va :ref:`Skeleton3D` **get_skeleton**\ (\ ) |const| :ref:`🔗` -Obtiene el nodo padre :ref:`Skeleton3D` si se encuentra. +Returns the parent :ref:`Skeleton3D` node if it exists. Otherwise, returns ``null``. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_skeletonprofilehumanoid.rst b/classes/es/class_skeletonprofilehumanoid.rst index dac71ee7fd..74359b94c7 100644 --- a/classes/es/class_skeletonprofilehumanoid.rst +++ b/classes/es/class_skeletonprofilehumanoid.rst @@ -16,7 +16,7 @@ Descripción A :ref:`SkeletonProfile` as a preset that is optimized for the human form. This exists for standardization, so all parameters are read-only. -A humanoid skeleton profile contains 54 bones divided in 4 groups: ``"Body"``, ``"Face"``, ``"LeftHand"``, and ``"RightHand"``. It is structured as follows: +A humanoid skeleton profile contains 56 bones divided into 4 groups: ``"Body"``, ``"Face"``, ``"LeftHand"``, and ``"RightHand"``. It is structured as follows: .. code:: text diff --git a/classes/es/class_socketserver.rst b/classes/es/class_socketserver.rst new file mode 100644 index 0000000000..402601823b --- /dev/null +++ b/classes/es/class_socketserver.rst @@ -0,0 +1,100 @@ +:github_url: hide + +.. _class_SocketServer: + +SocketServer +============ + +**Hereda:** :ref:`RefCounted` **<** :ref:`Object` + +**Heredado por:** :ref:`TCPServer`, :ref:`UDSServer` + +An abstract class for servers based on sockets. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +A socket server. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_connection_available`\ (\ ) |const| | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_listening`\ (\ ) |const| | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | |void| | :ref:`stop`\ (\ ) | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------+ + | :ref:`StreamPeerSocket` | :ref:`take_socket_connection`\ (\ ) | + +-------------------------------------------------+-------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_SocketServer_method_is_connection_available: + +.. rst-class:: classref-method + +:ref:`bool` **is_connection_available**\ (\ ) |const| :ref:`🔗` + +Devuelve ``true`` si hay una conexión disponible para tomar. + +.. rst-class:: classref-item-separator + +---- + +.. _class_SocketServer_method_is_listening: + +.. rst-class:: classref-method + +:ref:`bool` **is_listening**\ (\ ) |const| :ref:`🔗` + +Devuelve ``true`` si el servidor está actualmente a la escucha de las conexiones. + +.. rst-class:: classref-item-separator + +---- + +.. _class_SocketServer_method_stop: + +.. rst-class:: classref-method + +|void| **stop**\ (\ ) :ref:`🔗` + +Para de escuchar. + +.. rst-class:: classref-item-separator + +---- + +.. _class_SocketServer_method_take_socket_connection: + +.. rst-class:: classref-method + +:ref:`StreamPeerSocket` **take_socket_connection**\ (\ ) :ref:`🔗` + +If a connection is available, returns a StreamPeerSocket with the connection. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_spinbox.rst b/classes/es/class_spinbox.rst index 25f655c04e..d535ce0d52 100644 --- a/classes/es/class_spinbox.rst +++ b/classes/es/class_spinbox.rst @@ -63,6 +63,8 @@ Propiedades +-------------------------------------------------------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------+ | :ref:`HorizontalAlignment` | :ref:`alignment` | ``0`` | +-------------------------------------------------------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`custom_arrow_round` | ``false`` | + +-------------------------------------------------------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------+ | :ref:`float` | :ref:`custom_arrow_step` | ``0.0`` | +-------------------------------------------------------------------+------------------------------------------------------------------------------+------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`editable` | ``true`` | @@ -192,6 +194,23 @@ Cambia la alineación del :ref:`LineEdit` subyacente. ---- +.. _class_SpinBox_property_custom_arrow_round: + +.. rst-class:: classref-property + +:ref:`bool` **custom_arrow_round** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_custom_arrow_round**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_custom_arrow_rounding**\ (\ ) + +If ``true``, the value will be rounded to a multiple of :ref:`custom_arrow_step` when interacting with the arrow buttons. Otherwise, increments the value by :ref:`custom_arrow_step` and then rounds it according to :ref:`Range.step`. + +.. rst-class:: classref-item-separator + +---- + .. _class_SpinBox_property_custom_arrow_step: .. rst-class:: classref-property diff --git a/classes/es/class_splineik3d.rst b/classes/es/class_splineik3d.rst new file mode 100644 index 0000000000..14c17350f9 --- /dev/null +++ b/classes/es/class_splineik3d.rst @@ -0,0 +1,204 @@ +:github_url: hide + +.. _class_SplineIK3D: + +SplineIK3D +========== + +**Hereda:** :ref:`ChainIK3D` **<** :ref:`IKModifier3D` **<** :ref:`SkeletonModifier3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` + +A :ref:`SkeletonModifier3D` for aligning bones along a :ref:`Path3D`. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +A :ref:`SkeletonModifier3D` for aligning bones along a :ref:`Path3D`. The smoothness of the fitting depends on the :ref:`Curve3D.bake_interval`. + +If you want the :ref:`Path3D` to attach to a specific bone, it is recommended to place a :ref:`ModifierBoneTarget3D` before the **SplineIK3D** in the :ref:`SkeletonModifier3D` list (children of the :ref:`Skeleton3D`), and then place a :ref:`Path3D` as the :ref:`ModifierBoneTarget3D`'s child. + +Bone twist is determined based on the :ref:`Curve3D.get_point_tilt()`. + +If the root bone joint and the start point of the :ref:`Curve3D` are separated, it assumes that there is a linear line segment between them. This means that the vector pointing toward the start point of the :ref:`Curve3D` takes precedence over the shortest intersection point along the :ref:`Curve3D`. + +If the end bone joint exceeds the path length, it is bent as close as possible to the end point of the :ref:`Curve3D`. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +-----------------------+---------------------------------------------------------------+-------+ + | :ref:`int` | :ref:`setting_count` | ``0`` | + +-----------------------+---------------------------------------------------------------+-------+ + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`NodePath` | :ref:`get_path_3d`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_tilt_fade_in`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_tilt_fade_out`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_tilt_enabled`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_path_3d`\ (\ index\: :ref:`int`, path_3d\: :ref:`NodePath`\ ) | + +---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_tilt_enabled`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | + +---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_tilt_fade_in`\ (\ index\: :ref:`int`, size\: :ref:`int`\ ) | + +---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_tilt_fade_out`\ (\ index\: :ref:`int`, size\: :ref:`int`\ ) | + +---------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_SplineIK3D_property_setting_count: + +.. rst-class:: classref-property + +:ref:`int` **setting_count** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_setting_count**\ (\ value\: :ref:`int`\ ) +- :ref:`int` **get_setting_count**\ (\ ) + +El número de configuraciones. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_SplineIK3D_method_get_path_3d: + +.. rst-class:: classref-method + +:ref:`NodePath` **get_path_3d**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the node path of the :ref:`Path3D` which is describing the path. + +.. rst-class:: classref-item-separator + +---- + +.. _class_SplineIK3D_method_get_tilt_fade_in: + +.. rst-class:: classref-method + +:ref:`int` **get_tilt_fade_in**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the tilt interpolation method used between the root bone and the start point of the :ref:`Curve3D` when they are apart. See also :ref:`set_tilt_fade_in()`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_SplineIK3D_method_get_tilt_fade_out: + +.. rst-class:: classref-method + +:ref:`int` **get_tilt_fade_out**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the tilt interpolation method used between the end bone and the end point of the :ref:`Curve3D` when they are apart. See also :ref:`set_tilt_fade_out()`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_SplineIK3D_method_is_tilt_enabled: + +.. rst-class:: classref-method + +:ref:`bool` **is_tilt_enabled**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns if the tilt property of the :ref:`Curve3D` affects the bone twist. + +.. rst-class:: classref-item-separator + +---- + +.. _class_SplineIK3D_method_set_path_3d: + +.. rst-class:: classref-method + +|void| **set_path_3d**\ (\ index\: :ref:`int`, path_3d\: :ref:`NodePath`\ ) :ref:`🔗` + +Sets the node path of the :ref:`Path3D` which is describing the path. + +.. rst-class:: classref-item-separator + +---- + +.. _class_SplineIK3D_method_set_tilt_enabled: + +.. rst-class:: classref-method + +|void| **set_tilt_enabled**\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) :ref:`🔗` + +Sets if the tilt property of the :ref:`Curve3D` should affect the bone twist. + +.. rst-class:: classref-item-separator + +---- + +.. _class_SplineIK3D_method_set_tilt_fade_in: + +.. rst-class:: classref-method + +|void| **set_tilt_fade_in**\ (\ index\: :ref:`int`, size\: :ref:`int`\ ) :ref:`🔗` + +If ``size`` is greater than ``0``, the tilt is interpolated between ``size`` start bones from the start point of the :ref:`Curve3D` when they are apart. + +If ``size`` is equal ``0``, the tilts between the root bone head and the start point of the :ref:`Curve3D` are unified with a tilt of the start point of the :ref:`Curve3D`. + +If ``size`` is less than ``0``, the tilts between the root bone and the start point of the :ref:`Curve3D` are ``0.0``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_SplineIK3D_method_set_tilt_fade_out: + +.. rst-class:: classref-method + +|void| **set_tilt_fade_out**\ (\ index\: :ref:`int`, size\: :ref:`int`\ ) :ref:`🔗` + +If ``size`` is greater than ``0``, the tilt is interpolated between ``size`` end bones from the end point of the :ref:`Curve3D` when they are apart. + +If ``size`` is equal ``0``, the tilts between the end bone tail and the end point of the :ref:`Curve3D` are unified with a tilt of the end point of the :ref:`Curve3D`. + +If ``size`` is less than ``0``, the tilts between the end bone and the end point of the :ref:`Curve3D` are ``0.0``. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_splitcontainer.rst b/classes/es/class_splitcontainer.rst index a0ba78cc12..21bd221973 100644 --- a/classes/es/class_splitcontainer.rst +++ b/classes/es/class_splitcontainer.rst @@ -9,14 +9,14 @@ SplitContainer **Heredado por:** :ref:`HSplitContainer`, :ref:`VSplitContainer` -A container that splits two child controls horizontally or vertically and provides a grabber for adjusting the split ratio. +A container that arranges child controls horizontally or vertically and provides grabbers for adjusting the split ratios between them. .. rst-class:: classref-introduction-group Descripción ---------------------- -Un contenedor que acepta solo dos controles hijo, luego los organiza horizontal o verticalmente y crea un divisor entre ellos. El divisor se puede arrastrar para cambiar la relación de tamaño entre los controles hijo. +A container that arranges child controls horizontally or vertically and creates grabbers between them. The grabbers can be dragged around to change the size relations between the child controls. .. rst-class:: classref-introduction-group @@ -33,27 +33,29 @@ Propiedades .. table:: :widths: auto - +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-----------+ - | :ref:`bool` | :ref:`collapsed` | ``false`` | - +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-----------+ - | :ref:`bool` | :ref:`drag_area_highlight_in_editor` | ``false`` | - +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-----------+ - | :ref:`int` | :ref:`drag_area_margin_begin` | ``0`` | - +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-----------+ - | :ref:`int` | :ref:`drag_area_margin_end` | ``0`` | - +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-----------+ - | :ref:`int` | :ref:`drag_area_offset` | ``0`` | - +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-----------+ - | :ref:`DraggerVisibility` | :ref:`dragger_visibility` | ``0`` | - +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-----------+ - | :ref:`bool` | :ref:`dragging_enabled` | ``true`` | - +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-----------+ - | :ref:`int` | :ref:`split_offset` | ``0`` | - +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-----------+ - | :ref:`bool` | :ref:`touch_dragger_enabled` | ``false`` | - +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-----------+ - | :ref:`bool` | :ref:`vertical` | ``false`` | - +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-----------+ + +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`bool` | :ref:`collapsed` | ``false`` | + +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`bool` | :ref:`drag_area_highlight_in_editor` | ``false`` | + +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`int` | :ref:`drag_area_margin_begin` | ``0`` | + +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`int` | :ref:`drag_area_margin_end` | ``0`` | + +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`int` | :ref:`drag_area_offset` | ``0`` | + +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`DraggerVisibility` | :ref:`dragger_visibility` | ``0`` | + +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`bool` | :ref:`dragging_enabled` | ``true`` | + +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`int` | :ref:`split_offset` | ``0`` | + +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`PackedInt32Array` | :ref:`split_offsets` | ``PackedInt32Array(0)`` | + +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`bool` | :ref:`touch_dragger_enabled` | ``false`` | + +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-------------------------+ + | :ref:`bool` | :ref:`vertical` | ``false`` | + +-----------------------------------------------------------------+---------------------------------------------------------------------------------------------------+-------------------------+ .. rst-class:: classref-reftable-group @@ -63,11 +65,13 @@ Métodos .. table:: :widths: auto - +-------------------------------+---------------------------------------------------------------------------------------+ - | |void| | :ref:`clamp_split_offset`\ (\ ) | - +-------------------------------+---------------------------------------------------------------------------------------+ - | :ref:`Control` | :ref:`get_drag_area_control`\ (\ ) | - +-------------------------------+---------------------------------------------------------------------------------------+ + +------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clamp_split_offset`\ (\ priority_index\: :ref:`int` = 0\ ) | + +------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Control` | :ref:`get_drag_area_control`\ (\ ) | + +------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Array`\[:ref:`Control`\] | :ref:`get_drag_area_controls`\ (\ ) | + +------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -144,7 +148,7 @@ Emitida cuando el usuario comienza a arrastrar. **dragged**\ (\ offset\: :ref:`int`\ ) :ref:`🔗` -Emitida cuando el arrastrador es arrastrado por el usuario. +Emitted when any dragger is dragged by user. .. rst-class:: classref-section-separator @@ -211,7 +215,7 @@ Descripciones de Propiedades - |void| **set_collapsed**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_collapsed**\ (\ ) -If ``true``, the dragger will be disabled and the children will be sized as if the :ref:`split_offset` was ``0``. +If ``true``, the draggers will be disabled and the children will be sized as if all :ref:`split_offsets` were ``0``. .. rst-class:: classref-item-separator @@ -330,7 +334,32 @@ Enables or disables split dragging. - |void| **set_split_offset**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_split_offset**\ (\ ) -El desplazamiento inicial de la división entre los dos :ref:`Control`\ s, con ``0`` estando al final del primer :ref:`Control`. +**Obsoleto:** Use :ref:`split_offsets` instead. The first element of the array is the split offset between the first two children. + +The first element of :ref:`split_offsets`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_SplitContainer_property_split_offsets: + +.. rst-class:: classref-property + +:ref:`PackedInt32Array` **split_offsets** = ``PackedInt32Array(0)`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_split_offsets**\ (\ value\: :ref:`PackedInt32Array`\ ) +- :ref:`PackedInt32Array` **get_split_offsets**\ (\ ) + +Offsets for each dragger in pixels. Each one is the offset of the split between the :ref:`Control` nodes before and after the dragger, with ``0`` being the default position. The default position is based on the :ref:`Control` nodes expand flags and minimum sizes. See :ref:`Control.size_flags_horizontal`, :ref:`Control.size_flags_vertical`, and :ref:`Control.size_flags_stretch_ratio`. + +If none of the :ref:`Control` nodes before the dragger are expanded, the default position will be at the start of the **SplitContainer**. If none of the :ref:`Control` nodes after the dragger are expanded, the default position will be at the end of the **SplitContainer**. If the dragger is in between expanded :ref:`Control` nodes, the default position will be in the middle, based on the :ref:`Control.size_flags_stretch_ratio`\ s and minimum sizes. + +\ **Note:** If the split offsets cause :ref:`Control` nodes to overlap, the first split will take priority when resolving the positions. + +**Note:** The returned array is *copied* and any changes to it will not update the original property value. See :ref:`PackedInt32Array` for more details. .. rst-class:: classref-item-separator @@ -381,9 +410,9 @@ Descripciones de Métodos .. rst-class:: classref-method -|void| **clamp_split_offset**\ (\ ) :ref:`🔗` +|void| **clamp_split_offset**\ (\ priority_index\: :ref:`int` = 0\ ) :ref:`🔗` -Bloquea el valor :ref:`split_offset` para que no se salga de los valores mínimos y máximos actualmente posibles. +Clamps the :ref:`split_offsets` values to ensure they are within valid ranges and do not overlap with each other. When overlaps occur, this method prioritizes one split offset (at index ``priority_index``) by clamping any overlapping split offsets to it. .. rst-class:: classref-item-separator @@ -395,6 +424,8 @@ Bloquea el valor :ref:`split_offset` :ref:`Control` **get_drag_area_control**\ (\ ) :ref:`🔗` +**Obsoleto:** Use the first element of :ref:`get_drag_area_controls()` instead. + Returns the drag area :ref:`Control`. For example, you can move a pre-configured button into the drag area :ref:`Control` so that it rides along with the split bar. Try setting the :ref:`Button` anchors to ``center`` prior to the ``reparent()`` call. :: @@ -405,6 +436,26 @@ Returns the drag area :ref:`Control`. For example, you can move a \ **Warning:** This is a required internal node, removing and freeing it may cause a crash. +.. rst-class:: classref-item-separator + +---- + +.. _class_SplitContainer_method_get_drag_area_controls: + +.. rst-class:: classref-method + +:ref:`Array`\[:ref:`Control`\] **get_drag_area_controls**\ (\ ) :ref:`🔗` + +Returns an :ref:`Array` of the drag area :ref:`Control`\ s. These are the interactable :ref:`Control` nodes between each child. For example, this can be used to add a pre-configured button to a drag area :ref:`Control` so that it rides along with the split bar. Try setting the :ref:`Button` anchors to ``center`` prior to the :ref:`Node.reparent()` call. + +:: + + $BarnacleButton.reparent($SplitContainer.get_drag_area_controls()[0]) + +\ **Note:** The drag area :ref:`Control`\ s are drawn over the **SplitContainer**'s children, so :ref:`CanvasItem` draw objects called from a drag area and children added to it will also appear over the **SplitContainer**'s children. Try setting :ref:`Control.mouse_filter` of custom children to :ref:`Control.MOUSE_FILTER_IGNORE` to prevent blocking the mouse from dragging if desired. + +\ **Warning:** These are required internal nodes, removing or freeing them may cause a crash. + .. rst-class:: classref-section-separator ---- @@ -456,7 +507,7 @@ El color del control táctil de arrastre cuando se pulsa. :ref:`int` **autohide** = ``1`` :ref:`🔗` -Boolean value. If ``1`` (``true``), the grabber will hide automatically when it isn't under the cursor. If ``0`` (``false``), it's always visible. The :ref:`dragger_visibility` must be :ref:`DRAGGER_VISIBLE`. +Boolean value. If ``1`` (``true``), the grabbers will hide automatically when they aren't under the cursor. If ``0`` (``false``), the grabbers are always visible. The :ref:`dragger_visibility` must be :ref:`DRAGGER_VISIBLE`. .. rst-class:: classref-item-separator @@ -468,7 +519,7 @@ Boolean value. If ``1`` (``true``), the grabber will hide automatically when it :ref:`int` **minimum_grab_thickness** = ``6`` :ref:`🔗` -El grosor mínimo del área en la que los usuarios pueden hacer clic para agarrar la barra divisoria. Esto asegura que la barra divisoria todavía se pueda arrastrar si el :ref:`separation` o el tamaño de :ref:`h_grabber` / :ref:`v_grabber` es demasiado pequeño para seleccionarlo fácilmente. +The minimum thickness of the area users can click on to grab a split bar. This ensures that the split bar can still be dragged if :ref:`separation` or :ref:`h_grabber` / :ref:`v_grabber`'s size is too narrow to easily select. .. rst-class:: classref-item-separator @@ -480,9 +531,9 @@ El grosor mínimo del área en la que los usuarios pueden hacer clic para agarra :ref:`int` **separation** = ``12`` :ref:`🔗` -El grosor de la barra divisoria, es decir, el espacio entre los dos hijos del contenedor. Esto se anula por el tamaño del icono del agarrador si :ref:`dragger_visibility` se establece en :ref:`DRAGGER_VISIBLE`, o :ref:`DRAGGER_HIDDEN`, y :ref:`separation` es menor que el tamaño del icono del agarrador en el mismo eje. +The split bar thickness, i.e., the gap between each child of the container. This is overridden by the size of the grabber icon if :ref:`dragger_visibility` is set to :ref:`DRAGGER_VISIBLE`, or :ref:`DRAGGER_HIDDEN`, and :ref:`separation` is smaller than the size of the grabber icon in the same axis. -\ **Nota:** Para obtener valores de :ref:`separation` menores que el tamaño del icono del agarrador, por ejemplo, una línea fina de ``1 px``, establece :ref:`h_grabber` o :ref:`v_grabber` a una nueva :ref:`ImageTexture`, lo que establece el tamaño del icono del agarrador a ``0 px``. +\ **Note:** To obtain :ref:`separation` values less than the size of the grabber icon, for example a ``1 px`` hairline, set :ref:`h_grabber` or :ref:`v_grabber` to a new :ref:`ImageTexture`, which effectively sets the grabber icon size to ``0 px``. .. rst-class:: classref-item-separator @@ -494,7 +545,7 @@ El grosor de la barra divisoria, es decir, el espacio entre los dos hijos del co :ref:`Texture2D` **grabber** :ref:`🔗` -El icono utilizado para el agarrador dibujado en el área central. Esto solo se usa en :ref:`HSplitContainer` y :ref:`VSplitContainer`. Para **SplitContainer**, véase :ref:`h_grabber` y :ref:`v_grabber` en su lugar. +The icon used for the grabbers drawn in the separations. This is only used in :ref:`HSplitContainer` and :ref:`VSplitContainer`. For **SplitContainer**, see :ref:`h_grabber` and :ref:`v_grabber` instead. .. rst-class:: classref-item-separator @@ -506,7 +557,7 @@ El icono utilizado para el agarrador dibujado en el área central. Esto solo se :ref:`Texture2D` **h_grabber** :ref:`🔗` -El icono usado para el agarrador dibujado en el área central cuando :ref:`vertical` es ``false``. +The icon used for the grabbers drawn in the separations when :ref:`vertical` is ``false``. .. rst-class:: classref-item-separator @@ -542,7 +593,7 @@ El icono utilizado para el control de arrastre cuando :ref:`touch_dragger_enable :ref:`Texture2D` **v_grabber** :ref:`🔗` -El icono usado para el agarrador dibujado en el área central cuando :ref:`vertical` es ``true``. +The icon used for the grabbers drawn in the separations when :ref:`vertical` is ``true``. .. rst-class:: classref-item-separator diff --git a/classes/es/class_springarm3d.rst b/classes/es/class_springarm3d.rst index 8f738728f7..615d5b9e44 100644 --- a/classes/es/class_springarm3d.rst +++ b/classes/es/class_springarm3d.rst @@ -79,7 +79,7 @@ Descripciones de Propiedades - |void| **set_collision_mask**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_collision_mask**\ (\ ) -Las capas contra las que se realizará la comprobación de colisiones. Véase `Capas y máscaras de colisión <../tutorials/physics/physics_introduction.html#collision-layers-and-masks>`__ en la documentación para obtener más información. +The layers against which the collision check will be done. See `Collision layers and masks <../tutorials/physics/physics_introduction.html#collision-layers-and-masks>`__ in the documentation for more information. .. rst-class:: classref-item-separator diff --git a/classes/es/class_springbonesimulator3d.rst b/classes/es/class_springbonesimulator3d.rst index 385c8058c4..b42366f11c 100644 --- a/classes/es/class_springbonesimulator3d.rst +++ b/classes/es/class_springbonesimulator3d.rst @@ -36,11 +36,13 @@ Propiedades .. table:: :widths: auto - +-------------------------------+----------------------------------------------------------------------------+----------------------+ - | :ref:`Vector3` | :ref:`external_force` | ``Vector3(0, 0, 0)`` | - +-------------------------------+----------------------------------------------------------------------------+----------------------+ - | :ref:`int` | :ref:`setting_count` | ``0`` | - +-------------------------------+----------------------------------------------------------------------------+----------------------+ + +-------------------------------+----------------------------------------------------------------------------------+----------------------+ + | :ref:`Vector3` | :ref:`external_force` | ``Vector3(0, 0, 0)`` | + +-------------------------------+----------------------------------------------------------------------------------+----------------------+ + | :ref:`bool` | :ref:`mutable_bone_axes` | ``true`` | + +-------------------------------+----------------------------------------------------------------------------------+----------------------+ + | :ref:`int` | :ref:`setting_count` | ``0`` | + +-------------------------------+----------------------------------------------------------------------------------+----------------------+ .. rst-class:: classref-reftable-group @@ -50,161 +52,161 @@ Métodos .. table:: :widths: auto - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`are_all_child_collisions_enabled`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear_collisions`\ (\ index\: :ref:`int`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear_exclude_collisions`\ (\ index\: :ref:`int`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear_settings`\ (\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_center_bone`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_center_bone_name`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`CenterFrom` | :ref:`get_center_from`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`NodePath` | :ref:`get_center_node`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_collision_count`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`NodePath` | :ref:`get_collision_path`\ (\ index\: :ref:`int`, collision\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get_drag`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`get_drag_damping_curve`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_end_bone`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`BoneDirection` | :ref:`get_end_bone_direction`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get_end_bone_length`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_end_bone_name`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_exclude_collision_count`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`NodePath` | :ref:`get_exclude_collision_path`\ (\ index\: :ref:`int`, collision\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get_gravity`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`get_gravity_damping_curve`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Vector3` | :ref:`get_gravity_direction`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_joint_bone`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_joint_bone_name`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_joint_count`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get_joint_drag`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get_joint_gravity`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Vector3` | :ref:`get_joint_gravity_direction`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get_joint_radius`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`RotationAxis` | :ref:`get_joint_rotation_axis`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Vector3` | :ref:`get_joint_rotation_axis_vector`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get_joint_stiffness`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get_radius`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`get_radius_damping_curve`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_root_bone`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_root_bone_name`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`RotationAxis` | :ref:`get_rotation_axis`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Vector3` | :ref:`get_rotation_axis_vector`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get_stiffness`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Curve` | :ref:`get_stiffness_damping_curve`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_config_individual`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_end_bone_extended`\ (\ index\: :ref:`int`\ ) |const| | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`reset`\ (\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_center_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_center_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_center_from`\ (\ index\: :ref:`int`, center_from\: :ref:`CenterFrom`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_center_node`\ (\ index\: :ref:`int`, node_path\: :ref:`NodePath`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_collision_count`\ (\ index\: :ref:`int`, count\: :ref:`int`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_collision_path`\ (\ index\: :ref:`int`, collision\: :ref:`int`, node_path\: :ref:`NodePath`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_drag`\ (\ index\: :ref:`int`, drag\: :ref:`float`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_drag_damping_curve`\ (\ index\: :ref:`int`, curve\: :ref:`Curve`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_enable_all_child_collisions`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_end_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_end_bone_direction`\ (\ index\: :ref:`int`, bone_direction\: :ref:`BoneDirection`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_end_bone_length`\ (\ index\: :ref:`int`, length\: :ref:`float`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_end_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_exclude_collision_count`\ (\ index\: :ref:`int`, count\: :ref:`int`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_exclude_collision_path`\ (\ index\: :ref:`int`, collision\: :ref:`int`, node_path\: :ref:`NodePath`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_extend_end_bone`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_gravity`\ (\ index\: :ref:`int`, gravity\: :ref:`float`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_gravity_damping_curve`\ (\ index\: :ref:`int`, curve\: :ref:`Curve`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_gravity_direction`\ (\ index\: :ref:`int`, gravity_direction\: :ref:`Vector3`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_individual_config`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_joint_drag`\ (\ index\: :ref:`int`, joint\: :ref:`int`, drag\: :ref:`float`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_joint_gravity`\ (\ index\: :ref:`int`, joint\: :ref:`int`, gravity\: :ref:`float`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_joint_gravity_direction`\ (\ index\: :ref:`int`, joint\: :ref:`int`, gravity_direction\: :ref:`Vector3`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_joint_radius`\ (\ index\: :ref:`int`, joint\: :ref:`int`, radius\: :ref:`float`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_joint_rotation_axis`\ (\ index\: :ref:`int`, joint\: :ref:`int`, axis\: :ref:`RotationAxis`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_joint_rotation_axis_vector`\ (\ index\: :ref:`int`, joint\: :ref:`int`, vector\: :ref:`Vector3`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_joint_stiffness`\ (\ index\: :ref:`int`, joint\: :ref:`int`, stiffness\: :ref:`float`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_radius`\ (\ index\: :ref:`int`, radius\: :ref:`float`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_radius_damping_curve`\ (\ index\: :ref:`int`, curve\: :ref:`Curve`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_root_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_root_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_rotation_axis`\ (\ index\: :ref:`int`, axis\: :ref:`RotationAxis`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_rotation_axis_vector`\ (\ index\: :ref:`int`, vector\: :ref:`Vector3`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_stiffness`\ (\ index\: :ref:`int`, stiffness\: :ref:`float`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_stiffness_damping_curve`\ (\ index\: :ref:`int`, curve\: :ref:`Curve`\ ) | - +----------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`are_all_child_collisions_enabled`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear_collisions`\ (\ index\: :ref:`int`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear_exclude_collisions`\ (\ index\: :ref:`int`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear_settings`\ (\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_center_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_center_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`CenterFrom` | :ref:`get_center_from`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`NodePath` | :ref:`get_center_node`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_collision_count`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`NodePath` | :ref:`get_collision_path`\ (\ index\: :ref:`int`, collision\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_drag`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`get_drag_damping_curve`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_end_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`BoneDirection` | :ref:`get_end_bone_direction`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_end_bone_length`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_end_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_exclude_collision_count`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`NodePath` | :ref:`get_exclude_collision_path`\ (\ index\: :ref:`int`, collision\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_gravity`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`get_gravity_damping_curve`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Vector3` | :ref:`get_gravity_direction`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_joint_bone`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_joint_bone_name`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_joint_count`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_joint_drag`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_joint_gravity`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Vector3` | :ref:`get_joint_gravity_direction`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_joint_radius`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`RotationAxis` | :ref:`get_joint_rotation_axis`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Vector3` | :ref:`get_joint_rotation_axis_vector`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_joint_stiffness`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_radius`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`get_radius_damping_curve`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_root_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_root_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`RotationAxis` | :ref:`get_rotation_axis`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Vector3` | :ref:`get_rotation_axis_vector`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_stiffness`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`get_stiffness_damping_curve`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_config_individual`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_end_bone_extended`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`reset`\ (\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_center_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_center_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_center_from`\ (\ index\: :ref:`int`, center_from\: :ref:`CenterFrom`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_center_node`\ (\ index\: :ref:`int`, node_path\: :ref:`NodePath`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_collision_count`\ (\ index\: :ref:`int`, count\: :ref:`int`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_collision_path`\ (\ index\: :ref:`int`, collision\: :ref:`int`, node_path\: :ref:`NodePath`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_drag`\ (\ index\: :ref:`int`, drag\: :ref:`float`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_drag_damping_curve`\ (\ index\: :ref:`int`, curve\: :ref:`Curve`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_enable_all_child_collisions`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_direction`\ (\ index\: :ref:`int`, bone_direction\: :ref:`BoneDirection`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_length`\ (\ index\: :ref:`int`, length\: :ref:`float`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_exclude_collision_count`\ (\ index\: :ref:`int`, count\: :ref:`int`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_exclude_collision_path`\ (\ index\: :ref:`int`, collision\: :ref:`int`, node_path\: :ref:`NodePath`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_extend_end_bone`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_gravity`\ (\ index\: :ref:`int`, gravity\: :ref:`float`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_gravity_damping_curve`\ (\ index\: :ref:`int`, curve\: :ref:`Curve`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_gravity_direction`\ (\ index\: :ref:`int`, gravity_direction\: :ref:`Vector3`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_individual_config`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_drag`\ (\ index\: :ref:`int`, joint\: :ref:`int`, drag\: :ref:`float`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_gravity`\ (\ index\: :ref:`int`, joint\: :ref:`int`, gravity\: :ref:`float`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_gravity_direction`\ (\ index\: :ref:`int`, joint\: :ref:`int`, gravity_direction\: :ref:`Vector3`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_radius`\ (\ index\: :ref:`int`, joint\: :ref:`int`, radius\: :ref:`float`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_rotation_axis`\ (\ index\: :ref:`int`, joint\: :ref:`int`, axis\: :ref:`RotationAxis`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_rotation_axis_vector`\ (\ index\: :ref:`int`, joint\: :ref:`int`, vector\: :ref:`Vector3`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_stiffness`\ (\ index\: :ref:`int`, joint\: :ref:`int`, stiffness\: :ref:`float`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_radius`\ (\ index\: :ref:`int`, radius\: :ref:`float`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_radius_damping_curve`\ (\ index\: :ref:`int`, curve\: :ref:`Curve`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_root_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_root_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_rotation_axis`\ (\ index\: :ref:`int`, axis\: :ref:`RotationAxis`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_rotation_axis_vector`\ (\ index\: :ref:`int`, vector\: :ref:`Vector3`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_stiffness`\ (\ index\: :ref:`int`, stiffness\: :ref:`float`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_stiffness_damping_curve`\ (\ index\: :ref:`int`, curve\: :ref:`Curve`\ ) | + +-------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -215,72 +217,6 @@ Métodos Enumeraciones -------------------------- -.. _enum_SpringBoneSimulator3D_BoneDirection: - -.. rst-class:: classref-enumeration - -enum **BoneDirection**: :ref:`🔗` - -.. _class_SpringBoneSimulator3D_constant_BONE_DIRECTION_PLUS_X: - -.. rst-class:: classref-enumeration-constant - -:ref:`BoneDirection` **BONE_DIRECTION_PLUS_X** = ``0`` - -Valor enumerado para el eje +X. - -.. _class_SpringBoneSimulator3D_constant_BONE_DIRECTION_MINUS_X: - -.. rst-class:: classref-enumeration-constant - -:ref:`BoneDirection` **BONE_DIRECTION_MINUS_X** = ``1`` - -Valor enumerado para el eje -X. - -.. _class_SpringBoneSimulator3D_constant_BONE_DIRECTION_PLUS_Y: - -.. rst-class:: classref-enumeration-constant - -:ref:`BoneDirection` **BONE_DIRECTION_PLUS_Y** = ``2`` - -Valor enumerado para el eje +Y. - -.. _class_SpringBoneSimulator3D_constant_BONE_DIRECTION_MINUS_Y: - -.. rst-class:: classref-enumeration-constant - -:ref:`BoneDirection` **BONE_DIRECTION_MINUS_Y** = ``3`` - -Valor enumerado para el eje -Y. - -.. _class_SpringBoneSimulator3D_constant_BONE_DIRECTION_PLUS_Z: - -.. rst-class:: classref-enumeration-constant - -:ref:`BoneDirection` **BONE_DIRECTION_PLUS_Z** = ``4`` - -Valor enumerado para el eje +Z. - -.. _class_SpringBoneSimulator3D_constant_BONE_DIRECTION_MINUS_Z: - -.. rst-class:: classref-enumeration-constant - -:ref:`BoneDirection` **BONE_DIRECTION_MINUS_Z** = ``5`` - -Valor enumerado para el eje -Z. - -.. _class_SpringBoneSimulator3D_constant_BONE_DIRECTION_FROM_PARENT: - -.. rst-class:: classref-enumeration-constant - -:ref:`BoneDirection` **BONE_DIRECTION_FROM_PARENT** = ``6`` - -Valor enumerado para el eje desde un hueso padre hasta el hueso hijo. - -.. rst-class:: classref-item-separator - ----- - .. _enum_SpringBoneSimulator3D_CenterFrom: .. rst-class:: classref-enumeration @@ -315,56 +251,6 @@ El origen de la pose del hueso del :ref:`Skeleton3D` padre esp Si no se encuentra :ref:`Node3D`, el :ref:`Skeleton3D` padre se trata como centro. -.. rst-class:: classref-item-separator - ----- - -.. _enum_SpringBoneSimulator3D_RotationAxis: - -.. rst-class:: classref-enumeration - -enum **RotationAxis**: :ref:`🔗` - -.. _class_SpringBoneSimulator3D_constant_ROTATION_AXIS_X: - -.. rst-class:: classref-enumeration-constant - -:ref:`RotationAxis` **ROTATION_AXIS_X** = ``0`` - -Valor enumerado para la rotación del eje X. - -.. _class_SpringBoneSimulator3D_constant_ROTATION_AXIS_Y: - -.. rst-class:: classref-enumeration-constant - -:ref:`RotationAxis` **ROTATION_AXIS_Y** = ``1`` - -Valor enumerado para la rotación del eje Y. - -.. _class_SpringBoneSimulator3D_constant_ROTATION_AXIS_Z: - -.. rst-class:: classref-enumeration-constant - -:ref:`RotationAxis` **ROTATION_AXIS_Z** = ``2`` - -Valor enumerado para la rotación del eje Z. - -.. _class_SpringBoneSimulator3D_constant_ROTATION_AXIS_ALL: - -.. rst-class:: classref-enumeration-constant - -:ref:`RotationAxis` **ROTATION_AXIS_ALL** = ``3`` - -Valor enumerado para la rotación sin restricciones. - -.. _class_SpringBoneSimulator3D_constant_ROTATION_AXIS_CUSTOM: - -.. rst-class:: classref-enumeration-constant - -:ref:`RotationAxis` **ROTATION_AXIS_CUSTOM** = ``4`` - -Valor enumerado para un eje de rotación opcional. Véase también :ref:`set_joint_rotation_axis_vector()`. - .. rst-class:: classref-section-separator ---- @@ -393,6 +279,25 @@ Esto es útil para efectos como el viento y la antigravedad. ---- +.. _class_SpringBoneSimulator3D_property_mutable_bone_axes: + +.. rst-class:: classref-property + +:ref:`bool` **mutable_bone_axes** = ``true`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_mutable_bone_axes**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **are_bone_axes_mutable**\ (\ ) + +If ``true``, the solver retrieves the bone axis from the bone pose every frame. + +If ``false``, the solver retrieves the bone axis from the bone rest and caches it, which increases performance slightly, but position changes in the bone pose made before processing this **SpringBoneSimulator3D** are ignored. + +.. rst-class:: classref-item-separator + +---- + .. _class_SpringBoneSimulator3D_property_setting_count: .. rst-class:: classref-property @@ -575,9 +480,9 @@ Devuelve el índice del hueso final de la cadena de huesos. .. rst-class:: classref-method -:ref:`BoneDirection` **get_end_bone_direction**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` +:ref:`BoneDirection` **get_end_bone_direction**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve la dirección de la cola del hueso final de la cadena de huesos cuando :ref:`is_end_bone_extended()` es ``true``. +Returns the tail direction of the end bone of the bone chain when :ref:`is_end_bone_extended()` is ``true``. .. rst-class:: classref-item-separator @@ -589,7 +494,7 @@ Devuelve la dirección de la cola del hueso final de la cadena de huesos cuando :ref:`float` **get_end_bone_length**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve la longitud de la cola del hueso final de la cadena de huesos cuando :ref:`is_end_bone_extended()` es ``true``. +Returns the end bone tail length of the bone chain when :ref:`is_end_bone_extended()` is ``true``. .. rst-class:: classref-item-separator @@ -755,7 +660,7 @@ Devuelve el radio en ``joint`` en la lista de articulaciones de la cadena de hue .. rst-class:: classref-method -:ref:`RotationAxis` **get_joint_rotation_axis**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` +:ref:`RotationAxis` **get_joint_rotation_axis**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` Devuelve el eje de rotación en ``joint`` en la lista de articulaciones de la cadena de huesos. @@ -769,9 +674,9 @@ Devuelve el eje de rotación en ``joint`` en la lista de articulaciones de la ca :ref:`Vector3` **get_joint_rotation_axis_vector**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve el vector del eje de rotación para la articulación especificada en la cadena de huesos. Este vector representa el eje alrededor del cual la articulación puede rotar. Se determina en función del eje de rotación establecido para la articulación. +Returns the rotation axis vector for the specified joint in the bone chain. This vector represents the axis around which the joint can rotate. It is determined based on the rotation axis set for the joint. -Si :ref:`get_joint_rotation_axis()` es :ref:`ROTATION_AXIS_ALL`, este método devuelve ``Vector3(0, 0, 0)``. +If :ref:`get_joint_rotation_axis()` is :ref:`SkeletonModifier3D.ROTATION_AXIS_ALL`, this method returns ``Vector3(0, 0, 0)``. .. rst-class:: classref-item-separator @@ -841,7 +746,7 @@ Devuelve el nombre del hueso raíz de la cadena de huesos. .. rst-class:: classref-method -:ref:`RotationAxis` **get_rotation_axis**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` +:ref:`RotationAxis` **get_rotation_axis**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` Devuelve el eje de rotación de la cadena de huesos. @@ -855,9 +760,9 @@ Devuelve el eje de rotación de la cadena de huesos. :ref:`Vector3` **get_rotation_axis_vector**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve el vector del eje de rotación de la cadena de huesos. Este vector representa el eje alrededor del cual la cadena de huesos puede rotar. Se determina en función del eje de rotación establecido para la cadena de huesos. +Returns the rotation axis vector of the bone chain. This vector represents the axis around which the bone chain can rotate. It is determined based on the rotation axis set for the bone chain. -Si :ref:`get_rotation_axis()` es :ref:`ROTATION_AXIS_ALL`, este método devuelve ``Vector3(0, 0, 0)``. +If :ref:`get_rotation_axis()` is :ref:`SkeletonModifier3D.ROTATION_AXIS_ALL`, this method returns ``Vector3(0, 0, 0)``. .. rst-class:: classref-item-separator @@ -905,7 +810,7 @@ Devuelve ``true`` si la configuración puede ser editada individualmente para ca :ref:`bool` **is_end_bone_extended**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Devuelve ``true`` si el hueso final se extiende para tener la cola. +Returns ``true`` if the end bone is extended to have a tail. .. rst-class:: classref-item-separator @@ -1059,7 +964,7 @@ Establece el índice del hueso final de la cadena de huesos. .. rst-class:: classref-method -|void| **set_end_bone_direction**\ (\ index\: :ref:`int`, bone_direction\: :ref:`BoneDirection`\ ) :ref:`🔗` +|void| **set_end_bone_direction**\ (\ index\: :ref:`int`, bone_direction\: :ref:`BoneDirection`\ ) :ref:`🔗` Establece la dirección de la cola del hueso final de la cadena de huesos cuando :ref:`is_end_bone_extended()` es ``true``. @@ -1123,11 +1028,9 @@ Establece la ruta del nodo del :ref:`SpringBoneCollision3D`, enabled\: :ref:`bool`\ ) :ref:`🔗` -Si ``enabled`` es ``true``, el hueso final se extiende para tener la cola. +If ``enabled`` is ``true``, the end bone is extended to have a tail. -La configuración de la cola extendida se asigna al último elemento de la lista de articulaciones. - -En otras palabras, si estableces ``enabled`` como ``false``, la configuración del último elemento de la lista de articulaciones no tiene ningún efecto en el resultado simulado. +The extended tail config is allocated to the last element in the joint list. In other words, if you set ``enabled`` to ``false``, the config of the last element in the joint list has no effect in the simulated result. .. rst-class:: classref-item-separator @@ -1239,13 +1142,13 @@ Establece el radio de la articulación en ``joint`` en la lista de articulacione .. rst-class:: classref-method -|void| **set_joint_rotation_axis**\ (\ index\: :ref:`int`, joint\: :ref:`int`, axis\: :ref:`RotationAxis`\ ) :ref:`🔗` +|void| **set_joint_rotation_axis**\ (\ index\: :ref:`int`, joint\: :ref:`int`, axis\: :ref:`RotationAxis`\ ) :ref:`🔗` -Establece el eje de rotación en ``joint`` en la lista de articulaciones de la cadena de huesos cuando :ref:`is_config_individual()` es ``true``. +Sets the rotation axis at ``joint`` in the bone chain's joint list when :ref:`is_config_individual()` is ``true``. -Los ejes se basan en el espacio de :ref:`Skeleton3D.get_bone_rest()`, si ``axis`` es :ref:`ROTATION_AXIS_CUSTOM`, puedes especificar cualquier eje. +The axes are based on the :ref:`Skeleton3D.get_bone_rest()`'s space, if ``axis`` is :ref:`SkeletonModifier3D.ROTATION_AXIS_CUSTOM`, you can specify any axis. -\ **Nota:** El eje de rotación y el vector frontal no deben ser colineales para evitar una rotación no intencionada, ya que **SpringBoneSimulator3D** no tiene en cuenta las fuerzas de torsión. +\ **Note:** The rotation axis and the forward vector shouldn't be colinear to avoid unintended rotation since **SpringBoneSimulator3D** does not factor in twisting forces. .. rst-class:: classref-item-separator @@ -1257,11 +1160,11 @@ Los ejes se basan en el espacio de :ref:`Skeleton3D.get_bone_rest()`, joint\: :ref:`int`, vector\: :ref:`Vector3`\ ) :ref:`🔗` -Establece el vector del eje de rotación para la articulación especificada en la cadena de huesos. +Sets the rotation axis vector for the specified joint in the bone chain. -Este vector se normaliza mediante un proceso interno y representa el eje alrededor del cual puede rotar la cadena de huesos. +This vector is normalized by an internal process and represents the axis around which the bone chain can rotate. -Si la longitud del vector es ``0``, se considera sinónimo de :ref:`ROTATION_AXIS_ALL`. +If the vector length is ``0``, it is considered synonymous with :ref:`SkeletonModifier3D.ROTATION_AXIS_ALL`. .. rst-class:: classref-item-separator @@ -1333,13 +1236,13 @@ Establece el nombre del hueso raíz de la cadena de huesos. .. rst-class:: classref-method -|void| **set_rotation_axis**\ (\ index\: :ref:`int`, axis\: :ref:`RotationAxis`\ ) :ref:`🔗` +|void| **set_rotation_axis**\ (\ index\: :ref:`int`, axis\: :ref:`RotationAxis`\ ) :ref:`🔗` -Establece el eje de rotación de la cadena de huesos. Si se establece en un eje específico, actúa como una articulación de bisagra. El valor se guarda en caché en cada ajuste de articulación en la lista de articulaciones. +Sets the rotation axis of the bone chain. If set to a specific axis, it acts like a hinge joint. The value is cached in each joint setting in the joint list. -Los ejes se basan en el espacio de :ref:`Skeleton3D.get_bone_rest()`, si ``axis`` es :ref:`ROTATION_AXIS_CUSTOM`, puedes especificar cualquier eje. +The axes are based on the :ref:`Skeleton3D.get_bone_rest()`'s space, if ``axis`` is :ref:`SkeletonModifier3D.ROTATION_AXIS_CUSTOM`, you can specify any axis. -\ **Nota:** El vector del eje de rotación y el vector delantero no deben ser colineales para evitar una rotación no intencionada, ya que **SpringBoneSimulator3D** no tiene en cuenta las fuerzas de torsión. +\ **Note:** The rotation axis vector and the forward vector shouldn't be colinear to avoid unintended rotation since **SpringBoneSimulator3D** does not factor in twisting forces. .. rst-class:: classref-item-separator @@ -1351,11 +1254,11 @@ Los ejes se basan en el espacio de :ref:`Skeleton3D.get_bone_rest()`, vector\: :ref:`Vector3`\ ) :ref:`🔗` -Establece el vector del eje de rotación de la cadena de huesos. El valor se guarda en caché en cada ajuste de articulación en la lista de articulaciones. +Sets the rotation axis vector of the bone chain. The value is cached in each joint setting in the joint list. -Este vector se normaliza mediante un proceso interno y representa el eje alrededor del cual puede rotar la cadena de huesos. +This vector is normalized by an internal process and represents the axis around which the bone chain can rotate. -Si la longitud del vector es ``0``, se considera sinónimo de :ref:`ROTATION_AXIS_ALL`. +If the vector length is ``0``, it is considered synonymous with :ref:`SkeletonModifier3D.ROTATION_AXIS_ALL`. .. rst-class:: classref-item-separator diff --git a/classes/es/class_sprite2d.rst b/classes/es/class_sprite2d.rst index a7db5f8dc0..e56d0ee22f 100644 --- a/classes/es/class_sprite2d.rst +++ b/classes/es/class_sprite2d.rst @@ -372,9 +372,7 @@ Returns a :ref:`Rect2` representing the Sprite2D's boundary in loca :ref:`bool` **is_pixel_opaque**\ (\ pos\: :ref:`Vector2`\ ) |const| :ref:`🔗` -Devuelve ``true`` si el píxel en la posición dada es opaco y ``false`` en caso contrario. La posición está en coordenadas locales. - -\ **Nota:** También devuelve ``false`` si la textura del sprite es ``null`` o si la posición dada no es válida. +Returns ``true`` if the pixel at the given position is opaque, ``false`` otherwise. Also returns ``false`` if the given position is out of bounds or this sprite's :ref:`texture` is ``null``. ``pos`` is in local coordinates. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_streampeer.rst b/classes/es/class_streampeer.rst index 507227bef0..627f544795 100644 --- a/classes/es/class_streampeer.rst +++ b/classes/es/class_streampeer.rst @@ -7,7 +7,7 @@ StreamPeer **Hereda:** :ref:`RefCounted` **<** :ref:`Object` -**Heredado por:** :ref:`StreamPeerBuffer`, :ref:`StreamPeerExtension`, :ref:`StreamPeerGZIP`, :ref:`StreamPeerTCP`, :ref:`StreamPeerTLS` +**Heredado por:** :ref:`StreamPeerBuffer`, :ref:`StreamPeerExtension`, :ref:`StreamPeerGZIP`, :ref:`StreamPeerSocket`, :ref:`StreamPeerTLS` Clase base abstracta para interactuar con tranmisiones. @@ -205,7 +205,7 @@ Devuelve la cantidad de bytes que este **StreamPeer** tiene disponible. :ref:`Array` **get_data**\ (\ bytes\: :ref:`int`\ ) :ref:`🔗` -Devuelve un trozo de datos con los bytes recibidos. El número de bytes a recibir puede solicitarse en el argumento ``bytes``. Si no hay suficientes bytes disponibles, la función se bloqueará hasta que se reciba la cantidad deseada. Esta función devuelve dos valores, un código :ref:`Error` y un array de datos. +Returns a chunk data with the received bytes, as an :ref:`Array` containing two elements: an :ref:`Error` constant and a :ref:`PackedByteArray`. ``bytes`` is the number of bytes to be received. If not enough bytes are available, the function will block until the desired amount is received. .. rst-class:: classref-item-separator @@ -253,7 +253,7 @@ Obtiene un float de precisión media de la transmisión. :ref:`Array` **get_partial_data**\ (\ bytes\: :ref:`int`\ ) :ref:`🔗` -Devuelve un fragmento de datos con los bytes recibidos. La cantidad de bytes a recibir se puede solicitar en el argumento ``bytes``. Si no hay suficientes bytes disponibles, la función devolverá cuántos se recibieron realmente. Esta función devuelve dos valores: un código :ref:`Error` y un array de datos. +Returns a chunk data with the received bytes, as an :ref:`Array` containing two elements: an :ref:`Error` constant and a :ref:`PackedByteArray`. ``bytes`` is the number of bytes to be received. If not enough bytes are available, the function will return how many were actually received. .. rst-class:: classref-item-separator diff --git a/classes/es/class_streampeersocket.rst b/classes/es/class_streampeersocket.rst new file mode 100644 index 0000000000..aa2e4e775b --- /dev/null +++ b/classes/es/class_streampeersocket.rst @@ -0,0 +1,133 @@ +:github_url: hide + +.. _class_StreamPeerSocket: + +StreamPeerSocket +================ + +**Hereda:** :ref:`StreamPeer` **<** :ref:`RefCounted` **<** :ref:`Object` + +**Heredado por:** :ref:`StreamPeerTCP`, :ref:`StreamPeerUDS` + +Abstract base class for interacting with socket streams. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +StreamPeerSocket is an abstract base class that defines common behavior for socket-based streams. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +---------------------------------------------+---------------------------------------------------------------------------------------+ + | |void| | :ref:`disconnect_from_host`\ (\ ) | + +---------------------------------------------+---------------------------------------------------------------------------------------+ + | :ref:`Status` | :ref:`get_status`\ (\ ) |const| | + +---------------------------------------------+---------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`poll`\ (\ ) | + +---------------------------------------------+---------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Enumeraciones +-------------------------- + +.. _enum_StreamPeerSocket_Status: + +.. rst-class:: classref-enumeration + +enum **Status**: :ref:`🔗` + +.. _class_StreamPeerSocket_constant_STATUS_NONE: + +.. rst-class:: classref-enumeration-constant + +:ref:`Status` **STATUS_NONE** = ``0`` + +The initial status of the **StreamPeerSocket**. This is also the status after disconnecting. + +.. _class_StreamPeerSocket_constant_STATUS_CONNECTING: + +.. rst-class:: classref-enumeration-constant + +:ref:`Status` **STATUS_CONNECTING** = ``1`` + +A status representing a **StreamPeerSocket** that is connecting to a host. + +.. _class_StreamPeerSocket_constant_STATUS_CONNECTED: + +.. rst-class:: classref-enumeration-constant + +:ref:`Status` **STATUS_CONNECTED** = ``2`` + +A status representing a **StreamPeerSocket** that is connected to a host. + +.. _class_StreamPeerSocket_constant_STATUS_ERROR: + +.. rst-class:: classref-enumeration-constant + +:ref:`Status` **STATUS_ERROR** = ``3`` + +A status representing a **StreamPeerSocket** in error state. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_StreamPeerSocket_method_disconnect_from_host: + +.. rst-class:: classref-method + +|void| **disconnect_from_host**\ (\ ) :ref:`🔗` + +Se desconecta del host. + +.. rst-class:: classref-item-separator + +---- + +.. _class_StreamPeerSocket_method_get_status: + +.. rst-class:: classref-method + +:ref:`Status` **get_status**\ (\ ) |const| :ref:`🔗` + +Devuelve el estado de la conexión. + +.. rst-class:: classref-item-separator + +---- + +.. _class_StreamPeerSocket_method_poll: + +.. rst-class:: classref-method + +:ref:`Error` **poll**\ (\ ) :ref:`🔗` + +Polls the socket, updating its state. See :ref:`get_status()`. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_streampeertcp.rst b/classes/es/class_streampeertcp.rst index 94664c7cf9..ed0b15ba47 100644 --- a/classes/es/class_streampeertcp.rst +++ b/classes/es/class_streampeertcp.rst @@ -5,7 +5,7 @@ StreamPeerTCP ============= -**Hereda:** :ref:`StreamPeer` **<** :ref:`RefCounted` **<** :ref:`Object` +**Hereda:** :ref:`StreamPeerSocket` **<** :ref:`StreamPeer` **<** :ref:`RefCounted` **<** :ref:`Object` A stream peer that handles TCP connections. @@ -26,72 +26,19 @@ Métodos .. table:: :widths: auto - +------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Error` | :ref:`bind`\ (\ port\: :ref:`int`, host\: :ref:`String` = "*"\ ) | - +------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Error` | :ref:`connect_to_host`\ (\ host\: :ref:`String`, port\: :ref:`int`\ ) | - +------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`disconnect_from_host`\ (\ ) | - +------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_connected_host`\ (\ ) |const| | - +------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_connected_port`\ (\ ) |const| | - +------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_local_port`\ (\ ) |const| | - +------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Status` | :ref:`get_status`\ (\ ) |const| | - +------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Error` | :ref:`poll`\ (\ ) | - +------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_no_delay`\ (\ enabled\: :ref:`bool`\ ) | - +------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ - -.. rst-class:: classref-section-separator - ----- - -.. rst-class:: classref-descriptions-group - -Enumeraciones --------------------------- - -.. _enum_StreamPeerTCP_Status: - -.. rst-class:: classref-enumeration - -enum **Status**: :ref:`🔗` - -.. _class_StreamPeerTCP_constant_STATUS_NONE: - -.. rst-class:: classref-enumeration-constant - -:ref:`Status` **STATUS_NONE** = ``0`` - -El estado inicial del **StreamPeerTCP**. Este es también el estado después de la desconexión. - -.. _class_StreamPeerTCP_constant_STATUS_CONNECTING: - -.. rst-class:: classref-enumeration-constant - -:ref:`Status` **STATUS_CONNECTING** = ``1`` - -Un estado que representa un **StreamPeerTCP** que se está conectando a un host. - -.. _class_StreamPeerTCP_constant_STATUS_CONNECTED: - -.. rst-class:: classref-enumeration-constant - -:ref:`Status` **STATUS_CONNECTED** = ``2`` - -Un estado que representa un **StreamPeerTCP** que está conectado a un host. - -.. _class_StreamPeerTCP_constant_STATUS_ERROR: - -.. rst-class:: classref-enumeration-constant - -:ref:`Status` **STATUS_ERROR** = ``3`` - -Un estado que representa un **StreamPeerTCP** en estado de error. + +---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`bind`\ (\ port\: :ref:`int`, host\: :ref:`String` = "*"\ ) | + +---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`connect_to_host`\ (\ host\: :ref:`String`, port\: :ref:`int`\ ) | + +---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_connected_host`\ (\ ) |const| | + +---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_connected_port`\ (\ ) |const| | + +---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_local_port`\ (\ ) |const| | + +---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_no_delay`\ (\ enabled\: :ref:`bool`\ ) | + +---------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -128,18 +75,6 @@ Connects to the specified ``host:port`` pair. A hostname will be resolved if val ---- -.. _class_StreamPeerTCP_method_disconnect_from_host: - -.. rst-class:: classref-method - -|void| **disconnect_from_host**\ (\ ) :ref:`🔗` - -Se desconecta del host. - -.. rst-class:: classref-item-separator - ----- - .. _class_StreamPeerTCP_method_get_connected_host: .. rst-class:: classref-method @@ -176,30 +111,6 @@ Returns the local port to which this peer is bound. ---- -.. _class_StreamPeerTCP_method_get_status: - -.. rst-class:: classref-method - -:ref:`Status` **get_status**\ (\ ) |const| :ref:`🔗` - -Devuelve el estado de la conexión. - -.. rst-class:: classref-item-separator - ----- - -.. _class_StreamPeerTCP_method_poll: - -.. rst-class:: classref-method - -:ref:`Error` **poll**\ (\ ) :ref:`🔗` - -Sondea el socket, actualizando su estado. Véase :ref:`get_status()`. - -.. rst-class:: classref-item-separator - ----- - .. _class_StreamPeerTCP_method_set_no_delay: .. rst-class:: classref-method diff --git a/classes/es/class_streampeeruds.rst b/classes/es/class_streampeeruds.rst new file mode 100644 index 0000000000..bcbd9705a6 --- /dev/null +++ b/classes/es/class_streampeeruds.rst @@ -0,0 +1,88 @@ +:github_url: hide + +.. _class_StreamPeerUDS: + +StreamPeerUDS +============= + +**Hereda:** :ref:`StreamPeerSocket` **<** :ref:`StreamPeer` **<** :ref:`RefCounted` **<** :ref:`Object` + +A stream peer that handles UNIX Domain Socket (UDS) connections. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +A stream peer that handles UNIX Domain Socket (UDS) connections. This object can be used to connect to UDS servers, or also is returned by a UDS server. Unix Domain Sockets provide inter-process communication on the same machine using the filesystem namespace. + +\ **Note:** UNIX Domain Sockets are only available on UNIX-like systems (Linux, macOS, etc.) and are not supported on Windows. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +---------------------------------------+--------------------------------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`bind`\ (\ path\: :ref:`String`\ ) | + +---------------------------------------+--------------------------------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`connect_to_host`\ (\ path\: :ref:`String`\ ) | + +---------------------------------------+--------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_connected_path`\ (\ ) |const| | + +---------------------------------------+--------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_StreamPeerUDS_method_bind: + +.. rst-class:: classref-method + +:ref:`Error` **bind**\ (\ path\: :ref:`String`\ ) :ref:`🔗` + +Opens the UDS socket, and binds it to the specified socket path. + +This method is generally not needed, and only used to force the subsequent call to :ref:`connect_to_host()` to use the specified ``path`` as the source address. + +.. rst-class:: classref-item-separator + +---- + +.. _class_StreamPeerUDS_method_connect_to_host: + +.. rst-class:: classref-method + +:ref:`Error` **connect_to_host**\ (\ path\: :ref:`String`\ ) :ref:`🔗` + +Connects to the specified UNIX Domain Socket path. Returns :ref:`@GlobalScope.OK` on success. + +.. rst-class:: classref-item-separator + +---- + +.. _class_StreamPeerUDS_method_get_connected_path: + +.. rst-class:: classref-method + +:ref:`String` **get_connected_path**\ (\ ) |const| :ref:`🔗` + +Returns the socket path of this peer. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_string.rst b/classes/es/class_string.rst index 694198932a..64579480d2 100644 --- a/classes/es/class_string.rst +++ b/classes/es/class_string.rst @@ -691,6 +691,8 @@ Returns the index of the **first** occurrence of ``what`` in this string, or ``- \ **Note:** If you just want to know whether the string contains ``what``, use :ref:`contains()`. In GDScript, you may also use the ``in`` operator. +\ **Note:** A negative value of ``from`` is converted to a starting index by counting back from the last possible index with enough space to find ``what``. + .. rst-class:: classref-item-separator ---- @@ -837,13 +839,13 @@ If the string is a valid file path, returns the file name, including the extensi :ref:`String` **get_slice**\ (\ delimiter\: :ref:`String`, slice\: :ref:`int`\ ) |const| :ref:`🔗` -Divide la string usando ``delimiter`` y devuelve la substring en el índice ``slice``. Devuelve la string original si ``delimiter`` no aparece en la string. Devuelve una string vacía si ``slice`` no existe. +Splits the string using a ``delimiter`` and returns the substring at index ``slice``. Returns the original string if ``delimiter`` does not occur in the string. Returns an empty string if the ``slice`` does not exist. -Esto es más rápido que :ref:`split()`, si solo necesitas una substring. +This is faster than :ref:`split()`, if you only need one or two substrings. :: - print("i/am/example/hi".get_slice("/", 2)) # Imprime "example" + print("i/am/example/hi".get_slice("/", 2)) # Prints "example" .. rst-class:: classref-item-separator @@ -855,7 +857,14 @@ Esto es más rápido que :ref:`split()`, si solo nece :ref:`int` **get_slice_count**\ (\ delimiter\: :ref:`String`\ ) |const| :ref:`🔗` -Devuelve el número total de fragmentos cuando la string se divide con el ``delimiter`` dado (véase :ref:`split()`). +Returns the total number of slices when the string is split with the given ``delimiter`` (see :ref:`split()`). + +Use :ref:`get_slice()` to extract a specific slice. + +:: + + print("i/am/example/string".get_slice_count("/")) # Prints '4'. + print("i am example string".get_slice_count("/")) # Prints '1'. .. rst-class:: classref-item-separator @@ -867,9 +876,11 @@ Devuelve el número total de fragmentos cuando la string se divide con el ``deli :ref:`String` **get_slicec**\ (\ delimiter\: :ref:`int`, slice\: :ref:`int`\ ) |const| :ref:`🔗` -Divide la string usando un carácter Unicode con código ``delimiter`` y devuelve la substring en el índice ``slice``. Devuelve una string vacía si ``slice`` no existe. +Splits the string using a Unicode character with code ``delimiter`` and returns the substring at index ``slice``. Returns an empty string if the ``slice`` does not exist. -Esto es más rápido que :ref:`split()` si solo necesitas una substring. +This is faster than :ref:`split()`, if you only need one or two substrings. + +This is a Unicode version of :ref:`get_slice()`. .. rst-class:: classref-item-separator @@ -1572,7 +1583,7 @@ Elimina todas las ocurrencias del carácter Unicode con el código ``what``. Ver :ref:`String` **remove_chars**\ (\ chars\: :ref:`String`\ ) |const| :ref:`🔗` -Elimina cualquier ocurrencia de los caracteres en ``chars``. Véase también :ref:`remove_char()`. +Removes all occurrences of the characters in ``chars``. See also :ref:`remove_char()`. .. rst-class:: classref-item-separator @@ -1656,7 +1667,11 @@ Devuelve la copia de esta string en orden inverso. Esta operación funciona en p :ref:`int` **rfind**\ (\ what\: :ref:`String`, from\: :ref:`int` = -1\ ) |const| :ref:`🔗` -Devuelve el índice de la **última** ocurrencia de ``what`` en esta string, o ``-1`` si no hay ninguna. El inicio de la búsqueda se puede especificar con ``from``, continuando hasta el principio de la string. Este método es el inverso de :ref:`find()`. +Returns the index of the **last** occurrence of ``what`` in this string, or ``-1`` if there are none. The search's start can be specified with ``from``, continuing to the beginning of the string. This method is the reverse of :ref:`find()`. + +\ **Note:** A negative value of ``from`` is converted to a starting index by counting back from the last possible index with enough space to find ``what``. + +\ **Note:** A value of ``from`` that is greater than the last possible index with enough space to find ``what`` is considered out-of-bounds, and returns ``-1``. .. rst-class:: classref-item-separator diff --git a/classes/es/class_stringname.rst b/classes/es/class_stringname.rst index 580c226975..845b6caa24 100644 --- a/classes/es/class_stringname.rst +++ b/classes/es/class_stringname.rst @@ -643,6 +643,8 @@ Returns the index of the **first** occurrence of ``what`` in this string, or ``- \ **Note:** If you just want to know whether the string contains ``what``, use :ref:`contains()`. In GDScript, you may also use the ``in`` operator. +\ **Note:** A negative value of ``from`` is converted to a starting index by counting back from the last possible index with enough space to find ``what``. + .. rst-class:: classref-item-separator ---- @@ -1415,7 +1417,7 @@ Elimina todas las ocurrencias del carácter Unicode con el código ``what``. Ver :ref:`String` **remove_chars**\ (\ chars\: :ref:`String`\ ) |const| :ref:`🔗` -Elimina cualquier ocurrencia de los caracteres en ``chars``. Véase también :ref:`remove_char()`. +Removes all occurrences of the characters in ``chars``. See also :ref:`remove_char()`. .. rst-class:: classref-item-separator @@ -1499,7 +1501,11 @@ Devuelve la copia de esta string en orden inverso. Esta operación funciona en p :ref:`int` **rfind**\ (\ what\: :ref:`String`, from\: :ref:`int` = -1\ ) |const| :ref:`🔗` -Devuelve el índice de la **última** ocurrencia de ``what`` en esta string, o ``-1`` si no hay ninguna. El inicio de la búsqueda se puede especificar con ``from``, continuando hasta el principio de la string. Este método es el inverso de :ref:`find()`. +Returns the index of the **last** occurrence of ``what`` in this string, or ``-1`` if there are none. The search's start can be specified with ``from``, continuing to the beginning of the string. This method is the reverse of :ref:`find()`. + +\ **Note:** A negative value of ``from`` is converted to a starting index by counting back from the last possible index with enough space to find ``what``. + +\ **Note:** A value of ``from`` that is greater than the last possible index with enough space to find ``what`` is considered out-of-bounds, and returns ``-1``. .. rst-class:: classref-item-separator diff --git a/classes/es/class_surfacetool.rst b/classes/es/class_surfacetool.rst index 5e30ad95e2..891e2866bc 100644 --- a/classes/es/class_surfacetool.rst +++ b/classes/es/class_surfacetool.rst @@ -634,7 +634,9 @@ Especifica el grupo suavizado a usar para el *siguiente* vértice. Si nunca se l |void| **set_tangent**\ (\ tangent\: :ref:`Plane`\ ) :ref:`🔗` -Especifica una tangente para usar para el *siguiente* vértice. Si cada vértice necesita tener esta información establecida y no la envías para el primer vértice, es posible que esta información no se utilice en absoluto. +Specifies a tangent to use for the *next* vertex. If every vertex needs to have this information set and you fail to submit it for the first vertex, this information may not be used at all. + +\ **Note:** Even though ``tangent`` is a :ref:`Plane`, it does not directly represent the tangent plane. Its :ref:`Plane.x`, :ref:`Plane.y`, and :ref:`Plane.z` represent the tangent vector and :ref:`Plane.d` should be either ``-1`` or ``1``. See also :ref:`Mesh.ARRAY_TANGENT`. .. rst-class:: classref-item-separator diff --git a/classes/es/class_tabbar.rst b/classes/es/class_tabbar.rst index ba99a5e9bc..97fdca4ca5 100644 --- a/classes/es/class_tabbar.rst +++ b/classes/es/class_tabbar.rst @@ -45,6 +45,8 @@ Propiedades +-----------------------------------------------------------------------+-----------------------------------------------------------------------------------+---------------------------------------------------------------------+ | :ref:`bool` | :ref:`select_with_rmb` | ``false`` | +-----------------------------------------------------------------------+-----------------------------------------------------------------------------------+---------------------------------------------------------------------+ + | :ref:`bool` | :ref:`switch_on_drag_hover` | ``true`` | + +-----------------------------------------------------------------------+-----------------------------------------------------------------------------------+---------------------------------------------------------------------+ | :ref:`AlignmentMode` | :ref:`tab_alignment` | ``0`` | +-----------------------------------------------------------------------+-----------------------------------------------------------------------------------+---------------------------------------------------------------------+ | :ref:`CloseButtonDisplayPolicy` | :ref:`tab_close_display_policy` | ``0`` | @@ -136,57 +138,67 @@ Propiedades del Tema .. table:: :widths: auto - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`Color` | :ref:`drop_mark_color` | ``Color(1, 1, 1, 1)`` | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`Color` | :ref:`font_disabled_color` | ``Color(0.875, 0.875, 0.875, 0.5)`` | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`Color` | :ref:`font_hovered_color` | ``Color(0.95, 0.95, 0.95, 1)`` | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`Color` | :ref:`font_outline_color` | ``Color(0, 0, 0, 1)`` | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`Color` | :ref:`font_selected_color` | ``Color(0.95, 0.95, 0.95, 1)`` | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`Color` | :ref:`font_unselected_color` | ``Color(0.7, 0.7, 0.7, 1)`` | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`int` | :ref:`h_separation` | ``4`` | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`int` | :ref:`icon_max_width` | ``0`` | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`int` | :ref:`outline_size` | ``0`` | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`int` | :ref:`tab_separation` | ``0`` | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`Font` | :ref:`font` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`int` | :ref:`font_size` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`Texture2D` | :ref:`close` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`Texture2D` | :ref:`decrement` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`Texture2D` | :ref:`decrement_highlight` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`Texture2D` | :ref:`drop_mark` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`Texture2D` | :ref:`increment` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`Texture2D` | :ref:`increment_highlight` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`StyleBox` | :ref:`button_highlight` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`StyleBox` | :ref:`button_pressed` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`StyleBox` | :ref:`tab_disabled` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`StyleBox` | :ref:`tab_focus` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`StyleBox` | :ref:`tab_hovered` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`StyleBox` | :ref:`tab_selected` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ - | :ref:`StyleBox` | :ref:`tab_unselected` | | - +-----------------------------------+------------------------------------------------------------------------------+-------------------------------------+ + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Color` | :ref:`drop_mark_color` | ``Color(1, 1, 1, 1)`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Color` | :ref:`font_disabled_color` | ``Color(0.875, 0.875, 0.875, 0.5)`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Color` | :ref:`font_hovered_color` | ``Color(0.95, 0.95, 0.95, 1)`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Color` | :ref:`font_outline_color` | ``Color(0, 0, 0, 1)`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Color` | :ref:`font_selected_color` | ``Color(0.95, 0.95, 0.95, 1)`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Color` | :ref:`font_unselected_color` | ``Color(0.7, 0.7, 0.7, 1)`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Color` | :ref:`icon_disabled_color` | ``Color(1, 1, 1, 1)`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Color` | :ref:`icon_hovered_color` | ``Color(1, 1, 1, 1)`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Color` | :ref:`icon_selected_color` | ``Color(1, 1, 1, 1)`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Color` | :ref:`icon_unselected_color` | ``Color(1, 1, 1, 1)`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`int` | :ref:`h_separation` | ``4`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`int` | :ref:`hover_switch_wait_msec` | ``500`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`int` | :ref:`icon_max_width` | ``0`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`int` | :ref:`outline_size` | ``0`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`int` | :ref:`tab_separation` | ``0`` | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Font` | :ref:`font` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`int` | :ref:`font_size` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Texture2D` | :ref:`close` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Texture2D` | :ref:`decrement` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Texture2D` | :ref:`decrement_highlight` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Texture2D` | :ref:`drop_mark` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Texture2D` | :ref:`increment` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Texture2D` | :ref:`increment_highlight` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`StyleBox` | :ref:`button_highlight` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`StyleBox` | :ref:`button_pressed` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`StyleBox` | :ref:`tab_disabled` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`StyleBox` | :ref:`tab_focus` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`StyleBox` | :ref:`tab_hovered` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`StyleBox` | :ref:`tab_selected` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`StyleBox` | :ref:`tab_unselected` | | + +-----------------------------------+-----------------------------------------------------------------------------------+-------------------------------------+ .. rst-class:: classref-section-separator @@ -251,9 +263,9 @@ Emitida cuando se hace clic con el botón derecho del ratón en una pestaña. **tab_close_pressed**\ (\ tab\: :ref:`int`\ ) :ref:`🔗` -Emitted when a tab's close button is pressed or when middle-clicking on a tab, if :ref:`close_with_middle_mouse` is enabled. +Emitted when a tab's close button is pressed or, if :ref:`close_with_middle_mouse` is ``true``, when middle-clicking on a tab. -\ **Note:** Tabs are not removed automatically once the close button is pressed, this behavior needs to be programmed manually. For example: +\ **Note:** Tabs are not removed automatically; this behavior needs to be coded manually. For example: .. tabs:: @@ -290,7 +302,7 @@ Emitida cuando una pestaña tiene encima el cursor del ratón. **tab_rmb_clicked**\ (\ tab\: :ref:`int`\ ) :ref:`🔗` -Emitted when a tab is right-clicked. :ref:`select_with_rmb` must be enabled. +Emitted when a tab is right-clicked. .. rst-class:: classref-item-separator @@ -325,7 +337,7 @@ enum **AlignmentMode**: :ref:`🔗` :ref:`AlignmentMode` **ALIGNMENT_LEFT** = ``0`` -Coloca las pestañas a la izquierda. +Aligns tabs to the left. .. _class_TabBar_constant_ALIGNMENT_CENTER: @@ -333,7 +345,7 @@ Coloca las pestañas a la izquierda. :ref:`AlignmentMode` **ALIGNMENT_CENTER** = ``1`` -Coloca las pestañas en el medio. +Aligns tabs in the middle. .. _class_TabBar_constant_ALIGNMENT_RIGHT: @@ -341,7 +353,7 @@ Coloca las pestañas en el medio. :ref:`AlignmentMode` **ALIGNMENT_RIGHT** = ``2`` -Coloca las pestañas a la derecha. +Aligns tabs to the right. .. _class_TabBar_constant_ALIGNMENT_MAX: @@ -430,7 +442,7 @@ Si es ``true``, las pestañas que se desborden del ancho de este nodo se ocultar - |void| **set_close_with_middle_mouse**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **get_close_with_middle_mouse**\ (\ ) -If ``true``, middle clicking on the mouse will fire the :ref:`tab_close_pressed` signal. +If ``true``, middle-clicking on a tab will emit the :ref:`tab_close_pressed` signal. .. rst-class:: classref-item-separator @@ -555,6 +567,23 @@ Si es ``true``, permite seleccionar una pestaña con el botón derecho del rató ---- +.. _class_TabBar_property_switch_on_drag_hover: + +.. rst-class:: classref-property + +:ref:`bool` **switch_on_drag_hover** = ``true`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_switch_on_drag_hover**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **get_switch_on_drag_hover**\ (\ ) + +If ``true``, hovering over a tab while dragging something will switch to that tab. Does not have effect when hovering another tab to rearrange. The delay for when this happens is dictated by :ref:`hover_switch_wait_msec`. + +.. rst-class:: classref-item-separator + +---- + .. _class_TabBar_property_tab_alignment: .. rst-class:: classref-property @@ -566,7 +595,7 @@ Si es ``true``, permite seleccionar una pestaña con el botón derecho del rató - |void| **set_tab_alignment**\ (\ value\: :ref:`AlignmentMode`\ ) - :ref:`AlignmentMode` **get_tab_alignment**\ (\ ) -La posición en la que se colocarán las pestañas. +The horizontal alignment of the tabs. .. rst-class:: classref-item-separator @@ -960,7 +989,7 @@ Establece el ancho máximo permitido del icono para la pestaña en el índice `` |void| **set_tab_language**\ (\ tab_idx\: :ref:`int`, language\: :ref:`String`\ ) :ref:`🔗` -Establece el código de idioma del título de la pestaña utilizado para los algoritmos de ajuste de línea y forma del texto, si se deja vacío se utiliza la configuración regional actual. +Sets the language code of the title for the tab at index ``tab_idx`` to ``language``. This is used for line-breaking and text shaping algorithms. If ``language`` is empty, the current locale is used. .. rst-class:: classref-item-separator @@ -1093,6 +1122,54 @@ Color de la fuente de las otras pestañas no seleccionadas. ---- +.. _class_TabBar_theme_color_icon_disabled_color: + +.. rst-class:: classref-themeproperty + +:ref:`Color` **icon_disabled_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` + +Icon color of disabled tabs. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TabBar_theme_color_icon_hovered_color: + +.. rst-class:: classref-themeproperty + +:ref:`Color` **icon_hovered_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` + +Icon color of the currently hovered tab. Does not apply to the selected tab. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TabBar_theme_color_icon_selected_color: + +.. rst-class:: classref-themeproperty + +:ref:`Color` **icon_selected_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` + +Icon color of the currently selected tab. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TabBar_theme_color_icon_unselected_color: + +.. rst-class:: classref-themeproperty + +:ref:`Color` **icon_unselected_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` + +Icon color of the other, unselected tabs. + +.. rst-class:: classref-item-separator + +---- + .. _class_TabBar_theme_constant_h_separation: .. rst-class:: classref-themeproperty @@ -1105,6 +1182,18 @@ La separación horizontal entre los elementos dentro de las pestañas. ---- +.. _class_TabBar_theme_constant_hover_switch_wait_msec: + +.. rst-class:: classref-themeproperty + +:ref:`int` **hover_switch_wait_msec** = ``500`` :ref:`🔗` + +During a drag-and-drop, this is how many milliseconds to wait before switching the tab. + +.. rst-class:: classref-item-separator + +---- + .. _class_TabBar_theme_constant_icon_max_width: .. rst-class:: classref-themeproperty diff --git a/classes/es/class_tabcontainer.rst b/classes/es/class_tabcontainer.rst index 69f427e72d..2f85c513a9 100644 --- a/classes/es/class_tabcontainer.rst +++ b/classes/es/class_tabcontainer.rst @@ -44,6 +44,8 @@ Propiedades +---------------------------------------------------+-----------------------------------------------------------------------------------------------+-----------+ | :ref:`bool` | :ref:`drag_to_rearrange_enabled` | ``false`` | +---------------------------------------------------+-----------------------------------------------------------------------------------------------+-----------+ + | :ref:`bool` | :ref:`switch_on_drag_hover` | ``true`` | + +---------------------------------------------------+-----------------------------------------------------------------------------------------------+-----------+ | :ref:`AlignmentMode` | :ref:`tab_alignment` | ``0`` | +---------------------------------------------------+-----------------------------------------------------------------------------------------------+-----------+ | :ref:`FocusMode` | :ref:`tab_focus_mode` | ``2`` | @@ -142,6 +144,14 @@ Propiedades del Tema +-----------------------------------+------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_unselected_color` | ``Color(0.7, 0.7, 0.7, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Color` | :ref:`icon_disabled_color` | ``Color(1, 1, 1, 1)`` | + +-----------------------------------+------------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Color` | :ref:`icon_hovered_color` | ``Color(1, 1, 1, 1)`` | + +-----------------------------------+------------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Color` | :ref:`icon_selected_color` | ``Color(1, 1, 1, 1)`` | + +-----------------------------------+------------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Color` | :ref:`icon_unselected_color` | ``Color(1, 1, 1, 1)`` | + +-----------------------------------+------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`icon_max_width` | ``0`` | +-----------------------------------+------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`icon_separation` | ``4`` | @@ -411,6 +421,23 @@ Si es ``true``, las pestañas se pueden reorganizar con el arrastre del ratón. ---- +.. _class_TabContainer_property_switch_on_drag_hover: + +.. rst-class:: classref-property + +:ref:`bool` **switch_on_drag_hover** = ``true`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_switch_on_drag_hover**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **get_switch_on_drag_hover**\ (\ ) + +If ``true``, hovering over a tab while dragging something will switch to that tab. Does not have effect when hovering another tab to rearrange. + +.. rst-class:: classref-item-separator + +---- + .. _class_TabContainer_property_tab_alignment: .. rst-class:: classref-property @@ -456,7 +483,7 @@ The focus access mode for the internal :ref:`TabBar` node. - |void| **set_tabs_position**\ (\ value\: :ref:`TabPosition`\ ) - :ref:`TabPosition` **get_tabs_position**\ (\ ) -La posición de la barra de pestañas. +The horizontal alignment of the tabs. .. rst-class:: classref-item-separator @@ -885,7 +912,7 @@ El color de la fuente de las pestañas desactivadas. :ref:`Color` **font_hovered_color** = ``Color(0.95, 0.95, 0.95, 1)`` :ref:`🔗` -Font color of the currently hovered tab. +Color de la fuente de la pestaña sobre la que está el cursor. No se aplica a la pestaña seleccionada. .. rst-class:: classref-item-separator @@ -927,6 +954,54 @@ Color de la fuente de las otras pestañas no seleccionadas. ---- +.. _class_TabContainer_theme_color_icon_disabled_color: + +.. rst-class:: classref-themeproperty + +:ref:`Color` **icon_disabled_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` + +Icon color of disabled tabs. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TabContainer_theme_color_icon_hovered_color: + +.. rst-class:: classref-themeproperty + +:ref:`Color` **icon_hovered_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` + +Icon color of the currently hovered tab. Does not apply to the selected tab. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TabContainer_theme_color_icon_selected_color: + +.. rst-class:: classref-themeproperty + +:ref:`Color` **icon_selected_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` + +Icon color of the currently selected tab. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TabContainer_theme_color_icon_unselected_color: + +.. rst-class:: classref-themeproperty + +:ref:`Color` **icon_unselected_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` + +Icon color of the other, unselected tabs. + +.. rst-class:: classref-item-separator + +---- + .. _class_TabContainer_theme_constant_icon_max_width: .. rst-class:: classref-themeproperty diff --git a/classes/es/class_tcpserver.rst b/classes/es/class_tcpserver.rst index 56f050444f..689341857f 100644 --- a/classes/es/class_tcpserver.rst +++ b/classes/es/class_tcpserver.rst @@ -5,7 +5,7 @@ TCPServer ========= -**Hereda:** :ref:`RefCounted` **<** :ref:`Object` +**Hereda:** :ref:`SocketServer` **<** :ref:`RefCounted` **<** :ref:`Object` Un servidor TCP. @@ -29,14 +29,8 @@ Métodos +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_local_port`\ (\ ) |const| | +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_connection_available`\ (\ ) |const| | - +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_listening`\ (\ ) |const| | - +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Error` | :ref:`listen`\ (\ port\: :ref:`int`, bind_address\: :ref:`String` = "*"\ ) | +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`stop`\ (\ ) | - +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`StreamPeerTCP` | :ref:`take_connection`\ (\ ) | +-------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+ @@ -61,30 +55,6 @@ Devuelve el puerto local que este servidor está escuchando. ---- -.. _class_TCPServer_method_is_connection_available: - -.. rst-class:: classref-method - -:ref:`bool` **is_connection_available**\ (\ ) |const| :ref:`🔗` - -Devuelve ``true`` si hay una conexión disponible para tomar. - -.. rst-class:: classref-item-separator - ----- - -.. _class_TCPServer_method_is_listening: - -.. rst-class:: classref-method - -:ref:`bool` **is_listening**\ (\ ) |const| :ref:`🔗` - -Devuelve ``true`` si el servidor está actualmente a la escucha de las conexiones. - -.. rst-class:: classref-item-separator - ----- - .. _class_TCPServer_method_listen: .. rst-class:: classref-method @@ -103,18 +73,6 @@ If ``bind_address`` is set to any valid address (e.g. ``"192.168.1.101"``, ``":: ---- -.. _class_TCPServer_method_stop: - -.. rst-class:: classref-method - -|void| **stop**\ (\ ) :ref:`🔗` - -Para de escuchar. - -.. rst-class:: classref-item-separator - ----- - .. _class_TCPServer_method_take_connection: .. rst-class:: classref-method diff --git a/classes/es/class_textedit.rst b/classes/es/class_textedit.rst index 058e455bdf..9d05af2228 100644 --- a/classes/es/class_textedit.rst +++ b/classes/es/class_textedit.rst @@ -60,8 +60,6 @@ Propiedades +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`CaretType` | :ref:`caret_type` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`bool` | clip_contents | ``true`` (overrides :ref:`Control`) | - +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`context_menu_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`custom_word_separators` | ``""`` | @@ -514,6 +512,8 @@ Propiedades del Tema +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`outline_size` | ``0`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`int` | :ref:`wrap_offset` | ``10`` | + +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Font` | :ref:`font` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`font_size` | | @@ -1501,7 +1501,7 @@ Si es ``true``, todas las líneas envueltas se indentan a la misma cantidad que - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_language**\ (\ ) -Código de idioma utilizado para los algoritmos de salto de línea y forma del texto, si se deja vacío se utiliza la configuración regional actual. +Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead. .. rst-class:: classref-item-separator @@ -4206,6 +4206,18 @@ The size of the text outline. ---- +.. _class_TextEdit_theme_constant_wrap_offset: + +.. rst-class:: classref-themeproperty + +:ref:`int` **wrap_offset** = ``10`` :ref:`🔗` + +Sets an additional margin for line wrapping width. + +.. rst-class:: classref-item-separator + +---- + .. _class_TextEdit_theme_font_font: .. rst-class:: classref-themeproperty diff --git a/classes/es/class_textline.rst b/classes/es/class_textline.rst index 210445b5ab..bfd3fe3339 100644 --- a/classes/es/class_textline.rst +++ b/classes/es/class_textline.rst @@ -63,6 +63,8 @@ Métodos +---------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_outline`\ (\ canvas\: :ref:`RID`, pos\: :ref:`Vector2`, outline_size\: :ref:`int` = 1, color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| | +---------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`TextLine` | :ref:`duplicate`\ (\ ) |const| | + +---------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Direction` | :ref:`get_inferred_direction`\ (\ ) |const| | +---------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_line_ascent`\ (\ ) |const| | @@ -83,6 +85,8 @@ Métodos +---------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`get_size`\ (\ ) |const| | +---------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_object`\ (\ key\: :ref:`Variant`\ ) |const| | + +---------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`hit_test`\ (\ coords\: :ref:`float`\ ) |const| | +---------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`resize_object`\ (\ key\: :ref:`Variant`, size\: :ref:`Vector2`, inline_align\: :ref:`InlineAlignment` = 5, baseline\: :ref:`float` = 0.0\ ) | @@ -319,6 +323,18 @@ Draw text into a canvas item at a given position, with ``color``. ``pos`` specif ---- +.. _class_TextLine_method_duplicate: + +.. rst-class:: classref-method + +:ref:`TextLine` **duplicate**\ (\ ) |const| :ref:`🔗` + +Duplicates this **TextLine**. + +.. rst-class:: classref-item-separator + +---- + .. _class_TextLine_method_get_inferred_direction: .. rst-class:: classref-method @@ -439,6 +455,18 @@ Returns size of the bounding box of the text. ---- +.. _class_TextLine_method_has_object: + +.. rst-class:: classref-method + +:ref:`bool` **has_object**\ (\ key\: :ref:`Variant`\ ) |const| :ref:`🔗` + +Returns ``true`` if an object with ``key`` is embedded in this line. + +.. rst-class:: classref-item-separator + +---- + .. _class_TextLine_method_hit_test: .. rst-class:: classref-method diff --git a/classes/es/class_textmesh.rst b/classes/es/class_textmesh.rst index 754f3cb068..fd85e87ab7 100644 --- a/classes/es/class_textmesh.rst +++ b/classes/es/class_textmesh.rst @@ -110,7 +110,9 @@ Si se establece en algo que no sea :ref:`TextServer.AUTOWRAP_OFF`\ ) - :ref:`float` **get_curve_step**\ (\ ) -Paso (en píxeles) utilizado para aproximar las curvas de Bézier. +Step (in pixels) used to approximate Bézier curves. Lower values result in smoother curves, but is slower to generate and render. Consider adjusting this according to the font size and the typical viewing distance. + +\ **Note:** Changing this property will regenerate the mesh, which is a slow operation, especially with large font sizes and long texts. .. rst-class:: classref-item-separator @@ -161,7 +163,9 @@ Configuración de la fuente usada para mostrar texto. - |void| **set_font_size**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_font_size**\ (\ ) -Tamaño de fuente del texto de **TextMesh**. +Font size of the **TextMesh**'s text. This property works in tandem with :ref:`pixel_size`. Higher values will result in a more detailed font, regardless of :ref:`curve_step` and :ref:`pixel_size`. Consider keeping this value below 63 (inclusive) for good performance, and adjust :ref:`pixel_size` as needed to enlarge text. + +\ **Note:** Changing this property will regenerate the mesh, which is a slow operation, especially with large font sizes and long texts. To change the text's size in real-time efficiently, change the node's :ref:`Node3D.scale` instead. .. rst-class:: classref-item-separator @@ -178,7 +182,7 @@ Tamaño de fuente del texto de **TextMesh**. - |void| **set_horizontal_alignment**\ (\ value\: :ref:`HorizontalAlignment`\ ) - :ref:`HorizontalAlignment` **get_horizontal_alignment**\ (\ ) -Controla la alineación horizontal del texto. Admite izquierda, centro, derecha y relleno, o justificar. +Controla la alineación horizontal del texto. Admite izquierda, centro, derecha y relleno (también conocido como justificar). .. rst-class:: classref-item-separator @@ -212,7 +216,7 @@ Reglas de alineación de relleno de línea. - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_language**\ (\ ) -Código de idioma utilizado para los algoritmos de modelado de texto. Si se deja vacío, se utiliza la configuración regional actual. +Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead. .. rst-class:: classref-item-separator @@ -246,7 +250,9 @@ Additional vertical spacing between lines (in pixels), spacing is added to line - |void| **set_offset**\ (\ value\: :ref:`Vector2`\ ) - :ref:`Vector2` **get_offset**\ (\ ) -El desplazamiento del dibujo del texto (en píxeles). +The text drawing offset (in pixels). + +\ **Note:** Changing this property will regenerate the mesh, which is a slow operation. To change the text's position in real-time efficiently, change the node's :ref:`Node3D.position` instead. .. rst-class:: classref-item-separator @@ -263,7 +269,9 @@ El desplazamiento del dibujo del texto (en píxeles). - |void| **set_pixel_size**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_pixel_size**\ (\ ) -El tamaño del ancho de un píxel en el texto para escalarlo en 3D. +The size of one pixel's width on the text to scale it in 3D. This property works in tandem with :ref:`font_size`. + +\ **Note:** Changing this property will regenerate the mesh, which is a slow operation, especially with large font sizes and long texts. To change the text's size in real-time efficiently, change the node's :ref:`Node3D.scale` instead. .. rst-class:: classref-item-separator diff --git a/classes/es/class_textparagraph.rst b/classes/es/class_textparagraph.rst index 74bf99177e..643472e36d 100644 --- a/classes/es/class_textparagraph.rst +++ b/classes/es/class_textparagraph.rst @@ -81,6 +81,8 @@ Métodos +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_outline`\ (\ canvas\: :ref:`RID`, pos\: :ref:`Vector2`, outline_size\: :ref:`int` = 1, color\: :ref:`Color` = Color(1, 1, 1, 1), dc_color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`TextParagraph` | :ref:`duplicate`\ (\ ) |const| | + +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_dropcap_lines`\ (\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_dropcap_rid`\ (\ ) |const| | @@ -119,6 +121,8 @@ Métodos +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`get_size`\ (\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_object`\ (\ key\: :ref:`Variant`\ ) |const| | + +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`hit_test`\ (\ coords\: :ref:`Vector2`\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`resize_object`\ (\ key\: :ref:`Variant`, size\: :ref:`Vector2`, inline_align\: :ref:`InlineAlignment` = 5, baseline\: :ref:`float` = 0.0\ ) | @@ -485,6 +489,18 @@ Dibuja los contornos de todas las líneas del texto y la letra capital en un ele ---- +.. _class_TextParagraph_method_duplicate: + +.. rst-class:: classref-method + +:ref:`TextParagraph` **duplicate**\ (\ ) |const| :ref:`🔗` + +Duplicates this **TextParagraph**. + +.. rst-class:: classref-item-separator + +---- + .. _class_TextParagraph_method_get_dropcap_lines: .. rst-class:: classref-method @@ -713,6 +729,18 @@ Devuelve el tamaño del cuadro delimitador del párrafo. ---- +.. _class_TextParagraph_method_has_object: + +.. rst-class:: classref-method + +:ref:`bool` **has_object**\ (\ key\: :ref:`Variant`\ ) |const| :ref:`🔗` + +Returns ``true`` if an object with ``key`` is embedded in this shaped text buffer. + +.. rst-class:: classref-item-separator + +---- + .. _class_TextParagraph_method_hit_test: .. rst-class:: classref-method diff --git a/classes/es/class_textserver.rst b/classes/es/class_textserver.rst index def9e127e1..041c3c85a0 100644 --- a/classes/es/class_textserver.rst +++ b/classes/es/class_textserver.rst @@ -322,6 +322,8 @@ Métodos +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_locale_right_to_left`\ (\ locale\: :ref:`String`\ ) |const| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_locale_using_support_data`\ (\ locale\: :ref:`String`\ ) |const| | + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_valid_identifier`\ (\ string\: :ref:`String`\ ) |const| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_valid_letter`\ (\ unicode\: :ref:`int`\ ) |const| | @@ -380,6 +382,8 @@ Métodos +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`shaped_text_draw_outline`\ (\ shaped\: :ref:`RID`, canvas\: :ref:`RID`, pos\: :ref:`Vector2`, clip_l\: :ref:`float` = -1, clip_r\: :ref:`float` = -1, outline_size\: :ref:`int` = 1, color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`RID` | :ref:`shaped_text_duplicate`\ (\ rid\: :ref:`RID`\ ) | + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`shaped_text_fit_to_width`\ (\ shaped\: :ref:`RID`, width\: :ref:`float`, justification_flags\: |bitfield|\[:ref:`JustificationFlag`\] = 3\ ) | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`shaped_text_get_ascent`\ (\ shaped\: :ref:`RID`\ ) |const| | @@ -450,6 +454,8 @@ Métodos +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedInt32Array` | :ref:`shaped_text_get_word_breaks`\ (\ shaped\: :ref:`RID`, grapheme_flags\: |bitfield|\[:ref:`GraphemeFlag`\] = 264, skip_grapheme_flags\: |bitfield|\[:ref:`GraphemeFlag`\] = 4\ ) |const| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`shaped_text_has_object`\ (\ shaped\: :ref:`RID`, key\: :ref:`Variant`\ ) |const| | + +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`shaped_text_has_visible_chars`\ (\ shaped\: :ref:`RID`\ ) |const| | +------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`shaped_text_hit_test_grapheme`\ (\ shaped\: :ref:`RID`, coords\: :ref:`float`\ ) |const| | @@ -1070,6 +1076,14 @@ Determina si la elipsis al final del texto se aplica y no se puede ocultar. Tiene en cuenta que el texto esté justificado antes de intentar recortarlo (véase :ref:`JustificationFlag`). +.. _class_TextServer_constant_OVERRUN_SHORT_STRING_ELLIPSIS: + +.. rst-class:: classref-enumeration-constant + +:ref:`TextOverrunFlag` **OVERRUN_SHORT_STRING_ELLIPSIS** = ``32`` + +Determines whether the ellipsis should be added regardless of the string length, otherwise it is added only if the string is 6 characters or longer. + .. rst-class:: classref-item-separator ---- @@ -1949,7 +1963,7 @@ Returns ``true`` if font texture mipmap generation is enabled. **Obsoleto:** Use :ref:`Viewport` oversampling, or the ``oversampling`` argument of the ``draw_*`` methods instead. -Obsoleto. Este método siempre devuelve ``1.0``. +This method does nothing and always returns ``1.0``. .. rst-class:: classref-item-separator @@ -2523,7 +2537,7 @@ Devuelve ``true`` si el hinting automático es compatible y preferible al hintin :ref:`bool` **font_is_language_supported**\ (\ font_rid\: :ref:`RID`, language\: :ref:`String`\ ) |const| :ref:`🔗` -Devuelve ``true`` si la fuente soporta el idioma dado (código `ISO 639 `__). +Returns ``true`` if the font supports the given language (as a `ISO 639 `__ code). .. rst-class:: classref-item-separator @@ -2535,7 +2549,7 @@ Devuelve ``true`` si la fuente soporta el idioma dado (código `ISO 639 ` **font_is_modulate_color_glyphs**\ (\ font_rid\: :ref:`RID`\ ) |const| :ref:`🔗` -Devuelve ``true`` si la modulación de color se aplica al dibujar glifos coloreados. +Returns ``true`` if color modulation is applied when drawing the font's colored glyphs. .. rst-class:: classref-item-separator @@ -2559,7 +2573,7 @@ Devuelve ``true`` si los glifos de todos los tamaños se renderizan utilizando u :ref:`bool` **font_is_script_supported**\ (\ font_rid\: :ref:`RID`, script\: :ref:`String`\ ) |const| :ref:`🔗` -Devuelve ``true`` si la fuente admite el script dado (código ISO 15924). +Returns ``true`` if the font supports the given script (as a `ISO 15924 `__ code). .. rst-class:: classref-item-separator @@ -2829,7 +2843,7 @@ Si se establece en ``true``, la generación de mipmap de textura de fuente está **Obsoleto:** Use :ref:`Viewport` oversampling, or the ``oversampling`` argument of the ``draw_*`` methods instead. -Obsoleto. Este método no hace nada. +Este método no hace nada. .. rst-class:: classref-item-separator @@ -3237,9 +3251,11 @@ Devuelve el diccionario de las coordenadas de variación OpenType admitidas. :ref:`String` **format_number**\ (\ number\: :ref:`String`, language\: :ref:`String` = ""\ ) |const| :ref:`🔗` -Convierte un número del sistema arábigo occidental (0..9) a los sistemas numerales utilizados en ``language``. +**Obsoleto:** Use :ref:`TranslationServer.format_number()` instead. -Si se omite ``language``, se utilizará la configuración regional activa. +Converts a number from Western Arabic (0..9) to the numeral system used in the given ``language``. + +If ``language`` is an empty string, the active locale will be used. .. rst-class:: classref-item-separator @@ -3381,6 +3397,18 @@ Devuelve ``true`` si la configuración regional es de derecha a izquierda. ---- +.. _class_TextServer_method_is_locale_using_support_data: + +.. rst-class:: classref-method + +:ref:`bool` **is_locale_using_support_data**\ (\ locale\: :ref:`String`\ ) |const| :ref:`🔗` + +Returns ``true`` if the locale requires text server support data for line/word breaking. + +.. rst-class:: classref-item-separator + +---- + .. _class_TextServer_method_is_valid_identifier: .. rst-class:: classref-method @@ -3441,7 +3469,7 @@ Carga una base de datos opcional de TextServer (p. ej. iteradores de salto y dic :ref:`int` **name_to_tag**\ (\ name\: :ref:`String`\ ) |const| :ref:`🔗` -Convierte un nombre legible de característica, variación, script o idioma a una etiqueta OpenType. +Converts the given readable name of a feature, variation, script, or language to an OpenType tag. .. rst-class:: classref-item-separator @@ -3453,7 +3481,11 @@ Convierte un nombre legible de característica, variación, script o idioma a un :ref:`String` **parse_number**\ (\ number\: :ref:`String`, language\: :ref:`String` = ""\ ) |const| :ref:`🔗` -Convierte ``number`` del sistema numeral usado en ``language`` a árabe occidental (0..9). +**Obsoleto:** Use :ref:`TranslationServer.parse_number()` instead. + +Converts ``number`` from the numeral system used in the given ``language`` to Western Arabic (0..9). + +If ``language`` is an empty string, the active locale will be used. .. rst-class:: classref-item-separator @@ -3477,7 +3509,11 @@ Implementación predeterminada de la función de sobrescritura del algoritmo BiD :ref:`String` **percent_sign**\ (\ language\: :ref:`String` = ""\ ) |const| :ref:`🔗` -Devuelve el signo de porcentaje utilizado en el ``language``. +**Obsoleto:** Use :ref:`TranslationServer.get_percent_sign()` instead. + +Returns the percent sign used in the given ``language``. + +If ``language`` is an empty string, the active locale will be used. .. rst-class:: classref-item-separator @@ -3753,6 +3789,18 @@ Dibuja el contorno del texto conformado en un elemento del canvas en una posici ---- +.. _class_TextServer_method_shaped_text_duplicate: + +.. rst-class:: classref-method + +:ref:`RID` **shaped_text_duplicate**\ (\ rid\: :ref:`RID`\ ) :ref:`🔗` + +Duplicates shaped text buffer. + +.. rst-class:: classref-item-separator + +---- + .. _class_TextServer_method_shaped_text_fit_to_width: .. rst-class:: classref-method @@ -4179,6 +4227,18 @@ Divide el texto en palabras y devuelve un array de rangos de caracteres. Usa ``g ---- +.. _class_TextServer_method_shaped_text_has_object: + +.. rst-class:: classref-method + +:ref:`bool` **shaped_text_has_object**\ (\ shaped\: :ref:`RID`, key\: :ref:`Variant`\ ) |const| :ref:`🔗` + +Returns ``true`` if an object with ``key`` is embedded in this shaped text buffer. + +.. rst-class:: classref-item-separator + +---- + .. _class_TextServer_method_shaped_text_has_visible_chars: .. rst-class:: classref-method @@ -4512,11 +4572,11 @@ Cuando ``chars_per_line`` es mayor que cero, se devuelven en su lugar los límit :ref:`String` **string_to_lower**\ (\ string\: :ref:`String`, language\: :ref:`String` = ""\ ) |const| :ref:`🔗` -Devuelve la string convertida a minúsculas. +Returns the string converted to ``lowercase``. -\ **Nota:** El uso de mayúsculas y minúsculas depende de la configuración regional y del contexto si el servidor soporta la característica :ref:`FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION` (soportada por :ref:`TextServerAdvanced`). +\ **Note:** Casing is locale dependent and context sensitive if server support :ref:`FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION` feature (supported by :ref:`TextServerAdvanced`). -\ **Nota:** El resultado puede ser más largo o más corto que el original. +\ **Note:** The result may be longer or shorter than the original. .. rst-class:: classref-item-separator @@ -4528,11 +4588,11 @@ Devuelve la string convertida a minúsculas. :ref:`String` **string_to_title**\ (\ string\: :ref:`String`, language\: :ref:`String` = ""\ ) |const| :ref:`🔗` -Devuelve la string convertida a formato de título. +Returns the string converted to ``Title Case``. -\ **Nota:** El uso de mayúsculas y minúsculas depende de la configuración regional y del contexto si el servidor soporta la característica :ref:`FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION` (soportada por :ref:`TextServerAdvanced`). +\ **Note:** Casing is locale dependent and context sensitive if server support :ref:`FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION` feature (supported by :ref:`TextServerAdvanced`). -\ **Nota:** El resultado puede ser más largo o más corto que el original. +\ **Note:** The result may be longer or shorter than the original. .. rst-class:: classref-item-separator @@ -4544,11 +4604,11 @@ Devuelve la string convertida a formato de título. :ref:`String` **string_to_upper**\ (\ string\: :ref:`String`, language\: :ref:`String` = ""\ ) |const| :ref:`🔗` -Devuelve la string convertida a mayúsculas. +Returns the string converted to ``UPPERCASE``. -\ **Nota:** El uso de mayúsculas y minúsculas depende de la configuración regional y del contexto si el servidor soporta la característica :ref:`FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION` (soportada por :ref:`TextServerAdvanced`). +\ **Note:** Casing is locale dependent and context sensitive if server support :ref:`FEATURE_CONTEXT_SENSITIVE_CASE_CONVERSION` feature (supported by :ref:`TextServerAdvanced`). -\ **Nota:** El resultado puede ser más largo o más corto que el original. +\ **Note:** The result may be longer or shorter than the original. .. rst-class:: classref-item-separator @@ -4574,7 +4634,7 @@ Elimina los diacríticos de la string. :ref:`String` **tag_to_name**\ (\ tag\: :ref:`int`\ ) |const| :ref:`🔗` -Convierte la etiqueta OpenType a un nombre legible de característica, variación, script o idioma. +Converts the given OpenType tag to the readable name of a feature, variation, script, or language. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_textserverextension.rst b/classes/es/class_textserverextension.rst index c9075706f6..13413fc261 100644 --- a/classes/es/class_textserverextension.rst +++ b/classes/es/class_textserverextension.rst @@ -309,6 +309,8 @@ Métodos +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`_is_locale_right_to_left`\ (\ locale\: :ref:`String`\ ) |virtual| |const| | +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`_is_locale_using_support_data`\ (\ locale\: :ref:`String`\ ) |virtual| |const| | + +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`_is_valid_identifier`\ (\ string\: :ref:`String`\ ) |virtual| |const| | +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`_is_valid_letter`\ (\ unicode\: :ref:`int`\ ) |virtual| |const| | @@ -369,6 +371,8 @@ Métodos +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_shaped_text_draw_outline`\ (\ shaped\: :ref:`RID`, canvas\: :ref:`RID`, pos\: :ref:`Vector2`, clip_l\: :ref:`float`, clip_r\: :ref:`float`, outline_size\: :ref:`int`, color\: :ref:`Color`, oversampling\: :ref:`float`\ ) |virtual| |const| | +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`RID` | :ref:`_shaped_text_duplicate`\ (\ shaped\: :ref:`RID`\ ) |virtual| |required| | + +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`_shaped_text_fit_to_width`\ (\ shaped\: :ref:`RID`, width\: :ref:`float`, justification_flags\: |bitfield|\[:ref:`JustificationFlag`\]\ ) |virtual| | +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`_shaped_text_get_ascent`\ (\ shaped\: :ref:`RID`\ ) |virtual| |required| |const| | @@ -439,6 +443,8 @@ Métodos +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedInt32Array` | :ref:`_shaped_text_get_word_breaks`\ (\ shaped\: :ref:`RID`, grapheme_flags\: |bitfield|\[:ref:`GraphemeFlag`\], skip_grapheme_flags\: |bitfield|\[:ref:`GraphemeFlag`\]\ ) |virtual| |const| | +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`_shaped_text_has_object`\ (\ shaped\: :ref:`RID`, key\: :ref:`Variant`\ ) |virtual| |required| |const| | + +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`_shaped_text_hit_test_grapheme`\ (\ shaped\: :ref:`RID`, coord\: :ref:`float`\ ) |virtual| |const| | +------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`_shaped_text_hit_test_position`\ (\ shaped\: :ref:`RID`, coord\: :ref:`float`\ ) |virtual| |const| | @@ -1361,7 +1367,7 @@ Devuelve ``true`` si el hinting automático es compatible y preferido sobre el h :ref:`bool` **_font_is_language_supported**\ (\ font_rid\: :ref:`RID`, language\: :ref:`String`\ ) |virtual| |const| :ref:`🔗` -Devuelve ``true`` si la fuente soporta el idioma dado (código `ISO 639 `__). +Returns ``true`` if the font supports the given language (as a `ISO 639 `__ code). .. rst-class:: classref-item-separator @@ -1373,7 +1379,7 @@ Devuelve ``true`` si la fuente soporta el idioma dado (código `ISO 639 ` **_font_is_modulate_color_glyphs**\ (\ font_rid\: :ref:`RID`\ ) |virtual| |const| :ref:`🔗` -Devuelve ``true`` si la modulación de color se aplica al dibujar glifos coloreados. +Returns ``true`` if color modulation is applied when drawing the font's colored glyphs. .. rst-class:: classref-item-separator @@ -1397,7 +1403,7 @@ Devuelve ``true`` si los glifos de todos los tamaños se renderizan utilizando u :ref:`bool` **_font_is_script_supported**\ (\ font_rid\: :ref:`RID`, script\: :ref:`String`\ ) |virtual| |const| :ref:`🔗` -Devuelve ``true`` si la fuente admite el script dado (código ISO 15924). +Returns ``true`` if the font supports the given script (as a `ISO 15924 `__ code). .. rst-class:: classref-item-separator @@ -2069,7 +2075,11 @@ Devuelve el diccionario de las coordenadas de variación OpenType admitidas. :ref:`String` **_format_number**\ (\ number\: :ref:`String`, language\: :ref:`String`\ ) |virtual| |const| :ref:`🔗` -Convierte un número del sistema arábigo occidental (0..9) a los sistemas numerales utilizados en ``language``. +**Obsoleto:** Use :ref:`TranslationServer.format_number()` instead. + +Converts a number from Western Arabic (0..9) to the numeral system used in the given ``language``. + +If ``language`` is an empty string, the active locale will be used. .. rst-class:: classref-item-separator @@ -2207,6 +2217,18 @@ Devuelve ``true`` si la configuración regional es de derecha a izquierda. ---- +.. _class_TextServerExtension_private_method__is_locale_using_support_data: + +.. rst-class:: classref-method + +:ref:`bool` **_is_locale_using_support_data**\ (\ locale\: :ref:`String`\ ) |virtual| |const| :ref:`🔗` + +Returns ``true`` if the locale requires text server support data for line/word breaking. + +.. rst-class:: classref-item-separator + +---- + .. _class_TextServerExtension_private_method__is_valid_identifier: .. rst-class:: classref-method @@ -2251,7 +2273,7 @@ Carga la base de datos opcional del TextServer (por ejemplo, iteradores de salto :ref:`int` **_name_to_tag**\ (\ name\: :ref:`String`\ ) |virtual| |const| :ref:`🔗` -Convierte un nombre legible de característica, variación, script o idioma a una etiqueta OpenType. +Converts the given readable name of a feature, variation, script, or language to an OpenType tag. .. rst-class:: classref-item-separator @@ -2263,7 +2285,11 @@ Convierte un nombre legible de característica, variación, script o idioma a un :ref:`String` **_parse_number**\ (\ number\: :ref:`String`, language\: :ref:`String`\ ) |virtual| |const| :ref:`🔗` -Convierte ``number`` del sistema numeral usado en ``language`` a árabe occidental (0..9). +**Obsoleto:** Use :ref:`TranslationServer.parse_number()` instead. + +Converts ``number`` from the numeral system used in the given ``language`` to Western Arabic (0..9). + +If ``language`` is an empty string, the active locale will be used. .. rst-class:: classref-item-separator @@ -2287,7 +2313,9 @@ Implementación predeterminada de la función de sobrescritura del algoritmo BiD :ref:`String` **_percent_sign**\ (\ language\: :ref:`String`\ ) |virtual| |const| :ref:`🔗` -Devuelve el signo de porcentaje utilizado en el ``language``. +**Obsoleto:** Use :ref:`TranslationServer.get_percent_sign()` instead. + +Returns percent sign used in the given ``language``. .. rst-class:: classref-item-separator @@ -2569,6 +2597,18 @@ Dibuja el contorno del texto moldeado en un elemento Canvas en una posición det ---- +.. _class_TextServerExtension_private_method__shaped_text_duplicate: + +.. rst-class:: classref-method + +:ref:`RID` **_shaped_text_duplicate**\ (\ shaped\: :ref:`RID`\ ) |virtual| |required| :ref:`🔗` + +Duplicates shaped text buffer. + +.. rst-class:: classref-item-separator + +---- + .. _class_TextServerExtension_private_method__shaped_text_fit_to_width: .. rst-class:: classref-method @@ -2989,6 +3029,18 @@ Divide el texto en palabras y devuelve un array de rangos de caracteres. Usa ``g ---- +.. _class_TextServerExtension_private_method__shaped_text_has_object: + +.. rst-class:: classref-method + +:ref:`bool` **_shaped_text_has_object**\ (\ shaped\: :ref:`RID`, key\: :ref:`Variant`\ ) |virtual| |required| |const| :ref:`🔗` + +Returns ``true`` if an object with ``key`` is embedded in this shaped text buffer. + +.. rst-class:: classref-item-separator + +---- + .. _class_TextServerExtension_private_method__shaped_text_hit_test_grapheme: .. rst-class:: classref-method @@ -3307,7 +3359,7 @@ Devuelve un array con los límites de los saltos de palabra. Los elementos del a :ref:`String` **_string_to_lower**\ (\ string\: :ref:`String`, language\: :ref:`String`\ ) |virtual| |const| :ref:`🔗` -Devuelve la string convertida a minúsculas. +Devuelve la string convertida a ``minúsculas``. .. rst-class:: classref-item-separator @@ -3319,7 +3371,7 @@ Devuelve la string convertida a minúsculas. :ref:`String` **_string_to_title**\ (\ string\: :ref:`String`, language\: :ref:`String`\ ) |virtual| |const| :ref:`🔗` -Devuelve la string convertida al formato de título. +Returns the string converted to ``Title Case``. .. rst-class:: classref-item-separator @@ -3331,7 +3383,7 @@ Devuelve la string convertida al formato de título. :ref:`String` **_string_to_upper**\ (\ string\: :ref:`String`, language\: :ref:`String`\ ) |virtual| |const| :ref:`🔗` -Devuelve la string convertida a mayúsculas. +Devuelve la string convertida a ``MAYÚSCULAS``. .. rst-class:: classref-item-separator @@ -3355,7 +3407,7 @@ Elimina los diacríticos de la string. :ref:`String` **_tag_to_name**\ (\ tag\: :ref:`int`\ ) |virtual| |const| :ref:`🔗` -Convierte la etiqueta OpenType a un nombre legible de característica, variación, script o idioma. +Converts the given OpenType tag to the readable name of a feature, variation, script, or language. .. rst-class:: classref-item-separator diff --git a/classes/es/class_thread.rst b/classes/es/class_thread.rst index 9974e1e24d..b717f9af86 100644 --- a/classes/es/class_thread.rst +++ b/classes/es/class_thread.rst @@ -14,17 +14,15 @@ Una unidad de ejecución en un proceso. Descripción ---------------------- -Una unidad de ejecución en un proceso. Puede ejecutar métodos en :ref:`Object`\ s simultáneamente. Se aconseja el uso de la sincronización a través de :ref:`Mutex` o :ref:`Semaphore` si se trabaja con objetos compartidos. +A unit of execution in a process. Can run methods on :ref:`Object`\ s simultaneously. The use of synchronization via :ref:`Mutex` or :ref:`Semaphore` is advised if working with shared objects. -\ **Advertencia:**\ +\ **Warning:** To ensure proper cleanup without crashes or deadlocks, when a **Thread**'s reference count reaches zero and it is therefore destroyed, the following conditions must be met: -Para asegurar una limpieza adecuada sin bloqueos o fallos, cuando el contador de referencia de un **Thread** llega a cero y por lo tanto se destruye, se deben cumplir las siguientes condiciones: +- It must not have any :ref:`Mutex` objects locked. -- No debe tener ningún objeto :ref:`Mutex` bloqueado. +- It must not be waiting on any :ref:`Semaphore` objects. -- No debe estar esperando ningún objeto :ref:`Semaphore`. - -- Se debe haber llamado a :ref:`wait_to_finish()`. +- :ref:`wait_to_finish()` should have been called on it. .. rst-class:: classref-introduction-group @@ -50,6 +48,8 @@ Métodos +---------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_alive`\ (\ ) |const| | +---------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_main_thread`\ (\ ) |static| | + +---------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_started`\ (\ ) |const| | +---------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_thread_safety_checks_enabled`\ (\ enabled\: :ref:`bool`\ ) |static| | @@ -133,6 +133,20 @@ Para comprobar si un **Thread** se puede unir, utiliza :ref:`is_started()` **is_main_thread**\ (\ ) |static| :ref:`🔗` + +Returns ``true`` if the thread this method was called from is the main thread. + +\ **Note:** This is a static method and isn't associated with a specific **Thread** object. + +.. rst-class:: classref-item-separator + +---- + .. _class_Thread_method_is_started: .. rst-class:: classref-method diff --git a/classes/es/class_tilemaplayer.rst b/classes/es/class_tilemaplayer.rst index f1c46b1ca2..9914a2ea81 100644 --- a/classes/es/class_tilemaplayer.rst +++ b/classes/es/class_tilemaplayer.rst @@ -333,11 +333,11 @@ Habilitar o deshabilitar la oclusión de luz. - |void| **set_physics_quadrant_size**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_physics_quadrant_size**\ (\ ) -El tamaño del cuadrante de física de **TileMapLayer**. Dentro de un cuadrante de física, las celdas con propiedades físicas similares se agrupan y sus formas de colisión se fusionan. :ref:`physics_quadrant_size` define la longitud del lado de un cuadrado, en el sistema de coordenadas del mapa, que forma el cuadrante. Por lo tanto, el tamaño de cuadrante predeterminado agrupa juntos ``16 * 16 = 256`` tiles. +The **TileMapLayer**'s physics quadrant size. Within a physics quadrant, cells with similar physics properties are grouped together and their collision shapes get merged. :ref:`physics_quadrant_size` defines the length of a square's side, in the map's coordinate system, that forms the quadrant. Thus, the default quadrant size groups together ``16 * 16 = 256`` tiles. -\ **Nota:** Como los cuadrantes se crean de acuerdo con el sistema de coordenadas del mapa, la "forma cuadrada" del cuadrante podría no parecerse a un cuadrado en el sistema de coordenadas local de **TileMapLayer**. +\ **Note:** As quadrants are created according to the map's coordinate system, the quadrant's "square shape" might not look like square in the **TileMapLayer**'s local coordinate system. -\ **Nota:** Esto afecta el valor devuelto por :ref:`get_coords_for_body_rid()`. +\ **Note:** This impacts the value returned by :ref:`get_coords_for_body_rid()`. Higher values will make that function less precise. To get the exact cell coordinates, you need to set :ref:`physics_quadrant_size` to ``1``, which disables physics chunking. .. rst-class:: classref-item-separator @@ -616,7 +616,9 @@ Devuelve el objeto :ref:`TileData` asociado con la celda dada, o :ref:`Vector2i` **get_coords_for_body_rid**\ (\ body\: :ref:`RID`\ ) |const| :ref:`🔗` -Devuelve las coordenadas del cuadrante de física (ver :ref:`physics_quadrant_size`) para el cuerpo de física :ref:`RID` dado. Dicho :ref:`RID` se puede recuperar de :ref:`KinematicCollision2D.get_collider_rid()`, al colisionar con un tile. +Returns the coordinates of the physics quadrant (see :ref:`physics_quadrant_size`) for given physics body :ref:`RID`. Such an :ref:`RID` can be retrieved from :ref:`KinematicCollision2D.get_collider_rid()`, when colliding with a tile. + +\ **Note:** Higher values of :ref:`physics_quadrant_size` will make this function less precise. To get the exact cell coordinates, you need to set :ref:`physics_quadrant_size` to ``1``, which disables physics chunking. .. rst-class:: classref-item-separator diff --git a/classes/es/class_tilesetatlassource.rst b/classes/es/class_tilesetatlassource.rst index db36da6fee..0cdbbf77da 100644 --- a/classes/es/class_tilesetatlassource.rst +++ b/classes/es/class_tilesetatlassource.rst @@ -375,7 +375,7 @@ Devuelve el ID alternativo que devolvería una llamada posterior a :ref:`create_ :ref:`Texture2D` **get_runtime_texture**\ (\ ) |const| :ref:`🔗` -Si :ref:`use_texture_padding` es ``false``, devuelve :ref:`texture`. De lo contrario, devuelve una :ref:`ImageTexture` interna creada que incluye el relleno. +If :ref:`use_texture_padding` is ``false``, returns :ref:`texture`. Otherwise, returns an internal :ref:`ImageTexture` created that includes the padding. .. rst-class:: classref-item-separator diff --git a/classes/es/class_timer.rst b/classes/es/class_timer.rst index b738533444..dbc33c16fd 100644 --- a/classes/es/class_timer.rst +++ b/classes/es/class_timer.rst @@ -14,20 +14,20 @@ Un temporizador de cuenta atrás. Descripción ---------------------- -El nodo **Timer** es un temporizador de cuenta regresiva y es la forma más sencilla de manejar la lógica basada en el tiempo en el motor. Cuando un temporizador alcanza el final de su :ref:`wait_time`, emitirá la señal :ref:`timeout`. +The **Timer** node is a countdown timer and is the simplest way to handle time-based logic in the engine. When a timer reaches the end of its :ref:`wait_time`, it will emit the :ref:`timeout` signal. -Después de que un temporizador entra en el árbol de escenas, se puede iniciar manualmente con :ref:`start()`. Un nodo temporizador también se inicia automáticamente si :ref:`autostart` es ``true``. +After a timer enters the scene tree, it can be manually started with :ref:`start()`. A timer node is also started automatically if :ref:`autostart` is ``true``. -Sin requerir mucho código, se puede agregar y configurar un nodo temporizador en el editor. La señal :ref:`timeout` que emite también se puede conectar a través del dock de Nodos en el editor: +Without requiring much code, a timer node can be added and configured in the editor. The :ref:`timeout` signal it emits can also be connected through the Signals dock in the editor: :: func _on_timer_timeout(): - print("¡Hora de atacar!") + print("Time to attack!") -\ **Nota:** Para crear un temporizador de un solo disparo sin instanciar un nodo, usa :ref:`SceneTree.create_timer()`. +\ **Note:** To create a one-shot timer without instantiating a node, use :ref:`SceneTree.create_timer()`. -\ **Nota:** Los temporizadores se ven afectados por :ref:`Engine.time_scale` a menos que :ref:`ignore_time_scale` sea ``true``. Cuanto mayor sea la escala de tiempo, antes terminarán los temporizadores. La frecuencia con la que un temporizador procesa puede depender de la velocidad de fotogramas o de :ref:`Engine.physics_ticks_per_second`. +\ **Note:** Timers are affected by :ref:`Engine.time_scale` unless :ref:`ignore_time_scale` is ``true``. The higher the time scale, the sooner timers will end. How often a timer processes may depend on the framerate or :ref:`Engine.physics_ticks_per_second`. .. rst-class:: classref-introduction-group diff --git a/classes/es/class_translation.rst b/classes/es/class_translation.rst index 5cb08a3137..00baa635bb 100644 --- a/classes/es/class_translation.rst +++ b/classes/es/class_translation.rst @@ -16,7 +16,9 @@ Una traducción de idioma que asigna una colección de strings a sus traduccione Descripción ---------------------- -Las **Translation** son recursos que pueden ser cargados y descargados bajo demanda. Mapean una colección de strings a sus traducciones individuales y también proporcionan métodos convenientes para la pluralización. +**Translation** maps a collection of strings to their individual translations, and also provides convenience methods for pluralization. + +A **Translation** consists of messages. A message is identified by its context and untranslated string. Unlike `gettext `__, using an empty context string in Godot means not using any context. .. rst-class:: classref-introduction-group @@ -37,9 +39,11 @@ Propiedades .. table:: :widths: auto - +-----------------------------+--------------------------------------------------+----------+ - | :ref:`String` | :ref:`locale` | ``"en"`` | - +-----------------------------+--------------------------------------------------+----------+ + +-----------------------------+--------------------------------------------------------------------------------+----------+ + | :ref:`String` | :ref:`locale` | ``"en"`` | + +-----------------------------+--------------------------------------------------------------------------------+----------+ + | :ref:`String` | :ref:`plural_rules_override` | ``""`` | + +-----------------------------+--------------------------------------------------------------------------------+----------+ .. rst-class:: classref-reftable-group @@ -93,6 +97,25 @@ Descripciones de Propiedades El locale de la traducción. +.. rst-class:: classref-item-separator + +---- + +.. _class_Translation_property_plural_rules_override: + +.. rst-class:: classref-property + +:ref:`String` **plural_rules_override** = ``""`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_plural_rules_override**\ (\ value\: :ref:`String`\ ) +- :ref:`String` **get_plural_rules_override**\ (\ ) + +The plural rules string to enforce. See `GNU gettext `__ for examples and more info. + +If empty or invalid, default plural rules from :ref:`TranslationServer.get_plural_rules()` are used. The English plural rules are used as a fallback. + .. rst-class:: classref-section-separator ---- @@ -146,11 +169,9 @@ Se podría usar un contexto adicional para especificar el contexto de la traducc |void| **add_plural_message**\ (\ src_message\: :ref:`StringName`, xlated_messages\: :ref:`PackedStringArray`, context\: :ref:`StringName` = &""\ ) :ref:`🔗` -Añade un mensaje que involucra la traducción de plurales si no existe, seguido de su traducción. +Adds a message involving plural translation if nonexistent, followed by its translation. -Se podría usar un contexto adicional para especificar el contexto de la traducción o diferenciar palabras polisémicas. - -\ **Nota:** Los plurales solo se admiten en :doc:`traducciones basadas en gettext (PO) <../tutorials/i18n/localization_using_gettext>`, no en CSV. +An additional context could be used to specify the translation context or differentiate polysemic words. .. rst-class:: classref-item-separator @@ -198,7 +219,21 @@ Devuelve el número de mensajes existentes. :ref:`PackedStringArray` **get_message_list**\ (\ ) |const| :ref:`🔗` -Devuelve todos los mensajes (teclas). +Returns the keys of all messages, that is, the context and untranslated strings of each message. + +\ **Note:** If a message does not use a context, the corresponding element is the untranslated string. Otherwise, the corresponding element is the context and untranslated string separated by the EOT character (``U+0004``). This is done for compatibility purposes. + +:: + + for key in translation.get_message_list(): + var p = key.find("\u0004") + if p == -1: + var untranslated = key + print("Message %s" % untranslated) + else: + var context = key.substr(0, p) + var untranslated = key.substr(p + 1) + print("Message %s with context %s" % [untranslated, context]) .. rst-class:: classref-item-separator @@ -226,7 +261,7 @@ El número ``n`` es el número o cantidad del objeto plural. Se utilizará para :ref:`PackedStringArray` **get_translated_message_list**\ (\ ) |const| :ref:`🔗` -Devuelve todos los mensajes (texto traducido). +Returns all the translated strings. .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/es/class_translationdomain.rst b/classes/es/class_translationdomain.rst index 11ab134324..f94144eca8 100644 --- a/classes/es/class_translationdomain.rst +++ b/classes/es/class_translationdomain.rst @@ -56,25 +56,33 @@ Métodos .. table:: :widths: auto - +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`add_translation`\ (\ translation\: :ref:`Translation`\ ) | - +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear`\ (\ ) | - +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_locale_override`\ (\ ) |const| | - +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Translation` | :ref:`get_translation_object`\ (\ locale\: :ref:`String`\ ) |const| | - +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`StringName` | :ref:`pseudolocalize`\ (\ message\: :ref:`StringName`\ ) |const| | - +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`remove_translation`\ (\ translation\: :ref:`Translation`\ ) | - +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_locale_override`\ (\ locale\: :ref:`String`\ ) | - +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`StringName` | :ref:`translate`\ (\ message\: :ref:`StringName`, context\: :ref:`StringName` = &""\ ) |const| | - +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`StringName` | :ref:`translate_plural`\ (\ message\: :ref:`StringName`, message_plural\: :ref:`StringName`, n\: :ref:`int`, context\: :ref:`StringName` = &""\ ) |const| | - +---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`add_translation`\ (\ translation\: :ref:`Translation`\ ) | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear`\ (\ ) | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Array`\[:ref:`Translation`\] | :ref:`find_translations`\ (\ locale\: :ref:`String`, exact\: :ref:`bool`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_locale_override`\ (\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Translation` | :ref:`get_translation_object`\ (\ locale\: :ref:`String`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Array`\[:ref:`Translation`\] | :ref:`get_translations`\ (\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_translation`\ (\ translation\: :ref:`Translation`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_translation_for_locale`\ (\ locale\: :ref:`String`, exact\: :ref:`bool`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`StringName` | :ref:`pseudolocalize`\ (\ message\: :ref:`StringName`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_translation`\ (\ translation\: :ref:`Translation`\ ) | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_locale_override`\ (\ locale\: :ref:`String`\ ) | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`StringName` | :ref:`translate`\ (\ message\: :ref:`StringName`, context\: :ref:`StringName` = &""\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`StringName` | :ref:`translate_plural`\ (\ message\: :ref:`StringName`, message_plural\: :ref:`StringName`, n\: :ref:`int`, context\: :ref:`StringName` = &""\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -302,6 +310,18 @@ Elimina todas las traducciones. ---- +.. _class_TranslationDomain_method_find_translations: + +.. rst-class:: classref-method + +:ref:`Array`\[:ref:`Translation`\] **find_translations**\ (\ locale\: :ref:`String`, exact\: :ref:`bool`\ ) |const| :ref:`🔗` + +Returns the :ref:`Translation` instances that match ``locale`` (see :ref:`TranslationServer.compare_locales()`). If ``exact`` is ``true``, only instances whose locale exactly equals ``locale`` will be returned. + +.. rst-class:: classref-item-separator + +---- + .. _class_TranslationDomain_method_get_locale_override: .. rst-class:: classref-method @@ -320,12 +340,50 @@ Devuelve la configuración regional del dominio. Si la configuración regional e :ref:`Translation` **get_translation_object**\ (\ locale\: :ref:`String`\ ) |const| :ref:`🔗` +**Obsoleto:** Use :ref:`find_translations()` instead. + Devuelve la instancia de :ref:`Translation` que mejor coincide con ``locale``. Devuelve ``null`` si no hay coincidencias. .. rst-class:: classref-item-separator ---- +.. _class_TranslationDomain_method_get_translations: + +.. rst-class:: classref-method + +:ref:`Array`\[:ref:`Translation`\] **get_translations**\ (\ ) |const| :ref:`🔗` + +Returns all available :ref:`Translation` instances as added by :ref:`add_translation()`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TranslationDomain_method_has_translation: + +.. rst-class:: classref-method + +:ref:`bool` **has_translation**\ (\ translation\: :ref:`Translation`\ ) |const| :ref:`🔗` + +Returns ``true`` if this translation domain contains the given ``translation``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TranslationDomain_method_has_translation_for_locale: + +.. rst-class:: classref-method + +:ref:`bool` **has_translation_for_locale**\ (\ locale\: :ref:`String`, exact\: :ref:`bool`\ ) |const| :ref:`🔗` + +Returns ``true`` if there are any :ref:`Translation` instances that match ``locale`` (see :ref:`TranslationServer.compare_locales()`). If ``exact`` is ``true``, only instances whose locale exactly equals ``locale`` are considered. + +.. rst-class:: classref-item-separator + +---- + .. _class_TranslationDomain_method_pseudolocalize: .. rst-class:: classref-method diff --git a/classes/es/class_translationserver.rst b/classes/es/class_translationserver.rst index 586c411d8e..fa44c9d7aa 100644 --- a/classes/es/class_translationserver.rst +++ b/classes/es/class_translationserver.rst @@ -47,55 +47,71 @@ Métodos .. table:: :widths: auto - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`add_translation`\ (\ translation\: :ref:`Translation`\ ) | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear`\ (\ ) | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`compare_locales`\ (\ locale_a\: :ref:`String`, locale_b\: :ref:`String`\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`get_all_countries`\ (\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`get_all_languages`\ (\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`get_all_scripts`\ (\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_country_name`\ (\ country\: :ref:`String`\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_language_name`\ (\ language\: :ref:`String`\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`get_loaded_locales`\ (\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_locale`\ (\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_locale_name`\ (\ locale\: :ref:`String`\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`TranslationDomain` | :ref:`get_or_add_domain`\ (\ domain\: :ref:`StringName`\ ) | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_script_name`\ (\ script\: :ref:`String`\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_tool_locale`\ (\ ) | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`Translation` | :ref:`get_translation_object`\ (\ locale\: :ref:`String`\ ) | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has_domain`\ (\ domain\: :ref:`StringName`\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`StringName` | :ref:`pseudolocalize`\ (\ message\: :ref:`StringName`\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`reload_pseudolocalization`\ (\ ) | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`remove_domain`\ (\ domain\: :ref:`StringName`\ ) | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`remove_translation`\ (\ translation\: :ref:`Translation`\ ) | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_locale`\ (\ locale\: :ref:`String`\ ) | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`standardize_locale`\ (\ locale\: :ref:`String`, add_defaults\: :ref:`bool` = false\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`StringName` | :ref:`translate`\ (\ message\: :ref:`StringName`, context\: :ref:`StringName` = &""\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`StringName` | :ref:`translate_plural`\ (\ message\: :ref:`StringName`, plural_message\: :ref:`StringName`, n\: :ref:`int`, context\: :ref:`StringName` = &""\ ) |const| | - +---------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`add_translation`\ (\ translation\: :ref:`Translation`\ ) | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear`\ (\ ) | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`compare_locales`\ (\ locale_a\: :ref:`String`, locale_b\: :ref:`String`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Array`\[:ref:`Translation`\] | :ref:`find_translations`\ (\ locale\: :ref:`String`, exact\: :ref:`bool`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`format_number`\ (\ number\: :ref:`String`, locale\: :ref:`String`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`get_all_countries`\ (\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`get_all_languages`\ (\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`get_all_scripts`\ (\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_country_name`\ (\ country\: :ref:`String`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_language_name`\ (\ language\: :ref:`String`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedStringArray` | :ref:`get_loaded_locales`\ (\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_locale`\ (\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_locale_name`\ (\ locale\: :ref:`String`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`TranslationDomain` | :ref:`get_or_add_domain`\ (\ domain\: :ref:`StringName`\ ) | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_percent_sign`\ (\ locale\: :ref:`String`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_plural_rules`\ (\ locale\: :ref:`String`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_script_name`\ (\ script\: :ref:`String`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_tool_locale`\ (\ ) | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Translation` | :ref:`get_translation_object`\ (\ locale\: :ref:`String`\ ) | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Array`\[:ref:`Translation`\] | :ref:`get_translations`\ (\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_domain`\ (\ domain\: :ref:`StringName`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_translation`\ (\ translation\: :ref:`Translation`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`has_translation_for_locale`\ (\ locale\: :ref:`String`, exact\: :ref:`bool`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`parse_number`\ (\ number\: :ref:`String`, locale\: :ref:`String`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`StringName` | :ref:`pseudolocalize`\ (\ message\: :ref:`StringName`\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`reload_pseudolocalization`\ (\ ) | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_domain`\ (\ domain\: :ref:`StringName`\ ) | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`remove_translation`\ (\ translation\: :ref:`Translation`\ ) | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_locale`\ (\ locale\: :ref:`String`\ ) | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`standardize_locale`\ (\ locale\: :ref:`String`, add_defaults\: :ref:`bool` = false\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`StringName` | :ref:`translate`\ (\ message\: :ref:`StringName`, context\: :ref:`StringName` = &""\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`StringName` | :ref:`translate_plural`\ (\ message\: :ref:`StringName`, plural_message\: :ref:`StringName`, n\: :ref:`int`, context\: :ref:`StringName` = &""\ ) |const| | + +--------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -164,6 +180,30 @@ Compara dos configuraciones regionales y devuelve una puntuación de similitud e ---- +.. _class_TranslationServer_method_find_translations: + +.. rst-class:: classref-method + +:ref:`Array`\[:ref:`Translation`\] **find_translations**\ (\ locale\: :ref:`String`, exact\: :ref:`bool`\ ) |const| :ref:`🔗` + +Returns the :ref:`Translation` instances in the main translation domain that match ``locale`` (see :ref:`compare_locales()`). If ``exact`` is ``true``, only instances whose locale exactly equals ``locale`` will be returned. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TranslationServer_method_format_number: + +.. rst-class:: classref-method + +:ref:`String` **format_number**\ (\ number\: :ref:`String`, locale\: :ref:`String`\ ) |const| :ref:`🔗` + +Converts a number from Western Arabic (0..9) to the numeral system used in the given ``locale``. + +.. rst-class:: classref-item-separator + +---- + .. _class_TranslationServer_method_get_all_countries: .. rst-class:: classref-method @@ -274,6 +314,30 @@ Devuelve el dominio de traducción con el nombre especificado. Se creará y agre ---- +.. _class_TranslationServer_method_get_percent_sign: + +.. rst-class:: classref-method + +:ref:`String` **get_percent_sign**\ (\ locale\: :ref:`String`\ ) |const| :ref:`🔗` + +Returns the percent sign used in the given ``locale``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TranslationServer_method_get_plural_rules: + +.. rst-class:: classref-method + +:ref:`String` **get_plural_rules**\ (\ locale\: :ref:`String`\ ) |const| :ref:`🔗` + +Returns the default plural rules for the ``locale``. + +.. rst-class:: classref-item-separator + +---- + .. _class_TranslationServer_method_get_script_name: .. rst-class:: classref-method @@ -306,12 +370,26 @@ Devuelve la configuración regional actual del editor. :ref:`Translation` **get_translation_object**\ (\ locale\: :ref:`String`\ ) :ref:`🔗` +**Obsoleto:** Use :ref:`find_translations()` instead. + Devuelve la instancia de :ref:`Translation` que mejor coincide con ``locale`` en el dominio de traducción principal. Devuelve ``null`` si no hay coincidencias. .. rst-class:: classref-item-separator ---- +.. _class_TranslationServer_method_get_translations: + +.. rst-class:: classref-method + +:ref:`Array`\[:ref:`Translation`\] **get_translations**\ (\ ) |const| :ref:`🔗` + +Returns all available :ref:`Translation` instances in the main translation domain as added by :ref:`add_translation()`. + +.. rst-class:: classref-item-separator + +---- + .. _class_TranslationServer_method_has_domain: .. rst-class:: classref-method @@ -324,6 +402,42 @@ Devuelve ``true`` si existe un dominio de traducción con el nombre especificado ---- +.. _class_TranslationServer_method_has_translation: + +.. rst-class:: classref-method + +:ref:`bool` **has_translation**\ (\ translation\: :ref:`Translation`\ ) |const| :ref:`🔗` + +Returns ``true`` if the main translation domain contains the given ``translation``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TranslationServer_method_has_translation_for_locale: + +.. rst-class:: classref-method + +:ref:`bool` **has_translation_for_locale**\ (\ locale\: :ref:`String`, exact\: :ref:`bool`\ ) |const| :ref:`🔗` + +Returns ``true`` if there are any :ref:`Translation` instances in the main translation domain that match ``locale`` (see :ref:`compare_locales()`). If ``exact`` is ``true``, only instances whose locale exactly equals ``locale`` are considered. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TranslationServer_method_parse_number: + +.. rst-class:: classref-method + +:ref:`String` **parse_number**\ (\ number\: :ref:`String`, locale\: :ref:`String`\ ) |const| :ref:`🔗` + +Converts ``number`` from the numeral system used in the given ``locale`` to Western Arabic (0..9). + +.. rst-class:: classref-item-separator + +---- + .. _class_TranslationServer_method_pseudolocalize: .. rst-class:: classref-method diff --git a/classes/es/class_tree.rst b/classes/es/class_tree.rst index 5896816325..811221fa6c 100644 --- a/classes/es/class_tree.rst +++ b/classes/es/class_tree.rst @@ -59,37 +59,43 @@ Propiedades .. table:: :widths: auto - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`allow_reselect` | ``false`` | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`allow_rmb_select` | ``false`` | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`allow_search` | ``true`` | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`auto_tooltip` | ``true`` | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`bool` | clip_contents | ``true`` (overrides :ref:`Control`) | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`column_titles_visible` | ``false`` | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`int` | :ref:`columns` | ``1`` | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`int` | :ref:`drop_mode_flags` | ``0`` | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`enable_recursive_folding` | ``true`` | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`FocusMode` | focus_mode | ``2`` (overrides :ref:`Control`) | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`hide_folding` | ``false`` | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`hide_root` | ``false`` | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`scroll_horizontal_enabled` | ``true`` | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`scroll_vertical_enabled` | ``true`` | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ - | :ref:`SelectMode` | :ref:`select_mode` | ``0`` | - +------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`allow_reselect` | ``false`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`allow_rmb_select` | ``false`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`allow_search` | ``true`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`auto_tooltip` | ``true`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | clip_contents | ``true`` (overrides :ref:`Control`) | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`column_titles_visible` | ``false`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`int` | :ref:`columns` | ``1`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`int` | :ref:`drop_mode_flags` | ``0`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`enable_drag_unfolding` | ``true`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`enable_recursive_folding` | ``true`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`FocusMode` | focus_mode | ``2`` (overrides :ref:`Control`) | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`hide_folding` | ``false`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`hide_root` | ``false`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`ScrollHintMode` | :ref:`scroll_hint_mode` | ``0`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`scroll_horizontal_enabled` | ``true`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`scroll_vertical_enabled` | ``true`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`SelectMode` | :ref:`select_mode` | ``0`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`tile_scroll_hint` | ``false`` | + +-------------------------------------------------+---------------------------------------------------------------------------------+---------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -124,6 +130,8 @@ Métodos +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_column_title_language`\ (\ column\: :ref:`int`\ ) |const| | +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_column_title_tooltip_text`\ (\ column\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_column_width`\ (\ column\: :ref:`int`\ ) |const| | +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Rect2` | :ref:`get_custom_popup_rect`\ (\ ) |const| | @@ -172,6 +180,8 @@ Métodos +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_column_title_language`\ (\ column\: :ref:`int`, language\: :ref:`String`\ ) | +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_column_title_tooltip_text`\ (\ column\: :ref:`int`, tooltip_text\: :ref:`String`\ ) | + +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_selected`\ (\ item\: :ref:`TreeItem`, column\: :ref:`int`\ ) | +-------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -216,6 +226,8 @@ Propiedades del Tema +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`children_hl_line_width` | ``1`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`int` | :ref:`dragging_unfold_wait_msec` | ``500`` | + +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`draw_guides` | ``1`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`draw_relationship_lines` | ``0`` | @@ -282,6 +294,8 @@ Propiedades del Tema +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Texture2D` | :ref:`indeterminate_disabled` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ + | :ref:`Texture2D` | :ref:`scroll_hint` | | + +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Texture2D` | :ref:`select_arrow` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Texture2D` | :ref:`unchecked` | | @@ -599,6 +613,48 @@ Activa las secciones de caída "por encima del artículo" y "por debajo del art Cuando se combinan con :ref:`DROP_MODE_ON_ITEM`, estas secciones de caída reducen a la mitad la altura y se mantienen en la parte superior / inferior en consecuencia. +.. rst-class:: classref-item-separator + +---- + +.. _enum_Tree_ScrollHintMode: + +.. rst-class:: classref-enumeration + +enum **ScrollHintMode**: :ref:`🔗` + +.. _class_Tree_constant_SCROLL_HINT_MODE_DISABLED: + +.. rst-class:: classref-enumeration-constant + +:ref:`ScrollHintMode` **SCROLL_HINT_MODE_DISABLED** = ``0`` + +Scroll hints will never be shown. + +.. _class_Tree_constant_SCROLL_HINT_MODE_BOTH: + +.. rst-class:: classref-enumeration-constant + +:ref:`ScrollHintMode` **SCROLL_HINT_MODE_BOTH** = ``1`` + +Scroll hints will be shown at the top and bottom. + +.. _class_Tree_constant_SCROLL_HINT_MODE_TOP: + +.. rst-class:: classref-enumeration-constant + +:ref:`ScrollHintMode` **SCROLL_HINT_MODE_TOP** = ``2`` + +Only the top scroll hint will be shown. + +.. _class_Tree_constant_SCROLL_HINT_MODE_BOTTOM: + +.. rst-class:: classref-enumeration-constant + +:ref:`ScrollHintMode` **SCROLL_HINT_MODE_BOTTOM** = ``3`` + +Only the bottom scroll hint will be shown. + .. rst-class:: classref-section-separator ---- @@ -729,6 +785,23 @@ Esto controla las secciones de drop, es decir, la decisión y el dibujo de las p ---- +.. _class_Tree_property_enable_drag_unfolding: + +.. rst-class:: classref-property + +:ref:`bool` **enable_drag_unfolding** = ``true`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_enable_drag_unfolding**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_drag_unfolding_enabled**\ (\ ) + +If ``true``, tree items will unfold when hovered over during a drag-and-drop. The delay for when this happens is dictated by :ref:`dragging_unfold_wait_msec`. + +.. rst-class:: classref-item-separator + +---- + .. _class_Tree_property_enable_recursive_folding: .. rst-class:: classref-property @@ -780,6 +853,23 @@ Si es ``true``, la raíz del árbol está oculta. ---- +.. _class_Tree_property_scroll_hint_mode: + +.. rst-class:: classref-property + +:ref:`ScrollHintMode` **scroll_hint_mode** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_scroll_hint_mode**\ (\ value\: :ref:`ScrollHintMode`\ ) +- :ref:`ScrollHintMode` **get_scroll_hint_mode**\ (\ ) + +The way which scroll hints (indicators that show that the content can still be scrolled in a certain direction) will be shown. + +.. rst-class:: classref-item-separator + +---- + .. _class_Tree_property_scroll_horizontal_enabled: .. rst-class:: classref-property @@ -827,6 +917,23 @@ Si es ``true``, permite el desplazamiento vertical. Permite la selección simple o múltiple. Véase las constantes :ref:`SelectMode`. +.. rst-class:: classref-item-separator + +---- + +.. _class_Tree_property_tile_scroll_hint: + +.. rst-class:: classref-property + +:ref:`bool` **tile_scroll_hint** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_tile_scroll_hint**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_scroll_hint_tiled**\ (\ ) + +If ``true``, the scroll hint texture will be tiled instead of stretched. See :ref:`scroll_hint_mode`. + .. rst-class:: classref-section-separator ---- @@ -992,6 +1099,18 @@ Devuelve el código de idioma del título de la columna. ---- +.. _class_Tree_method_get_column_title_tooltip_text: + +.. rst-class:: classref-method + +:ref:`String` **get_column_title_tooltip_text**\ (\ column\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the column title's tooltip text. + +.. rst-class:: classref-item-separator + +---- + .. _class_Tree_method_get_column_width: .. rst-class:: classref-method @@ -1313,7 +1432,19 @@ Establece la dirección base de escritura del título de la columna. |void| **set_column_title_language**\ (\ column\: :ref:`int`, language\: :ref:`String`\ ) :ref:`🔗` -Establece el código de idioma del título de la columna utilizado para los algoritmos de ajuste de línea y modelado de texto, si se deja vacío se utiliza la configuración regional actual. +Sets the language code of the given ``column``'s title to ``language``. This is used for line-breaking and text shaping algorithms. If ``language`` is empty, the current locale is used. + +.. rst-class:: classref-item-separator + +---- + +.. _class_Tree_method_set_column_title_tooltip_text: + +.. rst-class:: classref-method + +|void| **set_column_title_tooltip_text**\ (\ column\: :ref:`int`, tooltip_text\: :ref:`String`\ ) :ref:`🔗` + +Sets the column title's tooltip text. .. rst-class:: classref-item-separator @@ -1528,6 +1659,18 @@ El ancho de las líneas de relación entre el :ref:`TreeItem` se ---- +.. _class_Tree_theme_constant_dragging_unfold_wait_msec: + +.. rst-class:: classref-themeproperty + +:ref:`int` **dragging_unfold_wait_msec** = ``500`` :ref:`🔗` + +During a drag-and-drop, this is how many milliseconds to wait over a section before the section unfolds. + +.. rst-class:: classref-item-separator + +---- + .. _class_Tree_theme_constant_draw_guides: .. rst-class:: classref-themeproperty @@ -1926,6 +2069,18 @@ El icono de marca que se muestra cuando la celda en modo :ref:`TreeItem.CELL_MOD ---- +.. _class_Tree_theme_icon_scroll_hint: + +.. rst-class:: classref-themeproperty + +:ref:`Texture2D` **scroll_hint** :ref:`🔗` + +The indicator that will be shown when the content can still be scrolled. See :ref:`scroll_hint_mode`. + +.. rst-class:: classref-item-separator + +---- + .. _class_Tree_theme_icon_select_arrow: .. rst-class:: classref-themeproperty diff --git a/classes/es/class_treeitem.rst b/classes/es/class_treeitem.rst index 6e4526aa5a..3c58890ac9 100644 --- a/classes/es/class_treeitem.rst +++ b/classes/es/class_treeitem.rst @@ -99,6 +99,8 @@ Métodos +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_custom_font_size`\ (\ column\: :ref:`int`\ ) |const| | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`StyleBox` | :ref:`get_custom_stylebox`\ (\ column\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_description`\ (\ column\: :ref:`int`\ ) |const| | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`get_expand_right`\ (\ column\: :ref:`int`\ ) |const| | @@ -221,6 +223,8 @@ Métodos +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_custom_font_size`\ (\ column\: :ref:`int`, font_size\: :ref:`int`\ ) | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_custom_stylebox`\ (\ column\: :ref:`int`, stylebox\: :ref:`StyleBox`\ ) | + +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_description`\ (\ column\: :ref:`int`, description\: :ref:`String`\ ) | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_edit_multiline`\ (\ column\: :ref:`int`, multiline\: :ref:`bool`\ ) | @@ -729,6 +733,18 @@ Devuelve el tamaño de fuente personalizado utilizado para dibujar texto en la c ---- +.. _class_TreeItem_method_get_custom_stylebox: + +.. rst-class:: classref-method + +:ref:`StyleBox` **get_custom_stylebox**\ (\ column\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the given column's custom :ref:`StyleBox` used to draw the background. + +.. rst-class:: classref-item-separator + +---- + .. _class_TreeItem_method_get_description: .. rst-class:: classref-method @@ -1413,7 +1429,9 @@ Hace que una celda con :ref:`CELL_MODE_CUSTOM`, color\: :ref:`Color`, just_outline\: :ref:`bool` = false\ ) :ref:`🔗` -Establece el color de fondo personalizado de la columna y si sólo se debe usar como contorno. +Sets the given column's custom background color and whether to just use it as an outline. + +\ **Note:** If a custom :ref:`StyleBox` is set, the background color will be drawn behind it. .. rst-class:: classref-item-separator @@ -1485,6 +1503,20 @@ Establece el tamaño de fuente personalizado utilizado para dibujar texto en la ---- +.. _class_TreeItem_method_set_custom_stylebox: + +.. rst-class:: classref-method + +|void| **set_custom_stylebox**\ (\ column\: :ref:`int`, stylebox\: :ref:`StyleBox`\ ) :ref:`🔗` + +Sets the given column's custom :ref:`StyleBox` used to draw the background. + +\ **Note:** If a custom background color is set, the :ref:`StyleBox` will be drawn in front of it. + +.. rst-class:: classref-item-separator + +---- + .. _class_TreeItem_method_set_description: .. rst-class:: classref-method @@ -1615,7 +1647,7 @@ Si ``indeterminate`` es ``true``, la ``column`` dada se marca como indeterminada |void| **set_language**\ (\ column\: :ref:`int`, language\: :ref:`String`\ ) :ref:`🔗` -Establece el código de idioma del texto del elemento utilizado para los algoritmos de ajuste de línea y modelado de texto, si se deja vacío se utiliza la configuración regional actual. +Sets the language code of the given ``column``'s text to ``language``. This is used for line-breaking and text shaping algorithms. If ``language`` is empty, the current locale is used. .. rst-class:: classref-item-separator diff --git a/classes/es/class_twoboneik3d.rst b/classes/es/class_twoboneik3d.rst new file mode 100644 index 0000000000..66d2a995c8 --- /dev/null +++ b/classes/es/class_twoboneik3d.rst @@ -0,0 +1,486 @@ +:github_url: hide + +.. _class_TwoBoneIK3D: + +TwoBoneIK3D +=========== + +**Hereda:** :ref:`IKModifier3D` **<** :ref:`SkeletonModifier3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` + +Rotation based intersection of two circles inverse kinematics solver. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +This :ref:`IKModifier3D` requires a pole target. It provides deterministic results by constructing a plane from each joint and pole target and finding the intersection of two circles (disks in 3D). + +This IK can handle twist by setting the pole direction. If there are more than one bone between each set bone, their rotations are ignored, and the straight line connecting the root-middle and middle-end joints are treated as virtual bones. + +.. rst-class:: classref-reftable-group + +Propiedades +---------------------- + +.. table:: + :widths: auto + + +-----------------------+----------------------------------------------------------------+-------+ + | :ref:`int` | :ref:`setting_count` | ``0`` | + +-----------------------+----------------------------------------------------------------+-------+ + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_end_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`BoneDirection` | :ref:`get_end_bone_direction`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_end_bone_length`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_end_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_middle_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_middle_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`SecondaryDirection` | :ref:`get_pole_direction`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Vector3` | :ref:`get_pole_direction_vector`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`NodePath` | :ref:`get_pole_node`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_root_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_root_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`NodePath` | :ref:`get_target_node`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_end_bone_extended`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_using_virtual_end`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_direction`\ (\ index\: :ref:`int`, bone_direction\: :ref:`BoneDirection`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_length`\ (\ index\: :ref:`int`, length\: :ref:`float`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_extend_end_bone`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_middle_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_middle_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_pole_direction`\ (\ index\: :ref:`int`, direction\: :ref:`SecondaryDirection`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_pole_direction_vector`\ (\ index\: :ref:`int`, vector\: :ref:`Vector3`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_pole_node`\ (\ index\: :ref:`int`, pole_node\: :ref:`NodePath`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_root_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_root_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_target_node`\ (\ index\: :ref:`int`, target_node\: :ref:`NodePath`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_use_virtual_end`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | + +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Propiedades +-------------------------------------------------------- + +.. _class_TwoBoneIK3D_property_setting_count: + +.. rst-class:: classref-property + +:ref:`int` **setting_count** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_setting_count**\ (\ value\: :ref:`int`\ ) +- :ref:`int` **get_setting_count**\ (\ ) + +El número de configuraciones. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_TwoBoneIK3D_method_get_end_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_end_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the end bone index. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_get_end_bone_direction: + +.. rst-class:: classref-method + +:ref:`BoneDirection` **get_end_bone_direction**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the end bone's tail direction when :ref:`is_end_bone_extended()` is ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_get_end_bone_length: + +.. rst-class:: classref-method + +:ref:`float` **get_end_bone_length**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the end bone tail length of the bone chain when :ref:`is_end_bone_extended()` is ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_get_end_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_end_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the end bone name. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_get_middle_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_middle_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the middle bone index. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_get_middle_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_middle_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the middle bone name. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_get_pole_direction: + +.. rst-class:: classref-method + +:ref:`SecondaryDirection` **get_pole_direction**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the pole direction. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_get_pole_direction_vector: + +.. rst-class:: classref-method + +:ref:`Vector3` **get_pole_direction_vector**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the pole direction vector. + +If :ref:`get_pole_direction()` is :ref:`SkeletonModifier3D.SECONDARY_DIRECTION_NONE`, this method returns ``Vector3(0, 0, 0)``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_get_pole_node: + +.. rst-class:: classref-method + +:ref:`NodePath` **get_pole_node**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the pole target node that constructs a plane which the joints are all on and the pole is trying to direct. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_get_root_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_root_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the root bone index. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_get_root_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_root_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the root bone name. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_get_target_node: + +.. rst-class:: classref-method + +:ref:`NodePath` **get_target_node**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the target node that the end bone is trying to reach. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_is_end_bone_extended: + +.. rst-class:: classref-method + +:ref:`bool` **is_end_bone_extended**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns ``true`` if the end bone is extended to have a tail. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_is_using_virtual_end: + +.. rst-class:: classref-method + +:ref:`bool` **is_using_virtual_end**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns ``true`` if the end bone is extended from the middle bone as a virtual bone. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_set_end_bone: + +.. rst-class:: classref-method + +|void| **set_end_bone**\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) :ref:`🔗` + +Sets the end bone index. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_set_end_bone_direction: + +.. rst-class:: classref-method + +|void| **set_end_bone_direction**\ (\ index\: :ref:`int`, bone_direction\: :ref:`BoneDirection`\ ) :ref:`🔗` + +Sets the end bone tail direction when :ref:`is_end_bone_extended()` is ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_set_end_bone_length: + +.. rst-class:: classref-method + +|void| **set_end_bone_length**\ (\ index\: :ref:`int`, length\: :ref:`float`\ ) :ref:`🔗` + +Sets the end bone tail length when :ref:`is_end_bone_extended()` is ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_set_end_bone_name: + +.. rst-class:: classref-method + +|void| **set_end_bone_name**\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) :ref:`🔗` + +Sets the end bone name. + +\ **Note:** The end bone must be a child of the middle bone. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_set_extend_end_bone: + +.. rst-class:: classref-method + +|void| **set_extend_end_bone**\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) :ref:`🔗` + +If ``enabled`` is ``true``, the end bone is extended to have a tail. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_set_middle_bone: + +.. rst-class:: classref-method + +|void| **set_middle_bone**\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) :ref:`🔗` + +Sets the middle bone index. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_set_middle_bone_name: + +.. rst-class:: classref-method + +|void| **set_middle_bone_name**\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) :ref:`🔗` + +Sets the middle bone name. + +\ **Note:** The middle bone must be a child of the root bone. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_set_pole_direction: + +.. rst-class:: classref-method + +|void| **set_pole_direction**\ (\ index\: :ref:`int`, direction\: :ref:`SecondaryDirection`\ ) :ref:`🔗` + +Sets the pole direction. + +The pole is on the middle bone and will direct to the pole target. + +The rotation axis is a vector that is orthogonal to this and the forward vector. + +\ **Note:** The pole direction and the forward vector shouldn't be colinear to avoid unintended rotation. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_set_pole_direction_vector: + +.. rst-class:: classref-method + +|void| **set_pole_direction_vector**\ (\ index\: :ref:`int`, vector\: :ref:`Vector3`\ ) :ref:`🔗` + +Sets the pole direction vector. + +This vector is normalized by an internal process. + +If the vector length is ``0``, it is considered synonymous with :ref:`SkeletonModifier3D.SECONDARY_DIRECTION_NONE`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_set_pole_node: + +.. rst-class:: classref-method + +|void| **set_pole_node**\ (\ index\: :ref:`int`, pole_node\: :ref:`NodePath`\ ) :ref:`🔗` + +Sets the pole target node that constructs a plane which the joints are all on and the pole is trying to direct. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_set_root_bone: + +.. rst-class:: classref-method + +|void| **set_root_bone**\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) :ref:`🔗` + +Sets the root bone index. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_set_root_bone_name: + +.. rst-class:: classref-method + +|void| **set_root_bone_name**\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) :ref:`🔗` + +Sets the root bone name. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_set_target_node: + +.. rst-class:: classref-method + +|void| **set_target_node**\ (\ index\: :ref:`int`, target_node\: :ref:`NodePath`\ ) :ref:`🔗` + +Sets the target node that the end bone is trying to reach. + +.. rst-class:: classref-item-separator + +---- + +.. _class_TwoBoneIK3D_method_set_use_virtual_end: + +.. rst-class:: classref-method + +|void| **set_use_virtual_end**\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) :ref:`🔗` + +If ``enabled`` is ``true``, the end bone is extended from the middle bone as a virtual bone. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_udsserver.rst b/classes/es/class_udsserver.rst new file mode 100644 index 0000000000..ea34038cc5 --- /dev/null +++ b/classes/es/class_udsserver.rst @@ -0,0 +1,74 @@ +:github_url: hide + +.. _class_UDSServer: + +UDSServer +========= + +**Hereda:** :ref:`SocketServer` **<** :ref:`RefCounted` **<** :ref:`Object` + +A Unix Domain Socket (UDS) server. + +.. rst-class:: classref-introduction-group + +Descripción +---------------------- + +A Unix Domain Socket (UDS) server. Listens to connections on a socket path and returns a :ref:`StreamPeerUDS` when it gets an incoming connection. Unix Domain Sockets provide inter-process communication on the same machine using the filesystem namespace. + +\ **Note:** Unix Domain Sockets are only available on Unix-like systems (Linux, macOS, etc.) and are not supported on Windows. + +.. rst-class:: classref-reftable-group + +Métodos +-------------- + +.. table:: + :widths: auto + + +-------------------------------------------+----------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`listen`\ (\ path\: :ref:`String`\ ) | + +-------------------------------------------+----------------------------------------------------------------------------------------+ + | :ref:`StreamPeerUDS` | :ref:`take_connection`\ (\ ) | + +-------------------------------------------+----------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de Métodos +------------------------------------------------ + +.. _class_UDSServer_method_listen: + +.. rst-class:: classref-method + +:ref:`Error` **listen**\ (\ path\: :ref:`String`\ ) :ref:`🔗` + +Listens on the socket at ``path``. The socket file will be created at the specified path. + +\ **Note:** The socket file must not already exist at the specified path. You may need to remove any existing socket file before calling this method. + +.. rst-class:: classref-item-separator + +---- + +.. _class_UDSServer_method_take_connection: + +.. rst-class:: classref-method + +:ref:`StreamPeerUDS` **take_connection**\ (\ ) :ref:`🔗` + +If a connection is available, returns a StreamPeerUDS with the connection. + +.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` +.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)` +.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)` +.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)` +.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)` +.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)` +.. |void| replace:: :abbr:`void (Sin valor de retorno.)` diff --git a/classes/es/class_vboxcontainer.rst b/classes/es/class_vboxcontainer.rst index b01138c599..c81c286f00 100644 --- a/classes/es/class_vboxcontainer.rst +++ b/classes/es/class_vboxcontainer.rst @@ -7,7 +7,7 @@ VBoxContainer **Hereda:** :ref:`BoxContainer` **<** :ref:`Container` **<** :ref:`Control` **<** :ref:`CanvasItem` **<** :ref:`Node` **<** :ref:`Object` -**Heredado por:** :ref:`ColorPicker`, :ref:`FileSystemDock`, :ref:`ScriptEditorBase` +**Heredado por:** :ref:`ColorPicker`, :ref:`ScriptEditorBase` Un contenedor que organiza sus controles hijo verticalmente. diff --git a/classes/es/class_vector2.rst b/classes/es/class_vector2.rst index 446a11f74a..ab09b11ca5 100644 --- a/classes/es/class_vector2.rst +++ b/classes/es/class_vector2.rst @@ -420,13 +420,13 @@ Devuelve un nuevo vector con todos los componentes en valores absolutos (es deci :ref:`float` **angle**\ (\ ) |const| :ref:`🔗` -Devuelve el ángulo de este vector con respecto al eje X positivo, o vector ``(1, 0)``, en radianes. +Returns this vector's angle with respect to the positive X axis, or ``(1, 0)`` vector, in radians. -Por ejemplo, ``Vector2.RIGHT.angle()`` devolverá cero, ``Vector2.DOWN.angle()`` devolverá ``PI / 2`` (un cuarto de vuelta, o 90 grados), y ``Vector2(1, -1).angle()`` devolverá ``-PI / 4`` (un octavo de vuelta negativo, o -45 grados). +For example, ``Vector2.RIGHT.angle()`` will return zero, ``Vector2.DOWN.angle()`` will return ``PI / 2`` (a quarter turn, or 90 degrees), and ``Vector2(1, -1).angle()`` will return ``-PI / 4`` (a negative eighth turn, or -45 degrees). -\ `Ilustración del ángulo devuelto. `__\ +This is equivalent to calling :ref:`@GlobalScope.atan2()` with :ref:`y` and :ref:`x`. -Equivalente al resultado de :ref:`@GlobalScope.atan2()` cuando se llama con el :ref:`y` e :ref:`x` del vector como parámetros: ``atan2(y, x)``. +\ `Illustration of the returned angle. `__ .. rst-class:: classref-item-separator @@ -438,9 +438,9 @@ Equivalente al resultado de :ref:`@GlobalScope.atan2()` **angle_to**\ (\ to\: :ref:`Vector2`\ ) |const| :ref:`🔗` -Devuelve el ángulo con signo al vector dado, en radianes. +Returns the signed angle to the given vector, in radians. The result ranges from ``-PI`` to ``PI`` (inclusive). -\ `Ilustración del ángulo devuelto. `__ +\ `Illustration of the returned angle. `__ .. rst-class:: classref-item-separator @@ -452,11 +452,11 @@ Devuelve el ángulo con signo al vector dado, en radianes. :ref:`float` **angle_to_point**\ (\ to\: :ref:`Vector2`\ ) |const| :ref:`🔗` -Devuelve el ángulo entre la línea que conecta los dos puntos y el eje X, en radianes. +Returns the signed angle between the X axis and the line from this vector to point ``to``, in radians. The result ranges from ``-PI`` to ``PI`` (inclusive). -\ ``a.angle_to_point(b)`` es equivalente a hacer ``(b - a).angle()``. +\ ``a.angle_to_point(b)`` is equivalent to ``(b - a).angle()``. See also :ref:`angle()`. -\ `Ilustración del ángulo devuelto. `__ +\ `Illustration of the returned angle. `__ .. rst-class:: classref-item-separator @@ -468,7 +468,7 @@ Devuelve el ángulo entre la línea que conecta los dos puntos y el eje X, en ra :ref:`float` **aspect**\ (\ ) |const| :ref:`🔗` -Devuelve la relación de aspecto de este vector, la relación de :ref:`x` a :ref:`y`. +Returns this vector's aspect ratio, which is :ref:`x` divided by :ref:`y`. .. rst-class:: classref-item-separator @@ -596,7 +596,9 @@ Puede realizar una interpolación más suave que :ref:`cubic_interpolate()` **direction_to**\ (\ to\: :ref:`Vector2`\ ) |const| :ref:`🔗` -Devuelve el vector normalizado que apunta desde este vector a ``to``. Esto es equivalente a usar ``(to - self).normalized()``. +Returns the normalized vector pointing from this vector to ``to``. + +\ ``a.direction_to(b)`` is equivalent to ``(b - a).normalized()``. See also :ref:`normalized()`. .. rst-class:: classref-item-separator diff --git a/classes/es/class_vector2i.rst b/classes/es/class_vector2i.rst index a465c53415..24e2674845 100644 --- a/classes/es/class_vector2i.rst +++ b/classes/es/class_vector2i.rst @@ -697,11 +697,11 @@ Divide cada componente de **Vector2i** entre los componentes del **Vector2i** da :ref:`Vector2` **operator /**\ (\ right\: :ref:`float`\ ) :ref:`🔗` -Divide cada componente del **Vector2i** entre el :ref:`float` dado. Devuelve un :ref:`Vector2`. +Divides each component of the **Vector2i** by the given :ref:`float`. Returns a :ref:`Vector2`. :: - print(Vector2i(10, 20) / 2.9) # Imprime (5.0, 10.0) + print(Vector2i(1, 2) / 2.5) # Prints (0.4, 0.8) .. rst-class:: classref-item-separator diff --git a/classes/es/class_vector3i.rst b/classes/es/class_vector3i.rst index 90b493a9da..c0667d9cea 100644 --- a/classes/es/class_vector3i.rst +++ b/classes/es/class_vector3i.rst @@ -721,11 +721,11 @@ Divide cada componente del **Vector3i** por los componentes del **Vector3i** dad :ref:`Vector3` **operator /**\ (\ right\: :ref:`float`\ ) :ref:`🔗` -Divide cada componente del **Vector3i** por el :ref:`float` dado. Devuelve un :ref:`Vector3`. +Divides each component of the **Vector3i** by the given :ref:`float`. Returns a :ref:`Vector3`. :: - print(Vector3i(10, 20, 30) / 2.9) # Imprime (5.0, 10.0, 15.0) + print(Vector3i(1, 2, 3) / 2.5) # Prints (0.4, 0.8, 1.2) .. rst-class:: classref-item-separator diff --git a/classes/es/class_vector4i.rst b/classes/es/class_vector4i.rst index d631877ab4..21cf645121 100644 --- a/classes/es/class_vector4i.rst +++ b/classes/es/class_vector4i.rst @@ -686,13 +686,13 @@ Divide cada componente del **Vector4i** por los componentes del **Vector4i** dad :ref:`Vector4` **operator /**\ (\ right\: :ref:`float`\ ) :ref:`🔗` -Divide cada componente del **Vector4i** por el :ref:`float` dado. +Divides each component of the **Vector4i** by the given :ref:`float`. -Devuelve un valor Vector4 debido a las operaciones de punto flotante. +Returns a Vector4 value due to floating-point operations. :: - print(Vector4i(10, 20, 30, 40) / 2) # Imprime (5.0, 10.0, 15.0, 20.0) + print(Vector4i(1, 2, 3, 4) / 2.5) # Prints (0.4, 0.8, 1.2, 1.6) .. rst-class:: classref-item-separator diff --git a/classes/es/class_videostream.rst b/classes/es/class_videostream.rst index aa8e0f45a7..201d3da0b8 100644 --- a/classes/es/class_videostream.rst +++ b/classes/es/class_videostream.rst @@ -47,9 +47,9 @@ Métodos .. table:: :widths: auto - +-------------------------------------------------------+------------------------------------------------------------------------------------------------------+ - | :ref:`VideoStreamPlayback` | :ref:`_instantiate_playback`\ (\ ) |virtual| | - +-------------------------------------------------------+------------------------------------------------------------------------------------------------------+ + +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------+ + | :ref:`VideoStreamPlayback` | :ref:`_instantiate_playback`\ (\ ) |virtual| |required| | + +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -88,7 +88,7 @@ Descripciones de Métodos .. rst-class:: classref-method -:ref:`VideoStreamPlayback` **_instantiate_playback**\ (\ ) |virtual| :ref:`🔗` +:ref:`VideoStreamPlayback` **_instantiate_playback**\ (\ ) |virtual| |required| :ref:`🔗` Se llama cuando el vídeo comienza a reproducirse, para inicializar y devolver una subclase de :ref:`VideoStreamPlayback`. diff --git a/classes/es/class_viewport.rst b/classes/es/class_viewport.rst index 4bf58ef1ea..b72050b99b 100644 --- a/classes/es/class_viewport.rst +++ b/classes/es/class_viewport.rst @@ -80,6 +80,8 @@ Propiedades +-----------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`gui_disable_input` | ``false`` | +-----------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`gui_drag_threshold` | ``10`` | + +-----------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`gui_embed_subwindows` | ``false`` | +-----------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`gui_snap_controls_to_pixels` | ``true`` | @@ -843,11 +845,13 @@ No hace nada si el :ref:`Environment.sdfgi_enabled` **DEBUG_DRAW_SDFGI_PROBES** = ``17`` -Dibuja las sondas utilizadas para la iluminación global del campo de distancia firmado (SDFGI). +Draws the probes used for signed distance field global illumination (SDFGI). -No hace nada si el :ref:`Environment.sdfgi_enabled` del entorno actual es ``false``. +When in the editor, left-clicking a probe will display additional bright dots that show its occlusion information. A white dot means the light is not occluded at all at the dot's position, while a red dot means the light is fully occluded. Intermediate values are possible. -\ **Nota:** Sólo se admite cuando se utiliza el método de renderizado Forward+. +Does nothing if the current environment's :ref:`Environment.sdfgi_enabled` is ``false``. + +\ **Note:** Only supported when using the Forward+ rendering method. .. _class_Viewport_constant_DEBUG_DRAW_GI_BUFFER: @@ -1286,7 +1290,9 @@ Si es ``true``, el viewport procesará streams de audio en 3D. - |void| **set_canvas_cull_mask**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_canvas_cull_mask**\ (\ ) -Las capas de renderizado en las que este **Viewport** renderiza nodos :ref:`CanvasItem`. +The rendering layers in which this **Viewport** renders :ref:`CanvasItem` nodes. + +\ **Note:** A :ref:`CanvasItem` does not inherit its parents' visibility layers. See :ref:`CanvasItem.visibility_layer`'s description for details. .. rst-class:: classref-item-separator @@ -1303,7 +1309,7 @@ Las capas de renderizado en las que este **Viewport** renderiza nodos :ref:`Canv - |void| **set_default_canvas_item_texture_filter**\ (\ value\: :ref:`DefaultCanvasItemTextureFilter`\ ) - :ref:`DefaultCanvasItemTextureFilter` **get_default_canvas_item_texture_filter**\ (\ ) -Establece el modo de filtro predeterminado que utilizan los :ref:`CanvasItem` en este Viewport. +The default filter mode used by :ref:`CanvasItem` nodes in this viewport. .. rst-class:: classref-item-separator @@ -1320,7 +1326,7 @@ Establece el modo de filtro predeterminado que utilizan los :ref:`CanvasItem`\ ) - :ref:`DefaultCanvasItemTextureRepeat` **get_default_canvas_item_texture_repeat**\ (\ ) -Establece el modo de repetición predeterminado que utilizan los :ref:`CanvasItem` en este Viewport. +The default repeat mode used by :ref:`CanvasItem` nodes in this viewport. .. rst-class:: classref-item-separator @@ -1430,6 +1436,23 @@ Si es ``true``, el viewport no recibirá eventos de entrada. ---- +.. _class_Viewport_property_gui_drag_threshold: + +.. rst-class:: classref-property + +:ref:`int` **gui_drag_threshold** = ``10`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_drag_threshold**\ (\ value\: :ref:`int`\ ) +- :ref:`int` **get_drag_threshold**\ (\ ) + +The minimum distance the mouse cursor must move while pressed before a drag operation begins. + +.. rst-class:: classref-item-separator + +---- + .. _class_Viewport_property_gui_embed_subwindows: .. rst-class:: classref-property @@ -1942,11 +1965,11 @@ If ``true``, the viewport should render its background as transparent. - |void| **set_use_debanding**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_using_debanding**\ (\ ) -Si es ``true``, utiliza un filtro rápido de postprocesamiento para hacer que el banding sea significativamente menos visible. Si :ref:`use_hdr_2d` es ``false``, el renderizado 2D *no* se ve afectado por el debanding a menos que el :ref:`Environment.background_mode` sea :ref:`Environment.BG_CANVAS`. Si :ref:`use_hdr_2d` es ``true``, el debanding solo se aplicará si este es el **Viewport** raíz y afectará a todo el renderizado 2D y 3D, incluidos los elementos del canvas. +When using the Mobile or Forward+ renderers, set :ref:`use_debanding` to enable or disable the debanding feature of this **Viewport**. 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. -En algunos casos, el debanding puede introducir un patrón de dithering ligeramente perceptible. Se recomienda activar el debanding solo cuando sea realmente necesario, ya que el patrón de dithering hará que las capturas de pantalla comprimidas sin pérdida sean más grandes. +\ :ref:`use_debanding` has no effect when using the Compatibility rendering method. The Mobile renderer can also use material debanding, which can be set with :ref:`RenderingServer.material_set_use_debanding()` or configured with :ref:`ProjectSettings.rendering/anti_aliasing/quality/use_debanding`. -Véase también :ref:`ProjectSettings.rendering/anti_aliasing/quality/use_debanding` y :ref:`RenderingServer.viewport_set_use_debanding()`. +See also :ref:`ProjectSettings.rendering/anti_aliasing/quality/use_debanding`, :ref:`RenderingServer.material_set_use_debanding()`, and :ref:`RenderingServer.viewport_set_use_debanding()`. .. rst-class:: classref-item-separator @@ -1963,11 +1986,9 @@ Véase también :ref:`ProjectSettings.rendering/anti_aliasing/quality/use_deband - |void| **set_use_hdr_2d**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_using_hdr_2d**\ (\ ) -Si es ``true``, el renderizado 2D utilizará un framebuffer de formato de alto rango dinámico (HDR) que coincida con la profundidad de bits del framebuffer 3D. Cuando se utiliza el renderizador Forward+ o el de Compatibilidad, este será un framebuffer ``RGBA16``. Cuando se utiliza el renderizador Mobile, será un framebuffer ``RGB10_A2``. +If ``true``, 2D rendering will use a high dynamic range (HDR) ``RGBA16`` format framebuffer. Additionally, 2D rendering will be performed on linear values and will be converted using the appropriate transfer function immediately before blitting to the screen (if the Viewport is attached to the screen). -Además, el renderizado 2D tendrá lugar en el espacio de color lineal y se convertirá al espacio sRGB inmediatamente antes de blittear a la pantalla (si el Viewport está adjunto a la pantalla). - -En la práctica, esto significa que el resultado final del Viewport no se limitará al rango ``0-1`` y se podrá utilizar en el renderizado 3D sin ajustes del espacio de color. Esto permite que el renderizado 2D aproveche los efectos que requieren un alto rango dinámico (por ejemplo, el brillo 2D), así como mejora sustancialmente la apariencia de los efectos que requieren gradientes muy detallados. +Practically speaking, this means that the end result of the Viewport will not be clamped to the ``0-1`` range and can be used in 3D rendering without color encoding adjustments. This allows 2D rendering to take advantage of effects requiring high dynamic range (e.g. 2D glow) as well as substantially improves the appearance of effects requiring highly detailed gradients. .. rst-class:: classref-item-separator @@ -2191,7 +2212,9 @@ Devuelve el oyente de audio 3D activo. Devuelve ``null`` si no hay oyentes de au :ref:`Camera2D` **get_camera_2d**\ (\ ) |const| :ref:`🔗` -Devuelve la cámara 2D actualmente activa. Devuelve ``null`` si no hay cámaras activas. +Returns the currently active 2D camera. Returns ``null`` if there are no active cameras. + +\ **Note:** If called while the *Camera Override* system is active in editor, this will return the internally managed override camera. It is therefore advised to avoid caching the return value, or to check that the cached value is still a valid instance and is the current camera before use. See :ref:`@GlobalScope.is_instance_valid()` and :ref:`Camera2D.is_current()`. .. rst-class:: classref-item-separator @@ -2203,7 +2226,9 @@ Devuelve la cámara 2D actualmente activa. Devuelve ``null`` si no hay cámaras :ref:`Camera3D` **get_camera_3d**\ (\ ) |const| :ref:`🔗` -Devuelve la cámara 3D actualmente activa. +Returns the currently active 3D camera. Returns ``null`` if there are no active cameras. + +\ **Note:** If called while the *Camera Override* system is active in editor, this will return the internally managed override camera. It is therefore advised to avoid caching the return value, or to check that the cached value is a valid instance and is the current camera before use. See :ref:`@GlobalScope.is_instance_valid()` and :ref:`Camera3D.current`. .. rst-class:: classref-item-separator @@ -2327,9 +2352,9 @@ Devuelve la transformación de estiramiento 2D calculada automáticamente, tenie :ref:`ViewportTexture` **get_texture**\ (\ ) |const| :ref:`🔗` -Devuelve la textura del viewport. +Returns the viewport's texture. -\ **Nota:** Al intentar almacenar la textura actual (por ejemplo, en un archivo), puede que esté completamente negra u obsoleta si se utiliza demasiado pronto, especialmente cuando se utiliza, por ejemplo, en :ref:`Node._ready()`. Para asegurarse de que la textura que obtiene es correcta, puede esperar la señal :ref:`RenderingServer.frame_post_draw`. +\ **Note:** When trying to store the current texture (e.g. in a file), it might be completely black or outdated if used too early, especially when used in e.g. :ref:`Node._ready()`. To make sure the texture you get is correct, you can await :ref:`RenderingServer.frame_post_draw` signal. .. tabs:: @@ -2351,7 +2376,7 @@ Devuelve la textura del viewport. -\ **Nota:** Cuando :ref:`use_hdr_2d` es ``true``, la textura devuelta será una imagen HDR codificada en espacio lineal. +\ **Note:** When :ref:`use_hdr_2d` is ``true`` the returned texture will be an HDR image using linear encoding. .. rst-class:: classref-item-separator @@ -2411,7 +2436,7 @@ Devuelve los datos de arrastre de la GUI, que fueron previamente devueltos por : :ref:`String` **gui_get_drag_description**\ (\ ) |const| :ref:`🔗` -Devuelve la descripción legible por humanos de los datos de arrastre. +Returns the human-readable description of the drag data, used for assistive apps. .. rst-class:: classref-item-separator @@ -2487,7 +2512,7 @@ Quita el foco del :ref:`Control` actualmente enfocado dentro de e |void| **gui_set_drag_description**\ (\ description\: :ref:`String`\ ) :ref:`🔗` -Establece la descripción legible por humanos de los datos de arrastre. +Sets the human-readable description of the drag data to ``description``, used for assistive apps. .. rst-class:: classref-item-separator @@ -2629,9 +2654,9 @@ Establece o borra bits individuales en la máscara de la capa de renderizado. Es |void| **set_input_as_handled**\ (\ ) :ref:`🔗` -Impide que la entrada se propague más abajo en el :ref:`SceneTree`. +Stops the input from propagating further up the :ref:`SceneTree`. -\ **Nota:** Esto no afecta a los métodos en :ref:`Input`, sólo a la forma en que se propagan los eventos. +\ **Note:** This does not affect the methods in :ref:`Input`, only the way events are propagated. .. rst-class:: classref-item-separator diff --git a/classes/es/class_viewporttexture.rst b/classes/es/class_viewporttexture.rst index 16b56db7bd..3b5b549c0a 100644 --- a/classes/es/class_viewporttexture.rst +++ b/classes/es/class_viewporttexture.rst @@ -14,22 +14,22 @@ Proporciona el contenido de un :ref:`Viewport` como una textura Descripción ---------------------- -Un **ViewportTexture** proporciona el contenido de un :ref:`Viewport` como una :ref:`Texture2D` dinámica. Esto se puede utilizar para combinar el renderizado de nodos :ref:`Control`, :ref:`Node2D` y :ref:`Node3D`. Por ejemplo, puedes utilizar esta textura para mostrar una escena 3D dentro de un :ref:`TextureRect`, o una superposición 2D en un :ref:`Sprite3D`. +A **ViewportTexture** provides the content of a :ref:`Viewport` as a dynamic :ref:`Texture2D`. This can be used to combine the rendering of :ref:`Control`, :ref:`Node2D` and :ref:`Node3D` nodes. For example, you can use this texture to display a 3D scene inside a :ref:`TextureRect`, or a 2D overlay in a :ref:`Sprite3D`. -Para obtener un **ViewportTexture** en el código, utiliza el método :ref:`Viewport.get_texture()` en el viewport de destino. +To get a **ViewportTexture** in code, use the :ref:`Viewport.get_texture()` method on the target viewport. -\ **Nota:** Un **ViewportTexture** es siempre local a su escena (véase :ref:`Resource.resource_local_to_scene`). Si la raíz de la escena no está lista, puede devolver datos incorrectos (véase :ref:`Node.ready`). +\ **Note:** A **ViewportTexture** is always local to its scene (see :ref:`Resource.resource_local_to_scene`). If the scene root is not ready, it may return incorrect data (see :ref:`Node.ready`). -\ **Nota:** Instanciar escenas que contengan un **ViewportTexture** de alta resolución puede causar tartamudeo notable. +\ **Note:** Instantiating scenes containing a high-resolution **ViewportTexture** may cause noticeable stutter. -\ **Nota:** Cuando se utiliza un :ref:`Viewport` con :ref:`Viewport.use_hdr_2d` establecido en ``true``, la textura devuelta será una imagen HDR codificada en espacio lineal. Esto puede verse más oscuro de lo normal cuando se muestra directamente en la pantalla. Para convertir al espacio gamma, puedes hacer lo siguiente: +\ **Note:** When using a :ref:`Viewport` with :ref:`Viewport.use_hdr_2d` set to ``true``, the returned texture will be an HDR image that uses linear encoding. This may look darker than normal when displayed directly on screen. To convert to nonlinear sRGB encoding, you can do the following: :: img.convert(Image.FORMAT_RGBA8) - imb.linear_to_srgb() + img.linear_to_srgb() -\ **Nota:** Algunos nodos como :ref:`Decal`, :ref:`Light3D` y :ref:`PointLight2D` no soportan el uso de **ViewportTexture** directamente. Para utilizar los datos de textura de un **ViewportTexture** en estos nodos, es necesario crear un :ref:`ImageTexture` llamando a :ref:`Texture2D.get_image()` en el **ViewportTexture** y pasando el resultado a :ref:`ImageTexture.create_from_image()`. Esta conversión es una operación lenta, por lo que no debe realizarse en cada fotograma. +\ **Note:** Some nodes such as :ref:`Decal`, :ref:`Light3D`, and :ref:`PointLight2D` do not support using **ViewportTexture** directly. To use texture data from a **ViewportTexture** in these nodes, you need to create an :ref:`ImageTexture` by calling :ref:`Texture2D.get_image()` on the **ViewportTexture** and passing the result to :ref:`ImageTexture.create_from_image()`. This conversion is a slow operation, so it should not be performed every frame. .. rst-class:: classref-introduction-group diff --git a/classes/es/class_visualinstance3d.rst b/classes/es/class_visualinstance3d.rst index 53731344c9..e0be5d41e1 100644 --- a/classes/es/class_visualinstance3d.rst +++ b/classes/es/class_visualinstance3d.rst @@ -26,13 +26,13 @@ Propiedades .. table:: :widths: auto - +---------------------------+-----------------------------------------------------------------------------------------+---------+ - | :ref:`int` | :ref:`layers` | ``1`` | - +---------------------------+-----------------------------------------------------------------------------------------+---------+ - | :ref:`float` | :ref:`sorting_offset` | ``0.0`` | - +---------------------------+-----------------------------------------------------------------------------------------+---------+ - | :ref:`bool` | :ref:`sorting_use_aabb_center` | | - +---------------------------+-----------------------------------------------------------------------------------------+---------+ + +---------------------------+-----------------------------------------------------------------------------------------+-------+ + | :ref:`int` | :ref:`layers` | ``1`` | + +---------------------------+-----------------------------------------------------------------------------------------+-------+ + | :ref:`float` | :ref:`sorting_offset` | | + +---------------------------+-----------------------------------------------------------------------------------------+-------+ + | :ref:`bool` | :ref:`sorting_use_aabb_center` | | + +---------------------------+-----------------------------------------------------------------------------------------+-------+ .. rst-class:: classref-reftable-group @@ -96,7 +96,7 @@ Para ajustar :ref:`layers` más fácilme .. rst-class:: classref-property -:ref:`float` **sorting_offset** = ``0.0`` :ref:`🔗` +:ref:`float` **sorting_offset** :ref:`🔗` .. rst-class:: classref-property-setget diff --git a/classes/es/class_visualshadernodecolorfunc.rst b/classes/es/class_visualshadernodecolorfunc.rst index b9dbfa39bc..34a7d5e198 100644 --- a/classes/es/class_visualshadernodecolorfunc.rst +++ b/classes/es/class_visualshadernodecolorfunc.rst @@ -97,7 +97,7 @@ Aplica el efecto de tono sepia usando la siguiente fórmula: :ref:`Function` **FUNC_LINEAR_TO_SRGB** = ``4`` -Convierte el color del espacio de color lineal al espacio de color sRGB usando la siguiente fórmula: +Converts color from linear encoding to nonlinear sRGB encoding using the following formula: :: @@ -105,7 +105,7 @@ Convierte el color del espacio de color lineal al espacio de color sRGB usando l const vec3 a = vec3(0.055f); return mix((vec3(1.0f) + a) * pow(c.rgb, vec3(1.0f / 2.4f)) - a, 12.92f * c.rgb, lessThan(c.rgb, vec3(0.0031308f))); -El renderizador de compatibilidad utiliza una fórmula más simple: +The Compatibility renderer uses a simpler formula: :: @@ -118,14 +118,14 @@ El renderizador de compatibilidad utiliza una fórmula más simple: :ref:`Function` **FUNC_SRGB_TO_LINEAR** = ``5`` -Convierte el color del espacio de color sRGB al espacio de color lineal usando la siguiente fórmula: +Converts color from nonlinear sRGB encoding to linear encoding using the following formula: :: vec3 c = input; return mix(pow((c.rgb + vec3(0.055)) * (1.0 / (1.0 + 0.055)), vec3(2.4)), c.rgb * (1.0 / 12.92), lessThan(c.rgb, vec3(0.04045))); -El renderizador de compatibilidad utiliza una fórmula más simple: +The Compatibility renderer uses a simpler formula: :: diff --git a/classes/es/class_visualshadernodecubemap.rst b/classes/es/class_visualshadernodecubemap.rst index 13a98721b2..d00c4d3f7c 100644 --- a/classes/es/class_visualshadernodecubemap.rst +++ b/classes/es/class_visualshadernodecubemap.rst @@ -95,7 +95,7 @@ No se añade ninguna sugerencia a la declaración del uniforme. :ref:`TextureType` **TYPE_COLOR** = ``1`` -Añade ``source_color`` como pista a la declaración uniforme para una conversión correcta de sRGB a lineal. +Adds ``source_color`` as hint to the uniform declaration for proper conversion from nonlinear sRGB encoding to linear encoding. .. _class_VisualShaderNodeCubemap_constant_TYPE_NORMAL_MAP: diff --git a/classes/es/class_visualshadernodecustom.rst b/classes/es/class_visualshadernodecustom.rst index 3a4dd297b1..b9353bcde7 100644 --- a/classes/es/class_visualshadernodecustom.rst +++ b/classes/es/class_visualshadernodecustom.rst @@ -394,9 +394,9 @@ Definir este método es **opcional**. Si no se sobrescribe, es ``true``. :ref:`bool` **_is_highend**\ (\ ) |virtual| |const| :ref:`🔗` -Sobrescribe este método para habilitar la marca de gama alta en el diálogo de miembros del Editor de Shaders Visuales. +Override this method to enable the high-end mark in the Visual Shader Editor's members dialog. This should return ``true`` for nodes that only work when using the Forward+ and Mobile renderers. -Definir este método es **opcional**. Si no se sobrescribe, es ``false``. +Defining this method is **optional**. If not overridden, it's ``false``, which indicates this node works with all renderers (including Compatibility). .. rst-class:: classref-item-separator diff --git a/classes/es/class_visualshadernodeparameter.rst b/classes/es/class_visualshadernodeparameter.rst index d7787a859b..b02a9ac0d4 100644 --- a/classes/es/class_visualshadernodeparameter.rst +++ b/classes/es/class_visualshadernodeparameter.rst @@ -26,6 +26,8 @@ Propiedades .. table:: :widths: auto + +------------------------------------------------------------+--------------------------------------------------------------------------------+--------+ + | :ref:`int` | :ref:`instance_index` | ``0`` | +------------------------------------------------------------+--------------------------------------------------------------------------------+--------+ | :ref:`String` | :ref:`parameter_name` | ``""`` | +------------------------------------------------------------+--------------------------------------------------------------------------------+--------+ @@ -71,11 +73,19 @@ El parámetro usará un valor global, definido en la Configuración del proyecto El parámetro se vinculará al nodo con :ref:`ShaderMaterial` adjunto usando este shader. +.. _class_VisualShaderNodeParameter_constant_QUAL_INSTANCE_INDEX: + +.. rst-class:: classref-enumeration-constant + +:ref:`Qualifier` **QUAL_INSTANCE_INDEX** = ``3`` + +The parameter will be tied to the node with attached :ref:`ShaderMaterial` using this shader. Enables setting a :ref:`instance_index` property. + .. _class_VisualShaderNodeParameter_constant_QUAL_MAX: .. rst-class:: classref-enumeration-constant -:ref:`Qualifier` **QUAL_MAX** = ``3`` +:ref:`Qualifier` **QUAL_MAX** = ``4`` Representa el tamaño del enum :ref:`Qualifier`. @@ -88,6 +98,23 @@ Representa el tamaño del enum :ref:`Qualifier` **instance_index** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_instance_index**\ (\ value\: :ref:`int`\ ) +- :ref:`int` **get_instance_index**\ (\ ) + +The index within 0-15 range, which is used to avoid clashes when shader used on multiple materials. + +.. rst-class:: classref-item-separator + +---- + .. _class_VisualShaderNodeParameter_property_parameter_name: .. rst-class:: classref-property diff --git a/classes/es/class_visualshadernodetexture.rst b/classes/es/class_visualshadernodetexture.rst index eed5d16505..35b85017eb 100644 --- a/classes/es/class_visualshadernodetexture.rst +++ b/classes/es/class_visualshadernodetexture.rst @@ -143,7 +143,7 @@ No se añade ninguna sugerencia a la declaración del uniforme. :ref:`TextureType` **TYPE_COLOR** = ``1`` -Añade ``source_color`` como pista a la declaración uniforme para una conversión correcta de sRGB a lineal. +Adds ``source_color`` as hint to the uniform declaration for proper conversion from nonlinear sRGB encoding to linear encoding. .. _class_VisualShaderNodeTexture_constant_TYPE_NORMAL_MAP: diff --git a/classes/es/class_visualshadernodetextureparameter.rst b/classes/es/class_visualshadernodetextureparameter.rst index d0cd1b5d8a..291da5c072 100644 --- a/classes/es/class_visualshadernodetextureparameter.rst +++ b/classes/es/class_visualshadernodetextureparameter.rst @@ -67,7 +67,7 @@ No se añade ninguna sugerencia a la declaración del uniforme. :ref:`TextureType` **TYPE_COLOR** = ``1`` -Añade ``source_color`` como pista a la declaración uniforme para una conversión correcta de sRGB a lineal. +Adds ``source_color`` as hint to the uniform declaration for proper conversion from nonlinear sRGB encoding to linear encoding. .. _class_VisualShaderNodeTextureParameter_constant_TYPE_NORMAL_MAP: diff --git a/classes/es/class_voxelgi.rst b/classes/es/class_voxelgi.rst index 49f644368c..87c2f43022 100644 --- a/classes/es/class_voxelgi.rst +++ b/classes/es/class_voxelgi.rst @@ -174,9 +174,9 @@ El recurso :ref:`VoxelGIData` que contiene los datos para est - |void| **set_size**\ (\ value\: :ref:`Vector3`\ ) - :ref:`Vector3` **get_size**\ (\ ) -El tamaño del área cubierta por el **VoxelGI**. Si aumentas el tamaño sin aumentar las subdivisiones con :ref:`subdiv`, el tamaño de cada celda aumentará y resultará en una iluminación menos detallada. +The size of the area covered by the **VoxelGI**. This must be ``1.0`` or greater on each axis. -\ **Nota:** El tamaño se limita a 1.0 unidad o más en cada eje. +\ **Note:** If you make the size larger without increasing the number of subdivisions with :ref:`subdiv`, the size of each cell will increase and result in less detailed lighting. .. rst-class:: classref-item-separator diff --git a/classes/es/class_vscrollbar.rst b/classes/es/class_vscrollbar.rst index 41da7b4e62..abd2808a97 100644 --- a/classes/es/class_vscrollbar.rst +++ b/classes/es/class_vscrollbar.rst @@ -30,6 +30,53 @@ Propiedades | |bitfield|\[:ref:`SizeFlags`\] | size_flags_vertical | ``1`` (overrides :ref:`Control`) | +--------------------------------------------------------+-----------------------+--------------------------------------------------------------------------------+ +.. rst-class:: classref-reftable-group + +Propiedades del Tema +---------------------------------------- + +.. table:: + :widths: auto + + +-----------------------+---------------------------------------------------------------------+-------+ + | :ref:`int` | :ref:`padding_left` | ``0`` | + +-----------------------+---------------------------------------------------------------------+-------+ + | :ref:`int` | :ref:`padding_right` | ``0`` | + +-----------------------+---------------------------------------------------------------------+-------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descripciones de las propiedades del tema +---------------------------------------------------------------------------------- + +.. _class_VScrollBar_theme_constant_padding_left: + +.. rst-class:: classref-themeproperty + +:ref:`int` **padding_left** = ``0`` :ref:`🔗` + +Padding between the left of the :ref:`ScrollBar.scroll` element and the :ref:`ScrollBar.grabber`. + +\ **Note:** To apply vertical padding, modify the top/bottom content margins of :ref:`ScrollBar.scroll` instead. + +.. rst-class:: classref-item-separator + +---- + +.. _class_VScrollBar_theme_constant_padding_right: + +.. rst-class:: classref-themeproperty + +:ref:`int` **padding_right** = ``0`` :ref:`🔗` + +Padding between the right of the :ref:`ScrollBar.scroll` element and the :ref:`ScrollBar.grabber`. + +\ **Note:** To apply vertical padding, modify the top/bottom content margins of :ref:`ScrollBar.scroll` instead. + .. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)` diff --git a/classes/es/class_webrtcpeerconnection.rst b/classes/es/class_webrtcpeerconnection.rst index a9094ec6f1..f1f5c11f2c 100644 --- a/classes/es/class_webrtcpeerconnection.rst +++ b/classes/es/class_webrtcpeerconnection.rst @@ -16,17 +16,26 @@ Interfaz a una conexión de pares WebRTC. Descripción ---------------------- -Una conexión WebRTC entre el equipo local y un par remoto. Proporciona una interfaz para conectar, mantener y monitorizar la conexión. +A WebRTC connection between the local computer and a remote peer. Provides an interface to connect, maintain, and monitor the connection. -Configurar una conexión WebRTC entre dos pares puede no parecer una tarea trivial, pero puede dividirse en 3 pasos principales: +Setting up a WebRTC connection between two peers may not seem a trivial task, but it can be broken down into 3 main steps: -- El par que quiere iniciar la conexión (``A`` a partir de ahora) crea una oferta y la envía al otro par (``B`` a partir de ahora). +- The peer that wants to initiate the connection (``A`` from now on) creates an offer and sends it to the other peer (``B`` from now on). -- ``B`` recibe la oferta, la genera y responde, y la envía a ``A``). +- ``B`` receives the offer, generates an answer, and sends it to ``A``. -- ``A`` y ``B`` generan e intercambian candidatos ICE entre sí. +- ``A`` and ``B`` then generate and exchange ICE candidates with each other. -Después de estos pasos, la conexión debería establecerse. Sigue leyendo o consulta el tutorial para obtener más información. +After these steps, the connection should be established. Refer to the linked tutorials for details. + +.. rst-class:: classref-introduction-group + +Tutoriales +-------------------- + +- :doc:`WebRTC documentation <../tutorials/networking/webrtc>` + +- :doc:`Multijugador de alto nivel <../tutorials/networking/high_level_multiplayer>` .. rst-class:: classref-reftable-group diff --git a/classes/es/class_websocketpeer.rst b/classes/es/class_websocketpeer.rst index 789a333c4d..fced40cc03 100644 --- a/classes/es/class_websocketpeer.rst +++ b/classes/es/class_websocketpeer.rst @@ -14,11 +14,11 @@ Una conexión WebSocket. Descripción ---------------------- -Esta clase representa una conexión WebSocket, y puede ser usada como un cliente WebSocket (compatible con RFC 6455) o como un par remoto de un servidor WebSocket. +This class represents WebSocket connection, and can be used as a WebSocket client (`RFC 6455 `__-compliant) or as a remote peer of a WebSocket server. -Puedes enviar tramas binarias de WebSocket usando :ref:`PacketPeer.put_packet()`, y tramas de texto de WebSocket usando :ref:`send()` (prefiere tramas de texto cuando interactúes con una API basada en texto). Puedes verificar el tipo de trama del último paquete a través de :ref:`was_string_packet()`. +You can send WebSocket binary frames using :ref:`PacketPeer.put_packet()`, and WebSocket text frames using :ref:`send()` (prefer text frames when interacting with text-based API). You can check the frame type of the last packet via :ref:`was_string_packet()`. -Para iniciar un cliente WebSocket, primero llama a :ref:`connect_to_url()`, luego llama regularmente a :ref:`poll()` (p. ej. durante el proceso de :ref:`Node`). Puedes consultar el estado del socket a través de :ref:`get_ready_state()`, obtener el número de paquetes pendientes usando :ref:`PacketPeer.get_available_packet_count()`, y recuperarlos a través de :ref:`PacketPeer.get_packet()`. +To start a WebSocket client, first call :ref:`connect_to_url()`, then regularly call :ref:`poll()` (e.g. during :ref:`Node` process). You can query the socket state via :ref:`get_ready_state()`, get the number of pending packets using :ref:`PacketPeer.get_available_packet_count()`, and retrieve them via :ref:`PacketPeer.get_packet()`. .. tabs:: @@ -30,26 +30,26 @@ Para iniciar un cliente WebSocket, primero llama a :ref:`connect_to_url()` y el tutorial en línea. +To use the peer as part of a WebSocket server refer to :ref:`accept_stream()` and the online tutorial. .. rst-class:: classref-reftable-group @@ -332,11 +332,15 @@ Acepta una conexión de par que realiza el establecimiento de comunicación HTTP |void| **close**\ (\ code\: :ref:`int` = 1000, reason\: :ref:`String` = ""\ ) :ref:`🔗` -Cierra esta conexión WebSocket. ``code`` es el código de estado para el cierre (ver la sección 7.4 del RFC 6455 para obtener una lista de códigos de estado válidos). ``reason`` es la razón legible por humanos para cerrar la conexión (puede ser cualquier cadena UTF-8 que tenga menos de 123 bytes). Si ``code`` es negativo, la conexión se cerrará inmediatamente sin notificar al par remoto. +Closes this WebSocket connection. -\ **Nota:** Para lograr un cierre limpio, deberá seguir sonedeando hasta que se alcance :ref:`STATE_CLOSED`. +\ ``code`` is the status code for the closure (see `RFC 6455 section 7.4 `__ for a list of valid status codes). If ``code`` is negative, the connection will be closed immediately without notifying the remote peer. -\ **Nota:** Es posible que la exportación Web no admita todos los códigos de estado. Consulta la documentación específica del navegador para obtener más detalles. +\ ``reason`` is the human-readable reason for closing the connection. It can be any UTF-8 string that's smaller than 123 bytes. + +\ **Note:** To achieve a clean closure, you will need to keep polling until :ref:`STATE_CLOSED` is reached. + +\ **Note:** The Web export might not support all status codes. Please refer to browser-specific documentation for more details. .. rst-class:: classref-item-separator diff --git a/classes/es/class_window.rst b/classes/es/class_window.rst index 6bb0b1b404..379fffa21f 100644 --- a/classes/es/class_window.rst +++ b/classes/es/class_window.rst @@ -77,6 +77,8 @@ Propiedades +-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+ | :ref:`PackedVector2Array` | :ref:`mouse_passthrough_polygon` | ``PackedVector2Array()`` | +-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+ + | :ref:`Rect2i` | :ref:`nonclient_area` | ``Rect2i(0, 0, 0, 0)`` | + +-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+ | :ref:`bool` | :ref:`popup_window` | ``false`` | +-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+ | :ref:`bool` | :ref:`popup_wm_hint` | ``false`` | @@ -435,6 +437,18 @@ Emitida cuando el cursor del ratón sale del área visible de la **Window**, que ---- +.. _class_Window_signal_nonclient_window_input: + +.. rst-class:: classref-signal + +**nonclient_window_input**\ (\ event\: :ref:`InputEvent`\ ) :ref:`🔗` + +Emitted when the mouse event is received by the custom decoration area defined by :ref:`nonclient_area`, and normal input to the window is blocked (such as when it has an exclusive child opened). ``event``'s position is in the embedder's coordinate system. + +.. rst-class:: classref-item-separator + +---- + .. _class_Window_signal_theme_changed: .. rst-class:: classref-signal @@ -1471,6 +1485,23 @@ Pasar un array vacío desactivará el soporte de paso (todos los eventos del rat ---- +.. _class_Window_property_nonclient_area: + +.. rst-class:: classref-property + +:ref:`Rect2i` **nonclient_area** = ``Rect2i(0, 0, 0, 0)`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_nonclient_area**\ (\ value\: :ref:`Rect2i`\ ) +- :ref:`Rect2i` **get_nonclient_area**\ (\ ) + +If set, defines the window's custom decoration area which will receive mouse input, even if normal input to the window is blocked (such as when it has an exclusive child opened). See also :ref:`nonclient_window_input`. + +.. rst-class:: classref-item-separator + +---- + .. _class_Window_property_popup_window: .. rst-class:: classref-property @@ -2367,7 +2398,7 @@ Devuelve ``true`` si el sobremuestreo de fuentes está habilitado. Véase :ref:` |void| **move_to_center**\ (\ ) :ref:`🔗` -Centra una ventana nativa en la pantalla actual y una ventana incrustada en su :ref:`Viewport` incrustado. +Centers the window in the current screen. If the window is embedded, it is centered in the embedder :ref:`Viewport` instead. .. rst-class:: classref-item-separator diff --git a/classes/es/class_xrinterfaceextension.rst b/classes/es/class_xrinterfaceextension.rst index 1f56217285..6970c1630b 100644 --- a/classes/es/class_xrinterfaceextension.rst +++ b/classes/es/class_xrinterfaceextension.rst @@ -302,7 +302,7 @@ Devuelve un :ref:`Dictionary` con información del sistema rel :ref:`TrackingStatus` **_get_tracking_status**\ (\ ) |virtual| |const| :ref:`🔗` -Devuelve un :ref:`TrackingStatus` que especifica el estado actual de nuestro seguimiento. +Returns the current status of our tracking. .. rst-class:: classref-item-separator diff --git a/classes/es/class_xrpositionaltracker.rst b/classes/es/class_xrpositionaltracker.rst index c053899f96..eaccfedd8e 100644 --- a/classes/es/class_xrpositionaltracker.rst +++ b/classes/es/class_xrpositionaltracker.rst @@ -7,7 +7,7 @@ XRPositionalTracker **Hereda:** :ref:`XRTracker` **<** :ref:`RefCounted` **<** :ref:`Object` -**Heredado por:** :ref:`XRBodyTracker`, :ref:`XRControllerTracker`, :ref:`XRHandTracker` +**Heredado por:** :ref:`OpenXRSpatialEntityTracker`, :ref:`XRBodyTracker`, :ref:`XRControllerTracker`, :ref:`XRHandTracker` Un objeto rastreado. diff --git a/classes/es/index.rst b/classes/es/index.rst index af1eca5fd7..3578cfa062 100644 --- a/classes/es/index.rst +++ b/classes/es/index.rst @@ -3,7 +3,7 @@ .. DO NOT EDIT THIS FILE!!! .. Generated automatically from Godot engine sources. -.. Generator: https://github.com/godotengine/godot/tree/4.5/doc/tools/make_rst.py. +.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py. .. _doc_class_reference: @@ -50,6 +50,7 @@ Nodos class_bone2d class_boneattachment3d class_boneconstraint3d + class_bonetwistdisperser3d class_boxcontainer class_button class_camera2d @@ -58,7 +59,9 @@ Nodos class_canvasitem class_canvaslayer class_canvasmodulate + class_ccdik3d class_centercontainer + class_chainik3d class_characterbody2d class_characterbody3d class_checkbox @@ -95,6 +98,7 @@ Nodos class_directionallight2d class_directionallight3d class_editorcommandpalette + class_editordock class_editorfiledialog class_editorfilesystem class_editorinspector @@ -105,6 +109,7 @@ Nodos class_editorscriptpicker class_editorspinslider class_editortoaster + class_fabrik3d class_filedialog class_filesystemdock class_flowcontainer @@ -139,9 +144,12 @@ Nodos class_hslider class_hsplitcontainer class_httprequest + class_ikmodifier3d class_importermeshinstance3d class_instanceplaceholder class_itemlist + class_iterateik3d + class_jacobianik3d class_joint2d class_joint3d class_label @@ -151,6 +159,7 @@ Nodos class_lightmapgi class_lightmapprobe class_lightoccluder2d + class_limitangularvelocitymodifier3d class_line2d class_lineedit class_linkbutton @@ -245,6 +254,7 @@ Nodos class_sliderjoint3d class_softbody3d class_spinbox + class_splineik3d class_splitcontainer class_spotlight3d class_springarm3d @@ -272,6 +282,7 @@ Nodos class_timer class_touchscreenbutton class_tree + class_twoboneik3d class_vboxcontainer class_vehiclebody3d class_vehiclewheel3d @@ -478,6 +489,8 @@ Recursos class_inputeventscreentouch class_inputeventshortcut class_inputeventwithmodifiers + class_jointlimitation3d + class_jointlimitationcone3d class_json class_labelsettings class_lightmapgidata @@ -809,6 +822,7 @@ Otros objetos class_geometry2d class_geometry3d class_gltfobjectmodelproperty + class_godotinstance class_hashingcontext class_hmaccontext class_httpclient @@ -849,19 +863,53 @@ Otros objetos class_navigationpathqueryresult2d class_navigationpathqueryresult3d class_navigationserver2d + class_navigationserver2dmanager class_navigationserver3d + class_navigationserver3dmanager class_node class_node3dgizmo class_offlinemultiplayerpeer class_oggpacketsequenceplayback + class_openxranchortracker + class_openxrandroidthreadsettingsextension class_openxrapiextension class_openxrextensionwrapper class_openxrextensionwrapperextension + class_openxrframesynthesisextension class_openxrfutureextension class_openxrfutureresult class_openxrinteractionprofilemetadata class_openxrinterface + class_openxrmarkertracker + class_openxrplanetracker class_openxrrendermodelextension + class_openxrspatialanchorcapability + class_openxrspatialcapabilityconfigurationanchor + class_openxrspatialcapabilityconfigurationapriltag + class_openxrspatialcapabilityconfigurationaruco + class_openxrspatialcapabilityconfigurationbaseheader + class_openxrspatialcapabilityconfigurationmicroqrcode + class_openxrspatialcapabilityconfigurationplanetracking + class_openxrspatialcapabilityconfigurationqrcode + class_openxrspatialcomponentanchorlist + class_openxrspatialcomponentbounded2dlist + class_openxrspatialcomponentbounded3dlist + class_openxrspatialcomponentdata + class_openxrspatialcomponentmarkerlist + class_openxrspatialcomponentmesh2dlist + class_openxrspatialcomponentmesh3dlist + class_openxrspatialcomponentparentlist + class_openxrspatialcomponentpersistencelist + class_openxrspatialcomponentplanealignmentlist + class_openxrspatialcomponentplanesemanticlabellist + class_openxrspatialcomponentpolygon2dlist + class_openxrspatialcontextpersistenceconfig + class_openxrspatialentityextension + class_openxrspatialentitytracker + class_openxrspatialmarkertrackingcapability + class_openxrspatialplanetrackingcapability + class_openxrspatialqueryresultdata + class_openxrstructurebase class_os class_packeddatacontainerref class_packetpeer @@ -961,12 +1009,15 @@ Otros objetos class_semaphore class_shaderincludedb class_skinreference + class_socketserver class_streampeer class_streampeerbuffer class_streampeerextension class_streampeergzip + class_streampeersocket class_streampeertcp class_streampeertls + class_streampeeruds class_subtweentweener class_surfacetool class_tcpserver @@ -990,6 +1041,7 @@ Otros objetos class_tween class_tweener class_udpserver + class_udsserver class_undoredo class_uniformsetcacherd class_upnp @@ -1030,6 +1082,7 @@ Solo para el Editor class_editorcontextmenuplugin class_editordebuggerplugin class_editordebuggersession + class_editordock class_editorexportplatform class_editorexportplatformandroid class_editorexportplatformappleembedded diff --git a/classes/fr/class_@gdscript.rst b/classes/fr/class_@gdscript.rst index 389bcd97da..fc092386d8 100644 --- a/classes/fr/class_@gdscript.rst +++ b/classes/fr/class_@gdscript.rst @@ -116,6 +116,8 @@ L'infini positif représenté en virgule flottante. C'est le résultat d'un nomb ---- +.. rst-class:: classref-descriptions-group + Annotations ----------- @@ -624,16 +626,17 @@ Voir aussi :ref:`@GlobalScope.PROPERTY_USAGE_GROUP` +**@export_multiline**\ (\ hint\: :ref:`String` = "", ...\ ) |vararg| :ref:`🔗` -Exporte une propriété :ref:`String`, :ref:`Array`\ \[:ref:`String`\ \], :ref:`PackedStringArray`, :ref:`Dictionary` ou :ref:`Array`\ \[:ref:`Dictionary`\ \] avec un widget :ref:`TextEdit` large à la place d'un :ref:`LineEdit`. Cela ajoute du support pour un contenu multi-ligne et rend plus facile l'édition de beaucoup de texte stocké dans la propriété. +Export a :ref:`String`, :ref:`Array`\ \[:ref:`String`\ \], :ref:`PackedStringArray`, :ref:`Dictionary` or :ref:`Array`\ \[:ref:`Dictionary`\ \] property with a large :ref:`TextEdit` widget instead of a :ref:`LineEdit`. This adds support for multiline content and makes it easier to edit large amount of text stored in the property. -Voir également :ref:`@GlobalScope.PROPERTY_HINT_MULTILINE_TEXT`. +See also :ref:`@GlobalScope.PROPERTY_HINT_MULTILINE_TEXT`. :: @export_multiline var character_biography @export_multiline var npc_dialogs: Array[String] + @export_multiline("monospace", "no_wrap") var favorite_ascii_art: String .. rst-class:: classref-item-separator @@ -685,13 +688,13 @@ Voir également :ref:`@GlobalScope.PROPERTY_HINT_PLACEHOLDER_TEXT`, max\: :ref:`float`, step\: :ref:`float` = 1.0, extra_hints\: :ref:`String` = "", ...\ ) |vararg| :ref:`🔗` -Exporte une propriété :ref:`int`, :ref:`float`, :ref:`Array`\ \[:ref:`int`\ \], :ref:`Array`\ \[:ref:`float`\ \], :ref:`PackedByteArray`, :ref:`PackedInt32Array`, :ref:`PackedInt64Array`, :ref:`PackedFloat32Array`, ou :ref:`PackedFloat64Array` en tant que valeur de plage. La plage doit être définie par ``min`` et ``max``, ainsi qu'un pas ``step`` facultatif et une variété d'indices supplémentaires. Le pas ``step`` est par défaut ``1`` pour les propriétés entières. Pour les nombres à virgule flottante, cette valeur dépend de votre paramètre :ref:`EditorSettings.interface/inspector/default_float_step`. +Export an :ref:`int`, :ref:`float`, :ref:`Array`\ \[:ref:`int`\ \], :ref:`Array`\ \[:ref:`float`\ \], :ref:`PackedByteArray`, :ref:`PackedInt32Array`, :ref:`PackedInt64Array`, :ref:`PackedFloat32Array`, or :ref:`PackedFloat64Array` property as a range value. The range must be defined by ``min`` and ``max``, as well as an optional ``step`` and a variety of extra hints. The ``step`` defaults to ``1`` for integer properties. For floating-point numbers this value depends on your :ref:`EditorSettings.interface/inspector/default_float_step` setting. -Si les indices ``"or_greater"`` et ``"or_less"`` sont fournis, le widget de l'éditeur ne plafonnera pas la valeur aux limites de la plage. L'indice ``"exp"`` fera en sorte que les valeurs modifiées sur la plage changent de manière exponentielle. L'indice ``"hide_slider"`` masquera l'élément slider du widget de l'éditeur. +If hints ``"or_greater"`` and ``"or_less"`` are provided, the editor widget will not cap the value at range boundaries. The ``"exp"`` hint will make the edited values on range to change exponentially. The ``"prefer_slider"`` hint will make integer values use the slider instead of arrows for editing, while ``"hide_control"`` will hide the element controlling the value of the editor widget. -Des indices permettent également d'indiquer les unités de la valeur modifiée. En utilisant ``"radians_as_degrees"``, vous pouvez spécifier que la valeur réelle est en radians, mais doit être affichée en degrés dans le dock Inspecteur (les valeurs de plage sont également en degrés). ``"degrees"`` permet d'ajouter un signe de degré comme suffixe d'unité (la valeur est inchangée). Enfin, un suffixe personnalisé peut être fourni en utilisant ``"suffix:unit"``, où "unit" peut être n'importe quelle chaîne. +Hints also allow to indicate the units for the edited value. Using ``"radians_as_degrees"`` you can specify that the actual value is in radians, but should be displayed in degrees in the Inspector dock (the range values are also in degrees). ``"degrees"`` allows to add a degree sign as a unit suffix (the value is unchanged). Finally, a custom suffix can be provided using ``"suffix:unit"``, where "unit" can be any string. -Voir également :ref:`@GlobalScope.PROPERTY_HINT_RANGE`. +See also :ref:`@GlobalScope.PROPERTY_HINT_RANGE`. :: diff --git a/classes/fr/class_@globalscope.rst b/classes/fr/class_@globalscope.rst index 35c66cc2eb..80bdd85eab 100644 --- a/classes/fr/class_@globalscope.rst +++ b/classes/fr/class_@globalscope.rst @@ -37,81 +37,85 @@ Propriétés .. table:: :widths: auto - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`AudioServer` | :ref:`AudioServer` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`CameraServer` | :ref:`CameraServer` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`ClassDB` | :ref:`ClassDB` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`DisplayServer` | :ref:`DisplayServer` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`EditorInterface` | :ref:`EditorInterface` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`Engine` | :ref:`Engine` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`EngineDebugger` | :ref:`EngineDebugger` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`GDExtensionManager` | :ref:`GDExtensionManager` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`Geometry2D` | :ref:`Geometry2D` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`Geometry3D` | :ref:`Geometry3D` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`IP` | :ref:`IP` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`Input` | :ref:`Input` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`InputMap` | :ref:`InputMap` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`JavaClassWrapper` | :ref:`JavaClassWrapper` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`JavaScriptBridge` | :ref:`JavaScriptBridge` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`Marshalls` | :ref:`Marshalls` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`NativeMenu` | :ref:`NativeMenu` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`NavigationMeshGenerator` | :ref:`NavigationMeshGenerator` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`NavigationServer2D` | :ref:`NavigationServer2D` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`NavigationServer3D` | :ref:`NavigationServer3D` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`OS` | :ref:`OS` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`Performance` | :ref:`Performance` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`PhysicsServer2D` | :ref:`PhysicsServer2D` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`PhysicsServer2DManager` | :ref:`PhysicsServer2DManager` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`PhysicsServer3D` | :ref:`PhysicsServer3D` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`PhysicsServer3DManager` | :ref:`PhysicsServer3DManager` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`ProjectSettings` | :ref:`ProjectSettings` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`RenderingServer` | :ref:`RenderingServer` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`ResourceLoader` | :ref:`ResourceLoader` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`ResourceSaver` | :ref:`ResourceSaver` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`ResourceUID` | :ref:`ResourceUID` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`TextServerManager` | :ref:`TextServerManager` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`ThemeDB` | :ref:`ThemeDB` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`Time` | :ref:`Time` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`TranslationServer` | :ref:`TranslationServer` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`WorkerThreadPool` | :ref:`WorkerThreadPool` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ - | :ref:`XRServer` | :ref:`XRServer` | - +---------------------------------------------------------------+-------------------------------------------------------------------------------------+ + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`AudioServer` | :ref:`AudioServer` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`CameraServer` | :ref:`CameraServer` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`ClassDB` | :ref:`ClassDB` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`DisplayServer` | :ref:`DisplayServer` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`EditorInterface` | :ref:`EditorInterface` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`Engine` | :ref:`Engine` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`EngineDebugger` | :ref:`EngineDebugger` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`GDExtensionManager` | :ref:`GDExtensionManager` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`Geometry2D` | :ref:`Geometry2D` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`Geometry3D` | :ref:`Geometry3D` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`IP` | :ref:`IP` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`Input` | :ref:`Input` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`InputMap` | :ref:`InputMap` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`JavaClassWrapper` | :ref:`JavaClassWrapper` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`JavaScriptBridge` | :ref:`JavaScriptBridge` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`Marshalls` | :ref:`Marshalls` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`NativeMenu` | :ref:`NativeMenu` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`NavigationMeshGenerator` | :ref:`NavigationMeshGenerator` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`NavigationServer2D` | :ref:`NavigationServer2D` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`NavigationServer2DManager` | :ref:`NavigationServer2DManager` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`NavigationServer3D` | :ref:`NavigationServer3D` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`NavigationServer3DManager` | :ref:`NavigationServer3DManager` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`OS` | :ref:`OS` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`Performance` | :ref:`Performance` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`PhysicsServer2D` | :ref:`PhysicsServer2D` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`PhysicsServer2DManager` | :ref:`PhysicsServer2DManager` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`PhysicsServer3D` | :ref:`PhysicsServer3D` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`PhysicsServer3DManager` | :ref:`PhysicsServer3DManager` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`ProjectSettings` | :ref:`ProjectSettings` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`RenderingServer` | :ref:`RenderingServer` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`ResourceLoader` | :ref:`ResourceLoader` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`ResourceSaver` | :ref:`ResourceSaver` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`ResourceUID` | :ref:`ResourceUID` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`TextServerManager` | :ref:`TextServerManager` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`ThemeDB` | :ref:`ThemeDB` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`Time` | :ref:`Time` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`TranslationServer` | :ref:`TranslationServer` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`WorkerThreadPool` | :ref:`WorkerThreadPool` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ + | :ref:`XRServer` | :ref:`XRServer` | + +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group @@ -3464,11 +3468,11 @@ La propriété n'a aucun indice pour l'éditeur. :ref:`PropertyHint` **PROPERTY_HINT_RANGE** = ``1`` -Indique qu'une propriété :ref:`int` ou :ref:`float` doit être dans un intervalle spécifié via la chaîne d'indice ``"min,max"`` ou ``"min,max,step"``. La chaîne d'indice peut en option inclure ``"or_greater"`` et/ou ``"or_less"`` pour permettre une entrée manuelle allant respectivement au-dessus ou en dessous des valeurs maximales et minimales. +Hints that an :ref:`int` or :ref:`float` property should be within a range specified via the hint string ``"min,max"`` or ``"min,max,step"``. The hint string can optionally include ``"or_greater"`` and/or ``"or_less"`` to allow manual input going respectively above the max or below the min values. -\ **Exemple :** ``"-360,360,1,or_greater,or_less"``. +\ **Example:** ``"-360,360,1,or_greater,or_less"``. -De plus, d'autres mots-clés peuvent être inclus : ``"exp"`` pour l'édition d'un intervalle exponentiel, ``"radians_as_degrees"`` pour l'édition des angles radians en degrés (les valeurs de l'intervalle sont également en degrés), ``"degrees"`` pour indiquer un angle et ``"hide_slider"`` pour cacher le slider. +Additionally, other keywords can be included: ``"exp"`` for exponential range editing, ``"radians_as_degrees"`` for editing radian angles in degrees (the range values are also in degrees), ``"degrees"`` to hint at an angle, ``"prefer_slider"`` to show the slider for integers, ``"hide_control"`` to hide the slider or up-down arrows, and ``"suffix:px/s"`` to display a suffix indicating the value's unit (e.g. ``px/s`` for pixels per second). .. _class_@GlobalScope_constant_PROPERTY_HINT_ENUM: @@ -3476,9 +3480,9 @@ De plus, d'autres mots-clés peuvent être inclus : ``"exp"`` pour l'édition d :ref:`PropertyHint` **PROPERTY_HINT_ENUM** = ``2`` -Indique qu'une propriété d'un entier :ref:`int` ou une chaine de caractères :ref:`String` est une valeur d'énumération à choisir dans une liste spécifiée par une chaîne d'indice. +Hints that an :ref:`int`, :ref:`String`, or :ref:`StringName` property is an enumerated value to pick in a list specified via a hint string. -Cette chaîne d'indice est une liste séparée par des virgules de noms tels que ``"Bonjour,Salut,Autre"``. Les espace **ne sont pas ** supprimés du début ou de la fin d'un nom. Pour les propriétés d'entiers, le premier nom de la liste a valeur 0, le suivant 1, et ainsi de suite. Des valeurs explicites peuvent également être spécifiées en ajoutant ``:integer`` au nom, par ex. ``"Zéro,Un,Trois:3,Quatre,Six:6"``. +The hint string is a comma separated list of names such as ``"Hello,Something,Else"``. Whitespace is **not** removed from either end of a name. For integer properties, the first name in the list has value 0, the next 1, and so on. Explicit values can also be specified by appending ``:integer`` to the name, e.g. ``"Zero,One,Three:3,Four,Six:6"``. .. _class_@GlobalScope_constant_PROPERTY_HINT_ENUM_SUGGESTION: @@ -3486,9 +3490,9 @@ Cette chaîne d'indice est une liste séparée par des virgules de noms tels que :ref:`PropertyHint` **PROPERTY_HINT_ENUM_SUGGESTION** = ``3`` -Indique qu'une propriété :ref:`String` peut être une valeur d'énumération parmi une liste spécifiée via une chaîne de caractères d'indice telle que ``"Bonjour,Salut,Autre"``. +Hints that a :ref:`String` or :ref:`StringName` property can be an enumerated value to pick in a list specified via a hint string such as ``"Hello,Something,Else"``. See :ref:`PROPERTY_HINT_ENUM` for details. -Contrairement à :ref:`PROPERTY_HINT_ENUM`, une propriété avec cette indice accepte toujours des valeurs arbitraires et peut être vide. La liste des valeurs permet donc de suggérer des valeurs possibles. +Unlike :ref:`PROPERTY_HINT_ENUM`, a property with this hint still accepts arbitrary values and can be empty. The list of values serves to suggest possible values. .. _class_@GlobalScope_constant_PROPERTY_HINT_EXP_EASING: @@ -3512,13 +3516,13 @@ Indique qu'une propriété vectorielle devrait permettre à ses composants d'êt :ref:`PropertyHint` **PROPERTY_HINT_FLAGS** = ``6`` -Indique qu'une propriété :ref:`int` est un maque de bits avec des drapeaux bits nommés. +Hints that an :ref:`int` property is a bitmask with named bit flags. -La chaîne d'indice est une liste de noms séparée par des virgules tels que ``"Bit0,Bit1,Bit2,Bit3"``. Les espaces blancs **ne sont pas ** retirés de chaque extrémité d'un nom. Le premier nom de la liste a la valeur 1, le 2 suivant, puis 4, 8, 16 et ainsi de suite. Des valeurs explicites peuvent également être spécifiées en ajoutant ``:integer`` au nom, par exemple ``"A:4,B:8,C:16"``. Vous pouvez également combiner plusieurs drapeaux (``"A:4,B:8,AB:12,C:16"``). +The hint string is a comma separated list of names such as ``"Bit0,Bit1,Bit2,Bit3"``. Whitespace is **not** removed from either end of a name. The first name in the list has value 1, the next 2, then 4, 8, 16 and so on. Explicit values can also be specified by appending ``:integer`` to the name, e.g. ``"A:4,B:8,C:16"``. You can also combine several flags (``"A:4,B:8,AB:12,C:16"``). -\ **Note :** Une valeur de drapeau doit être au moins ``1`` et au plus ``2 ** 32 - 1``. +\ **Note:** A flag value must be at least ``1`` and at most ``2 ** 32 - 1``. -\ **Note :** Contrairement à :ref:`PROPERTY_HINT_ENUM`, la valeur explicite précédente n'est pas prise en compte. Pour l'indice ``"A:16,B,C"``, A est 16, B est 2, C est 4. +\ **Note:** Unlike :ref:`PROPERTY_HINT_ENUM`, the previous explicit value is not taken into account. For the hint ``"A:16,B,C"``, A is 16, B is 2, C is 4. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_2D_RENDER: @@ -3622,7 +3626,11 @@ Indice que la propriété est une instance d'un type dérivé de :ref:`Resource< :ref:`PropertyHint` **PROPERTY_HINT_MULTILINE_TEXT** = ``18`` -Indique qu'une propriété chaîne de caractères :ref:`String` est du texte avec des sauts de ligne. L'éditer affichera une zone de saisie de texte où des sauts de ligne peuvent être tapés. +Hints that a :ref:`String` property is text with line breaks. Editing it will show a text input field where line breaks can be typed. + +The hint string can be set to ``"monospace"`` to force the input field to use a monospaced font. + +If the hint string ``"no_wrap"`` is set, the input field will not wrap lines at boundaries, instead resorting to making the area scrollable. .. _class_@GlobalScope_constant_PROPERTY_HINT_EXPRESSION: @@ -4076,7 +4084,23 @@ Si la propriété a ``nil`` comme valeur par défaut, son type sera :ref:`Varian :ref:`PropertyUsageFlags` **PROPERTY_USAGE_ARRAY** = ``262144`` -La propriété est un tableau. +The property is the element count of a property array, i.e. a list of groups of related properties. Properties defined with this usage also need a specific ``class_name`` field in the form of ``label,prefix``. The field may also include additional comma-separated options: + +- ``page_size=N``: Overrides :ref:`EditorSettings.interface/inspector/max_array_dictionary_items_per_page` for this array. + +- ``add_button_text=text``: The text displayed by the "Add Element" button. + +- ``static``: The elements can't be re-arranged. + +- ``const``: New elements can't be added. + +- ``numbered``: An index will appear next to each element. + +- ``unfoldable``: The array can't be folded. + +- ``swap_method=method_name``: The method that will be called when two elements switch places. The method should take 2 :ref:`int` parameters, which will be indices of the elements being swapped. + +Note that making a full-fledged property array requires boilerplate code involving :ref:`Object._get_property_list()`. .. _class_@GlobalScope_constant_PROPERTY_USAGE_ALWAYS_DUPLICATE: @@ -5059,6 +5083,18 @@ Le singleton :ref:`NavigationServer2D`. ---- +.. _class_@GlobalScope_property_NavigationServer2DManager: + +.. rst-class:: classref-property + +:ref:`NavigationServer2DManager` **NavigationServer2DManager** :ref:`🔗` + +The :ref:`NavigationServer2DManager` singleton. + +.. rst-class:: classref-item-separator + +---- + .. _class_@GlobalScope_property_NavigationServer3D: .. rst-class:: classref-property @@ -5071,6 +5107,18 @@ Le singleton :ref:`NavigationServer3D`. ---- +.. _class_@GlobalScope_property_NavigationServer3DManager: + +.. rst-class:: classref-property + +:ref:`NavigationServer3DManager` **NavigationServer3DManager** :ref:`🔗` + +The :ref:`NavigationServer3DManager` singleton. + +.. rst-class:: classref-item-separator + +---- + .. _class_@GlobalScope_property_OS: .. rst-class:: classref-property @@ -5966,31 +6014,31 @@ Renvoie le hachage entier de la ``variable`` passée. :ref:`Object` **instance_from_id**\ (\ instance_id\: :ref:`int`\ ) :ref:`🔗` -Renvoie l'objet :ref:`Object` correspondant à l'``instance_id``. Tous les Objects ont un identifiant d'instance unique. Voir aussi :ref:`Object.get_instance_id()`. +Returns the :ref:`Object` that corresponds to ``instance_id``. All Objects have a unique instance ID. See also :ref:`Object.get_instance_id()`. .. tabs:: .. code-tab:: gdscript - var boisson= "eau" + var drink = "water" func _ready(): var id = get_instance_id() var instance = instance_from_id(id) - print(instance.foo) # Affiche "eau" + print(instance.drink) # Prints "water" .. code-tab:: csharp - public partial class MonNoeud : Node + public partial class MyNode : Node { - public string Boisson { get; set; } = "eau"; + public string Drink { get; set; } = "water"; public override void _Ready() { ulong id = GetInstanceId(); - var instance = (MonNoeud)InstanceFromId(Id); - GD.Print(instance.Boisson); // Affiche "eau" + var instance = (MyNode)InstanceFromId(Id); + GD.Print(instance.Drink); // Prints "water" } } @@ -7390,19 +7438,19 @@ Voir aussi :ref:`typeof()`. :ref:`int` **typeof**\ (\ variable\: :ref:`Variant`\ ) :ref:`🔗` -Renvoie le type interne de la ``variable`` donnée, en utilisant la valeur de :ref:`Variant.Type`. +Returns the internal type of the given ``variable``, using the :ref:`Variant.Type` values. :: var json = JSON.new() json.parse('["a", "b", "c"]') var result = json.get_data() - if result is Array: - print(result[0]) # Affiche a + if typeof(result) == TYPE_ARRAY: + print(result[0]) # Prints "a" else: - print("Résultat inattendu !") + print("Unexpected result!") -Voir aussi :ref:`type_string()`. +See also :ref:`type_string()`. .. rst-class:: classref-item-separator diff --git a/classes/fr/class_acceptdialog.rst b/classes/fr/class_acceptdialog.rst index 296de41ecb..139b4233ad 100644 --- a/classes/fr/class_acceptdialog.rst +++ b/classes/fr/class_acceptdialog.rst @@ -16,7 +16,9 @@ Une boîte de dialogue de base utilisée pour la notification des utilisateurs. Description ----------- -L'utilisation par défaut d'**AcceptDialog** est de lui permettre d'être seulement accepté ou fermé, avec le même résultat. Cependant, les signaux :ref:`confirmed` et :ref:`canceled` permettent de rendre les deux actions différentes, et la méthode :ref:`add_button()` permet d'ajouter des boutons et des actions personnalisés. +The default use of **AcceptDialog** is to allow it to only be accepted or closed, with the same result. However, the :ref:`confirmed` and :ref:`canceled` signals allow to make the two actions different, and the :ref:`add_button()` method allows to add custom buttons and actions. + +\ **Note:** **AcceptDialog** is invisible by default. To make it visible, call one of the ``popup_*`` methods from :ref:`Window` on the node, such as :ref:`Window.popup_centered_clamped()`. .. rst-class:: classref-reftable-group @@ -172,7 +174,7 @@ Défini le retour à la ligne automatique du texte dans la fenêtre de dialogue. - |void| **set_close_on_escape**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **get_close_on_escape**\ (\ ) -Si ``true``, la boîte de dialogue sera cachée lorsque l'action ``ui_cancel`` est pressée (par défaut, cette action est liée à :ref:`@GlobalScope.KEY_ESCAPE`). +If ``true``, the dialog will be hidden when the ``ui_close_dialog`` action is pressed (by default, this action is bound to :kbd:`Escape`, or :kbd:`Cmd + W` on macOS). .. rst-class:: classref-item-separator diff --git a/classes/fr/class_aescontext.rst b/classes/fr/class_aescontext.rst index 06a27d698e..5838e4700e 100644 --- a/classes/fr/class_aescontext.rst +++ b/classes/fr/class_aescontext.rst @@ -146,7 +146,7 @@ Mode de décryptage du codebook électronique AES. :ref:`Mode` **MODE_CBC_ENCRYPT** = ``2`` -Mode de cryptage de chiffre de chaînage de blocs AES. +AES cipher block chaining encryption mode. .. _class_AESContext_constant_MODE_CBC_DECRYPT: @@ -154,7 +154,7 @@ Mode de cryptage de chiffre de chaînage de blocs AES. :ref:`Mode` **MODE_CBC_DECRYPT** = ``3`` -Mode de décryptage de chiffre de chaînage de blocs AES. +AES cipher block chaining decryption mode. .. _class_AESContext_constant_MODE_MAX: diff --git a/classes/fr/class_aimmodifier3d.rst b/classes/fr/class_aimmodifier3d.rst index b0da456783..3f40b38ee8 100644 --- a/classes/fr/class_aimmodifier3d.rst +++ b/classes/fr/class_aimmodifier3d.rst @@ -43,6 +43,8 @@ Méthodes +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Axis` | :ref:`get_primary_rotation_axis`\ (\ index\: :ref:`int`\ ) |const| | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_relative`\ (\ index\: :ref:`int`\ ) |const| | + +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_using_euler`\ (\ index\: :ref:`int`\ ) |const| | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_using_secondary_rotation`\ (\ index\: :ref:`int`\ ) |const| | @@ -51,6 +53,8 @@ Méthodes +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_primary_rotation_axis`\ (\ index\: :ref:`int`, axis\: :ref:`Axis`\ ) | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_relative`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | + +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_use_euler`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_use_secondary_rotation`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | @@ -111,6 +115,18 @@ Renvoie l'axe de la première rotation. Il est activé seulement si :ref:`is_usi ---- +.. _class_AimModifier3D_method_is_relative: + +.. rst-class:: classref-method + +:ref:`bool` **is_relative**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie ``true`` si l'option Relative est activée dans le paramètre à l'index ``index``. + +.. rst-class:: classref-item-separator + +---- + .. _class_AimModifier3D_method_is_using_euler: .. rst-class:: classref-method @@ -159,6 +175,22 @@ Définit l'axe de la première rotation. C'est activé seulement si :ref:`is_usi ---- +.. _class_AimModifier3D_method_set_relative: + +.. rst-class:: classref-method + +|void| **set_relative**\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) :ref:`🔗` + +Sets relative option in the setting at ``index`` to ``enabled``. + +If sets ``enabled`` to ``true``, the rotation is applied relative to the pose. + +If sets ``enabled`` to ``false``, the rotation is applied relative to the rest. It means to replace the current pose with the **AimModifier3D**'s result. + +.. rst-class:: classref-item-separator + +---- + .. _class_AimModifier3D_method_set_use_euler: .. rst-class:: classref-method diff --git a/classes/fr/class_animationnodeoneshot.rst b/classes/fr/class_animationnodeoneshot.rst index 087332de74..7780d69444 100644 --- a/classes/fr/class_animationnodeoneshot.rst +++ b/classes/fr/class_animationnodeoneshot.rst @@ -84,6 +84,8 @@ Propriétés .. table:: :widths: auto + +---------------------------------------------------+-----------------------------------------------------------------------------------------------+-----------+ + | :ref:`bool` | :ref:`abort_on_reset` | ``false`` | +---------------------------------------------------+-----------------------------------------------------------------------------------------------+-----------+ | :ref:`bool` | :ref:`autorestart` | ``false`` | +---------------------------------------------------+-----------------------------------------------------------------------------------------------+-----------+ @@ -186,6 +188,23 @@ Mélange deux animations additivement. Voir aussi :ref:`AnimationNodeAdd2` **abort_on_reset** = ``false`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_abort_on_reset**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **is_aborted_on_reset**\ (\ ) + +If ``true``, the sub-animation will abort if resumed with a reset after a prior interruption. + +.. rst-class:: classref-item-separator + +---- + .. _class_AnimationNodeOneShot_property_autorestart: .. rst-class:: classref-property diff --git a/classes/fr/class_animationnodestatemachineplayback.rst b/classes/fr/class_animationnodestatemachineplayback.rst index 9314659ac6..da337e224c 100644 --- a/classes/fr/class_animationnodestatemachineplayback.rst +++ b/classes/fr/class_animationnodestatemachineplayback.rst @@ -65,8 +65,16 @@ Méthodes +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_current_play_position`\ (\ ) |const| | +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_fading_from_length`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`StringName` | :ref:`get_fading_from_node`\ (\ ) |const| | +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_fading_from_play_position`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_fading_length`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_fading_position`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Array`\[:ref:`StringName`\] | :ref:`get_travel_path`\ (\ ) |const| | +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_playing`\ (\ ) |const| | @@ -160,6 +168,18 @@ Renvoie la position de lecture pour l'état actuel de l'animation. ---- +.. _class_AnimationNodeStateMachinePlayback_method_get_fading_from_length: + +.. rst-class:: classref-method + +:ref:`float` **get_fading_from_length**\ (\ ) |const| :ref:`🔗` + +Returns the playback state length of the node from :ref:`get_fading_from_node()`. Returns ``0`` if no animation fade is occurring. + +.. rst-class:: classref-item-separator + +---- + .. _class_AnimationNodeStateMachinePlayback_method_get_fading_from_node: .. rst-class:: classref-method @@ -172,6 +192,42 @@ Renvoie l'état de départ de l'animation en cours de fondu. ---- +.. _class_AnimationNodeStateMachinePlayback_method_get_fading_from_play_position: + +.. rst-class:: classref-method + +:ref:`float` **get_fading_from_play_position**\ (\ ) |const| :ref:`🔗` + +Returns the playback position of the node from :ref:`get_fading_from_node()`. Returns ``0`` if no animation fade is occurring. + +.. rst-class:: classref-item-separator + +---- + +.. _class_AnimationNodeStateMachinePlayback_method_get_fading_length: + +.. rst-class:: classref-method + +:ref:`float` **get_fading_length**\ (\ ) |const| :ref:`🔗` + +Returns the length of the current fade animation. Returns ``0`` if no animation fade is occurring. + +.. rst-class:: classref-item-separator + +---- + +.. _class_AnimationNodeStateMachinePlayback_method_get_fading_position: + +.. rst-class:: classref-method + +:ref:`float` **get_fading_position**\ (\ ) |const| :ref:`🔗` + +Returns the playback position of the current fade animation. Returns ``0`` if no animation fade is occurring. + +.. rst-class:: classref-item-separator + +---- + .. _class_AnimationNodeStateMachinePlayback_method_get_travel_path: .. rst-class:: classref-method diff --git a/classes/fr/class_animationplayer.rst b/classes/fr/class_animationplayer.rst index 3c0dde99b1..e8c92ca24d 100644 --- a/classes/fr/class_animationplayer.rst +++ b/classes/fr/class_animationplayer.rst @@ -42,11 +42,11 @@ Propriétés :widths: auto +--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------+-----------+ - | :ref:`String` | :ref:`assigned_animation` | | + | :ref:`StringName` | :ref:`assigned_animation` | | +--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------+-----------+ - | :ref:`String` | :ref:`autoplay` | ``""`` | + | :ref:`StringName` | :ref:`autoplay` | ``&""`` | +--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------+-----------+ - | :ref:`String` | :ref:`current_animation` | ``""`` | + | :ref:`StringName` | :ref:`current_animation` | ``&""`` | +--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------+-----------+ | :ref:`float` | :ref:`current_animation_length` | | +--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------+-----------+ @@ -90,7 +90,7 @@ Méthodes +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`AnimationProcessCallback` | :ref:`get_process_callback`\ (\ ) |const| | +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`PackedStringArray` | :ref:`get_queue`\ (\ ) | + | :ref:`Array`\[:ref:`StringName`\] | :ref:`get_queue`\ (\ ) | +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`NodePath` | :ref:`get_root`\ (\ ) |const| | +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -100,6 +100,8 @@ Méthodes +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_section`\ (\ ) |const| | +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_animation_active`\ (\ ) |const| | + +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_playing`\ (\ ) |const| | +--------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`pause`\ (\ ) | @@ -166,7 +168,7 @@ Signaux .. rst-class:: classref-signal -**current_animation_changed**\ (\ name\: :ref:`String`\ ) :ref:`🔗` +**current_animation_changed**\ (\ name\: :ref:`StringName`\ ) :ref:`🔗` Émis lorsque :ref:`current_animation` change. @@ -258,12 +260,12 @@ Descriptions des propriétés .. rst-class:: classref-property -:ref:`String` **assigned_animation** :ref:`🔗` +:ref:`StringName` **assigned_animation** :ref:`🔗` .. rst-class:: classref-property-setget -- |void| **set_assigned_animation**\ (\ value\: :ref:`String`\ ) -- :ref:`String` **get_assigned_animation**\ (\ ) +- |void| **set_assigned_animation**\ (\ value\: :ref:`StringName`\ ) +- :ref:`StringName` **get_assigned_animation**\ (\ ) Si en lecture, la clé de l'animation actuelle, sinon, la dernière animation jouée. Lorsque cela est défini, cela change l'animation, mais ne le jouera pas à moins de jouer déjà. Voir aussi :ref:`current_animation`. @@ -275,12 +277,12 @@ Si en lecture, la clé de l'animation actuelle, sinon, la dernière animation jo .. rst-class:: classref-property -:ref:`String` **autoplay** = ``""`` :ref:`🔗` +:ref:`StringName` **autoplay** = ``&""`` :ref:`🔗` .. rst-class:: classref-property-setget -- |void| **set_autoplay**\ (\ value\: :ref:`String`\ ) -- :ref:`String` **get_autoplay**\ (\ ) +- |void| **set_autoplay**\ (\ value\: :ref:`StringName`\ ) +- :ref:`StringName` **get_autoplay**\ (\ ) La clé d'animation à jouer quand la scène est chargée. @@ -292,12 +294,12 @@ La clé d'animation à jouer quand la scène est chargée. .. rst-class:: classref-property -:ref:`String` **current_animation** = ``""`` :ref:`🔗` +:ref:`StringName` **current_animation** = ``&""`` :ref:`🔗` .. rst-class:: classref-property-setget -- |void| **set_current_animation**\ (\ value\: :ref:`String`\ ) -- :ref:`String` **get_current_animation**\ (\ ) +- |void| **set_current_animation**\ (\ value\: :ref:`StringName`\ ) +- :ref:`StringName` **get_current_animation**\ (\ ) La clé de l'animation en cours de lecture. Si aucune animation ne joue, la valeur de la propriété est une chaîne vide. Changer cette valeur ne redémarre pas l'animation. Voir :ref:`play()` pour plus d'informations sur la lecture d'animations. @@ -565,7 +567,7 @@ Renvoie la notification de traitement dans laquelle mettre à jour les animation .. rst-class:: classref-method -:ref:`PackedStringArray` **get_queue**\ (\ ) :ref:`🔗` +:ref:`Array`\[:ref:`StringName`\] **get_queue**\ (\ ) :ref:`🔗` Renvoie une liste de clés d'animation qui sont actuellement dans la file pour jouer. @@ -623,6 +625,25 @@ Renvoie ``true`` si une animation joue actuellement avec une section. ---- +.. _class_AnimationPlayer_method_is_animation_active: + +.. rst-class:: classref-method + +:ref:`bool` **is_animation_active**\ (\ ) |const| :ref:`🔗` + +Returns ``true`` if the an animation is currently active. An animation is active if it was played by calling :ref:`play()` and was not finished yet, or was stopped by calling :ref:`stop()`. + +This can be used to check whether an animation is currently paused or stopped. + +:: + + var is_paused = not is_playing() and is_animation_active() + var is_stopped = not is_playing() and not is_animation_active() + +.. rst-class:: classref-item-separator + +---- + .. _class_AnimationPlayer_method_is_playing: .. rst-class:: classref-method diff --git a/classes/fr/class_array.rst b/classes/fr/class_array.rst index ec8432e383..91d1f4046d 100644 --- a/classes/fr/class_array.rst +++ b/classes/fr/class_array.rst @@ -680,9 +680,9 @@ Si ``deep`` vaut ``true``, une copie **profonde** est renvoyée : tous les tabl :ref:`Array` **duplicate_deep**\ (\ deep_subresources_mode\: :ref:`int` = 1\ ) |const| :ref:`🔗` -Duplique ce tableau, profondément, comme :ref:`duplicate()`\ ``(true)``, avec du contrôle supplémentaire sur la façon dont les sous-ressources sont gérées. +Duplicates this array, deeply, like :ref:`duplicate()` when passing ``true``, with extra control over how subresources are handled. -\ ``deep_subresources_mode`` doit être l'une des valeurs de :ref:`DeepDuplicateMode`. Par défaut, seules les ressources internes seront dupliquées (récursivement). +\ ``deep_subresources_mode`` must be one of the values from :ref:`DeepDuplicateMode`. By default, only internal resources will be duplicated (recursively). .. rst-class:: classref-item-separator @@ -831,9 +831,9 @@ Renvoie le premier élément du tableau. Si le tableau est vide, échoue et renv :ref:`Variant` **get**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` -Renvoie l'élément à l'index ``index`` donné dans le tableau. Si ``index`` est hors des limites ou négatif, cette méthode échoue et renvoie ``null``. +Returns the element at the given ``index`` in the array. If ``index`` is out-of-bounds or negative, this method fails and returns ``null``. -Cette méthode est similaire (mais pas identique) à l'opérateur ``[]``. Plus particulièrement, lorsque cette méthode échoue, elle ne met pas en pause l'exécution de projet si il est exécuté depuis l'éditeur. +This method is similar (but not identical) to the ``[]`` operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor. .. rst-class:: classref-item-separator @@ -923,9 +923,9 @@ En GDScript, c'est équivalent à l'opérateur ``in``\  : :ref:`int` **hash**\ (\ ) |const| :ref:`🔗` -Renvoie une valeur entière de 32 bits hachée représentant le tableau et son contenu. +Returns a hashed 32-bit integer value representing the array and its contents. -\ **Note :** Les tableaux avec des valeurs de hachage égales ne sont *pas* garantis d'être le même, à cause des collisions de hachage. Au contraire, les tableaux avec différentes valeurs de hachage sont garantis d'être différents. +\ **Note:** Arrays with equal hash values are *not* guaranteed to be the same, as a result of hash collisions. On the contrary, arrays with different hash values are guaranteed to be different. .. rst-class:: classref-item-separator @@ -1226,13 +1226,11 @@ Voir aussi :ref:`map()`, :ref:`filter()`\ ) :ref:`🔗` -Retire l'élément du tableau à l'index donné (``position``). Si l'index est hors des limites, cette méthode échoue. Si l'index est négativ, ``position`` est considéré comme relatif par rapport à la fin du tableau. +Removes the element from the array at the given index (``position``). If the index is out of bounds, this method fails. If the index is negative, ``position`` is considered relative to the end of the array. -Si vous devez renvoyer l'élément enlevé, utilisez :ref:`pop_at()`. Pour supprimer un élément par valeur, utilisez :ref:`erase()` à la place. +If you need to return the removed element, use :ref:`pop_at()`. To remove an element by value, use :ref:`erase()` instead. -\ **Note :** Cette méthode déplace l'index de chaque élément après ``position`` en arrière, ce qui peut avoir un coût de performance notable, en particulier sur les tableaux plus grands. - -\ **Note :** La ``position`` ne peut être négative. Pour supprimer un élément relatif à la fin du tableau, utilisez ``tab.remove_at(tab.size() - (i + 1))``. Pour supprimer le dernier élément du tableau, utilisez ``tab.resize(tab.size() - 1)``. +\ **Note:** This method shifts every element's index after ``position`` back, which may have a noticeable performance cost, especially on larger arrays. .. rst-class:: classref-item-separator diff --git a/classes/fr/class_atlastexture.rst b/classes/fr/class_atlastexture.rst index a7bdfa11c9..5c892b3cab 100644 --- a/classes/fr/class_atlastexture.rst +++ b/classes/fr/class_atlastexture.rst @@ -111,7 +111,9 @@ La marge autour de la :ref:`region`. Utile p - |void| **set_region**\ (\ value\: :ref:`Rect2`\ ) - :ref:`Rect2` **get_region**\ (\ ) -La région utilisée pour dessiner l':ref:`atlas`. Si l'une ou l'autre des dimensions de la région vaut ``0``, la valeur de la taille de l':ref:`atlas` sera utilisée pour cet axe à la place. +The region used to draw the :ref:`atlas`. If either dimension of the region's size is ``0``, the value from :ref:`atlas` size will be used for that axis instead. + +\ **Note:** The image size is always an integer, so the actual region size is rounded down. .. |virtual| replace:: :abbr:`virtual (Cette méthode doit typiquement être redéfinie par l'utilisateur pour avoir un effet.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` diff --git a/classes/fr/class_audioserver.rst b/classes/fr/class_audioserver.rst index b907d786ea..143c273e16 100644 --- a/classes/fr/class_audioserver.rst +++ b/classes/fr/class_audioserver.rst @@ -86,8 +86,14 @@ Méthodes +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_driver_name`\ (\ ) |const| | +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_input_buffer_length_frames`\ (\ ) | + +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedStringArray` | :ref:`get_input_device_list`\ (\ ) | +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`PackedVector2Array` | :ref:`get_input_frames`\ (\ frames\: :ref:`int`\ ) | + +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_input_frames_available`\ (\ ) | + +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_input_mix_rate`\ (\ ) |const| | +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_mix_rate`\ (\ ) |const| | @@ -142,6 +148,8 @@ Méthodes +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_enable_tagging_used_audio_streams`\ (\ enable\: :ref:`bool`\ ) | +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Error` | :ref:`set_input_device_active`\ (\ active\: :ref:`bool`\ ) | + +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`swap_bus_effects`\ (\ bus_idx\: :ref:`int`, effect_idx\: :ref:`int`, by_effect_idx\: :ref:`int`\ ) | +-------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`unlock`\ (\ ) | @@ -543,6 +551,20 @@ Renvoie le nom du pilote audio actuel. La valeur par défaut dépend généralem ---- +.. _class_AudioServer_method_get_input_buffer_length_frames: + +.. rst-class:: classref-method + +:ref:`int` **get_input_buffer_length_frames**\ (\ ) :ref:`🔗` + +**Expérimental :** Cette méthode peut être changée ou retirée dans de futures versions. + +Returns the absolute size of the microphone input buffer. This is set to a multiple of the audio latency and can be used to estimate the minimum rate at which the frames need to be fetched. + +.. rst-class:: classref-item-separator + +---- + .. _class_AudioServer_method_get_input_device_list: .. rst-class:: classref-method @@ -557,6 +579,38 @@ Renvoie les noms de tous les périphériques d'entrée audio détectés sur le s ---- +.. _class_AudioServer_method_get_input_frames: + +.. rst-class:: classref-method + +:ref:`PackedVector2Array` **get_input_frames**\ (\ frames\: :ref:`int`\ ) :ref:`🔗` + +**Expérimental :** Cette méthode peut être changée ou retirée dans de futures versions. + +Returns a :ref:`PackedVector2Array` containing exactly ``frames`` audio samples from the internal microphone buffer if available, otherwise returns an empty :ref:`PackedVector2Array`. + +The buffer is filled at the rate of :ref:`get_input_mix_rate()` frames per second when :ref:`set_input_device_active()` has successfully been set to ``true``. + +The samples are signed floating-point PCM values between ``-1`` and ``1``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_AudioServer_method_get_input_frames_available: + +.. rst-class:: classref-method + +:ref:`int` **get_input_frames_available**\ (\ ) :ref:`🔗` + +**Expérimental :** Cette méthode peut être changée ou retirée dans de futures versions. + +Returns the number of frames available to read using :ref:`get_input_frames()`. + +.. rst-class:: classref-item-separator + +---- + .. _class_AudioServer_method_get_input_mix_rate: .. rst-class:: classref-method @@ -897,6 +951,22 @@ S'il est défini à ``true``, toutes les instances de :ref:`AudioStreamPlayback< ---- +.. _class_AudioServer_method_set_input_device_active: + +.. rst-class:: classref-method + +:ref:`Error` **set_input_device_active**\ (\ active\: :ref:`bool`\ ) :ref:`🔗` + +**Expérimental :** Cette méthode peut être changée ou retirée dans de futures versions. + +If ``active`` is ``true``, starts the microphone input stream specified by :ref:`input_device` or returns an error if it failed. + +If ``active`` is ``false``, stops the input stream if it is running. + +.. rst-class:: classref-item-separator + +---- + .. _class_AudioServer_method_swap_bus_effects: .. rst-class:: classref-method diff --git a/classes/fr/class_audiostream.rst b/classes/fr/class_audiostream.rst index 9756654451..5010453d55 100644 --- a/classes/fr/class_audiostream.rst +++ b/classes/fr/class_audiostream.rst @@ -39,39 +39,39 @@ Méthodes .. table:: :widths: auto - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`_get_bar_beats`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`_get_beat_count`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`_get_bpm`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`_get_length`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`Array`\[:ref:`Dictionary`\] | :ref:`_get_parameter_list`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`_get_stream_name`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`Dictionary` | :ref:`_get_tags`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_has_loop`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`AudioStreamPlayback` | :ref:`_instantiate_playback`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_is_monophonic`\ (\ ) |virtual| |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`can_be_sampled`\ (\ ) |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`AudioSample` | :ref:`generate_sample`\ (\ ) |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get_length`\ (\ ) |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`AudioStreamPlayback` | :ref:`instantiate_playback`\ (\ ) | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_meta_stream`\ (\ ) |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`is_monophonic`\ (\ ) |const| | - +------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------+ + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`_get_bar_beats`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`_get_beat_count`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`_get_bpm`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`_get_length`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Array`\[:ref:`Dictionary`\] | :ref:`_get_parameter_list`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`_get_stream_name`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Dictionary` | :ref:`_get_tags`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`_has_loop`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`AudioStreamPlayback` | :ref:`_instantiate_playback`\ (\ ) |virtual| |required| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`_is_monophonic`\ (\ ) |virtual| |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`can_be_sampled`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`AudioSample` | :ref:`generate_sample`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_length`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`AudioStreamPlayback` | :ref:`instantiate_playback`\ (\ ) | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_meta_stream`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_monophonic`\ (\ ) |const| | + +------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -205,7 +205,7 @@ Surchargez cette méthode pour renvoyer ``true`` si ce flux a une boucle. .. rst-class:: classref-method -:ref:`AudioStreamPlayback` **_instantiate_playback**\ (\ ) |virtual| |const| :ref:`🔗` +:ref:`AudioStreamPlayback` **_instantiate_playback**\ (\ ) |virtual| |required| |const| :ref:`🔗` Surchargez cette méthode pour personnaliser la valeur renvoyée de :ref:`instantiate_playback()`. Doit renvoyer un nouveau :ref:`AudioStreamPlayback` créé lorsque le flux est joué (comme avec un :ref:`AudioStreamPlayer`). diff --git a/classes/fr/class_audiostreamplayback.rst b/classes/fr/class_audiostreamplayback.rst index 093103445b..e5190260b0 100644 --- a/classes/fr/class_audiostreamplayback.rst +++ b/classes/fr/class_audiostreamplayback.rst @@ -38,9 +38,9 @@ Méthodes +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Variant` | :ref:`_get_parameter`\ (\ name\: :ref:`StringName`\ ) |virtual| |const| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`_get_playback_position`\ (\ ) |virtual| |const| | + | :ref:`float` | :ref:`_get_playback_position`\ (\ ) |virtual| |required| |const| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_is_playing`\ (\ ) |virtual| |const| | + | :ref:`bool` | :ref:`_is_playing`\ (\ ) |virtual| |required| |const| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`_mix`\ (\ buffer\: ``AudioFrame*``, rate_scale\: :ref:`float`, frames\: :ref:`int`\ ) |virtual| |required| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -48,9 +48,9 @@ Méthodes +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_set_parameter`\ (\ name\: :ref:`StringName`, value\: :ref:`Variant`\ ) |virtual| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`_start`\ (\ from_pos\: :ref:`float`\ ) |virtual| | + | |void| | :ref:`_start`\ (\ from_pos\: :ref:`float`\ ) |virtual| |required| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`_stop`\ (\ ) |virtual| | + | |void| | :ref:`_stop`\ (\ ) |virtual| |required| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`_tag_used_streams`\ (\ ) |virtual| | +-------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -110,7 +110,7 @@ Renvoie la valeur courante d'un paramètre de lecture par son nom (voir :ref:`Au .. rst-class:: classref-method -:ref:`float` **_get_playback_position**\ (\ ) |virtual| |const| :ref:`🔗` +:ref:`float` **_get_playback_position**\ (\ ) |virtual| |required| |const| :ref:`🔗` Méthode redéfinissable. Devrait renvoyer la progression actuelle du flux audio, en secondes. @@ -122,7 +122,7 @@ Méthode redéfinissable. Devrait renvoyer la progression actuelle du flux audio .. rst-class:: classref-method -:ref:`bool` **_is_playing**\ (\ ) |virtual| |const| :ref:`🔗` +:ref:`bool` **_is_playing**\ (\ ) |virtual| |required| |const| :ref:`🔗` Méthode redéfinissable. Devrait renvoyer ``true`` si la lecture est active et joue son flux audio. @@ -172,7 +172,7 @@ Définit la valeur actuelle d'un paramètre de lecture par nom (voir :ref:`Audio .. rst-class:: classref-method -|void| **_start**\ (\ from_pos\: :ref:`float`\ ) |virtual| :ref:`🔗` +|void| **_start**\ (\ from_pos\: :ref:`float`\ ) |virtual| |required| :ref:`🔗` Redéfinissez cette méthode pour personnaliser ce qui se passe lorsque la lecture commence à la position donnée, comme lors de l'appel :ref:`AudioStreamPlayer.play()`. @@ -184,7 +184,7 @@ Redéfinissez cette méthode pour personnaliser ce qui se passe lorsque la lectu .. rst-class:: classref-method -|void| **_stop**\ (\ ) |virtual| :ref:`🔗` +|void| **_stop**\ (\ ) |virtual| |required| :ref:`🔗` Redéfinissez cette méthode pour personnaliser ce qui se passe lorsque la lecture est arrêtée, comme lors de l'appel de :ref:`AudioStreamPlayer.stop()`. diff --git a/classes/fr/class_audiostreamrandomizer.rst b/classes/fr/class_audiostreamrandomizer.rst index e72360f08b..c7787aa117 100644 --- a/classes/fr/class_audiostreamrandomizer.rst +++ b/classes/fr/class_audiostreamrandomizer.rst @@ -29,6 +29,8 @@ Propriétés +--------------------------------------------------------------+----------------------------------------------------------------------------------------------+---------+ | :ref:`float` | :ref:`random_pitch` | ``1.0`` | +--------------------------------------------------------------+----------------------------------------------------------------------------------------------+---------+ + | :ref:`float` | :ref:`random_pitch_semitones` | ``0.0`` | + +--------------------------------------------------------------+----------------------------------------------------------------------------------------------+---------+ | :ref:`float` | :ref:`random_volume_offset_db` | ``0.0`` | +--------------------------------------------------------------+----------------------------------------------------------------------------------------------+---------+ | :ref:`int` | :ref:`streams_count` | ``0`` | @@ -134,7 +136,28 @@ Contrôle comment cet AudioStreamRandomizer choisit quel AudioStream joue ensuit - |void| **set_random_pitch**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_random_pitch**\ (\ ) -L'intensité de la variation aléatoire de la hauteur. Une valeur de 1 signifie aucune variation. +The largest possible frequency multiplier of the random pitch variation. Pitch will be randomly chosen within a range of ``1.0 / random_pitch`` and ``random_pitch``. A value of ``1.0`` means no variation. A value of ``2.0`` means pitch will be randomized between double and half. + +\ **Note:** Setting this property also sets :ref:`random_pitch_semitones`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_AudioStreamRandomizer_property_random_pitch_semitones: + +.. rst-class:: classref-property + +:ref:`float` **random_pitch_semitones** = ``0.0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_random_pitch_semitones**\ (\ value\: :ref:`float`\ ) +- :ref:`float` **get_random_pitch_semitones**\ (\ ) + +The largest possible distance, in semitones, of the random pitch variation. A value of ``0.0`` means no variation. + +\ **Note:** Setting this property also sets :ref:`random_pitch`. .. rst-class:: classref-item-separator @@ -151,7 +174,7 @@ L'intensité de la variation aléatoire de la hauteur. Une valeur de 1 signifie - |void| **set_random_volume_offset_db**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_random_volume_offset_db**\ (\ ) -L'intensité de la variation aléatoire du volume. Une valeur de 0 signifie aucune variation. +The intensity of random volume variation. Volume will be increased or decreased by a random value up to ``random_volume_offset_db``. A value of ``0.0`` means no variation. A value of ``3.0`` means volume will be randomized between ``-3.0 dB`` and ``+3.0 dB``. .. rst-class:: classref-item-separator diff --git a/classes/fr/class_basematerial3d.rst b/classes/fr/class_basematerial3d.rst index f79c14edb7..d53c5e9349 100644 --- a/classes/fr/class_basematerial3d.rst +++ b/classes/fr/class_basematerial3d.rst @@ -1020,9 +1020,9 @@ Définit ``ALBEDO`` par la couleur définie pour chaque sommet du maillage. :ref:`Flags` **FLAG_SRGB_VERTEX_COLOR** = ``2`` -Les couleurs de sommet sont considérées comme stockées dans l'espace de couleur sRGB et sont converties en l'espace de couleur linéaire durant le rendu. Voir aussi :ref:`vertex_color_is_srgb`. +Vertex colors are considered to be stored in nonlinear sRGB encoding and are converted to linear encoding during rendering. See also :ref:`vertex_color_is_srgb`. -\ **Note :** Seulement effectif lors de l'utilisation des méthodes de rendu Forward+ et Mobile. +\ **Note:** Only effective when using the Forward+ and Mobile rendering methods. .. _class_BaseMaterial3D_constant_FLAG_USE_POINT_SIZE: @@ -1102,7 +1102,7 @@ Utiliser les coordonnées ``UV2`` pour la projection de la :ref:`emission_textur :ref:`Flags` **FLAG_ALBEDO_TEXTURE_FORCE_SRGB** = ``12`` -Force le shader à convertir l'albedo de l'espace sRGB en l'espace linéaire. Voir aussi :ref:`albedo_texture_force_srgb`. +Forces the shader to convert albedo from nonlinear sRGB encoding to linear encoding. See also :ref:`albedo_texture_force_srgb`. .. _class_BaseMaterial3D_constant_FLAG_DONT_RECEIVE_SHADOWS: @@ -1512,7 +1512,7 @@ enum **StencilFlags**: :ref:`🔗` :ref:`StencilFlags` **STENCIL_FLAG_READ** = ``1`` -Le matériau ne sera rendu que lorsqu'il passe une comparaison de pochoirs avec les valeurs du buffeur de pochoir existantes. Voir :ref:`StencilCompare`. +The material will only be rendered where it passes a stencil comparison with existing stencil buffer values. .. _class_BaseMaterial3D_constant_STENCIL_FLAG_WRITE: @@ -1654,9 +1654,9 @@ Si la texture apparaît de façon inattendue trop foncée ou trop lumineuse, vé - |void| **set_flag**\ (\ flag\: :ref:`Flags`, enable\: :ref:`bool`\ ) - :ref:`bool` **get_flag**\ (\ flag\: :ref:`Flags`\ ) |const| -Si ``true``, force une conversion de la texture :ref:`albedo_texture` de l'espace de couleur sRGB à l'espace de couleur linéaire. Voir aussi :ref:`vertex_color_is_srgb`. +If ``true``, forces a conversion of the :ref:`albedo_texture` from nonlinear sRGB encoding to linear encoding. See also :ref:`vertex_color_is_srgb`. -Cela ne devrait être activé qu'au besoin (généralement lorsque vous utilisez un :ref:`ViewportTexture` comme :ref:`albedo_texture`). Si :ref:`albedo_texture_force_srgb` vaut ``true`` lorsque cela ne devrait pas être, la texture semblera trop foncée. Si :ref:`albedo_texture_force_srgb` vaut ``false`` lorsque cela ne devrait pas être, la texture semblera trop brillante. +This should only be enabled when needed (typically when using a :ref:`ViewportTexture` as :ref:`albedo_texture`). If :ref:`albedo_texture_force_srgb` is ``true`` when it shouldn't be, the texture will appear to be too dark. If :ref:`albedo_texture_force_srgb` is ``false`` when it shouldn't be, the texture will appear to be too bright. .. rst-class:: classref-item-separator @@ -2152,9 +2152,9 @@ Détermine quand le rendu de la profondeur a lieu. Voir aussi :ref:`transparency **Expérimental :** May be affected by future rendering pipeline changes. -Détermine quel opérateur de comparaison est utilisé lors des tests de profondeur. Voir :ref:`DepthTest`. +Determines which comparison operator is used when testing depth. -\ **Note :** La modification de :ref:`depth_test` à une valeur non par défaut n'a qu'un effet visible que lorsqu'elle est utilisée sur un matériau transparent, ou un matériau qui a :ref:`depth_draw_mode` défini à :ref:`DEPTH_DRAW_DISABLED`. +\ **Note:** Changing :ref:`depth_test` to a non-default value only has a visible effect when used on a transparent material, or a material that has :ref:`depth_draw_mode` set to :ref:`DEPTH_DRAW_DISABLED`. .. rst-class:: classref-item-separator @@ -3337,7 +3337,7 @@ La couleur primaire de l'effet de pochoir. **Expérimental :** May be affected by future rendering pipeline changes. -L'opérateur de comparaison à utiliser pour les opérations de masque de pochoir. Voir :ref:`StencilCompare`. +The comparison operator to use for stencil masking operations. .. rst-class:: classref-item-separator @@ -3356,7 +3356,7 @@ L'opérateur de comparaison à utiliser pour les opérations de masque de pochoi **Expérimental :** May be affected by future rendering pipeline changes. -Les drapeaux dictant comment l'opération de pochoir se comporte. Voir :ref:`StencilFlags`. +The flags dictating how the stencil operation behaves. .. rst-class:: classref-item-separator @@ -3375,7 +3375,7 @@ Les drapeaux dictant comment l'opération de pochoir se comporte. Voir :ref:`Ste **Expérimental :** May be affected by future rendering pipeline changes. -Le mode d'effet de pochoir. Voir :ref:`StencilMode`. +The stencil effect mode. .. rst-class:: classref-item-separator @@ -3882,9 +3882,9 @@ Si ``true``, le mapping triplanaire pour ``UV2`` est calculé dans l'espace glob - |void| **set_flag**\ (\ flag\: :ref:`Flags`, enable\: :ref:`bool`\ ) - :ref:`bool` **get_flag**\ (\ flag\: :ref:`Flags`\ ) |const| -Si ``true``, les couleurs des sommets sont considérées comme stockées dans l'espace de couleur sRGB et sont converties en espace de couleur linéaire pendant le rendu. Si ``false``, les couleurs des sommets sont considérées comme stockées dans l'espace de couleur linéaire et sont rendues telles quelles. Voir aussi :ref:`albedo_texture_force_srgb`. +If ``true``, vertex colors are considered to be stored in nonlinear sRGB encoding and are converted to linear encoding during rendering. If ``false``, vertex colors are considered to be stored in linear encoding and are rendered as-is. See also :ref:`albedo_texture_force_srgb`. -\ **Note :** Seulement effectif lors de l'utilisation des moteurs de rendu Forward+ et Mobile, mais pas Compatibilité. +\ **Note:** Only effective when using the Forward+ and Mobile rendering methods, not Compatibility. .. rst-class:: classref-item-separator @@ -3935,7 +3935,7 @@ Descriptions des méthodes :ref:`bool` **get_feature**\ (\ feature\: :ref:`Feature`\ ) |const| :ref:`🔗` -Renvoie ``true`` si la fonctionnalité :ref:`Feature` spécifiée est active. +Returns ``true`` if the specified ``feature`` is enabled. .. rst-class:: classref-item-separator @@ -3947,7 +3947,7 @@ Renvoie ``true`` si la fonctionnalité :ref:`Feature` **get_flag**\ (\ flag\: :ref:`Flags`\ ) |const| :ref:`🔗` -Renvoie ``true`` si le drapeau spécifié est activé. +Returns ``true`` if the specified ``flag`` is enabled. .. rst-class:: classref-item-separator @@ -3959,7 +3959,7 @@ Renvoie ``true`` si le drapeau spécifié est activé. :ref:`Texture2D` **get_texture**\ (\ param\: :ref:`TextureParam`\ ) |const| :ref:`🔗` -Renvoie la :ref:`Texture2D` associée avec le :ref:`TextureParam` spécifié. +Returns the :ref:`Texture2D` associated with the specified texture ``param``. .. rst-class:: classref-item-separator @@ -3971,7 +3971,7 @@ Renvoie la :ref:`Texture2D` associée avec le :ref:`TexturePara |void| **set_feature**\ (\ feature\: :ref:`Feature`, enable\: :ref:`bool`\ ) :ref:`🔗` -Si ``true``, active la :ref:`Feature` spécifiée. De nombreuses fonctionnalités disponibles dans **BaseMaterial3D** doivent être activées avant utilisation. De cette façon, le coût d'utilisation de la fonctionnalité n'est présent que lorsque spécifié. Les fonctionnalités peuvent également être activées en définissant le membre correspondant à ``true``. +If ``enable`` is ``true``, enables the specified ``feature``. Many features that are available in **BaseMaterial3D** need to be enabled before use. This way, the cost for using the feature is only incurred when specified. Features can also be enabled by setting their corresponding property to ``true``. .. rst-class:: classref-item-separator @@ -3983,7 +3983,7 @@ Si ``true``, active la :ref:`Feature` spécifiée. |void| **set_flag**\ (\ flag\: :ref:`Flags`, enable\: :ref:`bool`\ ) :ref:`🔗` -Si ``true``, active le drapeau spécifié. Les drapeaux sont un comportement optionnel qui peut être activé et désactivé. Un seul drapeau peut être activé à la fois avec cette fonction, les énumérateurs de drapeau ne peuvent pas être mis dans un masque de bits ensemble pour activer ou désactiver plusieurs drapeaux à la fois. Les drapeaux peuvent également être activés en définissant le membre correspondant à ``true``. +If ``enable`` is ``true``, enables the specified ``flag``. Flags are optional behavior that can be turned on and off. Only one flag can be enabled at a time with this function, the flag enumerators cannot be bit-masked together to enable or disable multiple flags at once. Flags can also be enabled by setting their corresponding property to ``true``. .. rst-class:: classref-item-separator diff --git a/classes/fr/class_boneconstraint3d.rst b/classes/fr/class_boneconstraint3d.rst index 52c221e47a..1ac2c3ce96 100644 --- a/classes/fr/class_boneconstraint3d.rst +++ b/classes/fr/class_boneconstraint3d.rst @@ -26,33 +26,74 @@ Méthodes .. table:: :widths: auto - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`clear_setting`\ (\ ) | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`float` | :ref:`get_amount`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_apply_bone`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_apply_bone_name`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_reference_bone`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_reference_bone_name`\ (\ index\: :ref:`int`\ ) |const| | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_setting_count`\ (\ ) |const| | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_amount`\ (\ index\: :ref:`int`, amount\: :ref:`float`\ ) | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_apply_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_apply_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_reference_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_reference_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_setting_count`\ (\ count\: :ref:`int`\ ) | - +-----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear_setting`\ (\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_amount`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_apply_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_apply_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_reference_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_reference_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`NodePath` | :ref:`get_reference_node`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`ReferenceType` | :ref:`get_reference_type`\ (\ index\: :ref:`int`\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_setting_count`\ (\ ) |const| | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_amount`\ (\ index\: :ref:`int`, amount\: :ref:`float`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_apply_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_apply_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_reference_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_reference_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_reference_node`\ (\ index\: :ref:`int`, node\: :ref:`NodePath`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_reference_type`\ (\ index\: :ref:`int`, type\: :ref:`ReferenceType`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_setting_count`\ (\ count\: :ref:`int`\ ) | + +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Énumérations +------------------------ + +.. _enum_BoneConstraint3D_ReferenceType: + +.. rst-class:: classref-enumeration + +enum **ReferenceType**: :ref:`🔗` + +.. _class_BoneConstraint3D_constant_REFERENCE_TYPE_BONE: + +.. rst-class:: classref-enumeration-constant + +:ref:`ReferenceType` **REFERENCE_TYPE_BONE** = ``0`` + +The reference target is a bone. In this case, the reference target spaces is local space. + +.. _class_BoneConstraint3D_constant_REFERENCE_TYPE_NODE: + +.. rst-class:: classref-enumeration-constant + +:ref:`ReferenceType` **REFERENCE_TYPE_NODE** = ``1`` + +The reference target is a :ref:`Node3D`. In this case, the reference target spaces is model space. + +In other words, the reference target's coordinates are treated as if it were placed directly under :ref:`Skeleton3D` which parent of the **BoneConstraint3D**. .. rst-class:: classref-section-separator @@ -139,6 +180,32 @@ Cet os sera uniquement référencé et non modifié par ce modificateur. ---- +.. _class_BoneConstraint3D_method_get_reference_node: + +.. rst-class:: classref-method + +:ref:`NodePath` **get_reference_node**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the reference node path of the setting at ``index``. + +This node will be only referenced and not modified by this modifier. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneConstraint3D_method_get_reference_type: + +.. rst-class:: classref-method + +:ref:`ReferenceType` **get_reference_type**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the reference target type of the setting at ``index``. See also :ref:`ReferenceType`. + +.. rst-class:: classref-item-separator + +---- + .. _class_BoneConstraint3D_method_get_setting_count: .. rst-class:: classref-method @@ -215,6 +282,32 @@ Cet os sera uniquement référencé et non modifié par ce modificateur. ---- +.. _class_BoneConstraint3D_method_set_reference_node: + +.. rst-class:: classref-method + +|void| **set_reference_node**\ (\ index\: :ref:`int`, node\: :ref:`NodePath`\ ) :ref:`🔗` + +Sets the reference node path of the setting at ``index`` to ``node``. + +This node will be only referenced and not modified by this modifier. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneConstraint3D_method_set_reference_type: + +.. rst-class:: classref-method + +|void| **set_reference_type**\ (\ index\: :ref:`int`, type\: :ref:`ReferenceType`\ ) :ref:`🔗` + +Sets the reference target type of the setting at ``index`` to ``type``. See also :ref:`ReferenceType`. + +.. rst-class:: classref-item-separator + +---- + .. _class_BoneConstraint3D_method_set_setting_count: .. rst-class:: classref-method diff --git a/classes/fr/class_bonetwistdisperser3d.rst b/classes/fr/class_bonetwistdisperser3d.rst new file mode 100644 index 0000000000..71c6562060 --- /dev/null +++ b/classes/fr/class_bonetwistdisperser3d.rst @@ -0,0 +1,576 @@ +:github_url: hide + +.. _class_BoneTwistDisperser3D: + +BoneTwistDisperser3D +==================== + +**Hérite de :** :ref:`SkeletonModifier3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` + +A node that propagates and disperses the child bone's twist to the parent bones. + +.. rst-class:: classref-introduction-group + +Description +----------- + +This **BoneTwistDisperser3D** allows for smooth twist interpolation between multiple bones by dispersing the end bone's twist to the parents. This only changes the twist without changing the global position of each joint. + +This is useful for smoothly twisting bones in combination with :ref:`CopyTransformModifier3D` and IK. + +\ **Note:** If an extracted twist is greater than 180 degrees, flipping occurs. This is similar to :ref:`ConvertTransformModifier3D`. + +.. rst-class:: classref-reftable-group + +Propriétés +-------------------- + +.. table:: + :widths: auto + + +-------------------------+---------------------------------------------------------------------------------+----------+ + | :ref:`bool` | :ref:`mutable_bone_axes` | ``true`` | + +-------------------------+---------------------------------------------------------------------------------+----------+ + | :ref:`int` | :ref:`setting_count` | ``0`` | + +-------------------------+---------------------------------------------------------------------------------+----------+ + +.. rst-class:: classref-reftable-group + +Méthodes +---------------- + +.. table:: + :widths: auto + + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`clear_settings`\ (\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Curve` | :ref:`get_damping_curve`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`DisperseMode` | :ref:`get_disperse_mode`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_end_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`BoneDirection` | :ref:`get_end_bone_direction`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_end_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_joint_bone`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_joint_bone_name`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_joint_count`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_joint_twist_amount`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_reference_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_reference_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_root_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_root_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Quaternion` | :ref:`get_twist_from`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_weight_position`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_end_bone_extended`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_twist_from_rest`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_damping_curve`\ (\ index\: :ref:`int`, curve\: :ref:`Curve`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_disperse_mode`\ (\ index\: :ref:`int`, disperse_mode\: :ref:`DisperseMode`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_direction`\ (\ index\: :ref:`int`, bone_direction\: :ref:`BoneDirection`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_extend_end_bone`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_joint_twist_amount`\ (\ index\: :ref:`int`, joint\: :ref:`int`, twist_amount\: :ref:`float`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_root_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_root_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_twist_from`\ (\ index\: :ref:`int`, from\: :ref:`Quaternion`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_twist_from_rest`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_weight_position`\ (\ index\: :ref:`int`, weight_position\: :ref:`float`\ ) | + +-------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Énumérations +------------------------ + +.. _enum_BoneTwistDisperser3D_DisperseMode: + +.. rst-class:: classref-enumeration + +enum **DisperseMode**: :ref:`🔗` + +.. _class_BoneTwistDisperser3D_constant_DISPERSE_MODE_EVEN: + +.. rst-class:: classref-enumeration-constant + +:ref:`DisperseMode` **DISPERSE_MODE_EVEN** = ``0`` + +Assign amounts so that they monotonically increase from ``0.0`` to ``1.0``, ensuring all weights are equal. For example, with five joints, the amounts would be ``0.2``, ``0.4``, ``0.6``, ``0.8``, and ``1.0`` starting from the root bone. + +.. _class_BoneTwistDisperser3D_constant_DISPERSE_MODE_WEIGHTED: + +.. rst-class:: classref-enumeration-constant + +:ref:`DisperseMode` **DISPERSE_MODE_WEIGHTED** = ``1`` + +Assign amounts so that they monotonically increase from ``0.0`` to ``1.0``, based on the length of the bones between joint segments. See also :ref:`set_weight_position()`. + +.. _class_BoneTwistDisperser3D_constant_DISPERSE_MODE_CUSTOM: + +.. rst-class:: classref-enumeration-constant + +:ref:`DisperseMode` **DISPERSE_MODE_CUSTOM** = ``2`` + +You can assign arbitrary amounts to the joint list. See also :ref:`set_joint_twist_amount()`. + +When :ref:`is_end_bone_extended()` is ``false``, a child of the reference bone exists solely to determine the twist axis, so its custom amount has absolutely no effect at all. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descriptions des propriétés +------------------------------------------------------ + +.. _class_BoneTwistDisperser3D_property_mutable_bone_axes: + +.. rst-class:: classref-property + +:ref:`bool` **mutable_bone_axes** = ``true`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_mutable_bone_axes**\ (\ value\: :ref:`bool`\ ) +- :ref:`bool` **are_bone_axes_mutable**\ (\ ) + +If ``true``, the solver retrieves the bone axis from the bone pose every frame. + +If ``false``, the solver retrieves the bone axis from the bone rest and caches it. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_property_setting_count: + +.. rst-class:: classref-property + +:ref:`int` **setting_count** = ``0`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_setting_count**\ (\ value\: :ref:`int`\ ) +- :ref:`int` **get_setting_count**\ (\ ) + +Le nombre de paramètres. + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descriptions des méthodes +-------------------------------------------------- + +.. _class_BoneTwistDisperser3D_method_clear_settings: + +.. rst-class:: classref-method + +|void| **clear_settings**\ (\ ) :ref:`🔗` + +Efface tous les paramètres. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_damping_curve: + +.. rst-class:: classref-method + +:ref:`Curve` **get_damping_curve**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the damping curve when :ref:`get_disperse_mode()` is :ref:`DISPERSE_MODE_CUSTOM`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_disperse_mode: + +.. rst-class:: classref-method + +:ref:`DisperseMode` **get_disperse_mode**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns whether to use automatic amount assignment or to allow manual assignment. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_end_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_end_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie l'index de l'os de fin de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_end_bone_direction: + +.. rst-class:: classref-method + +:ref:`BoneDirection` **get_end_bone_direction**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the tail direction of the end bone of the bone chain when :ref:`is_end_bone_extended()` is ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_end_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_end_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie le nom de l'os de fin de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_joint_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_joint_bone**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie l'index de l'os à la liaison ``joint`` dans la liste de liaisons de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_joint_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_joint_bone_name**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie le nom de l'os à la liaison ``joint`` dans la liste de liaisons de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_joint_count: + +.. rst-class:: classref-method + +:ref:`int` **get_joint_count**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie la quantité de liaisons dans la liste des liaisons de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_joint_twist_amount: + +.. rst-class:: classref-method + +:ref:`float` **get_joint_twist_amount**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the twist amount at ``joint`` in the bone chain's joint list when :ref:`get_disperse_mode()` is :ref:`DISPERSE_MODE_CUSTOM`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_reference_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_reference_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the reference bone to extract twist of the setting at ``index``. + +This bone is either the end of the chain or its parent, depending on :ref:`is_end_bone_extended()`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_reference_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_reference_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the reference bone name to extract twist of the setting at ``index``. + +This bone is either the end of the chain or its parent, depending on :ref:`is_end_bone_extended()`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_root_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_root_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie l'index de l'os racine de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_root_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_root_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie le nom de l'os racine de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_twist_from: + +.. rst-class:: classref-method + +:ref:`Quaternion` **get_twist_from**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the rotation to an arbitrary state before twisting for the current bone pose to extract the twist when :ref:`is_twist_from_rest()` is ``false``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_get_weight_position: + +.. rst-class:: classref-method + +:ref:`float` **get_weight_position**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the position at which to divide the segment between joints for weight assignment when :ref:`get_disperse_mode()` is :ref:`DISPERSE_MODE_WEIGHTED`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_is_end_bone_extended: + +.. rst-class:: classref-method + +:ref:`bool` **is_end_bone_extended**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns ``true`` if the end bone is extended to have a tail. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_is_twist_from_rest: + +.. rst-class:: classref-method + +:ref:`bool` **is_twist_from_rest**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns ``true`` if extracting the twist amount from the difference between the bone rest and the current bone pose. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_damping_curve: + +.. rst-class:: classref-method + +|void| **set_damping_curve**\ (\ index\: :ref:`int`, curve\: :ref:`Curve`\ ) :ref:`🔗` + +Sets the damping curve when :ref:`get_disperse_mode()` is :ref:`DISPERSE_MODE_CUSTOM`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_disperse_mode: + +.. rst-class:: classref-method + +|void| **set_disperse_mode**\ (\ index\: :ref:`int`, disperse_mode\: :ref:`DisperseMode`\ ) :ref:`🔗` + +Sets whether to use automatic amount assignment or to allow manual assignment. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_end_bone: + +.. rst-class:: classref-method + +|void| **set_end_bone**\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) :ref:`🔗` + +Définit l'index de l'os de fin de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_end_bone_direction: + +.. rst-class:: classref-method + +|void| **set_end_bone_direction**\ (\ index\: :ref:`int`, bone_direction\: :ref:`BoneDirection`\ ) :ref:`🔗` + +Définit la direction de la queue de l'os de fin de la chaîne d'os lorsque :ref:`is_end_bone_extended()` vaut ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_end_bone_name: + +.. rst-class:: classref-method + +|void| **set_end_bone_name**\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) :ref:`🔗` + +Sets the end bone name of the bone chain. + +\ **Note:** The end bone must be a child of the root bone. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_extend_end_bone: + +.. rst-class:: classref-method + +|void| **set_extend_end_bone**\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) :ref:`🔗` + +If ``enabled`` is ``true``, the end bone is extended to have a tail. + +If ``enabled`` is ``false``, :ref:`get_reference_bone()` becomes a parent of the end bone and it uses the vector to the end bone as a twist axis. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_joint_twist_amount: + +.. rst-class:: classref-method + +|void| **set_joint_twist_amount**\ (\ index\: :ref:`int`, joint\: :ref:`int`, twist_amount\: :ref:`float`\ ) :ref:`🔗` + +Sets the twist amount at ``joint`` in the bone chain's joint list when :ref:`get_disperse_mode()` is :ref:`DISPERSE_MODE_CUSTOM`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_root_bone: + +.. rst-class:: classref-method + +|void| **set_root_bone**\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) :ref:`🔗` + +Définit l'index de l'os racine de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_root_bone_name: + +.. rst-class:: classref-method + +|void| **set_root_bone_name**\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) :ref:`🔗` + +Définit le nom de l'os racine de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_twist_from: + +.. rst-class:: classref-method + +|void| **set_twist_from**\ (\ index\: :ref:`int`, from\: :ref:`Quaternion`\ ) :ref:`🔗` + +Sets the rotation to an arbitrary state before twisting for the current bone pose to extract the twist when :ref:`is_twist_from_rest()` is ``false``. + +In other words, by calling :ref:`set_twist_from()` by :ref:`SkeletonModifier3D.modification_processed` of a specific :ref:`SkeletonModifier3D`, you can extract only the twists generated by modifiers processed after that but before this **BoneTwistDisperser3D**. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_twist_from_rest: + +.. rst-class:: classref-method + +|void| **set_twist_from_rest**\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) :ref:`🔗` + +If ``enabled`` is ``true``, it extracts the twist amount from the difference between the bone rest and the current bone pose. + +If ``enabled`` is ``false``, it extracts the twist amount from the difference between :ref:`get_twist_from()` and the current bone pose. See also :ref:`set_twist_from()`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_BoneTwistDisperser3D_method_set_weight_position: + +.. rst-class:: classref-method + +|void| **set_weight_position**\ (\ index\: :ref:`int`, weight_position\: :ref:`float`\ ) :ref:`🔗` + +Sets the position at which to divide the segment between joints for weight assignment when :ref:`get_disperse_mode()` is :ref:`DISPERSE_MODE_WEIGHTED`. + +For example, when ``weight_position`` is ``0.5``, if two bone segments with a length of ``1.0`` exist between three joints, weights are assigned to each joint from root to end at ratios of ``0.5``, ``1.0``, and ``0.5``. Then amounts become ``0.25``, ``0.75``, and ``1.0`` respectively. + +.. |virtual| replace:: :abbr:`virtual (Cette méthode doit typiquement être redéfinie par l'utilisateur pour avoir un effet.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Cette méthode n'a pas d'effets de bord. Elle ne modifie aucune des variables membres de l'instance.)` +.. |vararg| replace:: :abbr:`vararg (Cette méthode accepte n'importe quel nombre d'arguments après ceux décris ici.)` +.. |constructor| replace:: :abbr:`constructor (Cette méthode est utilisée pour construire un type.)` +.. |static| replace:: :abbr:`static (Cette méthode n'a pas besoin d'instance pour être appelée, elle peut donc être directement appelée en utilisant le nom de la classe.)` +.. |operator| replace:: :abbr:`operator (Cette méthode décrit un opérateur valide à utiliser avec ce type en tant qu'opérande gauche.)` +.. |bitfield| replace:: :abbr:`BitField (Cette valeur est un nombre entier composé d'un masque de bits des options suivantes.)` +.. |void| replace:: :abbr:`void (Aucune valeur de retour.)` diff --git a/classes/fr/class_button.rst b/classes/fr/class_button.rst index c6b3bc0cf9..45cca2e5cd 100644 --- a/classes/fr/class_button.rst +++ b/classes/fr/class_button.rst @@ -332,7 +332,7 @@ Spécifie si l'icône doit être alignée horizontalement sur la gauche, la droi - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_language**\ (\ ) -Code de langue utilisé pour les algorithmes de retour à la ligne et de "text shaping". Si vide, la langue locale actuelle est utilisée à la place. +Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead. .. rst-class:: classref-item-separator diff --git a/classes/fr/class_camerafeed.rst b/classes/fr/class_camerafeed.rst index 09b42fe029..6266f2306a 100644 --- a/classes/fr/class_camerafeed.rst +++ b/classes/fr/class_camerafeed.rst @@ -44,33 +44,35 @@ Méthodes .. table:: :widths: auto - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`_activate_feed`\ (\ ) |virtual| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`_deactivate_feed`\ (\ ) |virtual| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`FeedDataType` | :ref:`get_datatype`\ (\ ) |const| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_id`\ (\ ) |const| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`String` | :ref:`get_name`\ (\ ) |const| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`FeedPosition` | :ref:`get_position`\ (\ ) |const| | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`int` | :ref:`get_texture_tex_id`\ (\ feed_image_type\: :ref:`FeedImage`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_external`\ (\ width\: :ref:`int`, height\: :ref:`int`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`set_format`\ (\ index\: :ref:`int`, parameters\: :ref:`Dictionary`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_name`\ (\ name\: :ref:`String`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_position`\ (\ position\: :ref:`FeedPosition`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_rgb_image`\ (\ rgb_image\: :ref:`Image`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`set_ycbcr_image`\ (\ ycbcr_image\: :ref:`Image`\ ) | - +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+ + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`_activate_feed`\ (\ ) |virtual| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`_deactivate_feed`\ (\ ) |virtual| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`FeedDataType` | :ref:`get_datatype`\ (\ ) |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_id`\ (\ ) |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_name`\ (\ ) |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`FeedPosition` | :ref:`get_position`\ (\ ) |const| | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_texture_tex_id`\ (\ feed_image_type\: :ref:`FeedImage`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_external`\ (\ width\: :ref:`int`, height\: :ref:`int`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`set_format`\ (\ index\: :ref:`int`, parameters\: :ref:`Dictionary`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_name`\ (\ name\: :ref:`String`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_position`\ (\ position\: :ref:`FeedPosition`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_rgb_image`\ (\ rgb_image\: :ref:`Image`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_ycbcr_image`\ (\ ycbcr_image\: :ref:`Image`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_ycbcr_images`\ (\ y_image\: :ref:`Image`, cbcr_image\: :ref:`Image`\ ) | + +---------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator @@ -412,6 +414,18 @@ Définit l'image RGB pour ce flux. Définit l'image YCbCr pour ce flux. +.. rst-class:: classref-item-separator + +---- + +.. _class_CameraFeed_method_set_ycbcr_images: + +.. rst-class:: classref-method + +|void| **set_ycbcr_images**\ (\ y_image\: :ref:`Image`, cbcr_image\: :ref:`Image`\ ) :ref:`🔗` + +Sets Y and CbCr images for this feed. + .. |virtual| replace:: :abbr:`virtual (Cette méthode doit typiquement être redéfinie par l'utilisateur pour avoir un effet.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Cette méthode n'a pas d'effets de bord. Elle ne modifie aucune des variables membres de l'instance.)` diff --git a/classes/fr/class_canvasgroup.rst b/classes/fr/class_canvasgroup.rst index 7065b587ad..8485899825 100644 --- a/classes/fr/class_canvasgroup.rst +++ b/classes/fr/class_canvasgroup.rst @@ -14,16 +14,16 @@ Fusionne plusieurs nœuds 2D en une seule opération de dessin. Description ----------- -Les nœuds enfants :ref:`CanvasItem` d'un **CanvasGroup** sont dessinés comme un seul object. Cela permet par exemple de dessiner des nœuds 2D enchevêtrés sans mélange (activer la propriété :ref:`CanvasItem.self_modulate` de **CanvasGroup** pour aboutir à cet effet). +Child :ref:`CanvasItem` nodes of a **CanvasGroup** are drawn as a single object. It allows to e.g. draw overlapping translucent 2D nodes without causing the overlapping sections to be more opaque than intended (set the :ref:`CanvasItem.self_modulate` property on the **CanvasGroup** to achieve this effect). -\ **Remarque :** Le **CanvasGroup** utilise un shader pour lire depuis le tampon arrière pour dessiner ses enfants. Affecter un :ref:`Material` au **CanvasGroup** remplacera le shader de base. Pour dupliquer le comportement du shader de base dans un :ref:`Shader` personnalisé, le code suivant peut être utilisé : +\ **Note:** The **CanvasGroup** uses a custom shader to read from the backbuffer to draw its children. Assigning a :ref:`Material` to the **CanvasGroup** overrides the built-in shader. To duplicate the behavior of the built-in shader in a custom :ref:`Shader`, use the following: :: shader_type canvas_item; render_mode unshaded; - uniform sampler2D screen_texture : hint_screen_texture, repeat_disable, filter_nearest; + uniform sampler2D screen_texture : hint_screen_texture, repeat_disable, filter_nearest; void fragment() { vec4 c = textureLod(screen_texture, SCREEN_UV, 0.0); @@ -35,7 +35,7 @@ Les nœuds enfants :ref:`CanvasItem` d'un **CanvasGroup** sont COLOR *= c; } -\ **Remarque :** Vu que **CanvasGroup** et :ref:`CanvasItem.clip_children` utilisent tous deux le tampon arrière, les enfants d'un **CanvasGroup** qui ont leur propriété :ref:`CanvasItem.clip_children` définie à toute valeur exceptée :ref:`CanvasItem.CLIP_CHILDREN_DISABLED` ne fonctionneront pas correctement. +\ **Note:** Since **CanvasGroup** and :ref:`CanvasItem.clip_children` both utilize the backbuffer, children of a **CanvasGroup** who have their :ref:`CanvasItem.clip_children` set to anything other than :ref:`CanvasItem.CLIP_CHILDREN_DISABLED` will not function correctly. .. rst-class:: classref-reftable-group diff --git a/classes/fr/class_canvasitem.rst b/classes/fr/class_canvasitem.rst index d5ead7a20d..447fcb02cc 100644 --- a/classes/fr/class_canvasitem.rst +++ b/classes/fr/class_canvasitem.rst @@ -102,6 +102,10 @@ Méthodes +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_dashed_line`\ (\ from\: :ref:`Vector2`, to\: :ref:`Vector2`, color\: :ref:`Color`, width\: :ref:`float` = -1.0, dash\: :ref:`float` = 2.0, aligned\: :ref:`bool` = true, antialiased\: :ref:`bool` = false\ ) | +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`draw_ellipse`\ (\ position\: :ref:`Vector2`, major\: :ref:`float`, minor\: :ref:`float`, color\: :ref:`Color`, filled\: :ref:`bool` = true, width\: :ref:`float` = -1.0, antialiased\: :ref:`bool` = false\ ) | + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`draw_ellipse_arc`\ (\ center\: :ref:`Vector2`, major\: :ref:`float`, minor\: :ref:`float`, start_angle\: :ref:`float`, end_angle\: :ref:`float`, point_count\: :ref:`int`, color\: :ref:`Color`, width\: :ref:`float` = -1.0, antialiased\: :ref:`bool` = false\ ) | + +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_end_animation`\ (\ ) | +---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_lcd_texture_rect_region`\ (\ texture\: :ref:`Texture2D`, rect\: :ref:`Rect2`, src_rect\: :ref:`Rect2`, modulate\: :ref:`Color` = Color(1, 1, 1, 1)\ ) | @@ -504,7 +508,9 @@ Le **CanvasItem** est entré dans le canevas. **NOTIFICATION_EXIT_CANVAS** = ``33`` :ref:`🔗` -Le **CanvasItem** a quitté le canevas. +The **CanvasItem** has exited the canvas. + +This notification is sent in reversed order. .. _class_CanvasItem_constant_NOTIFICATION_WORLD_2D_CHANGED: @@ -710,7 +716,9 @@ Si ``true``, le matériau :ref:`material` du - |void| **set_visibility_layer**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_visibility_layer**\ (\ ) -La couche de rendu dans laquelle ce **CanvasItem** est rendu par les nœuds :ref:`Viewport`. Un :ref:`Viewport` rendra un **CanvasItem** s'il et tous ses parents partagent une couche avec le masque de cull du canevas du :ref:`Viewport`. +The rendering layer in which this **CanvasItem** is rendered by :ref:`Viewport` nodes. A :ref:`Viewport` will render a **CanvasItem** if it and all its parents share a layer with the :ref:`Viewport`'s canvas cull mask. + +\ **Note:** A **CanvasItem** does not inherit its parents' visibility layers. This means that if a parent **CanvasItem** does not have all the same layers as its child, the child may not be visible even if both the parent and child have :ref:`visible` set to ``true``. For example, if a parent has layer 1 and a child has layer 2, the child will not be visible in a :ref:`Viewport` with the canvas cull mask set to layer 1 or 2 (see :ref:`Viewport.canvas_cull_mask`). To ensure that both the parent and child are visible, the parent must have both layers 1 and 2, or the child must have :ref:`top_level` set to ``true``. .. rst-class:: classref-item-separator @@ -831,11 +839,11 @@ Les commandes de dessin qui suivent seront ignorées sauf si elles tombent dans |void| **draw_arc**\ (\ center\: :ref:`Vector2`, radius\: :ref:`float`, start_angle\: :ref:`float`, end_angle\: :ref:`float`, point_count\: :ref:`int`, color\: :ref:`Color`, width\: :ref:`float` = -1.0, antialiased\: :ref:`bool` = false\ ) :ref:`🔗` -Dessine un arc non rempli entre les angles donnés avec une couleur (``color``) et une épaisseur (``width``) uniformes, ainsi qu'un anticrénelage facultatif (pris en charge uniquement si ``width`` est positif). Plus la valeur de ``point_count`` est grande, plus la courbe est lisse. Voir aussi :ref:`draw_circle()`. +Draws an unfilled arc between the given angles with a uniform ``color`` and ``width`` and optional antialiasing (supported only for positive ``width``). The larger the value of ``point_count``, the smoother the curve. ``center`` is defined in local space. For elliptical arcs, see :ref:`draw_ellipse_arc()`. See also :ref:`draw_circle()`. -Si ``width`` est négatif, il sera ignoré et l'arc sera dessiné à l'aide de :ref:`RenderingServer.PRIMITIVE_LINE_STRIP`. Cela signifie que lorsque le CanvasItem est mis à l'échelle, l'arc restera mince. Si ce comportement n'est pas souhaité, transmettez une ``width`` positive comme ``1.0``. +If ``width`` is negative, it will be ignored and the arc will be drawn using :ref:`RenderingServer.PRIMITIVE_LINE_STRIP`. This means that when the CanvasItem is scaled, the arc will remain thin. If this behavior is not desired, then pass a positive ``width`` like ``1.0``. -L'arc est tracé de ``start_angle`` vers la valeur de ``end_angle`` donc dans le sens des aiguilles d'une montre si ``start_angle < end_angle`` et dans le sens inverse des aiguilles d'une montre sinon. Passer les mêmes angles mais dans l’ordre inversé produira le même arc. Si la différence absolue entre ``start_angle`` et ``end_angle`` est supérieure à :ref:`@GDScript.TAU` radians, alors un arc de cercle complet est dessiné (c'est-à-dire que l'arc ne se chevauchera pas). +The arc is drawn from ``start_angle`` towards the value of ``end_angle`` so in clockwise direction if ``start_angle < end_angle`` and counter-clockwise otherwise. Passing the same angles but in reversed order will produce the same arc. If absolute difference of ``start_angle`` and ``end_angle`` is greater than :ref:`@GDScript.TAU` radians, then a full circle arc is drawn (i.e. arc will not overlap itself). .. rst-class:: classref-item-separator @@ -871,15 +879,15 @@ Dessine le contour du premier caractère d'une chaîne en utilisant une police p |void| **draw_circle**\ (\ position\: :ref:`Vector2`, radius\: :ref:`float`, color\: :ref:`Color`, filled\: :ref:`bool` = true, width\: :ref:`float` = -1.0, antialiased\: :ref:`bool` = false\ ) :ref:`🔗` -Dessine un cercle, avec ``position`` défini dans l'espace local. Voir aussi :ref:`draw_arc()`, :ref:`draw_polyline()`, et :ref:`draw_polygon()`. +Draws a circle, with ``position`` defined in local space. See also :ref:`draw_ellipse()`, :ref:`draw_arc()`, :ref:`draw_polyline()`, and :ref:`draw_polygon()`. -Si ``filled`` vaut ``true``, le cercle sera rempli avec la couleur ``color`` spécifiée. Si ``filled`` vaut ``false``, le cercle sera dessiné avec un trait de couleur ``color`` et de largeur ``width`` spécifiées. +If ``filled`` is ``true``, the circle will be filled with the ``color`` specified. If ``filled`` is ``false``, the circle will be drawn as a stroke with the ``color`` and ``width`` specified. -Si ``width`` est négative, alors des primitives à deux points seront dessinées au lieu de celles à 4 points. Cela signifie que lorsque le CanvasItem est redimensionné, les lignes resteront fines. Si ce comportement n'est pas souhaité, passez une largeur ``width`` positive comme ``1.0``. +If ``width`` is negative, then two-point primitives will be drawn instead of a four-point ones. This means that when the CanvasItem is scaled, the lines will remain thin. If this behavior is not desired, then pass a positive ``width`` like ``1.0``. -Si ``antialiased`` vaut ``true``, des « gaines » à moitié transparentes seront attachées aux bords, rendant les contours lisses. +If ``antialiased`` is ``true``, half transparent "feathers" will be attached to the boundary, making outlines smooth. -\ **Note :** ``width`` est seulement effectif si ``filled`` vaut ``false``. +\ **Note:** ``width`` is only effective if ``filled`` is ``false``. .. rst-class:: classref-item-separator @@ -919,6 +927,42 @@ Si ``antialiased`` vaut ``true``, des « gaines » à moitié transparentes sero ---- +.. _class_CanvasItem_method_draw_ellipse: + +.. rst-class:: classref-method + +|void| **draw_ellipse**\ (\ position\: :ref:`Vector2`, major\: :ref:`float`, minor\: :ref:`float`, color\: :ref:`Color`, filled\: :ref:`bool` = true, width\: :ref:`float` = -1.0, antialiased\: :ref:`bool` = false\ ) :ref:`🔗` + +Draws an ellipse with semi-major axis ``major`` and semi-minor axis ``minor``. See also :ref:`draw_circle()`, :ref:`draw_ellipse_arc()`, :ref:`draw_polyline()`, and :ref:`draw_polygon()`. + +If ``filled`` is ``true``, the ellipse will be filled with the ``color`` specified. If ``filled`` is ``false``, the ellipse will be drawn as a stroke with the ``color`` and ``width`` specified. + +If ``width`` is negative, then two-point primitives will be drawn instead of four-point ones. This means that when the CanvasItem is scaled, the lines will remain thin. If this behavior is not desired, then pass a positive ``width`` like ``1.0``. + +If ``antialiased`` is ``true``, half transparent "feathers" will be attached to the boundary, making outlines smooth. + +\ **Note:** ``width`` is only effective if ``filled`` is ``false``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_CanvasItem_method_draw_ellipse_arc: + +.. rst-class:: classref-method + +|void| **draw_ellipse_arc**\ (\ center\: :ref:`Vector2`, major\: :ref:`float`, minor\: :ref:`float`, start_angle\: :ref:`float`, end_angle\: :ref:`float`, point_count\: :ref:`int`, color\: :ref:`Color`, width\: :ref:`float` = -1.0, antialiased\: :ref:`bool` = false\ ) :ref:`🔗` + +Draws an unfilled elliptical arc between the given angles with a uniform ``color`` and ``width`` and optional antialiasing (supported only for positive ``width``). The larger the value of ``point_count``, the smoother the curve. For circular arcs, see :ref:`draw_arc()`. See also :ref:`draw_ellipse()`. + +If ``width`` is negative, it will be ignored and the arc will be drawn using :ref:`RenderingServer.PRIMITIVE_LINE_STRIP`. This means that when the CanvasItem is scaled, the arc will remain thin. If this behavior is not desired, then pass a positive ``width`` like ``1.0``. + +The arc is drawn from ``start_angle`` towards the value of ``end_angle`` so in clockwise direction if ``start_angle < end_angle`` and counter-clockwise otherwise. Passing the same angles but in reversed order will produce the same arc. If absolute difference of ``start_angle`` and ``end_angle`` is greater than :ref:`@GDScript.TAU` radians, then a full ellipse is drawn (i.e. arc will not overlap itself). + +.. rst-class:: classref-item-separator + +---- + .. _class_CanvasItem_method_draw_end_animation: .. rst-class:: classref-method @@ -1391,9 +1435,9 @@ Renvoie la position de la souris dans le **CanvasItem** en utilisant le système :ref:`Transform2D` **get_screen_transform**\ (\ ) |const| :ref:`🔗` -Renvoie la transformation de ce **CanvasItem** dans les coordonnées d'écran globales (c.-à-d. en tenant compte de la position de fenêtre). Généralement utile pour les plugins d'éditeur. +Returns the transform of this **CanvasItem** in global screen coordinates (i.e. taking window position into account). Mostly useful for editor plugins. -Égal à :ref:`get_global_transform()` si la fenêtre est intégrée (voir :ref:`Viewport.gui_embed_subwindows`). +Equivalent to :ref:`get_global_transform_with_canvas()` if the window is embedded (see :ref:`Viewport.gui_embed_subwindows`). .. rst-class:: classref-item-separator @@ -1603,9 +1647,9 @@ Si ``true``, le nœud recevra :ref:`NOTIFICATION_LOCAL_TRANSFORM_CHANGED`\ ) :ref:`🔗` -Si ``true``, le nœud recevra :ref:`NOTIFICATION_TRANSFORM_CHANGED` chaque fois que sa transformation globale change. +If ``true``, the node will receive :ref:`NOTIFICATION_TRANSFORM_CHANGED` whenever its global transform changes. -\ **Note :** De nombreux éléments de canevas tels que :ref:`Camera2D` ou :ref:`Light2D` activent ceci automatiquement afin de fonctionner correctement. +\ **Note:** Many canvas items such as :ref:`Camera2D` or :ref:`Light2D` automatically enable this in order to function correctly. .. rst-class:: classref-item-separator diff --git a/classes/fr/class_ccdik3d.rst b/classes/fr/class_ccdik3d.rst new file mode 100644 index 0000000000..87d5d95b47 --- /dev/null +++ b/classes/fr/class_ccdik3d.rst @@ -0,0 +1,31 @@ +:github_url: hide + +.. _class_CCDIK3D: + +CCDIK3D +======= + +**Hérite de :** :ref:`IterateIK3D` **<** :ref:`ChainIK3D` **<** :ref:`IKModifier3D` **<** :ref:`SkeletonModifier3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` + +Rotation based cyclic coordinate descent inverse kinematics solver. + +.. rst-class:: classref-introduction-group + +Description +----------- + +**CCDIK3D** is rotation based IK, enabling fast and effective tracking even with large joint rotations. It's especially suitable for chains with limitations, providing smoother and more stable target tracking compared to :ref:`FABRIK3D`. + +The resulting twist around the forward vector will always be kept from the previous pose. + +\ **Note:** When the target is close to the root, it can cause unnatural movement, including joint flips and oscillations. + +.. |virtual| replace:: :abbr:`virtual (Cette méthode doit typiquement être redéfinie par l'utilisateur pour avoir un effet.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Cette méthode n'a pas d'effets de bord. Elle ne modifie aucune des variables membres de l'instance.)` +.. |vararg| replace:: :abbr:`vararg (Cette méthode accepte n'importe quel nombre d'arguments après ceux décris ici.)` +.. |constructor| replace:: :abbr:`constructor (Cette méthode est utilisée pour construire un type.)` +.. |static| replace:: :abbr:`static (Cette méthode n'a pas besoin d'instance pour être appelée, elle peut donc être directement appelée en utilisant le nom de la classe.)` +.. |operator| replace:: :abbr:`operator (Cette méthode décrit un opérateur valide à utiliser avec ce type en tant qu'opérande gauche.)` +.. |bitfield| replace:: :abbr:`BitField (Cette valeur est un nombre entier composé d'un masque de bits des options suivantes.)` +.. |void| replace:: :abbr:`void (Aucune valeur de retour.)` diff --git a/classes/fr/class_chainik3d.rst b/classes/fr/class_chainik3d.rst new file mode 100644 index 0000000000..6627a6de92 --- /dev/null +++ b/classes/fr/class_chainik3d.rst @@ -0,0 +1,286 @@ +:github_url: hide + +.. _class_ChainIK3D: + +ChainIK3D +========= + +**Hérite de :** :ref:`IKModifier3D` **<** :ref:`SkeletonModifier3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` + +**Hérité par :** :ref:`IterateIK3D`, :ref:`SplineIK3D` + +A :ref:`SkeletonModifier3D` to apply inverse kinematics to bone chains containing an arbitrary number of bones. + +.. rst-class:: classref-introduction-group + +Description +----------- + +Base class of :ref:`SkeletonModifier3D` that automatically generates a joint list from the bones between the root bone and the end bone. + +.. rst-class:: classref-reftable-group + +Méthodes +---------------- + +.. table:: + :widths: auto + + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_end_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`BoneDirection` | :ref:`get_end_bone_direction`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`float` | :ref:`get_end_bone_length`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_end_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_joint_bone`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_joint_bone_name`\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_joint_count`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`int` | :ref:`get_root_bone`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`String` | :ref:`get_root_bone_name`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`bool` | :ref:`is_end_bone_extended`\ (\ index\: :ref:`int`\ ) |const| | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_direction`\ (\ index\: :ref:`int`, bone_direction\: :ref:`BoneDirection`\ ) | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_length`\ (\ index\: :ref:`int`, length\: :ref:`float`\ ) | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_end_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_extend_end_bone`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_root_bone`\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | |void| | :ref:`set_root_bone_name`\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) | + +-------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + +.. rst-class:: classref-section-separator + +---- + +.. rst-class:: classref-descriptions-group + +Descriptions des méthodes +-------------------------------------------------- + +.. _class_ChainIK3D_method_get_end_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_end_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie l'index de l'os de fin de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_end_bone_direction: + +.. rst-class:: classref-method + +:ref:`BoneDirection` **get_end_bone_direction**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the tail direction of the end bone of the bone chain when :ref:`is_end_bone_extended()` is ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_end_bone_length: + +.. rst-class:: classref-method + +:ref:`float` **get_end_bone_length**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns the end bone tail length of the bone chain when :ref:`is_end_bone_extended()` is ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_end_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_end_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie le nom de l'os de fin de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_joint_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_joint_bone**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie l'index de l'os à la liaison ``joint`` dans la liste de liaisons de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_joint_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_joint_bone_name**\ (\ index\: :ref:`int`, joint\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie le nom de l'os à la liaison ``joint`` dans la liste de liaisons de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_joint_count: + +.. rst-class:: classref-method + +:ref:`int` **get_joint_count**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie la quantité de liaisons dans la liste des liaisons de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_root_bone: + +.. rst-class:: classref-method + +:ref:`int` **get_root_bone**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie l'index de l'os racine de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_get_root_bone_name: + +.. rst-class:: classref-method + +:ref:`String` **get_root_bone_name**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Renvoie le nom de l'os racine de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_is_end_bone_extended: + +.. rst-class:: classref-method + +:ref:`bool` **is_end_bone_extended**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` + +Returns ``true`` if the end bone is extended to have a tail. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_set_end_bone: + +.. rst-class:: classref-method + +|void| **set_end_bone**\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) :ref:`🔗` + +Définit l'index de l'os de fin de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_set_end_bone_direction: + +.. rst-class:: classref-method + +|void| **set_end_bone_direction**\ (\ index\: :ref:`int`, bone_direction\: :ref:`BoneDirection`\ ) :ref:`🔗` + +Définit la direction de la queue de l'os de fin de la chaîne d'os lorsque :ref:`is_end_bone_extended()` vaut ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_set_end_bone_length: + +.. rst-class:: classref-method + +|void| **set_end_bone_length**\ (\ index\: :ref:`int`, length\: :ref:`float`\ ) :ref:`🔗` + +Définit la longueur de la queue de l'os de fin de la chaîne d'os lorsque :ref:`is_end_bone_extended()` vaut ``true``. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_set_end_bone_name: + +.. rst-class:: classref-method + +|void| **set_end_bone_name**\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) :ref:`🔗` + +Sets the end bone name of the bone chain. + +\ **Note:** The end bone must be the root bone or a child of the root bone. If they are the same, the tail must be extended by :ref:`set_extend_end_bone()` to modify the bone. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_set_extend_end_bone: + +.. rst-class:: classref-method + +|void| **set_extend_end_bone**\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) :ref:`🔗` + +If ``enabled`` is ``true``, the end bone is extended to have a tail. + +The extended tail config is allocated to the last element in the joint list. In other words, if you set ``enabled`` to ``false``, the config of the last element in the joint list has no effect in the simulated result. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_set_root_bone: + +.. rst-class:: classref-method + +|void| **set_root_bone**\ (\ index\: :ref:`int`, bone\: :ref:`int`\ ) :ref:`🔗` + +Définit l'index de l'os racine de la chaîne d'os. + +.. rst-class:: classref-item-separator + +---- + +.. _class_ChainIK3D_method_set_root_bone_name: + +.. rst-class:: classref-method + +|void| **set_root_bone_name**\ (\ index\: :ref:`int`, bone_name\: :ref:`String`\ ) :ref:`🔗` + +Définit le nom de l'os racine de la chaîne d'os. + +.. |virtual| replace:: :abbr:`virtual (Cette méthode doit typiquement être redéfinie par l'utilisateur pour avoir un effet.)` +.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` +.. |const| replace:: :abbr:`const (Cette méthode n'a pas d'effets de bord. Elle ne modifie aucune des variables membres de l'instance.)` +.. |vararg| replace:: :abbr:`vararg (Cette méthode accepte n'importe quel nombre d'arguments après ceux décris ici.)` +.. |constructor| replace:: :abbr:`constructor (Cette méthode est utilisée pour construire un type.)` +.. |static| replace:: :abbr:`static (Cette méthode n'a pas besoin d'instance pour être appelée, elle peut donc être directement appelée en utilisant le nom de la classe.)` +.. |operator| replace:: :abbr:`operator (Cette méthode décrit un opérateur valide à utiliser avec ce type en tant qu'opérande gauche.)` +.. |bitfield| replace:: :abbr:`BitField (Cette valeur est un nombre entier composé d'un masque de bits des options suivantes.)` +.. |void| replace:: :abbr:`void (Aucune valeur de retour.)` diff --git a/classes/fr/class_characterbody2d.rst b/classes/fr/class_characterbody2d.rst index 0e71a015b3..7f892d8074 100644 --- a/classes/fr/class_characterbody2d.rst +++ b/classes/fr/class_characterbody2d.rst @@ -439,9 +439,9 @@ Vecteur pointant vers le haut, utilisé pour déterminer ce qui est un mur et ce - |void| **set_velocity**\ (\ value\: :ref:`Vector2`\ ) - :ref:`Vector2` **get_velocity**\ (\ ) -Vecteur de vitesse actuel en pixels par seconde, utilisé et modifié pendant les appels à :ref:`move_and_slide()`. +Current velocity vector in pixels per second, used and modified during calls to :ref:`move_and_slide()`. -Cette propriété ne doit pas être assignée une valeur multipliée par ``delta``, car cela est appliqué en interne dans :ref:`move_and_slide()`. Dans le cas contraire, la simulation avancera à une vitesse incorrecte. +\ **Note:** A common mistake is setting this property to the desired velocity multiplied by ``delta``, which produces a motion vector in pixels. .. rst-class:: classref-item-separator @@ -525,7 +525,7 @@ Renvoie le dernier mouvement appliqué au **CharacterBody2D** lors du dernier ap :ref:`KinematicCollision2D` **get_last_slide_collision**\ (\ ) :ref:`🔗` -Renvoie un :ref:`KinematicCollision2D`, qui contient les information sur la dernière collision qui est arrivée lors du dernier appel de :ref:`move_and_slide()`. +Returns a :ref:`KinematicCollision2D` if a collision occurred. The returned value contains information about the latest collision that occurred during the last call to :ref:`move_and_slide()`. Returns ``null`` if no collision occurred. See also :ref:`get_slide_collision()`. .. rst-class:: classref-item-separator @@ -573,9 +573,9 @@ Renvoie la vitesse réelle actuelle depuis le dernier appel à :ref:`move_and_sl :ref:`KinematicCollision2D` **get_slide_collision**\ (\ slide_idx\: :ref:`int`\ ) :ref:`🔗` -Renvoie une :ref:`KinematicCollision2D` qui contient des informations sur une collision qui s'est produite lors du dernier appel à :ref:`move_and_slide()`. Comme le corps peut entrer en collisions plusieurs fois dans un seul appel à :ref:`move_and_slide()`, vous devez spécifier l'index de la collision dans une plage de 0 à (:ref:`get_slide_collision_count()` - 1). +Returns a :ref:`KinematicCollision2D`, which contains information about a collision that occurred during the last call to :ref:`move_and_slide()`. Since the body can collide several times in a single call to :ref:`move_and_slide()`, you must specify the index of the collision in the range 0 to (:ref:`get_slide_collision_count()` - 1). See also :ref:`get_last_slide_collision()`. -\ **Exemple :** Itérer sur les collisions avec une boucle ``for``\  : +\ **Example:** Iterate through the collisions with a ``for`` loop: .. tabs:: @@ -584,14 +584,14 @@ Renvoie une :ref:`KinematicCollision2D` qui contient for i in get_slide_collision_count(): var collision = get_slide_collision(i) - print("Entré en collision avec : ", collision.get_collider().name) + print("Collided with: ", collision.get_collider().name) .. code-tab:: csharp for (int i = 0; i < GetSlideCollisionCount(); i++) { KinematicCollision2D collision = GetSlideCollision(i); - GD.Print("Entré en collision avec : ", (collision.GetCollider() as Node).Name); + GD.Print("Collided with: ", (collision.GetCollider() as Node).Name); } diff --git a/classes/fr/class_characterbody3d.rst b/classes/fr/class_characterbody3d.rst index 3c89020f8a..7a4154d380 100644 --- a/classes/fr/class_characterbody3d.rst +++ b/classes/fr/class_characterbody3d.rst @@ -443,9 +443,9 @@ Vecteur pointant vers le haut, utilisé pour déterminer ce qui est un mur et ce - |void| **set_velocity**\ (\ value\: :ref:`Vector3`\ ) - :ref:`Vector3` **get_velocity**\ (\ ) -Vecteur de vitesse actuel (typiquement en mètres par seconde), utilisé et modifié pendant les appels à :ref:`move_and_slide()`. +Current velocity vector (typically meters per second), used and modified during calls to :ref:`move_and_slide()`. -Cette propriété ne doit pas être assignée une valeur multipliée par ``delta``, car cela est appliqué en interne dans :ref:`move_and_slide()`. Dans le cas contraire, la simulation avancera à une vitesse incorrecte. +\ **Note:** A common mistake is setting this property to the desired velocity multiplied by ``delta``, which produces a motion vector (typically in meters). .. rst-class:: classref-item-separator @@ -529,7 +529,7 @@ Renvoie le dernier mouvement appliqué au **CharacterBody3D** lors du dernier ap :ref:`KinematicCollision3D` **get_last_slide_collision**\ (\ ) :ref:`🔗` -Renvoie un :ref:`KinematicCollision3D`, qui contient des informations sur la dernière collision qui est arrivée lors du dernier appel de :ref:`move_and_slide()`. +Returns a :ref:`KinematicCollision3D` if a collision occurred. The returned value contains information about the latest collision that occurred during the last call to :ref:`move_and_slide()`. Returns ``null`` if no collision occurred. See also :ref:`get_slide_collision()`. .. rst-class:: classref-item-separator @@ -589,7 +589,7 @@ Renvoie la vitesse réelle actuelle depuis le dernier appel à :ref:`move_and_sl :ref:`KinematicCollision3D` **get_slide_collision**\ (\ slide_idx\: :ref:`int`\ ) :ref:`🔗` -Renvoie un :ref:`KinematicCollision3D` qui contient des informations sur une collision qui s'est produite au cours du dernier appel à :ref:`move_and_slide()`. Comme le corps peut entrer en collision plusieurs fois dans un seul appel à :ref:`move_and_slide()`, vous devez spécifier l'index de la collision dans une plage de 0 à (:ref:`get_slide_collision_count()` - 1). +Returns a :ref:`KinematicCollision3D`, which contains information about a collision that occurred during the last call to :ref:`move_and_slide()`. Since the body can collide several times in a single call to :ref:`move_and_slide()`, you must specify the index of the collision in the range 0 to (:ref:`get_slide_collision_count()` - 1). See also :ref:`get_last_slide_collision()`. .. rst-class:: classref-item-separator diff --git a/classes/fr/class_codeedit.rst b/classes/fr/class_codeedit.rst index 8c7c57e4e6..2580851abf 100644 --- a/classes/fr/class_codeedit.rst +++ b/classes/fr/class_codeedit.rst @@ -51,6 +51,8 @@ Propriétés +----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ | :ref:`bool` | :ref:`gutters_draw_line_numbers` | ``false`` | +----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ + | :ref:`int` | :ref:`gutters_line_numbers_min_digits` | ``3`` | + +----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ | :ref:`bool` | :ref:`gutters_zero_pad_line_numbers` | ``false`` | +----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------+ | :ref:`bool` | :ref:`indent_automatic` | ``false`` | @@ -709,6 +711,23 @@ If ``true``, the line number gutter is drawn. Line numbers start at ``1`` and ar ---- +.. _class_CodeEdit_property_gutters_line_numbers_min_digits: + +.. rst-class:: classref-property + +:ref:`int` **gutters_line_numbers_min_digits** = ``3`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_line_numbers_min_digits**\ (\ value\: :ref:`int`\ ) +- :ref:`int` **get_line_numbers_min_digits**\ (\ ) + +The minimum width in digits reserved for the line number gutter. + +.. rst-class:: classref-item-separator + +---- + .. _class_CodeEdit_property_gutters_zero_pad_line_numbers: .. rst-class:: classref-property diff --git a/classes/fr/class_collisionpolygon2d.rst b/classes/fr/class_collisionpolygon2d.rst index fbb3e5c673..4caf101764 100644 --- a/classes/fr/class_collisionpolygon2d.rst +++ b/classes/fr/class_collisionpolygon2d.rst @@ -14,9 +14,9 @@ Un nœud qui fournit une forme de polygone à un :ref:`CollisionObject2D` parent et permet de l'éditer. Le polygone peut être concave ou convexe. Cela peut donner une forme de détection à une :ref:`Area2D`, transformer un :ref:`PhysicsBody2D` en un objet solide, ou donner une forme creuse à un :ref:`StaticBody2D`. +A node that provides a polygon shape to a :ref:`CollisionObject2D` parent and allows it to be edited. The polygon can be concave or convex. This can give a detection shape to an :ref:`Area2D`, turn a :ref:`PhysicsBody2D` into a solid object, or give a hollow shape to a :ref:`StaticBody2D`. -\ **Attention :** Un\ **CollisionPolygon2D** avec une échelle non uniforme ne se comportera probablement pas comme prévu. Assurez-vous de garder la même échelle sur tous les axes et ajustez son polygone à la place. +\ **Warning:** A non-uniformly scaled **CollisionPolygon2D** will likely not behave as expected. Make sure to keep its scale the same on all axes and adjust its polygon instead. .. rst-class:: classref-reftable-group diff --git a/classes/fr/class_collisionpolygon3d.rst b/classes/fr/class_collisionpolygon3d.rst index 3a46d7e4fa..48c079e862 100644 --- a/classes/fr/class_collisionpolygon3d.rst +++ b/classes/fr/class_collisionpolygon3d.rst @@ -14,9 +14,9 @@ Un nœud qui fournit une forme de polygone épaissie (un prisme) à un :ref:`Col Description ----------- -Un nœud qui fournit une forme de polygone épaissie (un prisme) à un :ref:`CollisionObject3D` parent et permet de l'éditer. Le polygone peut être concave ou convexe. Cela peut donner une forme de détection à une :ref:`Area3D` ou transformer :ref:`PhysicsBody3D` en un objet solide. +A node that provides a thickened polygon shape (a prism) to a :ref:`CollisionObject3D` parent and allows it to be edited. The polygon can be concave or convex. This can give a detection shape to an :ref:`Area3D` or turn a :ref:`PhysicsBody3D` into a solid object. -\ **Attention :** Un :ref:`CollisionShape3D` avec une échelle non uniforme ne se comportera probablement pas comme prévu. Assurez-vous de garder la même échelle sur tous les axes et d'ajuster sa ressource de forme à la place. +\ **Warning:** A non-uniformly scaled :ref:`CollisionShape3D` will likely not behave as expected. Make sure to keep its scale the same on all axes and adjust its shape resource instead. .. rst-class:: classref-reftable-group diff --git a/classes/fr/class_collisionshape2d.rst b/classes/fr/class_collisionshape2d.rst index c64e88b6f0..f97bfc9f73 100644 --- a/classes/fr/class_collisionshape2d.rst +++ b/classes/fr/class_collisionshape2d.rst @@ -14,7 +14,7 @@ Un nœud qui fournit une :ref:`Shape2D` à un parent :ref:`Collis Description ----------- -Un nœud qui fournit une :ref:`Shape2D` à un parent :ref:`CollisionObject2D` et permet de la modifier. Cela peut donner une forme de détection à une :ref:`Area2D` ou transformer un :ref:`PhysicsBody2D` en un objet solide. +A node that provides a :ref:`Shape2D` to a :ref:`CollisionObject2D` parent and allows it to be edited. This can give a detection shape to an :ref:`Area2D` or turn a :ref:`PhysicsBody2D` into a solid object. .. rst-class:: classref-introduction-group diff --git a/classes/fr/class_collisionshape3d.rst b/classes/fr/class_collisionshape3d.rst index 6f6c8f561d..d1cae5bbae 100644 --- a/classes/fr/class_collisionshape3d.rst +++ b/classes/fr/class_collisionshape3d.rst @@ -14,9 +14,9 @@ Un nœud qui fournit une :ref:`Shape3D` à un parent :ref:`Collis Description ----------- -Un nœud qui fournit une :ref:`Shape3D` à un parent :ref:`CollisionObject3D` et permet de la modifier. Cela peut donner une forme de détection à une :ref:`Area3D` ou transformer un :ref:`PhysicsBody3D` en un objet solide. +A node that provides a :ref:`Shape3D` to a :ref:`CollisionObject3D` parent and allows it to be edited. This can give a detection shape to an :ref:`Area3D` or turn a :ref:`PhysicsBody3D` into a solid object. -\ **Attention :**\  : Un **CollisionShape3D** non-uniformémement dimensionné ne se comportera probablement pas comme prévu. Assurez-vous de garder la même échelle sur tous les axes et d'ajuster sa ressource :ref:`shape` à la place. +\ **Warning:** A non-uniformly scaled **CollisionShape3D** will likely not behave as expected. Make sure to keep its scale the same on all axes and adjust its :ref:`shape` resource instead. .. rst-class:: classref-introduction-group diff --git a/classes/fr/class_color.rst b/classes/fr/class_color.rst index 6eda176224..32df5362c3 100644 --- a/classes/fr/class_color.rst +++ b/classes/fr/class_color.rst @@ -12,15 +12,17 @@ Une couleur représentée au format RGBA (Red Green Blue Alpha, ou Rouge Vert Bl Description ----------- -Une couleur représentée au format RGBA par une composante rouge (:ref:`r`), verte (:ref:`g`), bleue (:ref:`b`), et alpha (:ref:`a`). Chaque composante est une valeur flottante sur 32 bits, variant habituellement de ``0.0`` à ``1.0``. Certaines propriétés (comme :ref:`CanvasItem.modulate`) peuvent supporter des valeurs supérieures à ``1.0``, pour les couleurs overbright (litt. "surlumineuse") ou HDR (High Dynamic Range, "Grande plage dynamique"). +A color represented in RGBA format by a red (:ref:`r`), green (:ref:`g`), blue (:ref:`b`), and alpha (:ref:`a`) component. Each component is a 32-bit floating-point value, usually ranging from ``0.0`` to ``1.0``. Some properties (such as :ref:`CanvasItem.modulate`) may support values greater than ``1.0``, for overbright or HDR (High Dynamic Range) colors. -Les couleurs peuvent être créées de différentes manières : Par les différents constructeurs **Color**, par des méthodes statiques telles que :ref:`from_hsv()`, et en utilisant un nom de l'ensemble des couleurs normalisées basées sur les `noms de couleur X11 `__ avec l'ajout de :ref:`TRANSPARENT`. GDScript fournit également :ref:`@GDScript.Color8()`, qui utilise des entiers de ``0`` à ``255`` et ne supporte pas les couleurs overbright. +Colors can be created in a number of ways: By the various **Color** constructors, by static methods such as :ref:`from_hsv()`, and by using a name from the set of standardized colors based on `X11 color names `__ with the addition of :ref:`TRANSPARENT`. -Les données de couleur peuvent être stockées dans de nombreux espaces de couleurs et encodages. Les méthodes :ref:`srgb_to_linear()` et :ref:`linear_to_srgb()` peuvent convertir entre l'encodage non linéaire sRGB et l'encodage linéaire RGB. +\ `Color constants cheatsheet `__\ -\ **Note :** Dans un contexte booléen, une couleur évaluera à ``false`` si elle est égale à ``Color(0, 0, 0, 1)`` (noir opaque). Sinon, une couleur évaluera toujours à ``true``. +Although **Color** may be used to store values of any encoding, the red (:ref:`r`), green (:ref:`g`), and blue (:ref:`b`) properties of **Color** are expected by Godot to be encoded using the `nonlinear sRGB transfer function `__ unless otherwise stated. This color encoding is used by many traditional art and web tools, making it easy to match colors between Godot and these tools. Godot uses `Rec. ITU-R BT.709 `__ color primaries, which are used by the sRGB standard. -\ `Aide-mémoire des constantes de couleur `__ +All physical simulation, such as lighting calculations, and colorimetry transformations, such as :ref:`get_luminance()`, must be performed on linearly encoded values to produce correct results. When performing these calculations, convert **Color** to and from linear encoding using :ref:`srgb_to_linear()` and :ref:`linear_to_srgb()`. + +\ **Note:** In a boolean context, a Color will evaluate to ``false`` if it is equal to ``Color(0, 0, 0, 1)`` (opaque black). Otherwise, a Color will always evaluate to ``true``. .. note:: @@ -1389,9 +1391,9 @@ Descriptions des propriétés :ref:`float` **a** = ``1.0`` :ref:`🔗` -La composante alpha de la couleur, généralement dans l’intervalle allant de 0 à 1. Une valeur de 0 signifie que la couleur est entièrement transparente. Une valeur de 1 signifie que la couleur est entièrement opaque. +The color's alpha component, typically on the range of 0 to 1. A value of 0 means that the color is fully transparent. A value of 1 means that the color is fully opaque. -\ **Note :** Le canal alpha est toujours stocké avec un encodage linéaire, peu importe l'espace de couleur des autres canaux de couleur. Les méthodes :ref:`linear_to_srgb()` et :ref:`srgb_to_linear()` n'affectent pas le canal alpha. +\ **Note:** The alpha channel is always stored with linear encoding, regardless of the encoding of the other color channels. The :ref:`linear_to_srgb()` and :ref:`srgb_to_linear()` methods do not affect the alpha channel. .. rst-class:: classref-item-separator @@ -1629,18 +1631,18 @@ Construit une **Color** soit depuis un code de couleur HTML, soit depuis un nom :ref:`Color` **Color**\ (\ r\: :ref:`float`, g\: :ref:`float`, b\: :ref:`float`\ ) -Construit une **Color** depuis des valeurs Rouge Vertes Bleues, typiquement entre 0.0 et 1.0. :ref:`a` est défini à 1.0 +Constructs a **Color** from RGB values, typically between 0.0 and 1.0. :ref:`a` is set to 1.0. .. tabs:: .. code-tab:: gdscript - var couleur = Color(0.2, 1.0, 0.7) # Similaire à `Color8(51, 255, 178, 255)` + var color = Color(0.2, 1.0, 0.7) # Similar to `Color.from_rgba8(51, 255, 178, 255)` .. code-tab:: csharp - var couleur = Color(0.2f, 1.0f, 0.7f); # Similaire à `Color.Color8(51, 255, 178, 255)` + var color = new Color(0.2f, 1.0f, 0.7f); // Similar to `Color.Color8(51, 255, 178, 255)` @@ -1652,18 +1654,18 @@ Construit une **Color** depuis des valeurs Rouge Vertes Bleues, typiquement entr :ref:`Color` **Color**\ (\ r\: :ref:`float`, g\: :ref:`float`, b\: :ref:`float`, a\: :ref:`float`\ ) -Construit une **Color** depuis des valeurs Rouge Vertes Bleues Alpha, typiquement entre 0.0 et 1.0. +Constructs a **Color** from RGBA values, typically between 0.0 and 1.0. .. tabs:: .. code-tab:: gdscript - var couleur = Color(0.2, 1.0, 0.7, 0.8) # Similaire à `Color8(51, 255, 178, 204)` + var color = Color(0.2, 1.0, 0.7, 0.8) # Similar to `Color.from_rgba8(51, 255, 178, 204)` .. code-tab:: csharp - var couleur = Color(0.2f, 1.0f, 0.7f, 0.8f); # Similaire à `Color.Color8(51, 255, 178, 204)` + var color = new Color(0.2f, 1.0f, 0.7f, 0.8f); // Similar to `Color.Color8(51, 255, 178, 255, 204)` @@ -1846,9 +1848,9 @@ Si vous voulez créer une couleur depuis une chaîne dans une expression constan :ref:`float` **get_luminance**\ (\ ) |const| :ref:`🔗` -Renvoie l'intensité lumineuse de la couleur, en tant que valeur entre 0.0 et 1.0 (inclusive). Ceci est utile pour déterminer si la couleur est claire ou foncée. Les couleurs avec une luminance inférieure à 0,5 peuvent généralement être considérées comme foncées. +Returns the light intensity of the color, as a value between 0.0 and 1.0 (inclusive). This is useful when determining light or dark color. Colors with a luminance smaller than 0.5 can be generally considered dark. -\ **Note :** :ref:`get_luminance()` s'appuie sur la couleur étant dans l'espace de couleur linéaire pour renvoyer une valeur de luminosité relative exacte. Si la couleur est dans l'espace de couleur sRGB, utilisez :ref:`srgb_to_linear()` pour la convertir en l'espace de couleur linéaire d'abord. +\ **Note:** :ref:`get_luminance()` relies on the color using linear encoding to return an accurate relative luminance value. If the color uses the default nonlinear sRGB encoding, use :ref:`srgb_to_linear()` to convert it to linear encoding first. .. rst-class:: classref-item-separator @@ -2078,9 +2080,9 @@ Renvoie une nouvelle couleur résultant du fait de rendre cette couleur plus cla :ref:`Color` **linear_to_srgb**\ (\ ) |const| :ref:`🔗` -Renvoie la couleur convertie dans l'espace de couleur `sRGB `__. Cette méthode suppose que la couleur originale est dans l'espace de couleur linéaire. Voir aussi :ref:`srgb_to_linear()` qui effectue l'opération inverse. +Returns a copy of the color that is encoded using the `nonlinear sRGB transfer function `__. This method requires the original color to use linear encoding. See also :ref:`srgb_to_linear()` which performs the opposite operation. -\ **Note :** La couleur du canal :ref:`a`\ lpha n'est pas affectée. Le canal alpha est toujours stocké dans un encodage linéaire, peu importe l'espace de couleur des autres canaux de couleur. +\ **Note:** The color's alpha channel (:ref:`a`) is not affected. The alpha channel is always stored with linear encoding, regardless of the color space of the other color channels. .. rst-class:: classref-item-separator @@ -2092,9 +2094,9 @@ Renvoie la couleur convertie dans l'espace de couleur `sRGB ` **srgb_to_linear**\ (\ ) |const| :ref:`🔗` -Renvoie la couleur convertie dans l'espace de couleur linéaire. Cette méthode suppose que la couleur originale soit déjà dans l'espace de couleur sRGB. Voir aussi :ref:`linear_to_srgb()` qui effectue l'opération inverse. +Returns a copy of the color that uses linear encoding. This method requires the original color to be encoded using the `nonlinear sRGB transfer function `__. See also :ref:`linear_to_srgb()` which performs the opposite operation. -\ **Note :** La couleur du canal :ref:`a`\ lpha n'est pas affectée. Le canal alpha est toujours stocké dans un encodage linéaire, peu importe l'espace de couleur des autres canaux de couleur. +\ **Note:** The color's alpha channel (:ref:`a`) is not affected. The alpha channel is always stored with linear encoding, regardless of the color space of the other color channels. .. rst-class:: classref-item-separator diff --git a/classes/fr/class_colorpicker.rst b/classes/fr/class_colorpicker.rst index 298549ba7c..38aa28761a 100644 --- a/classes/fr/class_colorpicker.rst +++ b/classes/fr/class_colorpicker.rst @@ -433,7 +433,7 @@ Si ``true``, affiche un slider de canal alpha (opacité). - |void| **set_edit_intensity**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_editing_intensity**\ (\ ) -Si ``true``, affiche un slider d'intensité. L'intensité est appliquée comme suit : multiplier la couleur par ``2 ** intensité`` dans l'espace RGB linéaire, puis la convertir en sRGB. +If ``true``, shows an intensity slider. The intensity is applied as follows: convert the color to linear encoding, multiply it by ``2 ** intensity``, and then convert it back to nonlinear sRGB encoding. .. rst-class:: classref-item-separator diff --git a/classes/fr/class_confirmationdialog.rst b/classes/fr/class_confirmationdialog.rst index 7ac8636d41..3c62099c30 100644 --- a/classes/fr/class_confirmationdialog.rst +++ b/classes/fr/class_confirmationdialog.rst @@ -7,7 +7,7 @@ ConfirmationDialog **Hérite de :** :ref:`AcceptDialog` **<** :ref:`Window` **<** :ref:`Viewport` **<** :ref:`Node` **<** :ref:`Object` -**Hérité par :** :ref:`EditorCommandPalette`, :ref:`EditorFileDialog`, :ref:`FileDialog`, :ref:`ScriptCreateDialog` +**Hérité par :** :ref:`EditorCommandPalette`, :ref:`FileDialog`, :ref:`ScriptCreateDialog` Une boîte de dialogue pour la confirmation des actions. @@ -16,23 +16,25 @@ Une boîte de dialogue pour la confirmation des actions. Description ----------- -Une fenêtre utilisée pour la confirmation des actions. Cette fenêtre est similaire à :ref:`AcceptDialog`, mais appuyer sur son bouton Annuler peut avoir un résultat différent de l'appui sur le bouton OK. L'ordre des deux boutons varie selon le système d'exploitation hôte. +A dialog used for confirmation of actions. This window is similar to :ref:`AcceptDialog`, but pressing its Cancel button can have a different outcome from pressing the OK button. The order of the two buttons varies depending on the host OS. -Pour annuler l'action, vous pouvez utiliser : +To get cancel action, you can use: .. tabs:: .. code-tab:: gdscript - get_cancel_button().pressed.connect(_lorsque_annulation) + get_cancel_button().pressed.connect(_on_canceled) .. code-tab:: csharp - GetCancelButton().Pressed += LorsqueAnnulation; + GetCancelButton().Pressed += OnCanceled; +\ **Note:** :ref:`AcceptDialog` is invisible by default. To make it visible, call one of the ``popup_*`` methods from :ref:`Window` on the node, such as :ref:`Window.popup_centered_clamped()`. + .. rst-class:: classref-reftable-group Propriétés diff --git a/classes/fr/class_control.rst b/classes/fr/class_control.rst index 6c1b88e777..7e696856fc 100644 --- a/classes/fr/class_control.rst +++ b/classes/fr/class_control.rst @@ -16,27 +16,27 @@ Classe de base pour tous les contrôles GUI. Adapte sa position et sa taille en Description ----------- -Classe de base pour tous les nœuds liés à l'interface utilisateur. **Control** contient un rectangle englobant qui définit sa taille, une position d'ancrage par rapport au contrôle parent ou au viewport actuel, et des déclages qui représentent relatifs à l'ancrage. Les décalages se mettent à jour automatiquement lorsque le nœud, l'un de ses parents ou la taille de l'écran changent. +Base class for all UI-related nodes. **Control** features a bounding rectangle that defines its extents, an anchor position relative to its parent control or the current viewport, and offsets relative to the anchor. The offsets update automatically when the node, any of its parents, or the screen size change. -Pour plus d'informations sur le système d'interface utilisateur de Godot, les ancres, les décalages, les conteneurs, voir les tutoriels correspondants dans le manuel. Pour construire des interfaces flexibles, vous avez besoin d'un ensemble d'éléments d'interface utilisateur héritant des nœuds **Control** et :ref:`Container`. +For more information on Godot's UI system, anchors, offsets, and containers, see the related tutorials in the manual. To build flexible UIs, you'll need a mix of UI elements that inherit from **Control** and :ref:`Container` nodes. -\ **Note :** Comme :ref:`Node2D` et **Control** héritent tous deux de :ref:`CanvasItem`, ils partagent de nombreux concepts de la classe, comme les propriétés :ref:`CanvasItem.z_index` et :ref:`CanvasItem.visible`. +\ **Note:** Since both :ref:`Node2D` and **Control** inherit from :ref:`CanvasItem`, they share several concepts from the class such as the :ref:`CanvasItem.z_index` and :ref:`CanvasItem.visible` properties. -\ **Nœuds d'interface utilisateur et entrées**\ +\ **User Interface nodes and input**\ -Godot propage les évènements d'entrée via les viewports. Chaque :ref:`Viewport` est responsable de propage des :ref:`InputEvent`\ s à ses nœuds enfants. Comme :ref:`SceneTree.root` est une :ref:`Window`, cela se déroule déjà automatiquement pour les évènements d'interface utilisateur dans votre jeu. +Godot propagates input events via viewports. Each :ref:`Viewport` is responsible for propagating :ref:`InputEvent`\ s to their child nodes. As the :ref:`SceneTree.root` is a :ref:`Window`, this already happens automatically for all UI elements in your game. -Les événements d'entrée sont propagés dans le :ref:`SceneTree` à partir du nœud racine de la scène vers les nœuds enfants, en appelant :ref:`Node._input()`. Pour les éléments d'UI spécifiquement, il est plus logique de redéfinir la méthode virtuelle :ref:`_gui_input()`, qui filtre les évènements d'entrée sans rapport, en vérifiant le z-order, :ref:`mouse_filter`, le focus, ou si l'évènement était à l'intérieur de la boîte délimitante du contrôle. +Input events are propagated through the :ref:`SceneTree` from the root node to all child nodes by calling :ref:`Node._input()`. For UI elements specifically, it makes more sense to override the virtual method :ref:`_gui_input()`, which filters out unrelated input events, such as by checking z-order, :ref:`mouse_filter`, focus, or if the event was inside of the control's bounding box. -Appelez :ref:`accept_event()` afin qu'aucun autre nœud ne reçoive l'évènement. Une fois que vous acceptez une entrée, elle devient gérée et :ref:`Node._unhandled_input()` ne la traitera donc pas. +Call :ref:`accept_event()` so no other node receives the event. Once you accept an input, it becomes handled so :ref:`Node._unhandled_input()` will not process it. -Seul un nœud **Control** peut avoir le focus. Seulement le nœud avec le focus recevra des événements. Pour obtenir le focus, appelez :ref:`grab_focus()`. Les nœuds **Control** perdent le focus lorsqu'un autre nœud le prend, ou si vous cachez le nœud ayant le focus. +Only one **Control** node can be in focus. Only the node in focus will receive events. To get the focus, call :ref:`grab_focus()`. **Control** nodes lose focus when another node grabs it, or if you hide the node in focus. Focus will not be represented visually if gained via mouse/touch input, only appearing with keyboard/gamepad input (for accessibility), or via :ref:`grab_focus()`. -Définissez :ref:`mouse_filter` à :ref:`MOUSE_FILTER_IGNORE` pour indiquer qu'un nœud **Control** doit ignorer les événements de la souris ou du clavier. Vous en aurez besoin si vous placez une icône par dessus un bouton. +Set :ref:`mouse_filter` to :ref:`MOUSE_FILTER_IGNORE` to tell a **Control** node to ignore mouse or touch events. You'll need it if you place an icon on top of a button. -Les ressources :ref:`Theme` changent l'aspect du contrôle. Le :ref:`theme` d'un nœud **Control** affecte tous ses enfants directs et indirects (tant qu'une chaîne de contrôles est ininterrompue). Pour redéfinir certains paramètres du thème, appelez l'une des méthodes ``add_theme_*_override``, comme :ref:`add_theme_font_override()`. Vous pouvez redéfinir les éléments du thème depuis l'Inspecteur. +\ :ref:`Theme` resources change the control's appearance. The :ref:`theme` of a **Control** node affects all of its direct and indirect children (as long as a chain of controls is uninterrupted). To override some of the theme items, call one of the ``add_theme_*_override`` methods, like :ref:`add_theme_font_override()`. You can also override theme items in the Inspector. -\ **Note :** Les objets de thème ne sont *pas* des propriétés :ref:`Object`. Cela signifie que vous ne pouvez pas accéder à leurs valeurs en utilisant :ref:`Object.get()` et :ref:`Object.set()`. À la place, utilisez les méthodes ``get_theme_*`` et ``add_theme_*_override`` fournies par cette classe. +\ **Note:** Theme items are *not* :ref:`Object` properties. This means you can't access their values using :ref:`Object.get()` and :ref:`Object.set()`. Instead, use the ``get_theme_*`` and ``add_theme_*_override`` methods provided by this class. .. rst-class:: classref-introduction-group @@ -136,6 +136,8 @@ Propriétés +------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`pivot_offset` | ``Vector2(0, 0)`` | +------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ + | :ref:`Vector2` | :ref:`pivot_offset_ratio` | ``Vector2(0, 0)`` | + +------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`position` | ``Vector2(0, 0)`` | +------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+ | :ref:`float` | :ref:`rotation` | ``0.0`` | @@ -230,6 +232,8 @@ Méthodes +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`get_combined_minimum_size`\ (\ ) |const| | +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + | :ref:`Vector2` | :ref:`get_combined_pivot_offset`\ (\ ) |const| | + +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`CursorShape` | :ref:`get_cursor_shape`\ (\ position\: :ref:`Vector2` = Vector2(0, 0)\ ) |const| | +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`get_end`\ (\ ) |const| | @@ -276,9 +280,9 @@ Méthodes +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`grab_click_focus`\ (\ ) | +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | |void| | :ref:`grab_focus`\ (\ ) | + | |void| | :ref:`grab_focus`\ (\ hide_focus\: :ref:`bool` = false\ ) | +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - | :ref:`bool` | :ref:`has_focus`\ (\ ) |const| | + | :ref:`bool` | :ref:`has_focus`\ (\ ignore_hidden_focus\: :ref:`bool` = false\ ) |const| | +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_theme_color`\ (\ name\: :ref:`StringName`, theme_type\: :ref:`StringName` = &""\ ) |const| | +--------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ @@ -595,7 +599,7 @@ Empêche le contrôle de recevoir l'entrée de la souris. :ref:`get_mouse_filter :ref:`MouseBehaviorRecursive` **MOUSE_BEHAVIOR_ENABLED** = ``2`` -Permet au contrôle de recevoir l'entrée de la souris, en fonction de :ref:`mouse_filter`. Cela peut être utilisé pour ignorer le :ref:`mouse_behavior_recursive` du parent. :ref:`get_mouse_filter_with_override()` renverra :ref:`mouse_filter`. +Allows the control to receive mouse input, depending on the :ref:`mouse_filter`. This can be used to ignore the parent's :ref:`mouse_behavior_recursive`. :ref:`get_mouse_filter_with_override()` will return the :ref:`mouse_filter`. .. rst-class:: classref-item-separator @@ -1274,7 +1278,9 @@ Envoyé lorsque le nœud reçoit le focus. **NOTIFICATION_FOCUS_EXIT** = ``44`` :ref:`🔗` -Envoyé lorsque le nœud perd le focus. +Sent when the node loses focus. + +This notification is sent in reversed order. .. _class_Control_constant_NOTIFICATION_THEME_CHANGED: @@ -1964,7 +1970,28 @@ Les décalages sont souvent contrôlés par un ou plusieurs nœuds :ref:`Contain - |void| **set_pivot_offset**\ (\ value\: :ref:`Vector2`\ ) - :ref:`Vector2` **get_pivot_offset**\ (\ ) -Par défaut, le pivot du nœud est son coin supérieur gauche. Lorsque vous modifiez sa :ref:`rotation` ou son échelle :ref:`scale`, il tournera ou se redimensionnera autour de ce pivot. Définir cette propriété à :ref:`size` / 2 permet de pivoter autour du centre du contrôle. +By default, the node's pivot is its top-left corner. When you change its :ref:`rotation` or :ref:`scale`, it will rotate or scale around this pivot. + +The actual offset is the combined value of this property and :ref:`pivot_offset_ratio`. + +.. rst-class:: classref-item-separator + +---- + +.. _class_Control_property_pivot_offset_ratio: + +.. rst-class:: classref-property + +:ref:`Vector2` **pivot_offset_ratio** = ``Vector2(0, 0)`` :ref:`🔗` + +.. rst-class:: classref-property-setget + +- |void| **set_pivot_offset_ratio**\ (\ value\: :ref:`Vector2`\ ) +- :ref:`Vector2` **get_pivot_offset_ratio**\ (\ ) + +Same as :ref:`pivot_offset`, but expressed as uniform vector, where ``Vector2(0, 0)`` is the top-left corner of this control, and ``Vector2(1, 1)`` is its bottom-right corner. Set this property to ``Vector2(0.5, 0.5)`` to pivot around this control's center. + +The actual offset is the combined value of this property and :ref:`pivot_offset`. .. rst-class:: classref-item-separator @@ -2481,19 +2508,19 @@ Si non redéfini, le comportement par défaut vérifie si le point se trouve dan :ref:`Object` **_make_custom_tooltip**\ (\ for_text\: :ref:`String`\ ) |virtual| |const| :ref:`🔗` -Méthode virtuelle à implémenter par l'utilisateur. Renvoie un nœud **Control** qui devrait être utilisé pour l'infobulle plutôt que celui par défaut. Le texte ``for_text`` contient le valeur de renvoi de :ref:`get_tooltip()`. +Virtual method to be implemented by the user. Returns a **Control** node that should be used as a tooltip instead of the default one. ``for_text`` is the return value of :ref:`get_tooltip()`. -Le nœud renvoyé doit être du type **Control** ou en hériter. Il peut avoir des nœuds enfants de n'importe quel type. Il est libéré quand l'infobulle disparaît, alors assurez vous que vous fournissez toujours une nouvelle instance (si vous voulez utiliser un nœud déjà existant dans votre arborescence de scène, vous pouvez le dupliquer et passer cette instance dupliquée). Quand ``null`` ou un nœud non-Control est renvoyé, l'infobulle par défaut sera utilisée à la place. +The returned node must be of type **Control** or Control-derived. It can have child nodes of any type. It is freed when the tooltip disappears, so make sure you always provide a new instance (if you want to use a pre-existing node from your scene tree, you can duplicate it and pass the duplicated instance). When ``null`` or a non-Control node is returned, the default tooltip will be used instead. -Le nœud renvoyé sera ajouté comme enfant à un :ref:`PopupPanel`, vous devriez donc fournir uniquement le contenu de ce panneau. Ce :ref:`PopupPanel` peut avoir un thème défini par :ref:`Theme.set_stylebox()` pour le type ``"TooltipPanel"`` (voir :ref:`tooltip_text` pour un exemple). +The returned node will be added as child to a :ref:`PopupPanel`, so you should only provide the contents of that panel. That :ref:`PopupPanel` can be themed using :ref:`Theme.set_stylebox()` for the type ``"TooltipPanel"`` (see :ref:`tooltip_text` for an example). -\ **Note :** L'infobulle est réduite à sa taille minimale. Si vous voulez vous assurer qu'elle soit entièrement visible, vous devriez définir sa taille minimale :ref:`custom_minimum_size` à une valeur non-nulle. +\ **Note:** The tooltip is shrunk to minimal size. If you want to ensure it's fully visible, you might want to set its :ref:`custom_minimum_size` to some non-zero value. -\ **Note :** Le nœud (et tous les enfants pertinents) devraient avoir leur :ref:`CanvasItem.visible` défini à ``true`` lorsque renvoyé, sinon, le viewport qui l'instancie ne pourra pas calculer sa taille minimale de manière fiable. +\ **Note:** The node (and any relevant children) should have their :ref:`CanvasItem.visible` set to ``true`` when returned, otherwise, the viewport that instantiates it will not be able to calculate its minimum size reliably. -\ **Note :** Si cette méthode est redéfinie, même si :ref:`get_tooltip()` renvoie une chaîne vide. Lorsque cela se produit avec l'infobulle par défaut, elle n'est pas affichée. Pour copier ce comportement, renvoyez ``null`` dans cette méthode lorsque ``for_text`` est vide. +\ **Note:** If overridden, this method is called even if :ref:`get_tooltip()` returns an empty string. When this happens with the default tooltip, it is not displayed. To copy this behavior, return ``null`` in this method when ``for_text`` is empty. -\ **Exemple :** Utiliser un nœud construit comme info-bulle : +\ **Example:** Use a constructed node as a tooltip: .. tabs:: @@ -2516,7 +2543,7 @@ Le nœud renvoyé sera ajouté comme enfant à un :ref:`PopupPanel("res://une_scene_d_infobulle.tscn").Instantiate(); - infobulle.GetNode