CanvasItemMaterial

Inherits: Material < Resource < Reference < Object CanvasItems.

Description

CanvasItemMaterials provide a means of modifying the textures associated with a CanvasItem. They specialize in describing blend and lighting behaviors for textures. Use a ShaderMaterial to more fully customize a material’s interactions with a CanvasItem.

Properties

Enumerations

BlendMode:

  • BLEND_MODE_MIX = 0 —- Mix blending mode. Colors are assumed to be independent of the alpha (opacity) value.
  • BLEND_MODE_ADD = 1 —- Additive blending mode.
  • BLEND_MODE_SUB = 2 —- Subtractive blending mode.
  • BLEND_MODE_MUL = 3 —- Multiplicative blending mode.
  • BLEND_MODE_PREMULT_ALPHA = 4 —- Mix blending mode. Colors are assumed to be premultiplied by the alpha (opacity) value.

LightMode:

  • LIGHT_MODE_NORMAL = 0 —- Render the material using both light and non-light sensitive material properties.
  • LIGHT_MODE_UNSHADED = 1 —- Render the material as if there were no light.
  • LIGHT_MODE_LIGHT_ONLY = 2 —- Render the material as if there were only light.

    Property Descriptions

  • BlendMode blend_mode The manner in which a material’s rendering is applied to underlying textures.
  • LightMode light_mode The manner in which material reacts to lighting.
  • int particles_anim_h_frames Texture for a Particles2D or CPUParticles2D. Note: This property is only used and visible in the editor if particles_animation is true.
  • bool particles_anim_loop true, the particles animation will loop. Note: This property is only used and visible in the editor if particles_animation is true.
  • int particles_anim_v_frames Texture for a Particles2D or CPUParticles2D. Note: This property is only used and visible in the editor if particles_animation is true.
  • bool particles_animation true, enable spritesheet-based animation features when assigned to Particles2D and CPUParticles2D nodes. The ParticlesMaterial.animspeed or CPUParticles2D.anim_speed should also be set to a positive value for the animation to play. `particles_anim*` properties that depend on it) has no effect on other types of nodes.