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.

CanvasItemMaterial

Eredita: Material < Resource < RefCounted < Object

Un materiale per i CanvasItem.

Descrizione

I CanvasItemMaterial forniscono un mezzo per modificare le texture associate a un CanvasItem. Sono specializzati nella descrizione dei comportamenti di fusione e illuminazione per le texture. Utilizza uno ShaderMaterial per personalizzare appieno le interazioni di un materiale con un CanvasItem.

Proprietà

BlendMode

blend_mode

0

LightMode

light_mode

0

int

particles_anim_h_frames

bool

particles_anim_loop

int

particles_anim_v_frames

bool

particles_animation

false


Enumerazioni

enum BlendMode: 🔗

BlendMode BLEND_MODE_MIX = 0

Modalità di fusione mista. Si presuppone che i colori siano indipendenti dal valore alfa (opacità).

BlendMode BLEND_MODE_ADD = 1

Modalità di fusione additiva.

BlendMode BLEND_MODE_SUB = 2

Modalità di fusione sottrattiva.

BlendMode BLEND_MODE_MUL = 3

Modalità di fusione moltiplicativa.

BlendMode BLEND_MODE_PREMULT_ALPHA = 4

Modalità di fusione mista. Si presuppone che i colori siano premoltiplicati per il valore alfa (opacità).


enum LightMode: 🔗

LightMode LIGHT_MODE_NORMAL = 0

Renderizza il materiale usando proprietà del materiale sia sensibili alla luce sia non sensibili alla luce.

LightMode LIGHT_MODE_UNSHADED = 1

Renderizza il materiale come se non ci fosse luce.

LightMode LIGHT_MODE_LIGHT_ONLY = 2

Renderizza il materiale come se ci fosse solo luce.


Descrizioni delle proprietà

BlendMode blend_mode = 0 🔗

Il modo in cui il rendering di un materiale è applicato alle texture sottostanti.


LightMode light_mode = 0 🔗

Il modo in cui il materiale reagisce all'illuminazione.


int particles_anim_h_frames 🔗

  • void set_particles_anim_h_frames(value: int)

  • int get_particles_anim_h_frames()

Il numero di colonne nello spritesheet assegnato come Texture2D per un GPUParticles2D o CPUParticles2D.

Nota: Questa proprietà è usata e visibile nell'editor solo se particles_animation è true.


bool particles_anim_loop 🔗

  • void set_particles_anim_loop(value: bool)

  • bool get_particles_anim_loop()

Se true, l'animazione delle particelle si ripeterà.

Nota: Questa proprietà è usata e visibile nell'editor solo se particles_animation è true.


int particles_anim_v_frames 🔗

  • void set_particles_anim_v_frames(value: int)

  • int get_particles_anim_v_frames()

Il numero di righe nello spritesheet assegnato come Texture2D per un GPUParticles2D o CPUParticles2D.

Nota: Questa proprietà è usata e visibile nell'editor solo se particles_animation è true.


bool particles_animation = false 🔗

  • void set_particles_animation(value: bool)

  • bool get_particles_animation()

Se true, abilita le funzionalità di animazione basate su spritesheet quando assegnato ai nodi GPUParticles2D e CPUParticles2D. Anche ParticleProcessMaterial.anim_speed_max o CPUParticles2D.anim_speed_max devono essere impostati su un valore positivo affinché l'animazione possa essere riprodotta.

Questa proprietà (e altre proprietà particles_anim_* che dipendono da essa) non ha effetto su altri tipi di nodi.