2017-09-12 22:42:36 +02:00
<?xml version="1.0" encoding="UTF-8" ?>
2021-03-23 13:40:34 +01:00
<class name= "CanvasItemMaterial" inherits= "Material" version= "3.3" >
2017-09-12 22:42:36 +02:00
<brief_description >
2017-12-07 20:17:08 +01:00
A material for [CanvasItem]s.
2017-09-12 22:42:36 +02:00
</brief_description>
<description >
2019-03-29 23:37:35 +01:00
[CanvasItemMaterial]s 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].
2017-09-12 22:42:36 +02:00
</description>
<tutorials >
</tutorials>
<methods >
</methods>
<members >
2019-06-29 12:38:01 +02:00
<member name= "blend_mode" type= "int" setter= "set_blend_mode" getter= "get_blend_mode" enum= "CanvasItemMaterial.BlendMode" default= "0" >
2017-12-07 20:17:08 +01:00
The manner in which a material's rendering is applied to underlying textures.
2017-09-12 22:42:36 +02:00
</member>
2019-06-29 12:38:01 +02:00
<member name= "light_mode" type= "int" setter= "set_light_mode" getter= "get_light_mode" enum= "CanvasItemMaterial.LightMode" default= "0" >
2017-12-07 20:17:08 +01:00
The manner in which material reacts to lighting.
2017-09-12 22:42:36 +02:00
</member>
2019-06-29 21:22:15 +02:00
<member name= "particles_anim_h_frames" type= "int" setter= "set_particles_anim_h_frames" getter= "get_particles_anim_h_frames" >
2020-01-23 11:14:14 +01:00
The number of columns in the spritesheet assigned as [Texture] for a [Particles2D] or [CPUParticles2D].
[b]Note:[/b] This property is only used and visible in the editor if [member particles_animation] is [code]true[/code].
2018-11-10 14:21:34 +01:00
</member>
2019-06-29 21:22:15 +02:00
<member name= "particles_anim_loop" type= "bool" setter= "set_particles_anim_loop" getter= "get_particles_anim_loop" >
2020-01-23 11:14:14 +01:00
If [code]true[/code], the particles animation will loop.
[b]Note:[/b] This property is only used and visible in the editor if [member particles_animation] is [code]true[/code].
2018-11-10 14:21:34 +01:00
</member>
2019-06-29 21:22:15 +02:00
<member name= "particles_anim_v_frames" type= "int" setter= "set_particles_anim_v_frames" getter= "get_particles_anim_v_frames" >
2020-01-23 11:14:14 +01:00
The number of rows in the spritesheet assigned as [Texture] for a [Particles2D] or [CPUParticles2D].
[b]Note:[/b] This property is only used and visible in the editor if [member particles_animation] is [code]true[/code].
2018-11-10 14:21:34 +01:00
</member>
2019-06-29 12:38:01 +02:00
<member name= "particles_animation" type= "bool" setter= "set_particles_animation" getter= "get_particles_animation" default= "false" >
2020-01-23 11:14:14 +01:00
If [code]true[/code], enable spritesheet-based animation features when assigned to [Particles2D] and [CPUParticles2D] nodes. The [member ParticlesMaterial.anim_speed] or [member CPUParticles2D.anim_speed] should also be set to a positive value for the animation to play.
This property (and other [code]particles_anim_*[/code] properties that depend on it) has no effect on other types of nodes.
2018-11-10 14:21:34 +01:00
</member>
2017-09-12 22:42:36 +02:00
</members>
<constants >
2017-11-24 23:16:30 +01:00
<constant name= "BLEND_MODE_MIX" value= "0" enum= "BlendMode" >
2017-12-07 20:17:08 +01:00
Mix blending mode. Colors are assumed to be independent of the alpha (opacity) value.
2017-09-12 22:42:36 +02:00
</constant>
2017-11-24 23:16:30 +01:00
<constant name= "BLEND_MODE_ADD" value= "1" enum= "BlendMode" >
2017-12-07 20:17:08 +01:00
Additive blending mode.
2017-09-12 22:42:36 +02:00
</constant>
2017-11-24 23:16:30 +01:00
<constant name= "BLEND_MODE_SUB" value= "2" enum= "BlendMode" >
2017-12-07 20:17:08 +01:00
Subtractive blending mode.
2017-09-12 22:42:36 +02:00
</constant>
2017-11-24 23:16:30 +01:00
<constant name= "BLEND_MODE_MUL" value= "3" enum= "BlendMode" >
2017-12-07 20:17:08 +01:00
Multiplicative blending mode.
2017-09-12 22:42:36 +02:00
</constant>
2017-11-24 23:16:30 +01:00
<constant name= "BLEND_MODE_PREMULT_ALPHA" value= "4" enum= "BlendMode" >
2017-12-07 20:17:08 +01:00
Mix blending mode. Colors are assumed to be premultiplied by the alpha (opacity) value.
2017-09-12 22:42:36 +02:00
</constant>
2017-11-24 23:16:30 +01:00
<constant name= "LIGHT_MODE_NORMAL" value= "0" enum= "LightMode" >
2017-12-07 20:17:08 +01:00
Render the material using both light and non-light sensitive material properties.
2017-09-12 22:42:36 +02:00
</constant>
2017-11-24 23:16:30 +01:00
<constant name= "LIGHT_MODE_UNSHADED" value= "1" enum= "LightMode" >
2017-12-07 20:17:08 +01:00
Render the material as if there were no light.
2017-09-12 22:42:36 +02:00
</constant>
2017-11-24 23:16:30 +01:00
<constant name= "LIGHT_MODE_LIGHT_ONLY" value= "2" enum= "LightMode" >
2017-12-07 20:17:08 +01:00
Render the material as if there were only light.
2017-09-12 22:42:36 +02:00
</constant>
</constants>
</class>