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

AtlasTexture

Eredita: Texture2D < Texture < Resource < RefCounted < Object

Una texture che ritaglia parte di un'altra Texture2D.

Descrizione

Risorsa Texture2D che disegna solo parte della sua texture atlas, come definita dalla regione (region). È inoltre possibile impostare un ulteriore margin, che è utile per piccoli aggiustamenti.

È possibile ritagliare molteplici risorse AtlasTexture dallo stesso atlas. Impacchettare molte texture più piccole in una singola, grande texture aiuta a ottimizzare i costi di memoria video e delle chiamate per il rendering.

Nota: AtlasTexture non può essere utilizzato in un AnimatedTexture e potrebbe non ripetersi correttamente in nodi come TextureRect o Sprite2D. Per ripetere un AtlasTexture, modifica invece la sua region.

Proprietà

Texture2D

atlas

bool

filter_clip

false

Rect2

margin

Rect2(0, 0, 0, 0)

Rect2

region

Rect2(0, 0, 0, 0)

bool

resource_local_to_scene

false (overrides Resource)

Descrizioni delle proprietà

Texture2D atlas 🔗

La texture che contiene l'atlante. Può essere qualsiasi tipo ereditante da Texture2D, tra cui un altro AtlasTexture.

bool filter_clip = false 🔗

  • void set_filter_clip(value: bool)

  • bool has_filter_clip()

Se true, l'area al di fuori della regione (region) è ritagliata per evitare il bleeding dei pixel circostanti della texture.

Rect2 margin = Rect2(0, 0, 0, 0) 🔗

  • void set_margin(value: Rect2)

  • Rect2 get_margin()

Il margine attorno alla regione (region). Utile per piccoli aggiustamenti. Se il Rect2.size di questa proprietà ("w" e "h" nell'editor) è impostato, la texture disegnata è ridimensionata per adattarsi all'interno del margine.

Rect2 region = Rect2(0, 0, 0, 0) 🔗

  • void set_region(value: Rect2)

  • Rect2 get_region()

La regione usata per disegnare l'atlas. Se una delle dimensioni della regione è 0, il valore dalla dimensione dell'atlas sarà invece utilizzato per quell'asse.

Nota: Le dimensioni dell'immagine sono sempre numeri interi, quindi le dimensioni effettive della regione sono arrotondate per difetto.