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

CanvasTexture

Eredita: Texture2D < Texture < Resource < RefCounted < Object

Texture con mappe normali e speculari facoltative da utilizzare nel rendering 2D.

Descrizione

CanvasTexture è un'alternativa a ImageTexture per il rendering 2D. Consente di utilizzare mappe normali e mappe speculari in qualsiasi nodo che eredita da CanvasItem. CanvasTexture consente inoltre di sovrascrivere il filtro della texture e la modalità di ripetizione indipendentemente dalle proprietà del nodo (o dalle impostazioni del progetto).

Nota: CanvasTexture non può essere utilizzato in 3D. Non sarà visualizzato correttamente se applicato a qualsiasi VisualInstance3D, come Sprite3D o Decal. Per materiali basati sulla fisica in 3D, utilizza invece BaseMaterial3D.

Tutorial

Luci e ombre in 2D

Proprietà

Texture2D	diffuse_texture
Texture2D	normal_texture
bool	resource_local_to_scene	`false` (overrides Resource)
Color	specular_color	`Color(1, 1, 1, 1)`
float	specular_shininess	`1.0`
Texture2D	specular_texture
TextureFilter	texture_filter	`0`
TextureRepeat	texture_repeat	`0`

Descrizioni delle proprietà

Texture2D diffuse_texture 🔗

void set_diffuse_texture(value: Texture2D)
Texture2D get_diffuse_texture()

La texture diffusa (colore) da utilizzare. Questa è la texture principale che desideri impostare nella maggior parte dei casi.

Texture2D normal_texture 🔗

void set_normal_texture(value: Texture2D)
Texture2D get_normal_texture()

La texture della mappa normale da usare. Ha un effetto visibile solo se Light2Ds stanno influenzando questa CanvasTexture.

Nota: Godot si aspetta che la mappa normale utilizzi le coordinate X+, Y+ e Z+. Consulta questa pagina per un confronto delle coordinate di mappa normale previste dai motori più diffusi.

Color specular_color = Color(1, 1, 1, 1) 🔗

void set_specular_color(value: Color)
Color get_specular_color()

Il moltiplicatore per i colori del riflesso speculare. Anche il colore dei Light2D è preso in considerazione quando si determina il colore del riflesso. Ha un effetto visibile solo se ci sono Light2D che stanno influenzando questa CanvasTexture.

float specular_shininess = 1.0 🔗

void set_specular_shininess(value: float)
float get_specular_shininess()

L'esponente speculare per i riflessi speculari Light2D. Valori più alti risultano in un aspetto più lucido/"bagnato", con riflessi che diventano più localizzati e meno visibili nel complesso. Il valore predefinito di 1.0 disabilita totalmente i riflessi speculari. Ha un effetto visibile solo se ci sono Light2D che stanno influenzando questa CanvasTexture.

Texture2D specular_texture 🔗

void set_specular_texture(value: Texture2D)
Texture2D get_specular_texture()

La mappa speculare da usare per i riflessi speculari Light2D. Dovrebbe essere una texture in scala di grigi o colorata, con aree più luminose che risultano in un valore di specular_shininess più alto. L'uso di una specular_texture colorata consente di controllare la lucentezza speculare singolarmente per canale. Ha un effetto visibile solo se ci sono Light2D che stanno influenzando questa CanvasTexture.

TextureFilter texture_filter = 0 🔗

void set_texture_filter(value: TextureFilter)
TextureFilter get_texture_filter()

La modalità di filtro della texture da utilizzare quando si disegna questa CanvasTexture.

TextureRepeat texture_repeat = 0 🔗

void set_texture_repeat(value: TextureRepeat)
TextureRepeat get_texture_repeat()

La modalità di ripetizione della texture da utilizzare quando si disegna questa CanvasTexture.