CanvasItemMaterial

Inherits: Material < Resource < Reference < Object

CanvasItem的材质。

描述

CanvasItemMaterial提供了一种修改与CanvasItem相关联的纹理的方法。他们专注于描述纹理的混合和照明行为。使用ShaderMaterial可以更全面地自定义材质与CanvasItem的交互。

属性

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

枚举

enum BlendMode:

  • BLEND_MODE_MIX = 0 —- 混合混合模式。假设颜色与alpha(不透明度)值无关。

  • BLEND_MODE_ADD = 1 —- 加法混合模式。

  • BLEND_MODE_SUB = 2 —- 减法混合模式。

  • BLEND_MODE_MUL = 3 —- 乘法混合模式。

  • BLEND_MODE_PREMULT_ALPHA = 4 —- 混合混合模式。假定颜色已预先乘以alpha(不透明度)值。


enum LightMode:

  • LIGHT_MODE_NORMAL = 0 —- 使用光敏和非光敏材料属性渲染材质。

  • LIGHT_MODE_UNSHADED = 1 —- 将材质渲染成没有光的样子。

  • LIGHT_MODE_LIGHT_ONLY = 2 —- 将材质渲染成只有光的样子。

属性说明

Default

0

Setter

set_blend_mode(value)

Getter

get_blend_mode()

将材质的渲染应用于基础纹理的方式。


Default

0

Setter

set_light_mode(value)

Getter

get_light_mode()

材质对照明的反应方式。


  • int particles_anim_h_frames

Setter

set_particles_anim_h_frames(value)

Getter

get_particles_anim_h_frames()

精灵表中分配为 Particles2DCPUParticles2DTexture 的列数。

注意:仅当 particles_animationtrue 时,此属性才在编辑器中使用和可见。


  • bool particles_anim_loop

Setter

set_particles_anim_loop(value)

Getter

get_particles_anim_loop()

如果true,粒子动画将循环播放。

注意:只有当particles_animationtrue时,该属性才会在编辑器中使用并可见。


  • int particles_anim_v_frames

Setter

set_particles_anim_v_frames(value)

Getter

get_particles_anim_v_frames()

精灵表中分配为 Particles2DCPUParticles2DTexture 的行数。

注意:仅当 particles_animationtrue 时,此属性才在编辑器中使用和可见。


  • bool particles_animation

Default

false

Setter

set_particles_animation(value)

Getter

get_particles_animation()

如果为true,当分配给 Particles2DCPUParticles2D 节点时,启用基于spritesheet的动画功能。ParticlesMaterial.anim_speedCPUParticles2D.anim_speed也应设置为正值,才能播放动画。

这个属性(以及其他依赖于它的particles_anim_*属性)对其他类型的节点没有影响。