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.

TextureLayered

Eredita: Texture < Resource < RefCounted < Object

Ereditato da: CompressedTextureLayered, ImageTextureLayered, PlaceholderTextureLayered, TextureLayeredRD

Classe di base per tipi di texture che contengono i dati di più Image. Ogni immagine ha le stesse dimensioni e lo stesso formato.

Descrizione

Classe di base per ImageTextureLayered e CompressedTextureLayered. Non può essere utilizzata direttamente, ma contiene tutte le funzioni necessarie per accedere ai tipi di risorse derivati. Vedi anche Texture3D.

I dati sono impostati per livello. Per Texture2DArray, il livello specifica il livello dell'array.

Tutte le immagini devono avere la stessa larghezza, altezza e numero di livelli mipmap.

Un TextureLayered può essere caricato con ResourceLoader.load().

Internamente, Godot mappa questi file alle rispettive controparti nel driver di rendering di destinazione (Vulkan, OpenGL3).

Metodi

Format

_get_format() virtual required const

int

_get_height() virtual required const

Image

_get_layer_data(layer_index: int) virtual required const

int

_get_layered_type() virtual required const

int

_get_layers() virtual required const

int

_get_width() virtual required const

bool

_has_mipmaps() virtual required const

Format

get_format() const

int

get_height() const

Image

get_layer_data(layer: int) const

LayeredType

get_layered_type() const

int

get_layers() const

int

get_width() const

bool

has_mipmaps() const


Enumerazioni

enum LayeredType: 🔗

LayeredType LAYERED_TYPE_2D_ARRAY = 0

La texture è un Texture2DArray generico.

LayeredType LAYERED_TYPE_CUBEMAP = 1

La texture è una Cubemap, con ogni lato nel proprio livello (6 in totale).

LayeredType LAYERED_TYPE_CUBEMAP_ARRAY = 2

La texture è un CubemapArray, in cui ogni cubemap è composta da 6 livelli.


Descrizioni dei metodi

Format _get_format() virtual required const 🔗

Chiamato quando il formato del TextureLayered viene richiesto.


int _get_height() virtual required const 🔗

Chiamato quando l'altezza del TextureLayered viene richiesta.


Image _get_layer_data(layer_index: int) virtual required const 🔗

Chiamato quando i dati per un livello nel TextureLayered vengono richiesti.


int _get_layered_type() virtual required const 🔗

Chiamato quando il tipo di livello nel TextureLayered viene richiesto.


int _get_layers() virtual required const 🔗

Chiamato quando il numero di livelli nel TextureLayered viene richiesto.


int _get_width() virtual required const 🔗

Chiamato quando la larghezza del TextureLayered viene richiesta.


bool _has_mipmaps() virtual required const 🔗

Chiamato quando la presenza di mipmap nel TextureLayered viene richiesta.


Format get_format() const 🔗

Restituisce il formato attuale utilizzato da questa texture.


int get_height() const 🔗

Restituisce l'altezza della texture in pixel. L'altezza è solitamente rappresentata dall'asse Y.


Image get_layer_data(layer: int) const 🔗

Restituisce una risorsa Image con i dati dal livello layer.


LayeredType get_layered_type() const 🔗

Restituisce il tipo del TextureLayered. Il tipo determina come si accede ai dati, con cubemap che hanno tipi speciali.


int get_layers() const 🔗

Restituisce il numero di Image referenziate.


int get_width() const 🔗

Restituisce la larghezza della texture in pixel. La larghezza è solitamente rappresentata dall'asse X.


bool has_mipmaps() const 🔗

Restituisce true se i livelli hanno mipmap generate.