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...
DrawableTexture2D
Eredita: Texture2D < Texture < Resource < RefCounted < Object
Una texture 2D che supporta il disegno su se stessa tramite chiamate blit.
Descrizione
Una texture 2D modificabile tramite chiamate blit, che copiano da una texture di destinazione a se stessa. Pensata principalmente per essere gestita tramite codice, richiede all'utente di chiamare setup() per inizializzare lo stato prima di poterci disegnare. Ogni chiamata a blit_rect() accetta almeno un rettangolo, l'area su cui disegnare, e un'altra texture, cosa disegnare. Le chiamate di disegno utilizzano uno shader Texture_Blit per elaborare e calcolare il risultato, pixel per pixel. Gli utenti possono fornire il proprio ShaderMaterial con shader Texture_Blit personalizzati per ottenere comportamenti più complessi.
Proprietà
resource_local_to_scene |
|
Metodi
void |
blit_rect(rect: Rect2i, source: Texture2D, modulate: Color = Color(1, 1, 1, 1), mipmap: int = 0, material: Material = null) |
void |
blit_rect_multi(rect: Rect2i, sources: Array[Texture2D], extra_targets: Array[DrawableTexture2D], modulate: Color = Color(1, 1, 1, 1), mipmap: int = 0, material: Material = null) |
void |
|
get_use_mipmaps() const |
|
void |
set_format(format: DrawableFormat) |
void |
set_use_mipmaps(mipmaps: bool) |
void |
setup(width: int, height: int, format: DrawableFormat, color: Color = Color(1, 1, 1, 1), use_mipmaps: bool = false) |
Enumerazioni
enum DrawableFormat: 🔗
DrawableFormat DRAWABLE_FORMAT_RGBA8 = 0
Formato di texture OpenGL RGBA con quattro componenti, ciascuno di 8 bit.
DrawableFormat DRAWABLE_FORMAT_RGBA8_SRGB = 1
Formato di texture OpenGL RGBA con quattro componenti, ciascuno di 8 bit.
Se disegnata su, viene effettuata una conversione da sRGB a spazio colore lineare.
DrawableFormat DRAWABLE_FORMAT_RGBAH = 2
Formato di texture OpenGL GL_RGBA16F in cui sono presenti quattro componenti, ciascuno un valore in virgola mobile "a mezza precisione" di 16 bit.
DrawableFormat DRAWABLE_FORMAT_RGBAF = 3
Formato di texture OpenGL GL_RGBA32F in cui sono presenti quattro componenti, ciascuno un valore in virgola mobile di 32 bit.
Descrizioni dei metodi
void blit_rect(rect: Rect2i, source: Texture2D, modulate: Color = Color(1, 1, 1, 1), mipmap: int = 0, material: Material = null) 🔗
Sperimentale: Questo metodo potrebbe essere cambiato o rimosso in versioni future.
Disegna sul rettangolo rect su questa texture copiandolo dalla sorgente source. È possibile passare un colore modulate utilizzando dallo shader, ma il valore predefinito è bianco. Il valore mipmap può specificare un disegno a un livello mipmap inferiore. Il parametro material può accettare un ShaderMaterial con uno TextureBlit Shader per un comportamento di disegno personalizzato.
void blit_rect_multi(rect: Rect2i, sources: Array[Texture2D], extra_targets: Array[DrawableTexture2D], modulate: Color = Color(1, 1, 1, 1), mipmap: int = 0, material: Material = null) 🔗
Sperimentale: Questo metodo potrebbe essere cambiato o rimosso in versioni future.
Disegna sul rettangolo rect su questa texture, nonché su un massimo di 3 DrawableTexture extra_targets. Tutte le extra_targets devono avere le stesse dimensioni e lo stesso DrawableFormat della destinazione originale, altrimenti lo shader potrebbe non funzionare. Prevede fino a 4 Texture sources, ma sostituirà le sorgenti sources mancanti con texture nere predefinite.
void generate_mipmaps() 🔗
Ricalcola le mipmap per questa texture su richiesta.
bool get_use_mipmaps() const 🔗
Restituisce true se le mipmap sono impostate per essere utilizzate su questa DrawableTexture.
void set_format(format: DrawableFormat) 🔗
Imposta il formato di questa DrawableTexture.
void set_use_mipmaps(mipmaps: bool) 🔗
Imposta se le mipmap si dovrebbero utilizzare su questa DrawableTexture.
void setup(width: int, height: int, format: DrawableFormat, color: Color = Color(1, 1, 1, 1), use_mipmaps: bool = false) 🔗
Sperimentale: Questo metodo potrebbe essere cambiato o rimosso in versioni future.
Inizializza DrawableTexture con una texture bianca delle dimensioni specificate da width e height, con il formato format.