:github_url: hide .. _class_TileSetAtlasSource: TileSetAtlasSource ================== **Eredita:** :ref:`TileSetSource` **<** :ref:`Resource` **<** :ref:`RefCounted` **<** :ref:`Object` Espone una texture di atlante 2D come un insieme di tasselli per una risorsa :ref:`TileSet`. .. rst-class:: classref-introduction-group Descrizione ---------------------- Un atlante è una griglia di tasselli disposte su una texture. Ogni tassello nella griglia deve essere esposto tramite :ref:`create_tile()`. Tali tasselli sono quindi indicizzati tramite le loro coordinate nella griglia. Ogni tassello può anche avere dimensioni nelle coordinate della griglia, rendendolo più o meno celle nell'atlante. È possibile creare le versioni alternative di un tassello tramite :ref:`create_alternative_tile()`, le quali sono quindi indicizzate usando un ID alternativo. Il tassello principalo (quello nella griglia), è accessibile con un ID alternativo pari a 0. Ogni tassello alternativo ha una serie di proprietà che è definita dagli strati del :ref:`TileSet` della sorgente. Tali proprietà sono memorizzate in un oggetto TileData a cui è possibile accedere e modificare tramite :ref:`get_tile_data()`. Poiché le proprietà TileData sono memorizzate direttamente nella risorsa TileSetAtlasSource, è possibile impostare le loro proprietà anche tramite ``TileSetAtlasSource.set("://")``. .. rst-class:: classref-reftable-group Proprietà ------------------ .. table:: :widths: auto +-----------------------------------+-----------------------------------------------------------------------------------+----------------------+ | :ref:`Vector2i` | :ref:`margins` | ``Vector2i(0, 0)`` | +-----------------------------------+-----------------------------------------------------------------------------------+----------------------+ | :ref:`Vector2i` | :ref:`separation` | ``Vector2i(0, 0)`` | +-----------------------------------+-----------------------------------------------------------------------------------+----------------------+ | :ref:`Texture2D` | :ref:`texture` | | +-----------------------------------+-----------------------------------------------------------------------------------+----------------------+ | :ref:`Vector2i` | :ref:`texture_region_size` | ``Vector2i(16, 16)`` | +-----------------------------------+-----------------------------------------------------------------------------------+----------------------+ | :ref:`bool` | :ref:`use_texture_padding` | ``true`` | +-----------------------------------+-----------------------------------------------------------------------------------+----------------------+ .. rst-class:: classref-reftable-group Metodi ------------ .. table:: :widths: auto +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`clear_tiles_outside_texture`\ (\ ) | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`create_alternative_tile`\ (\ atlas_coords\: :ref:`Vector2i`, alternative_id_override\: :ref:`int` = -1\ ) | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`create_tile`\ (\ atlas_coords\: :ref:`Vector2i`, size\: :ref:`Vector2i` = Vector2i(1, 1)\ ) | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i` | :ref:`get_atlas_grid_size`\ (\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_next_alternative_tile_id`\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Texture2D` | :ref:`get_runtime_texture`\ (\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Rect2i` | :ref:`get_runtime_tile_texture_region`\ (\ atlas_coords\: :ref:`Vector2i`, frame\: :ref:`int`\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_tile_animation_columns`\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_tile_animation_frame_duration`\ (\ atlas_coords\: :ref:`Vector2i`, frame_index\: :ref:`int`\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_tile_animation_frames_count`\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`TileAnimationMode` | :ref:`get_tile_animation_mode`\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i` | :ref:`get_tile_animation_separation`\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_tile_animation_speed`\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_tile_animation_total_duration`\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i` | :ref:`get_tile_at_coords`\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`TileData` | :ref:`get_tile_data`\ (\ atlas_coords\: :ref:`Vector2i`, alternative_tile\: :ref:`int`\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i` | :ref:`get_tile_size_in_atlas`\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Rect2i` | :ref:`get_tile_texture_region`\ (\ atlas_coords\: :ref:`Vector2i`, frame\: :ref:`int` = 0\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PackedVector2Array` | :ref:`get_tiles_to_be_removed_on_change`\ (\ texture\: :ref:`Texture2D`, margins\: :ref:`Vector2i`, separation\: :ref:`Vector2i`, texture_region_size\: :ref:`Vector2i`\ ) | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_room_for_tile`\ (\ atlas_coords\: :ref:`Vector2i`, size\: :ref:`Vector2i`, animation_columns\: :ref:`int`, animation_separation\: :ref:`Vector2i`, frames_count\: :ref:`int`, ignored_tile\: :ref:`Vector2i` = Vector2i(-1, -1)\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_tiles_outside_texture`\ (\ ) |const| | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`move_tile_in_atlas`\ (\ atlas_coords\: :ref:`Vector2i`, new_atlas_coords\: :ref:`Vector2i` = Vector2i(-1, -1), new_size\: :ref:`Vector2i` = Vector2i(-1, -1)\ ) | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`remove_alternative_tile`\ (\ atlas_coords\: :ref:`Vector2i`, alternative_tile\: :ref:`int`\ ) | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`remove_tile`\ (\ atlas_coords\: :ref:`Vector2i`\ ) | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_alternative_tile_id`\ (\ atlas_coords\: :ref:`Vector2i`, alternative_tile\: :ref:`int`, new_id\: :ref:`int`\ ) | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_tile_animation_columns`\ (\ atlas_coords\: :ref:`Vector2i`, frame_columns\: :ref:`int`\ ) | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_tile_animation_frame_duration`\ (\ atlas_coords\: :ref:`Vector2i`, frame_index\: :ref:`int`, duration\: :ref:`float`\ ) | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_tile_animation_frames_count`\ (\ atlas_coords\: :ref:`Vector2i`, frames_count\: :ref:`int`\ ) | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_tile_animation_mode`\ (\ atlas_coords\: :ref:`Vector2i`, mode\: :ref:`TileAnimationMode`\ ) | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_tile_animation_separation`\ (\ atlas_coords\: :ref:`Vector2i`, separation\: :ref:`Vector2i`\ ) | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_tile_animation_speed`\ (\ atlas_coords\: :ref:`Vector2i`, speed\: :ref:`float`\ ) | +---------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Enumerazioni ------------------------ .. _enum_TileSetAtlasSource_TileAnimationMode: .. rst-class:: classref-enumeration enum **TileAnimationMode**: :ref:`🔗` .. _class_TileSetAtlasSource_constant_TILE_ANIMATION_MODE_DEFAULT: .. rst-class:: classref-enumeration-constant :ref:`TileAnimationMode` **TILE_ANIMATION_MODE_DEFAULT** = ``0`` Le animazioni dei tasselli iniziano allo stesso tempo, sembrando identiche. .. _class_TileSetAtlasSource_constant_TILE_ANIMATION_MODE_RANDOM_START_TIMES: .. rst-class:: classref-enumeration-constant :ref:`TileAnimationMode` **TILE_ANIMATION_MODE_RANDOM_START_TIMES** = ``1`` Le animazioni dei tasselli iniziano in momenti a caso, apparendo varie. .. _class_TileSetAtlasSource_constant_TILE_ANIMATION_MODE_MAX: .. rst-class:: classref-enumeration-constant :ref:`TileAnimationMode` **TILE_ANIMATION_MODE_MAX** = ``2`` Rappresenta la dimensione dell'enumerazione :ref:`TileAnimationMode`. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Costanti ---------------- .. _class_TileSetAtlasSource_constant_TRANSFORM_FLIP_H: .. rst-class:: classref-constant **TRANSFORM_FLIP_H** = ``4096`` :ref:`🔗` Rappresenta il flag di capovolgimento orizzontale della cella. Dovrebbe essere utilizzato direttamente con :ref:`TileMapLayer` per capovolgere i tasselli posizionati modificandone gli ID alternativi. :: var alternate_id = $TileMap.get_cell_alternative_tile(0, Vector2i(2, 2)) if not alternate_id & TileSetAtlasSource.TRANSFORM_FLIP_H: # Se la tessera non è già capovolta, capovolgila. $TileMap.set_cell(0, Vector2i(2, 2), source_id, atlas_coords, alternate_id | TileSetAtlasSource.TRANSFORM_FLIP_H) \ **Nota:** Queste trasformazioni possono essere combinate per ottenere l'equivalente di rotazioni di 0, 90, 180 e 270 gradi, come mostrato di seguito: :: enum TileTransform { ROTATE_0 = 0, ROTATE_90 = TileSetAtlasSource.TRANSFORM_TRANSPOSE | TileSetAtlasSource.TRANSFORM_FLIP_H, ROTATE_180 = TileSetAtlasSource.TRANSFORM_FLIP_H | TileSetAtlasSource.TRANSFORM_FLIP_V, ROTATE_270 = TileSetAtlasSource.TRANSFORM_TRANSPOSE | TileSetAtlasSource.TRANSFORM_FLIP_V, } .. _class_TileSetAtlasSource_constant_TRANSFORM_FLIP_V: .. rst-class:: classref-constant **TRANSFORM_FLIP_V** = ``8192`` :ref:`🔗` Rappresenta il flag di capovolgimento verticale della cella. Vedi :ref:`TRANSFORM_FLIP_H` per l'utilizzo. .. _class_TileSetAtlasSource_constant_TRANSFORM_TRANSPOSE: .. rst-class:: classref-constant **TRANSFORM_TRANSPOSE** = ``16384`` :ref:`🔗` Rappresenta il flag di trasposizione della cella. Vedi :ref:`TRANSFORM_FLIP_H` per l'utilizzo. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descrizioni delle proprietà ------------------------------------------------------ .. _class_TileSetAtlasSource_property_margins: .. rst-class:: classref-property :ref:`Vector2i` **margins** = ``Vector2i(0, 0)`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_margins**\ (\ value\: :ref:`Vector2i`\ ) - :ref:`Vector2i` **get_margins**\ (\ ) I margini, in pixel, per spostare l'origine della griglia nella texture. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_property_separation: .. rst-class:: classref-property :ref:`Vector2i` **separation** = ``Vector2i(0, 0)`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_separation**\ (\ value\: :ref:`Vector2i`\ ) - :ref:`Vector2i` **get_separation**\ (\ ) La separazione, in pixel, tra ciascuna regione della texture dei tasselli della griglia. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_property_texture: .. rst-class:: classref-property :ref:`Texture2D` **texture** :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_texture**\ (\ value\: :ref:`Texture2D`\ ) - :ref:`Texture2D` **get_texture**\ (\ ) La texture d'atlante. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_property_texture_region_size: .. rst-class:: classref-property :ref:`Vector2i` **texture_region_size** = ``Vector2i(16, 16)`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_texture_region_size**\ (\ value\: :ref:`Vector2i`\ ) - :ref:`Vector2i` **get_texture_region_size**\ (\ ) Le dimensioni base di un tassello nella texture (in pixel). Queste dimensioni devono essere maggiori del valore ``tile_size`` del TileSet. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_property_use_texture_padding: .. rst-class:: classref-property :ref:`bool` **use_texture_padding** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_use_texture_padding**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **get_use_texture_padding**\ (\ ) Se ``true``, genera una texture interna con un ulteriore padding di un pixel attorno a ogni tassello. Il padding della texture evita un artefatto comune in cui compaiono linee tra i tasselli. Disabilitare questa impostazione potrebbe portare a un piccolo miglioramento delle prestazioni, poiché la generazione della texture interna richiede sia memoria sia tempo di elaborazione quando la risorsa TileSetAtlasSource viene modificata. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descrizioni dei metodi -------------------------------------------- .. _class_TileSetAtlasSource_method_clear_tiles_outside_texture: .. rst-class:: classref-method |void| **clear_tiles_outside_texture**\ (\ ) :ref:`🔗` Rimuove tutti i tasselli che non rientrano nell'area della texture disponibile. Questo metodo esegue un iterazione su tutti i tasselli della sorgente, quindi è consigliabile usare :ref:`has_tiles_outside_texture()` in anticipo. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_create_alternative_tile: .. rst-class:: classref-method :ref:`int` **create_alternative_tile**\ (\ atlas_coords\: :ref:`Vector2i`, alternative_id_override\: :ref:`int` = -1\ ) :ref:`🔗` Crea un tassello alternativo per il tassello alle coordinate ``atlas_coords``. Se ``alternative_id_override`` è -1, assegna un ID univoco generato automaticamente, altrimenti assegna l'ID specificato. Restituisce il nuovo identificatore alternativo, oppure -1 se l'alternativa non può essere creata con il ``alternative_id_override`` fornito. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_create_tile: .. rst-class:: classref-method |void| **create_tile**\ (\ atlas_coords\: :ref:`Vector2i`, size\: :ref:`Vector2i` = Vector2i(1, 1)\ ) :ref:`🔗` Crea un nuovo tassello alle coordinate ``atlas_coords`` con le dimensioni ``size``. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_atlas_grid_size: .. rst-class:: classref-method :ref:`Vector2i` **get_atlas_grid_size**\ (\ ) |const| :ref:`🔗` Restituisce le dimensioni della griglia dell'atlante, che dipende da quanti tasselli possono essere inseriti nella texture. Dipende quindi dalle dimensioni della :ref:`texture`, dai :ref:`margins` dell'atlante e dalle :ref:`texture_region_size` dei tasselli. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_next_alternative_tile_id: .. rst-class:: classref-method :ref:`int` **get_next_alternative_tile_id**\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| :ref:`🔗` Restituisce l'ID alternativo che restituirebbe una chiamata successiva al :ref:`create_alternative_tile()`. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_runtime_texture: .. rst-class:: classref-method :ref:`Texture2D` **get_runtime_texture**\ (\ ) |const| :ref:`🔗` 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 ---- .. _class_TileSetAtlasSource_method_get_runtime_tile_texture_region: .. rst-class:: classref-method :ref:`Rect2i` **get_runtime_tile_texture_region**\ (\ atlas_coords\: :ref:`Vector2i`, frame\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce la regione del tassello alle coordinate ``atlas_coords`` per il fotogramma ``frame`` all'interno della texture restituita da :ref:`get_runtime_texture()`. \ **Nota:** Se :ref:`use_texture_padding` è ``false``, restituisce lo stesso di :ref:`get_tile_texture_region()`. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_tile_animation_columns: .. rst-class:: classref-method :ref:`int` **get_tile_animation_columns**\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| :ref:`🔗` Restituisce il numero di colonne presenti nel layout di animazione del tassello alle coordinate ``atlas_coords``. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_tile_animation_frame_duration: .. rst-class:: classref-method :ref:`float` **get_tile_animation_frame_duration**\ (\ atlas_coords\: :ref:`Vector2i`, frame_index\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce la durata del fotogramma all'indice ``frame_index`` dell'animazione per il tassello alle coordinate ``atlas_coords``. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_tile_animation_frames_count: .. rst-class:: classref-method :ref:`int` **get_tile_animation_frames_count**\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| :ref:`🔗` Restituisce il numero di fotogrammi dell'animazione presenti nel tassello alle coordinate ``atlas_coords``. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_tile_animation_mode: .. rst-class:: classref-method :ref:`TileAnimationMode` **get_tile_animation_mode**\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| :ref:`🔗` Restituisce la modalità di animazione del tassello alle coordinate ``atlas_coords``. Vedi anche :ref:`set_tile_animation_mode()`. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_tile_animation_separation: .. rst-class:: classref-method :ref:`Vector2i` **get_tile_animation_separation**\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| :ref:`🔗` Restituisce la separazione (come nella griglia dell'atlante) tra ciascun fotogramma di un tassello animato alle coordinate ``atlas_coords``. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_tile_animation_speed: .. rst-class:: classref-method :ref:`float` **get_tile_animation_speed**\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| :ref:`🔗` Restituisce la velocità di animazione del tassello alle coordinate ``atlas_coords``. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_tile_animation_total_duration: .. rst-class:: classref-method :ref:`float` **get_tile_animation_total_duration**\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| :ref:`🔗` Restituisce la somma di tutte le durate dei fotogrammi del tassello alle coordinate ``atlas_coords``. Questo valore deve essere diviso per la velocità di animazione per ottenere la durata effettiva del ciclo di animazione. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_tile_at_coords: .. rst-class:: classref-method :ref:`Vector2i` **get_tile_at_coords**\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| :ref:`🔗` Se è presente un tassello che copre le coordinate ``atlas_coords``, restituisce le coordinate in alto a sinistra del tassello (quindi il suo ID di coordinate). Altrimenti restituisce ``Vector2i(-1, -1)``. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_tile_data: .. rst-class:: classref-method :ref:`TileData` **get_tile_data**\ (\ atlas_coords\: :ref:`Vector2i`, alternative_tile\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce l'oggetto :ref:`TileData` per le coordinate dell'atlante specificate e l'ID alternativo. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_tile_size_in_atlas: .. rst-class:: classref-method :ref:`Vector2i` **get_tile_size_in_atlas**\ (\ atlas_coords\: :ref:`Vector2i`\ ) |const| :ref:`🔗` Restituisce le dimensioni del tassello (nel sistema di coordinate della griglia) alle coordinate ``atlas_coords``. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_tile_texture_region: .. rst-class:: classref-method :ref:`Rect2i` **get_tile_texture_region**\ (\ atlas_coords\: :ref:`Vector2i`, frame\: :ref:`int` = 0\ ) |const| :ref:`🔗` Restituisce la regione di texture di un tassello nella texture d'atlante. Per tasselli animati, potrebbe essere fornito un argomento ``frame`` per i diversi fotogrammi dell'animazione. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_get_tiles_to_be_removed_on_change: .. rst-class:: classref-method :ref:`PackedVector2Array` **get_tiles_to_be_removed_on_change**\ (\ texture\: :ref:`Texture2D`, margins\: :ref:`Vector2i`, separation\: :ref:`Vector2i`, texture_region_size\: :ref:`Vector2i`\ ) :ref:`🔗` Restituisce un array di ID di coordinate dei tasselli che saranno rimossi automaticamente quando si modifica una o più di queste proprietà: ``texture``, ``margins``, ``separation`` o ``texture_region_size``. Può essere utilizzato per annullare le modifiche che avrebbero causato la perdita di dati dei tasselli. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_has_room_for_tile: .. rst-class:: classref-method :ref:`bool` **has_room_for_tile**\ (\ atlas_coords\: :ref:`Vector2i`, size\: :ref:`Vector2i`, animation_columns\: :ref:`int`, animation_separation\: :ref:`Vector2i`, frames_count\: :ref:`int`, ignored_tile\: :ref:`Vector2i` = Vector2i(-1, -1)\ ) |const| :ref:`🔗` Restituisce se c'è abbastanza spazio in un atlante per creare o modificare un tassello con le proprietà specificate. Se viene fornito ``ignored_tile``, si comporta come se il tassello specificato non fosse presente nell'atlante. Questo può essere usato quando si desidera modificare le proprietà di un tassello. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_has_tiles_outside_texture: .. rst-class:: classref-method :ref:`bool` **has_tiles_outside_texture**\ (\ ) |const| :ref:`🔗` Verifica se la sorgente contiene tasselli che non rientrano nell'area della texture (parzialmente o completamente). .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_move_tile_in_atlas: .. rst-class:: classref-method |void| **move_tile_in_atlas**\ (\ atlas_coords\: :ref:`Vector2i`, new_atlas_coords\: :ref:`Vector2i` = Vector2i(-1, -1), new_size\: :ref:`Vector2i` = Vector2i(-1, -1)\ ) :ref:`🔗` Sposta il tassello e le sue alternative dalle coordinate ``atlas_coords`` alle coordinate ``new_atlas_coords`` con le dimensioni ``new_size``. Questa funzione fallirà se un tassello è già presente nell'area specificata. Se ``new_atlas_coords`` è ``Vector2i(-1, -1)``, mantiene le coordinate del tassello. Se ``new_size`` è ``Vector2i(-1, -1)``, mantiene le dimensioni del tassello. Per evitare un errore, verifica prima se è possibile uno spostamento tramite :ref:`has_room_for_tile()`. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_remove_alternative_tile: .. rst-class:: classref-method |void| **remove_alternative_tile**\ (\ atlas_coords\: :ref:`Vector2i`, alternative_tile\: :ref:`int`\ ) :ref:`🔗` Rimuovi l'alternativa di un tassello con l'ID alternativo ``alternative_tile``. La chiamata di questa funzione con ``alternative_tile`` uguale a 0 fallirà, poiché l'alternativa base del tassello non può essere rimossa. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_remove_tile: .. rst-class:: classref-method |void| **remove_tile**\ (\ atlas_coords\: :ref:`Vector2i`\ ) :ref:`🔗` Rimuovi un tassello e la sua alternativa alle coordinate ``atlas_coords``. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_set_alternative_tile_id: .. rst-class:: classref-method |void| **set_alternative_tile_id**\ (\ atlas_coords\: :ref:`Vector2i`, alternative_tile\: :ref:`int`, new_id\: :ref:`int`\ ) :ref:`🔗` Cambia l'ID alternativo di un tassello da ``alternative_tile`` a ``new_id``. La chiamata di questa funzione con ``new_id`` di 0 fallirà, poiché l'alternativa base del tassello non può essere spostata. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_set_tile_animation_columns: .. rst-class:: classref-method |void| **set_tile_animation_columns**\ (\ atlas_coords\: :ref:`Vector2i`, frame_columns\: :ref:`int`\ ) :ref:`🔗` Imposta il numero di colonne nel layout di animazione del tassello alle coordinate ``atlas_coords``. Se impostato su 0, i diversi fotogrammi dell'animazione saranno disposti come una singola linea orizzontale nell'atlante. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_set_tile_animation_frame_duration: .. rst-class:: classref-method |void| **set_tile_animation_frame_duration**\ (\ atlas_coords\: :ref:`Vector2i`, frame_index\: :ref:`int`, duration\: :ref:`float`\ ) :ref:`🔗` Imposta la durata del fotogramma ``frame_index`` dell'animazione per il tassello alle coordinate ``atlas_coords`` su ``duration``. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_set_tile_animation_frames_count: .. rst-class:: classref-method |void| **set_tile_animation_frames_count**\ (\ atlas_coords\: :ref:`Vector2i`, frames_count\: :ref:`int`\ ) :ref:`🔗` Imposta il numero di fotogrammi di animazione presenti nel tassello alle coordinate ``atlas_coords``. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_set_tile_animation_mode: .. rst-class:: classref-method |void| **set_tile_animation_mode**\ (\ atlas_coords\: :ref:`Vector2i`, mode\: :ref:`TileAnimationMode`\ ) :ref:`🔗` Imposta la modalità di animazione del tassello alle coordinate ``atlas_coords`` a ``mode``. Vedi anche :ref:`get_tile_animation_mode()`. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_set_tile_animation_separation: .. rst-class:: classref-method |void| **set_tile_animation_separation**\ (\ atlas_coords\: :ref:`Vector2i`, separation\: :ref:`Vector2i`\ ) :ref:`🔗` Imposta il margine (nei tasselli della griglia) tra ogni tassello nel layout di animazione del tassello alle coordinate ``atlas_coords``. .. rst-class:: classref-item-separator ---- .. _class_TileSetAtlasSource_method_set_tile_animation_speed: .. rst-class:: classref-method |void| **set_tile_animation_speed**\ (\ atlas_coords\: :ref:`Vector2i`, speed\: :ref:`float`\ ) :ref:`🔗` Imposta la velocità di animazione del tassello alle coordinate ``atlas_coords``. .. |virtual| replace:: :abbr:`virtual (Questo metodo dovrebbe solitamente essere sovrascritto dall'utente per aver un effetto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Questo metodo non ha effetti collaterali. Non modifica alcuna variabile appartenente all'istanza.)` .. |vararg| replace:: :abbr:`vararg (Questo metodo accetta qualsiasi numero di argomenti oltre a quelli descritti qui.)` .. |constructor| replace:: :abbr:`constructor (Questo metodo è utilizzato per creare un tipo.)` .. |static| replace:: :abbr:`static (Questo metodo non necessita di alcun'istanza per essere chiamato, quindi può essere chiamato direttamente usando il nome della classe.)` .. |operator| replace:: :abbr:`operator (Questo metodo descrive un operatore valido da usare con questo tipo come operando di sinistra.)` .. |bitfield| replace:: :abbr:`BitField (Questo valore è un intero composto da una maschera di bit dei seguenti flag.)` .. |void| replace:: :abbr:`void (Nessun valore restituito.)`