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

Hérite de : Material < Resource < RefCounted < Object

Un matériel pour les CanvasItems.

Description

Les CanvasItemMaterials fournissent un moyen de modifier les textures associées à un CanvasItem. Ils se spécialisent dans la description des comportements de mélange et d'éclairage pour les textures. Utilisez un ShaderMaterial pour personnaliser les interactions d'un matériau avec un CanvasItem.

Propriétés

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


Énumérations

enum BlendMode: 🔗

BlendMode BLEND_MODE_MIX = 0

Le mode de mélange. Les couleurs sont supposées être indépendantes de l'opacité.

BlendMode BLEND_MODE_ADD = 1

Mode de fusion additif.

BlendMode BLEND_MODE_SUB = 2

Mode de fusion soustractif.

BlendMode BLEND_MODE_MUL = 3

Mode de fusion multiplicatif.

BlendMode BLEND_MODE_PREMULT_ALPHA = 4

Le mode de mélange. Les couleurs sont supposées être prémultipliées par leur opacité.


enum LightMode: 🔗

LightMode LIGHT_MODE_NORMAL = 0

Fait le rendu du matériau avec et sans lumière des propriétés matérielles.

LightMode LIGHT_MODE_UNSHADED = 1

Rend du matériau comme s'il n'y avait pas de lumière.

LightMode LIGHT_MODE_LIGHT_ONLY = 2

Rend du matériau comme s'il n'y avait que de la lumière.


Descriptions des propriétés

BlendMode blend_mode = 0 🔗

La manière dont le rendu du matériau est appliqué aux textures en-dessous.


LightMode light_mode = 0 🔗

La façon dont le matériau réagit à la lumière.


int particles_anim_h_frames 🔗

  • void set_particles_anim_h_frames(value: int)

  • int get_particles_anim_h_frames()

Le nombre de colonnes dans la feuille de sprite assignée comme Texture2D pour un GPUParticles2D ou un CPUParticles2D.

Note : Cette propriété est uniquement utilisée et visible dans l'éditeur si particles_animation vaut true.


bool particles_anim_loop 🔗

  • void set_particles_anim_loop(value: bool)

  • bool get_particles_anim_loop()

Si true, l'animation des particules boucle.

Note : Cette propriété est uniquement utilisée et visible dans l'éditeur si particles_animation est true.


int particles_anim_v_frames 🔗

  • void set_particles_anim_v_frames(value: int)

  • int get_particles_anim_v_frames()

Le nombre de lignes dans la feuille de sprite assignée comme Texture2D pour un GPUParticles2D ou un CPUParticles2D.

Note : Cette propriété est uniquement utilisée et visible dans l'éditeur si particles_animation vaut true.


bool particles_animation = false 🔗

  • void set_particles_animation(value: bool)

  • bool get_particles_animation()

Si true, cela active les fonctionnalités d'animation basées sur des feuilles de sprite lorsqu'elles sont affectées aux nœuds GPUParticles2D et CPUParticles2D. ParticleProcessMaterial.anim_speed_max ou CPUParticles2D.anim_speed_max doit être une valeur positive pour que l'animation joue.

Cette propriété (et les autres propriétés particles_anim_* qui en dépendent) n'a aucun effet sur d'autres types de nœuds.