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

ImageTexture

Eredita: Texture2D < Texture < Resource < RefCounted < Object

Una Texture2D basata su un Image.

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

Proprietà

bool

resource_local_to_scene

false (overrides Resource)

Metodi

ImageTexture

create_from_image(image: Image) static

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.

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.