ImageTexture

Eredita: Texture2D < Texture < Resource < RefCounted < Object

Descrizione

Una Texture2D basata su una Image. Per visualizzare un'immagine, è necessario creare una ImageTexture da essa attraverso il metodo create_from_image():

var image = Image.load_from_file("res://icon.svg")
var texture = ImageTexture.create_from_image(image)
$Sprite2D.texture = texture

In questo modo, è possibile creare le texture in fase di esecuzione caricando le immagini sia dall'interno dell'editor sia esternamente.

Attenzione: Si consiglia di caricare le texture importate con @GDScript.load() invece di caricarle dinamicamente dall'interno del file system con Image.load(), poiché ciò potrebbe non funzionare nei progetti esportati:

var texture = load("res://icon.svg")
$Sprite2D.texture = texture

Questo perché le immagini devono essere importate prima come CompressedTexture2D per essere caricate con @GDScript.load(). Se si desidera comunque caricare un file immagine come qualsiasi altra Resource, importarla invece come risorsa Image e poi caricarla normalmente attraverso il metodo @GDScript.load().

Nota: L'immagine può essere recuperata da una texture importata tramite il metodo Texture2D.get_image(), che restituisce una copia dell'immagine:

var texture = load("res://icon.svg")
var image: Image = texture.get_image()

Una ImageTexture non è pensata per essere utilizzata direttamente dall'interfaccia dell'editor, ed è utile soprattutto per il rendering dinamico delle immagini sullo schermo tramite codice. Se è necessario generare immagini proceduralmente dall'editor, considerare di salvare e importare le immagini come risorse texture personalizzate implementando un nuovo EditorImportPlugin.

Nota: Le dimensioni massime della texture sono 16384×16384 pixel a causa delle limitazioni degli hardware grafici.

Tutorial

Importare immagini

Proprietà

bool

resource_local_to_scene

false (overrides Resource)

Metodi

ImageTexture	create_from_image(image: Image) static
Format	get_format() const
void	set_image(image: Image)
void	set_size_override(size: Vector2i)
void	update(image: Image)

Descrizioni dei metodi

ImageTexture create_from_image(image: Image) static 🔗

Crea una nuova ImageTexture e la inizializza allocando e impostando i dati da una Image.

Format get_format() const 🔗

Restituisce il formato della texture.

void set_image(image: Image) 🔗

Sostituisce i dati della texture con una nuova Image. Ciò riallocherà nuova memoria per la texture.

Se si desidera aggiornare l'immagine, ma c'è bisogno di modificarne i parametri (formato, dimensione), usare update() per migliori prestazioni.

void set_size_override(size: Vector2i) 🔗

Ridimensiona la texture alle dimensioni specificate.

void update(image: Image) 🔗

Sostituisce i dati della texture con una nuova Image.

Nota: La texture deve essere creata usando create_from_image() o inizializzata prima con il metodo set_image() prima di poter essere aggiornata. Le nuove dimensioni dell'immagine, il formato e la configurazione delle mipmap devono corrispondere alla configurazione dell'immagine della texture esistente.

Usa questo metodo invece di set_image() se è necessario aggiornare la texture frequentemente, il che è più veloce di allocare memoria per una nuova texture ogni volta.