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.

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à

bool

resource_local_to_scene

false (overrides Resource)

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

generate_mipmaps()

bool

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.