Files
godot-docs-l10n/classes/es/class_label3d.rst
Rémi Verschelde c3f2364c10 Sync classref with 4.6 branch
Lots of translations invalidated (fuzzied) as we just synced Weblate.
2025-12-19 16:39:51 +01:00

854 lines
48 KiB
ReStructuredText

:github_url: hide
.. meta::
:keywords: text
.. _class_Label3D:
Label3D
=======
**Hereda:** :ref:`GeometryInstance3D<class_GeometryInstance3D>` **<** :ref:`VisualInstance3D<class_VisualInstance3D>` **<** :ref:`Node3D<class_Node3D>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
Un nodo para mostrar texto plano en el espacio 3D.
.. rst-class:: classref-introduction-group
Descripción
----------------------
Un nodo para mostrar texto plano en el espacio 3D. Ajustando varias propiedades de este nodo, puedes configurar cosas como la apariencia del texto y si siempre mira hacia la cámara.
.. rst-class:: classref-introduction-group
Tutoriales
--------------------
- :doc:`Texto 3D <../tutorials/3d/3d_text>`
.. rst-class:: classref-reftable-group
Propiedades
----------------------
.. table::
:widths: auto
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`alpha_antialiasing_edge<class_Label3D_property_alpha_antialiasing_edge>` | ``0.0`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`AlphaAntiAliasing<enum_BaseMaterial3D_AlphaAntiAliasing>` | :ref:`alpha_antialiasing_mode<class_Label3D_property_alpha_antialiasing_mode>` | ``0`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`AlphaCutMode<enum_Label3D_AlphaCutMode>` | :ref:`alpha_cut<class_Label3D_property_alpha_cut>` | ``0`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`alpha_hash_scale<class_Label3D_property_alpha_hash_scale>` | ``1.0`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`alpha_scissor_threshold<class_Label3D_property_alpha_scissor_threshold>` | ``0.5`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`AutowrapMode<enum_TextServer_AutowrapMode>` | :ref:`autowrap_mode<class_Label3D_property_autowrap_mode>` | ``0`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| |bitfield|\[:ref:`LineBreakFlag<enum_TextServer_LineBreakFlag>`\] | :ref:`autowrap_trim_flags<class_Label3D_property_autowrap_trim_flags>` | ``192`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`BillboardMode<enum_BaseMaterial3D_BillboardMode>` | :ref:`billboard<class_Label3D_property_billboard>` | ``0`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`ShadowCastingSetting<enum_GeometryInstance3D_ShadowCastingSetting>` | cast_shadow | ``0`` (overrides :ref:`GeometryInstance3D<class_GeometryInstance3D_property_cast_shadow>`) |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`double_sided<class_Label3D_property_double_sided>` | ``true`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`fixed_size<class_Label3D_property_fixed_size>` | ``false`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`Font<class_Font>` | :ref:`font<class_Label3D_property_font>` | |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`font_size<class_Label3D_property_font_size>` | ``32`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`GIMode<enum_GeometryInstance3D_GIMode>` | gi_mode | ``0`` (overrides :ref:`GeometryInstance3D<class_GeometryInstance3D_property_gi_mode>`) |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` | :ref:`horizontal_alignment<class_Label3D_property_horizontal_alignment>` | ``1`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| |bitfield|\[:ref:`JustificationFlag<enum_TextServer_JustificationFlag>`\] | :ref:`justification_flags<class_Label3D_property_justification_flags>` | ``163`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`language<class_Label3D_property_language>` | ``""`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`line_spacing<class_Label3D_property_line_spacing>` | ``0.0`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`Color<class_Color>` | :ref:`modulate<class_Label3D_property_modulate>` | ``Color(1, 1, 1, 1)`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`no_depth_test<class_Label3D_property_no_depth_test>` | ``false`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`Vector2<class_Vector2>` | :ref:`offset<class_Label3D_property_offset>` | ``Vector2(0, 0)`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`Color<class_Color>` | :ref:`outline_modulate<class_Label3D_property_outline_modulate>` | ``Color(0, 0, 0, 1)`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`outline_render_priority<class_Label3D_property_outline_render_priority>` | ``-1`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`outline_size<class_Label3D_property_outline_size>` | ``12`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`pixel_size<class_Label3D_property_pixel_size>` | ``0.005`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`render_priority<class_Label3D_property_render_priority>` | ``0`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`shaded<class_Label3D_property_shaded>` | ``false`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` | :ref:`structured_text_bidi_override<class_Label3D_property_structured_text_bidi_override>` | ``0`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`Array<class_Array>` | :ref:`structured_text_bidi_override_options<class_Label3D_property_structured_text_bidi_override_options>` | ``[]`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`text<class_Label3D_property_text>` | ``""`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`Direction<enum_TextServer_Direction>` | :ref:`text_direction<class_Label3D_property_text_direction>` | ``0`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`TextureFilter<enum_BaseMaterial3D_TextureFilter>` | :ref:`texture_filter<class_Label3D_property_texture_filter>` | ``3`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`uppercase<class_Label3D_property_uppercase>` | ``false`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` | :ref:`vertical_alignment<class_Label3D_property_vertical_alignment>` | ``1`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`width<class_Label3D_property_width>` | ``500.0`` |
+---------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------+
.. rst-class:: classref-reftable-group
Métodos
--------------
.. table::
:widths: auto
+-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`TriangleMesh<class_TriangleMesh>` | :ref:`generate_triangle_mesh<class_Label3D_method_generate_triangle_mesh>`\ (\ ) |const| |
+-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`get_draw_flag<class_Label3D_method_get_draw_flag>`\ (\ flag\: :ref:`DrawFlags<enum_Label3D_DrawFlags>`\ ) |const| |
+-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_draw_flag<class_Label3D_method_set_draw_flag>`\ (\ flag\: :ref:`DrawFlags<enum_Label3D_DrawFlags>`, enabled\: :ref:`bool<class_bool>`\ ) |
+-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Enumeraciones
--------------------------
.. _enum_Label3D_DrawFlags:
.. rst-class:: classref-enumeration
enum **DrawFlags**: :ref:`🔗<enum_Label3D_DrawFlags>`
.. _class_Label3D_constant_FLAG_SHADED:
.. rst-class:: classref-enumeration-constant
:ref:`DrawFlags<enum_Label3D_DrawFlags>` **FLAG_SHADED** = ``0``
Si se establece, las luces del entorno afectan la etiqueta.
.. _class_Label3D_constant_FLAG_DOUBLE_SIDED:
.. rst-class:: classref-enumeration-constant
:ref:`DrawFlags<enum_Label3D_DrawFlags>` **FLAG_DOUBLE_SIDED** = ``1``
Si está activado, el texto también puede verse desde atrás. Si no, el texto es invisible cuando se mira desde atrás.
.. _class_Label3D_constant_FLAG_DISABLE_DEPTH_TEST:
.. rst-class:: classref-enumeration-constant
:ref:`DrawFlags<enum_Label3D_DrawFlags>` **FLAG_DISABLE_DEPTH_TEST** = ``2``
Desactiva la prueba de profundidad, así que este objeto se dibuja encima de todos los demás. Sin embargo, los objetos dibujados después de él en el orden de dibujo pueden cubrirlo.
.. _class_Label3D_constant_FLAG_FIXED_SIZE:
.. rst-class:: classref-enumeration-constant
:ref:`DrawFlags<enum_Label3D_DrawFlags>` **FLAG_FIXED_SIZE** = ``3``
La etiqueta se escala según la profundidad para que siempre aparezca del mismo tamaño en la pantalla.
.. _class_Label3D_constant_FLAG_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`DrawFlags<enum_Label3D_DrawFlags>` **FLAG_MAX** = ``4``
Representa el tamaño del enum :ref:`DrawFlags<enum_Label3D_DrawFlags>`.
.. rst-class:: classref-item-separator
----
.. _enum_Label3D_AlphaCutMode:
.. rst-class:: classref-enumeration
enum **AlphaCutMode**: :ref:`🔗<enum_Label3D_AlphaCutMode>`
.. _class_Label3D_constant_ALPHA_CUT_DISABLED:
.. rst-class:: classref-enumeration-constant
:ref:`AlphaCutMode<enum_Label3D_AlphaCutMode>` **ALPHA_CUT_DISABLED** = ``0``
Este modo realiza una mezcla alfa estándar. Puede mostrar áreas translúcidas, pero pueden ser visibles problemas de ordenación de transparencias cuando se superponen múltiples materiales transparentes. :ref:`GeometryInstance3D.cast_shadow<class_GeometryInstance3D_property_cast_shadow>` no tiene efecto cuando se utiliza este modo de transparencia; la **Label3D** nunca proyectará sombras.
.. _class_Label3D_constant_ALPHA_CUT_DISCARD:
.. rst-class:: classref-enumeration-constant
:ref:`AlphaCutMode<enum_Label3D_AlphaCutMode>` **ALPHA_CUT_DISCARD** = ``1``
Este modo solo permite píxeles totalmente transparentes o totalmente opacos. Los bordes duros serán visibles a menos que se habilite alguna forma de antialiasing de espacio de pantalla (véase :ref:`ProjectSettings.rendering/anti_aliasing/quality/screen_space_aa<class_ProjectSettings_property_rendering/anti_aliasing/quality/screen_space_aa>`). Este modo también se conoce como *prueba alfa* o *transparencia de 1 bit*.
\ **Nota:** Este modo puede tener problemas con las fuentes y contornos con suavizado, intente ajustar :ref:`alpha_scissor_threshold<class_Label3D_property_alpha_scissor_threshold>` o utilizar una fuente MSDF.
\ **Nota:** Cuando se utiliza texto con glifos superpuestos (por ejemplo, escrituras cursivas), este modo puede tener problemas de clasificación de transparencias entre el texto principal y el contorno.
.. _class_Label3D_constant_ALPHA_CUT_OPAQUE_PREPASS:
.. rst-class:: classref-enumeration-constant
:ref:`AlphaCutMode<enum_Label3D_AlphaCutMode>` **ALPHA_CUT_OPAQUE_PREPASS** = ``2``
Este modo dibuja píxeles totalmente opacos en el prepass de profundidad. Esto es más lento que :ref:`ALPHA_CUT_DISABLED<class_Label3D_constant_ALPHA_CUT_DISABLED>` o :ref:`ALPHA_CUT_DISCARD<class_Label3D_constant_ALPHA_CUT_DISCARD>`, pero permite mostrar áreas translúcidas y bordes suaves mientras se utiliza una clasificación adecuada.
\ **Nota:** Al utilizar texto con glifos superpuestos (por ejemplo, escrituras cursivas), este modo puede tener problemas de clasificación de transparencias entre el texto principal y el contorno.
.. _class_Label3D_constant_ALPHA_CUT_HASH:
.. rst-class:: classref-enumeration-constant
:ref:`AlphaCutMode<enum_Label3D_AlphaCutMode>` **ALPHA_CUT_HASH** = ``3``
Este modo corta todos los valores por debajo de un umbral espacialmente determinista; el resto permanecerá opaco.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descripciones de Propiedades
--------------------------------------------------------
.. _class_Label3D_property_alpha_antialiasing_edge:
.. rst-class:: classref-property
:ref:`float<class_float>` **alpha_antialiasing_edge** = ``0.0`` :ref:`🔗<class_Label3D_property_alpha_antialiasing_edge>`
.. rst-class:: classref-property-setget
- |void| **set_alpha_antialiasing_edge**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_alpha_antialiasing_edge**\ (\ )
Threshold at which antialiasing will be applied on the alpha channel.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_alpha_antialiasing_mode:
.. rst-class:: classref-property
:ref:`AlphaAntiAliasing<enum_BaseMaterial3D_AlphaAntiAliasing>` **alpha_antialiasing_mode** = ``0`` :ref:`🔗<class_Label3D_property_alpha_antialiasing_mode>`
.. rst-class:: classref-property-setget
- |void| **set_alpha_antialiasing**\ (\ value\: :ref:`AlphaAntiAliasing<enum_BaseMaterial3D_AlphaAntiAliasing>`\ )
- :ref:`AlphaAntiAliasing<enum_BaseMaterial3D_AlphaAntiAliasing>` **get_alpha_antialiasing**\ (\ )
El tipo de antialiasing alfa que se aplicará.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_alpha_cut:
.. rst-class:: classref-property
:ref:`AlphaCutMode<enum_Label3D_AlphaCutMode>` **alpha_cut** = ``0`` :ref:`🔗<class_Label3D_property_alpha_cut>`
.. rst-class:: classref-property-setget
- |void| **set_alpha_cut_mode**\ (\ value\: :ref:`AlphaCutMode<enum_Label3D_AlphaCutMode>`\ )
- :ref:`AlphaCutMode<enum_Label3D_AlphaCutMode>` **get_alpha_cut_mode**\ (\ )
El modo de corte alfa a utilizar para el sprite.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_alpha_hash_scale:
.. rst-class:: classref-property
:ref:`float<class_float>` **alpha_hash_scale** = ``1.0`` :ref:`🔗<class_Label3D_property_alpha_hash_scale>`
.. rst-class:: classref-property-setget
- |void| **set_alpha_hash_scale**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_alpha_hash_scale**\ (\ )
The hashing scale for Alpha Hash. Recommended values between ``0`` and ``2``.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_alpha_scissor_threshold:
.. rst-class:: classref-property
:ref:`float<class_float>` **alpha_scissor_threshold** = ``0.5`` :ref:`🔗<class_Label3D_property_alpha_scissor_threshold>`
.. rst-class:: classref-property-setget
- |void| **set_alpha_scissor_threshold**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_alpha_scissor_threshold**\ (\ )
Umbral en el que el alpha scissor descartará los valores.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_autowrap_mode:
.. rst-class:: classref-property
:ref:`AutowrapMode<enum_TextServer_AutowrapMode>` **autowrap_mode** = ``0`` :ref:`🔗<class_Label3D_property_autowrap_mode>`
.. rst-class:: classref-property-setget
- |void| **set_autowrap_mode**\ (\ value\: :ref:`AutowrapMode<enum_TextServer_AutowrapMode>`\ )
- :ref:`AutowrapMode<enum_TextServer_AutowrapMode>` **get_autowrap_mode**\ (\ )
Si se establece en algo que no sea :ref:`TextServer.AUTOWRAP_OFF<class_TextServer_constant_AUTOWRAP_OFF>`, el texto se ajusta dentro del rectángulo delimitador del nodo. Si cambias el tamaño del nodo, cambiará su altura automáticamente para mostrar todo el texto.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_autowrap_trim_flags:
.. rst-class:: classref-property
|bitfield|\[:ref:`LineBreakFlag<enum_TextServer_LineBreakFlag>`\] **autowrap_trim_flags** = ``192`` :ref:`🔗<class_Label3D_property_autowrap_trim_flags>`
.. rst-class:: classref-property-setget
- |void| **set_autowrap_trim_flags**\ (\ value\: |bitfield|\[:ref:`LineBreakFlag<enum_TextServer_LineBreakFlag>`\]\ )
- |bitfield|\[:ref:`LineBreakFlag<enum_TextServer_LineBreakFlag>`\] **get_autowrap_trim_flags**\ (\ )
Flags de recorte de espacio de ajuste automático. Véase :ref:`TextServer.BREAK_TRIM_START_EDGE_SPACES<class_TextServer_constant_BREAK_TRIM_START_EDGE_SPACES>` y :ref:`TextServer.BREAK_TRIM_END_EDGE_SPACES<class_TextServer_constant_BREAK_TRIM_END_EDGE_SPACES>` para más información.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_billboard:
.. rst-class:: classref-property
:ref:`BillboardMode<enum_BaseMaterial3D_BillboardMode>` **billboard** = ``0`` :ref:`🔗<class_Label3D_property_billboard>`
.. rst-class:: classref-property-setget
- |void| **set_billboard_mode**\ (\ value\: :ref:`BillboardMode<enum_BaseMaterial3D_BillboardMode>`\ )
- :ref:`BillboardMode<enum_BaseMaterial3D_BillboardMode>` **get_billboard_mode**\ (\ )
El modo billboard a usar para la etiqueta.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_double_sided:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **double_sided** = ``true`` :ref:`🔗<class_Label3D_property_double_sided>`
.. rst-class:: classref-property-setget
- |void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_Label3D_DrawFlags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_Label3D_DrawFlags>`\ ) |const|
Si es ``true``, el texto también puede verse desde atrás; si es ``false``, es invisible al mirarlo desde atrás.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_fixed_size:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **fixed_size** = ``false`` :ref:`🔗<class_Label3D_property_fixed_size>`
.. rst-class:: classref-property-setget
- |void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_Label3D_DrawFlags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_Label3D_DrawFlags>`\ ) |const|
Si es ``true``, la etiqueta se renderiza al mismo tamaño sin importar la distancia. El tamaño de la etiqueta en la pantalla es el mismo que si la cámara estuviera a ``1.0`` unidades de distancia del origen de la etiqueta, independientemente de la distancia real de la cámara. El campo de visión de la :ref:`Camera3D<class_Camera3D>` (o :ref:`Camera3D.size<class_Camera3D_property_size>` en modo ortogonal/frustum) todavía afecta el tamaño con el que se dibuja la etiqueta.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_font:
.. rst-class:: classref-property
:ref:`Font<class_Font>` **font** :ref:`🔗<class_Label3D_property_font>`
.. rst-class:: classref-property-setget
- |void| **set_font**\ (\ value\: :ref:`Font<class_Font>`\ )
- :ref:`Font<class_Font>` **get_font**\ (\ )
Configuración de la fuente usada para mostrar texto.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_font_size:
.. rst-class:: classref-property
:ref:`int<class_int>` **font_size** = ``32`` :ref:`🔗<class_Label3D_property_font_size>`
.. rst-class:: classref-property-setget
- |void| **set_font_size**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_font_size**\ (\ )
Tamaño de la fuente del texto de **Label3D**. Para que la fuente se vea más detallada de cerca, aumenta :ref:`font_size<class_Label3D_property_font_size>` mientras disminuyes :ref:`pixel_size<class_Label3D_property_pixel_size>` al mismo tiempo.
Los tamaños de fuente más grandes requieren más tiempo para renderizar nuevos caracteres, lo que puede causar tartamudeo ("stuttering") durante el juego.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_horizontal_alignment:
.. rst-class:: classref-property
:ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **horizontal_alignment** = ``1`` :ref:`🔗<class_Label3D_property_horizontal_alignment>`
.. rst-class:: classref-property-setget
- |void| **set_horizontal_alignment**\ (\ value\: :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>`\ )
- :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **get_horizontal_alignment**\ (\ )
Controla la alineación horizontal del texto. Admite izquierda, centro, derecha y relleno (también conocido como justificar).
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_justification_flags:
.. rst-class:: classref-property
|bitfield|\[:ref:`JustificationFlag<enum_TextServer_JustificationFlag>`\] **justification_flags** = ``163`` :ref:`🔗<class_Label3D_property_justification_flags>`
.. rst-class:: classref-property-setget
- |void| **set_justification_flags**\ (\ value\: |bitfield|\[:ref:`JustificationFlag<enum_TextServer_JustificationFlag>`\]\ )
- |bitfield|\[:ref:`JustificationFlag<enum_TextServer_JustificationFlag>`\] **get_justification_flags**\ (\ )
Reglas de alineación de relleno de línea.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_language:
.. rst-class:: classref-property
:ref:`String<class_String>` **language** = ``""`` :ref:`🔗<class_Label3D_property_language>`
.. rst-class:: classref-property-setget
- |void| **set_language**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_language**\ (\ )
Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_line_spacing:
.. rst-class:: classref-property
:ref:`float<class_float>` **line_spacing** = ``0.0`` :ref:`🔗<class_Label3D_property_line_spacing>`
.. rst-class:: classref-property-setget
- |void| **set_line_spacing**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_line_spacing**\ (\ )
Additional vertical spacing between lines (in pixels), spacing is added to line descent. This value can be negative.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_modulate:
.. rst-class:: classref-property
:ref:`Color<class_Color>` **modulate** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_Label3D_property_modulate>`
.. rst-class:: classref-property-setget
- |void| **set_modulate**\ (\ value\: :ref:`Color<class_Color>`\ )
- :ref:`Color<class_Color>` **get_modulate**\ (\ )
:ref:`Color<class_Color>` de texto de la **Label3D**.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_no_depth_test:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **no_depth_test** = ``false`` :ref:`🔗<class_Label3D_property_no_depth_test>`
.. rst-class:: classref-property-setget
- |void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_Label3D_DrawFlags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_Label3D_DrawFlags>`\ ) |const|
Si es ``true``, la prueba de profundidad está desactivada y el objeto se dibujará en orden de renderizado.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_offset:
.. rst-class:: classref-property
:ref:`Vector2<class_Vector2>` **offset** = ``Vector2(0, 0)`` :ref:`🔗<class_Label3D_property_offset>`
.. rst-class:: classref-property-setget
- |void| **set_offset**\ (\ value\: :ref:`Vector2<class_Vector2>`\ )
- :ref:`Vector2<class_Vector2>` **get_offset**\ (\ )
El desplazamiento del dibujo del texto (en píxeles).
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_outline_modulate:
.. rst-class:: classref-property
:ref:`Color<class_Color>` **outline_modulate** = ``Color(0, 0, 0, 1)`` :ref:`🔗<class_Label3D_property_outline_modulate>`
.. rst-class:: classref-property-setget
- |void| **set_outline_modulate**\ (\ value\: :ref:`Color<class_Color>`\ )
- :ref:`Color<class_Color>` **get_outline_modulate**\ (\ )
El tinte del contorno del texto.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_outline_render_priority:
.. rst-class:: classref-property
:ref:`int<class_int>` **outline_render_priority** = ``-1`` :ref:`🔗<class_Label3D_property_outline_render_priority>`
.. rst-class:: classref-property-setget
- |void| **set_outline_render_priority**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_outline_render_priority**\ (\ )
Establece la prioridad de renderizado para el contorno del texto. Los objetos de mayor prioridad se ordenarán por delante de los de menor prioridad.
\ **Nota:** Esto solo se aplica si :ref:`alpha_cut<class_Label3D_property_alpha_cut>` está configurado como :ref:`ALPHA_CUT_DISABLED<class_Label3D_constant_ALPHA_CUT_DISABLED>` (valor predeterminado).
\ **Nota:** Esto solo se aplica al ordenamiento de objetos transparentes. Esto no afectará cómo se ordenan los objetos transparentes en relación con los objetos opacos. Esto se debe a que los objetos opacos no se ordenan, mientras que los objetos transparentes se ordenan de atrás hacia adelante (sujeto a prioridad).
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_outline_size:
.. rst-class:: classref-property
:ref:`int<class_int>` **outline_size** = ``12`` :ref:`🔗<class_Label3D_property_outline_size>`
.. rst-class:: classref-property-setget
- |void| **set_outline_size**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_outline_size**\ (\ )
Tamaño del contorno del texto.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_pixel_size:
.. rst-class:: classref-property
:ref:`float<class_float>` **pixel_size** = ``0.005`` :ref:`🔗<class_Label3D_property_pixel_size>`
.. rst-class:: classref-property-setget
- |void| **set_pixel_size**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_pixel_size**\ (\ )
El tamaño del ancho de un píxel en la etiqueta para escalarla en 3D. Para que la fuente se vea más detallada de cerca, aumenta :ref:`font_size<class_Label3D_property_font_size>` mientras disminuyes :ref:`pixel_size<class_Label3D_property_pixel_size>` al mismo tiempo.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_render_priority:
.. rst-class:: classref-property
:ref:`int<class_int>` **render_priority** = ``0`` :ref:`🔗<class_Label3D_property_render_priority>`
.. rst-class:: classref-property-setget
- |void| **set_render_priority**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_render_priority**\ (\ )
Establece la prioridad de renderizado del texto. Los objetos de mayor prioridad se ordenarán delante de los objetos de menor prioridad.
\ **Nota:** Esto solo se aplica si :ref:`alpha_cut<class_Label3D_property_alpha_cut>` está establecido en :ref:`ALPHA_CUT_DISABLED<class_Label3D_constant_ALPHA_CUT_DISABLED>` (valor predeterminado).
\ **Nota:** Esto solo se aplica a la ordenación de objetos transparentes. Esto no afectará a la forma en que se ordenan los objetos transparentes en relación con los objetos opacos. Esto se debe a que los objetos opacos no se ordenan, mientras que los objetos transparentes se ordenan de atrás hacia adelante (sujeto a prioridad).
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_shaded:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **shaded** = ``false`` :ref:`🔗<class_Label3D_property_shaded>`
.. rst-class:: classref-property-setget
- |void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_Label3D_DrawFlags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_Label3D_DrawFlags>`\ ) |const|
Si es ``true``, la :ref:`Light3D<class_Light3D>` en el :ref:`Environment<class_Environment>` tiene efectos sobre la etiqueta.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_structured_text_bidi_override:
.. rst-class:: classref-property
:ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **structured_text_bidi_override** = ``0`` :ref:`🔗<class_Label3D_property_structured_text_bidi_override>`
.. rst-class:: classref-property-setget
- |void| **set_structured_text_bidi_override**\ (\ value\: :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>`\ )
- :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **get_structured_text_bidi_override**\ (\ )
Establece la sobrescritura del algoritmo BiDi para el texto estructurado.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_structured_text_bidi_override_options:
.. rst-class:: classref-property
:ref:`Array<class_Array>` **structured_text_bidi_override_options** = ``[]`` :ref:`🔗<class_Label3D_property_structured_text_bidi_override_options>`
.. rst-class:: classref-property-setget
- |void| **set_structured_text_bidi_override_options**\ (\ value\: :ref:`Array<class_Array>`\ )
- :ref:`Array<class_Array>` **get_structured_text_bidi_override_options**\ (\ )
Establece opciones adicionales para la sobrescritura BiDi.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_text:
.. rst-class:: classref-property
:ref:`String<class_String>` **text** = ``""`` :ref:`🔗<class_Label3D_property_text>`
.. rst-class:: classref-property-setget
- |void| **set_text**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_text**\ (\ )
El texto a mostrar en la pantalla.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_text_direction:
.. rst-class:: classref-property
:ref:`Direction<enum_TextServer_Direction>` **text_direction** = ``0`` :ref:`🔗<class_Label3D_property_text_direction>`
.. rst-class:: classref-property-setget
- |void| **set_text_direction**\ (\ value\: :ref:`Direction<enum_TextServer_Direction>`\ )
- :ref:`Direction<enum_TextServer_Direction>` **get_text_direction**\ (\ )
Dirección base de escritura del texto.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_texture_filter:
.. rst-class:: classref-property
:ref:`TextureFilter<enum_BaseMaterial3D_TextureFilter>` **texture_filter** = ``3`` :ref:`🔗<class_Label3D_property_texture_filter>`
.. rst-class:: classref-property-setget
- |void| **set_texture_filter**\ (\ value\: :ref:`TextureFilter<enum_BaseMaterial3D_TextureFilter>`\ )
- :ref:`TextureFilter<enum_BaseMaterial3D_TextureFilter>` **get_texture_filter**\ (\ )
Filtrar banderas para la textura.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_uppercase:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **uppercase** = ``false`` :ref:`🔗<class_Label3D_property_uppercase>`
.. rst-class:: classref-property-setget
- |void| **set_uppercase**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_uppercase**\ (\ )
Si es ``true``, todo el texto se muestra como MAYÚSCULAS.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_vertical_alignment:
.. rst-class:: classref-property
:ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` **vertical_alignment** = ``1`` :ref:`🔗<class_Label3D_property_vertical_alignment>`
.. rst-class:: classref-property-setget
- |void| **set_vertical_alignment**\ (\ value\: :ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>`\ )
- :ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` **get_vertical_alignment**\ (\ )
Controla la alineación vertical del texto. Admite alineación superior, centrada e inferior.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_property_width:
.. rst-class:: classref-property
:ref:`float<class_float>` **width** = ``500.0`` :ref:`🔗<class_Label3D_property_width>`
.. rst-class:: classref-property-setget
- |void| **set_width**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_width**\ (\ )
Ancho del texto (en píxeles), usado para el ajuste automático de línea y la alineación de relleno.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descripciones de Métodos
------------------------------------------------
.. _class_Label3D_method_generate_triangle_mesh:
.. rst-class:: classref-method
:ref:`TriangleMesh<class_TriangleMesh>` **generate_triangle_mesh**\ (\ ) |const| :ref:`🔗<class_Label3D_method_generate_triangle_mesh>`
Devuelve una :ref:`TriangleMesh<class_TriangleMesh>` con los vértices de la etiqueta siguiendo su configuración actual (como su :ref:`pixel_size<class_Label3D_property_pixel_size>`).
.. rst-class:: classref-item-separator
----
.. _class_Label3D_method_get_draw_flag:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **get_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_Label3D_DrawFlags>`\ ) |const| :ref:`🔗<class_Label3D_method_get_draw_flag>`
Devuelve el valor de la flag especificada.
.. rst-class:: classref-item-separator
----
.. _class_Label3D_method_set_draw_flag:
.. rst-class:: classref-method
|void| **set_draw_flag**\ (\ flag\: :ref:`DrawFlags<enum_Label3D_DrawFlags>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_Label3D_method_set_draw_flag>`
Si es ``true``, la ``flag`` especificado se activará.
.. |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.)`