Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

ResourceImporterTextureAtlas

Eredita: ResourceImporter < RefCounted < Object

Importa una raccolta di texture da un'immagine PNG in un AtlasTexture ottimizzato per il rendering 2D.

Descrizione

Questo importa una raccolta di texture da un'immagine PNG in un AtlasTexture o ArrayMesh 2D. Può essere usato per risparmiare memoria quando si importano animazioni 2D da spritesheet. Gli atlanti delle texture sono supportati solo nel rendering 2D, non in quello 3D. Vedi anche ResourceImporterTexture e ResourceImporterLayeredTexture.

Nota: ResourceImporterTextureAtlas non gestisce l'importazione di TileSetAtlasSource, il quale viene creato tramite l'editor di TileSet.

Proprietà

String

atlas_file

""

bool

crop_to_region

false

int

import_mode

0

bool

trim_alpha_border_from_region

true

Descrizioni delle proprietà

String atlas_file = "" 🔗

Percorso per lo spritesheet dell'atlante. È necessario impostarlo su un percorso valido per un'immagine PNG. Altrimenti, l'atlante non verrà importato.

bool crop_to_region = false 🔗

Se true, scarta le aree vuote dall'atlante. Ciò influisce solo sul posizionamento finale dello sprite, non sulla memorizzazione. Vedi anche trim_alpha_border_from_region.

Nota: Efficace solo se import_mode è Region.

int import_mode = 0 🔗

Region: Importa l'atlante in una risorsa AtlasTexture, che è renderizzata come un rettangolo. Questo è veloce da renderizzare, ma le aree trasparenti devono comunque essere renderizzate se non possono essere ritagliate in modo efficace da trim_alpha_border_from_region. Questo può ridurre le prestazioni durante il rendering di sprite di grandi dimensioni sullo schermo.

Mesh: Importa l'atlante come una risorsa ArrayMesh, mantenendo visibile la bitmap originale (ma renderizzata come un poligono). Questo può essere utilizzato per ridurre il fill rate durante il rendering di sprite trasparenti di grandi dimensioni, a costo di un rendering più lento se ci sono poche o nessuna area trasparente nello sprite.

bool trim_alpha_border_from_region = true 🔗

Se true, ritaglia la regione per escludere i pixel completamente trasparenti usando un rettangolo di ritaglio (che non viene mai ruotato). Questo può essere usato per risparmiare memoria. Vedi anche crop_to_region.

Nota: Efficace solo se import_mode è Region.