godot-docs-l10n/classes/es/class_resourceimporterlayeredtexture.rst

:github_url: hide

.. DO NOT EDIT THIS FILE!!!
.. Generated automatically from Godot engine sources.
.. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
.. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/ResourceImporterLayeredTexture.xml.

.. _class_ResourceImporterLayeredTexture:

ResourceImporterLayeredTexture
==============================

**Hereda:** :ref:`ResourceImporter<class_ResourceImporter>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`

Importa una textura tridimensional (:ref:`Texture3D<class_Texture3D>`), un :ref:`Texture2DArray<class_Texture2DArray>`, un :ref:`Cubemap<class_Cubemap>` o un :ref:`CubemapArray<class_CubemapArray>`.

.. rst-class:: classref-introduction-group

Descripción
----------------------

Esto importa una textura tridimensional, que luego puede ser usada en shaders personalizados, como un mapa de densidad :ref:`FogMaterial<class_FogMaterial>` o como un :ref:`GPUParticlesAttractorVectorField3D<class_GPUParticlesAttractorVectorField3D>`. Véase también :ref:`ResourceImporterTexture<class_ResourceImporterTexture>` y :ref:`ResourceImporterTextureAtlas<class_ResourceImporterTextureAtlas>`.

.. rst-class:: classref-introduction-group

Tutoriales
--------------------

- :doc:`Importando imágenes <../tutorials/assets_pipeline/importing_images>`

.. rst-class:: classref-reftable-group

Propiedades
----------------------

.. table::
   :widths: auto

   +---------------------------+-----------------------------------------------------------------------------------------------------------+-----------+
   | :ref:`int<class_int>`     | :ref:`compress/channel_pack<class_ResourceImporterLayeredTexture_property_compress/channel_pack>`         | ``0``     |
   +---------------------------+-----------------------------------------------------------------------------------------------------------+-----------+
   | :ref:`int<class_int>`     | :ref:`compress/hdr_compression<class_ResourceImporterLayeredTexture_property_compress/hdr_compression>`   | ``1``     |
   +---------------------------+-----------------------------------------------------------------------------------------------------------+-----------+
   | :ref:`bool<class_bool>`   | :ref:`compress/high_quality<class_ResourceImporterLayeredTexture_property_compress/high_quality>`         | ``false`` |
   +---------------------------+-----------------------------------------------------------------------------------------------------------+-----------+
   | :ref:`float<class_float>` | :ref:`compress/lossy_quality<class_ResourceImporterLayeredTexture_property_compress/lossy_quality>`       | ``0.7``   |
   +---------------------------+-----------------------------------------------------------------------------------------------------------+-----------+
   | :ref:`int<class_int>`     | :ref:`compress/mode<class_ResourceImporterLayeredTexture_property_compress/mode>`                         | ``1``     |
   +---------------------------+-----------------------------------------------------------------------------------------------------------+-----------+
   | :ref:`float<class_float>` | :ref:`compress/rdo_quality_loss<class_ResourceImporterLayeredTexture_property_compress/rdo_quality_loss>` | ``0.0``   |
   +---------------------------+-----------------------------------------------------------------------------------------------------------+-----------+
   | :ref:`int<class_int>`     | :ref:`compress/uastc_level<class_ResourceImporterLayeredTexture_property_compress/uastc_level>`           | ``0``     |
   +---------------------------+-----------------------------------------------------------------------------------------------------------+-----------+
   | :ref:`bool<class_bool>`   | :ref:`mipmaps/generate<class_ResourceImporterLayeredTexture_property_mipmaps/generate>`                   | ``true``  |
   +---------------------------+-----------------------------------------------------------------------------------------------------------+-----------+
   | :ref:`int<class_int>`     | :ref:`mipmaps/limit<class_ResourceImporterLayeredTexture_property_mipmaps/limit>`                         | ``-1``    |
   +---------------------------+-----------------------------------------------------------------------------------------------------------+-----------+
   | :ref:`int<class_int>`     | :ref:`slices/arrangement<class_ResourceImporterLayeredTexture_property_slices/arrangement>`               | ``1``     |
   +---------------------------+-----------------------------------------------------------------------------------------------------------+-----------+

.. rst-class:: classref-section-separator

----

.. rst-class:: classref-descriptions-group

Descripciones de Propiedades
--------------------------------------------------------

.. _class_ResourceImporterLayeredTexture_property_compress/channel_pack:

.. rst-class:: classref-property

:ref:`int<class_int>` **compress/channel_pack** = ``0`` :ref:`🔗<class_ResourceImporterLayeredTexture_property_compress/channel_pack>`

Controla cómo se deben usar los canales de color en la textura importada.

\ **Compatible con sRGB:**, evita que se utilice el formato de color RG, ya que no es compatible con el color sRGB.

\ **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``).

\ **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<class_Cubemap>`, :ref:`CubemapArray<class_CubemapArray>`, :ref:`Texture2DArray<class_Texture2DArray>` y :ref:`Texture3D<class_Texture3D>`).

.. rst-class:: classref-item-separator

----

.. _class_ResourceImporterLayeredTexture_property_compress/hdr_compression:

.. rst-class:: classref-property

:ref:`int<class_int>` **compress/hdr_compression** = ``1`` :ref:`🔗<class_ResourceImporterLayeredTexture_property_compress/hdr_compression>`

Controla cómo se debe realizar la compresión VRAM para las imágenes HDR.

\ **Desactivado:** Nunca uses la compresión VRAM para texturas HDR, independientemente de si son opacas o transparentes. En su lugar, la textura se convierte a RGBE9995 (9 bits por canal + exponente de 5 bits = 32 bits por píxel) para reducir el uso de memoria en comparación con un formato de imagen de coma flotante de media precisión o de precisión simple.

\ **Solo opaco:** Solo usa la compresión VRAM para texturas HDR opacas. Esto se debe a una limitación de los formatos HDR, ya que no hay un formato HDR comprimido en VRAM que admita la transparencia al mismo tiempo.

\ **Siempre:** Fuerza la compresión VRAM incluso para texturas HDR con un canal alfa. Para realizar esto, el canal alfa se descarta en la importación.

\ **Nota:** Solo es efectivo en imágenes Radiance HDR (``.hdr``) y OpenEXR (``.exr``).

.. rst-class:: classref-item-separator

----

.. _class_ResourceImporterLayeredTexture_property_compress/high_quality:

.. rst-class:: classref-property

:ref:`bool<class_bool>` **compress/high_quality** = ``false`` :ref:`🔗<class_ResourceImporterLayeredTexture_property_compress/high_quality>`

Si es ``true``, usa la compresión BPTC en plataformas de escritorio y la compresión ASTC en plataformas móviles. Cuando se usa BPTC, BC7 se usa para texturas SDR y BC6H se usa para texturas HDR.

Si es ``false``, usa la compresión S3TC más rápida pero de menor calidad en plataformas de escritorio y ETC2 en plataformas móviles/web. Cuando se usa S3TC, DXT1 (BC1) se usa para texturas opacas y DXT5 (BC3) se usa para texturas transparentes o mapas normales (RGTC).

BPTC y ASTC admiten la compresión VRAM para texturas HDR, pero S3TC y ETC2 no (ver :ref:`compress/hdr_compression<class_ResourceImporterLayeredTexture_property_compress/hdr_compression>`).

.. rst-class:: classref-item-separator

----

.. _class_ResourceImporterLayeredTexture_property_compress/lossy_quality:

.. rst-class:: classref-property

:ref:`float<class_float>` **compress/lossy_quality** = ``0.7`` :ref:`🔗<class_ResourceImporterLayeredTexture_property_compress/lossy_quality>`

La calidad a usar cuando se usa el modo de compresión **Con pérdida**. Los valores más altos dan como resultado una mejor calidad, a costa de tamaños de archivo más grandes. La calidad con pérdida no afecta el uso de memoria de la textura importada, solo el tamaño de su archivo en el disco.

.. rst-class:: classref-item-separator

----

.. _class_ResourceImporterLayeredTexture_property_compress/mode:

.. rst-class:: classref-property

:ref:`int<class_int>` **compress/mode** = ``1`` :ref:`🔗<class_ResourceImporterLayeredTexture_property_compress/mode>`

El modo de compresión a utilizar. Cada modo de compresión ofrece una compensación diferente:

\ **Sin pérdida**: Calidad original, alto uso de memoria, gran tamaño en el disco, importación rápida.

\ **Con pérdida:** Calidad reducida, alto uso de memoria, tamaño reducido en el disco, importación rápida.

\ **VRAM Comprimido:** Calidad reducida, bajo uso de memoria, tamaño reducido en el disco, importación más lenta. Solo usar para texturas en escenas 3D, no para elementos 2D.

\ **VRAM Sin comprimir:** Calidad original, alto uso de memoria, mayor tamaño en el disco, importación más rápida.

\ **Basis Universal:** Calidad reducida, bajo uso de memoria, menor tamaño en el disco, importación lenta. Solo usar para texturas en escenas 3D, no para elementos 2D.

Ver `Modo de compresión <../tutorials/assets_pipeline/importing_images.html#compress-mode>`__ en el manual para más detalles.

.. rst-class:: classref-item-separator

----

.. _class_ResourceImporterLayeredTexture_property_compress/rdo_quality_loss:

.. rst-class:: classref-property

:ref:`float<class_float>` **compress/rdo_quality_loss** = ``0.0`` :ref:`🔗<class_ResourceImporterLayeredTexture_property_compress/rdo_quality_loss>`

Si es mayor o igual que ``0.01``, activa la optimización de tasa-distorsión (RDO) para reducir el tamaño del archivo. Los valores más altos dan como resultado archivos más pequeños, pero de menor calidad.

\ **Nota:** Habilitar RDO hace que los tiempos de codificación sean significativamente más largos, especialmente cuando la imagen es grande.

Ver también :ref:`ProjectSettings.rendering/textures/basis_universal/rdo_dict_size<class_ProjectSettings_property_rendering/textures/basis_universal/rdo_dict_size>` y :ref:`ProjectSettings.rendering/textures/basis_universal/zstd_supercompression_level<class_ProjectSettings_property_rendering/textures/basis_universal/zstd_supercompression_level>` si quieres reducir aún más el tamaño del archivo.

.. rst-class:: classref-item-separator

----

.. _class_ResourceImporterLayeredTexture_property_compress/uastc_level:

.. rst-class:: classref-property

:ref:`int<class_int>` **compress/uastc_level** = ``0`` :ref:`🔗<class_ResourceImporterLayeredTexture_property_compress/uastc_level>`

El nivel de codificación UASTC. Los valores más altos dan como resultado una mejor calidad, pero hacen que los tiempos de codificación sean más largos.

.. rst-class:: classref-item-separator

----

.. _class_ResourceImporterLayeredTexture_property_mipmaps/generate:

.. rst-class:: classref-property

:ref:`bool<class_bool>` **mipmaps/generate** = ``true`` :ref:`🔗<class_ResourceImporterLayeredTexture_property_mipmaps/generate>`

Si es ``true``, las versiones más pequeñas de la textura se generan en la importación. Por ejemplo, una textura de 64×64 generará 6 mipmaps (32×32, 16×16, 8×8, 4×4, 2×2, 1×1). Esto tiene varios beneficios:

- Las texturas no se volverán granuladas en la distancia (en 3D), o si se reducen debido al zoom de :ref:`Camera2D<class_Camera2D>` o a la escala de :ref:`CanvasItem<class_CanvasItem>` (en 2D).

- El rendimiento mejorará si la textura se muestra en la distancia, ya que el muestreo de versiones más pequeñas de la textura original es más rápido y requiere menos ancho de banda de memoria.

La desventaja de los mipmaps es que aumentan el uso de memoria en aproximadamente un 33% (para :ref:`Texture2DArray<class_Texture2DArray>`, :ref:`Cubemap<class_Cubemap>` y :ref:`CubemapArray<class_CubemapArray>`) o un 14% (para :ref:`Texture3D<class_Texture3D>`).

Se recomienda habilitar los mipmaps en 3D. Sin embargo, en 2D, esto solo debe habilitarse si tu proyecto se beneficia visiblemente de tener los mipmaps habilitados. Si la cámara nunca se aleja significativamente, no habrá ningún beneficio al habilitar los mipmaps, pero el uso de memoria aumentará.

.. rst-class:: classref-item-separator

----

.. _class_ResourceImporterLayeredTexture_property_mipmaps/limit:

.. rst-class:: classref-property

:ref:`int<class_int>` **mipmaps/limit** = ``-1`` :ref:`🔗<class_ResourceImporterLayeredTexture_property_mipmaps/limit>`

Sin implementar. Esto actualmente no tiene ningún efecto cuando se cambia.

.. rst-class:: classref-item-separator

----

.. _class_ResourceImporterLayeredTexture_property_slices/arrangement:

.. rst-class:: classref-property

:ref:`int<class_int>` **slices/arrangement** = ``1`` :ref:`🔗<class_ResourceImporterLayeredTexture_property_slices/arrangement>`

Controla cómo se dispone internamente la textura del mapa de entorno. Cuando se utilizan mapas de entorno de alta resolución, **2×3** y **3×2** son menos propensos a exceder los límites de tamaño de la textura del hardware en comparación con **1×6** y **6×1**.

.. |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.)`