Files
godot-docs-l10n/classes/es/class_tilesetsource.rst
2025-09-30 13:31:55 +02:00

141 lines
8.2 KiB
ReStructuredText

:github_url: hide
.. _class_TileSetSource:
TileSetSource
=============
**Hereda:** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
**Heredado por:** :ref:`TileSetAtlasSource<class_TileSetAtlasSource>`, :ref:`TileSetScenesCollectionSource<class_TileSetScenesCollectionSource>`
Expone un conjunto de tiles para un recurso :ref:`TileSet<class_TileSet>`.
.. rst-class:: classref-introduction-group
Descripción
----------------------
Expone un conjunto de tiles para un recurso :ref:`TileSet<class_TileSet>`.
Los tiles de un origen se indexan con dos IDs, un ID de coordenadas (de tipo Vector2i) y un ID alternativo (de tipo int), denominados según su uso en la clase :ref:`TileSetAtlasSource<class_TileSetAtlasSource>`.
Dependiendo del tipo de origen TileSet, esos IDs pueden tener restricciones en sus valores, por eso la clase base **TileSetSource** solo expone getters para ellos.
Puedes iterar sobre todos los tiles expuestos por un TileSetSource iterando primero sobre los ID de coordenadas usando :ref:`get_tiles_count()<class_TileSetSource_method_get_tiles_count>` y :ref:`get_tile_id()<class_TileSetSource_method_get_tile_id>`, luego sobre los ID alternativos usando :ref:`get_alternative_tiles_count()<class_TileSetSource_method_get_alternative_tiles_count>` y :ref:`get_alternative_tile_id()<class_TileSetSource_method_get_alternative_tile_id>`.
\ **Advertencia:** **TileSetSource** solo se puede añadir a un TileSet al mismo tiempo. Llamar a :ref:`TileSet.add_source()<class_TileSet_method_add_source>` en un segundo :ref:`TileSet<class_TileSet>` eliminará el origen del primero.
.. rst-class:: classref-reftable-group
Métodos
--------------
.. table::
:widths: auto
+---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_alternative_tile_id<class_TileSetSource_method_get_alternative_tile_id>`\ (\ atlas_coords\: :ref:`Vector2i<class_Vector2i>`, index\: :ref:`int<class_int>`\ ) |const| |
+---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_alternative_tiles_count<class_TileSetSource_method_get_alternative_tiles_count>`\ (\ atlas_coords\: :ref:`Vector2i<class_Vector2i>`\ ) |const| |
+---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Vector2i<class_Vector2i>` | :ref:`get_tile_id<class_TileSetSource_method_get_tile_id>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
+---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_tiles_count<class_TileSetSource_method_get_tiles_count>`\ (\ ) |const| |
+---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_alternative_tile<class_TileSetSource_method_has_alternative_tile>`\ (\ atlas_coords\: :ref:`Vector2i<class_Vector2i>`, alternative_tile\: :ref:`int<class_int>`\ ) |const| |
+---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_tile<class_TileSetSource_method_has_tile>`\ (\ atlas_coords\: :ref:`Vector2i<class_Vector2i>`\ ) |const| |
+---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descripciones de Métodos
------------------------------------------------
.. _class_TileSetSource_method_get_alternative_tile_id:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_alternative_tile_id**\ (\ atlas_coords\: :ref:`Vector2i<class_Vector2i>`, index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_TileSetSource_method_get_alternative_tile_id>`
Devuelve el ID alternativo para el tile con ID de coordenadas ``atlas_coords`` en el índice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_TileSetSource_method_get_alternative_tiles_count:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_alternative_tiles_count**\ (\ atlas_coords\: :ref:`Vector2i<class_Vector2i>`\ ) |const| :ref:`🔗<class_TileSetSource_method_get_alternative_tiles_count>`
Devuelve el número de tiles alternativos para el ID de coordenadas ``atlas_coords``.
Para :ref:`TileSetAtlasSource<class_TileSetAtlasSource>`, esto siempre devuelve al menos 1, ya que el tile base con ID 0 siempre forma parte de la lista de alternativas.
Devuelve -1 si no hay tile en las coordenadas dadas.
.. rst-class:: classref-item-separator
----
.. _class_TileSetSource_method_get_tile_id:
.. rst-class:: classref-method
:ref:`Vector2i<class_Vector2i>` **get_tile_id**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_TileSetSource_method_get_tile_id>`
Devuelve el ID de las coordenadas del tile con el índice ``index``.
.. rst-class:: classref-item-separator
----
.. _class_TileSetSource_method_get_tiles_count:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_tiles_count**\ (\ ) |const| :ref:`🔗<class_TileSetSource_method_get_tiles_count>`
Devuelve cuántos tiles define este origen del atlas (sin incluir los tiles alternativos).
.. rst-class:: classref-item-separator
----
.. _class_TileSetSource_method_has_alternative_tile:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_alternative_tile**\ (\ atlas_coords\: :ref:`Vector2i<class_Vector2i>`, alternative_tile\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_TileSetSource_method_has_alternative_tile>`
Devuelve si el tile base en las coordenadas ``atlas_coords`` tiene una alternativa con ID ``alternative_tile``.
.. rst-class:: classref-item-separator
----
.. _class_TileSetSource_method_has_tile:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_tile**\ (\ atlas_coords\: :ref:`Vector2i<class_Vector2i>`\ ) |const| :ref:`🔗<class_TileSetSource_method_has_tile>`
Devuelve si este atlas tiene un tile con ID de coordenadas ``atlas_coords``.
.. |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.)`