ParticlesMaterial

继承

Material

简要描述

Particles和Particles2D节点的粒子属性。

描述

粒子材质定义了粒子的特性和行为。

该材料的某些属性在发射时会应用于每个粒子，而其他材质可以应用CurveTexture来在粒子的整个生命周期内改变其值。

当将随机率应用于属性时，它会按随机量缩放该属性。

成员

类型	属性名	默认值
float	angle	0.0
Texture	angle_curve
float	angle_random	0.0
float	angular_velocity	0.0
Texture	angular_velocity_curve
float	angular_velocity_random	0.0
float	anim_offset	0.0
Texture	anim_offset_curve
float	anim_offset_random	0.0
float	anim_speed	0.0
Texture	anim_speed_curve
float	anim_speed_random	0.0
Color	color	Color( 1, 1, 1, 1 )
Texture	color_ramp
float	damping	0.0
Texture	damping_curve
float	damping_random	0.0
Vector3	direction	Vector3( 1, 0, 0 )
Vector3	emission_box_extents
Texture	emission_color_texture
Texture	emission_normal_texture
int	emission_point_count
Texture	emission_point_texture
int	emission_shape	0
float	emission_sphere_radius
bool	flag_align_y	false
bool	flag_disable_z	false
bool	flag_rotate_y	false
float	flatness	0.0
Vector3	gravity	Vector3( 0, -9.8, 0 )
float	hue_variation	0.0
Texture	hue_variation_curve
float	hue_variation_random	0.0
float	initial_velocity	0.0
float	initial_velocity_random	0.0
float	lifetime_randomness	0.0
float	linear_accel	0.0
Texture	linear_accel_curve
float	linear_accel_random	0.0
float	orbit_velocity
Texture	orbit_velocity_curve
float	orbit_velocity_random
float	radial_accel	0.0
Texture	radial_accel_curve
float	radial_accel_random	0.0
float	scale	1.0
Texture	scale_curve
float	scale_random	0.0
float	spread	45.0
float	tangential_accel	0.0
Texture	tangential_accel_curve
float	tangential_accel_random	0.0
GradientTexture	trail_color_modifier
int	trail_divisor	1
CurveTexture	trail_size_modifier

方法

返回值类型	方法名称
bool	get_flag(flag: int) const
float	get_param(param: int) const
float	get_param_randomness(param: int) const
Texture	get_param_texture(param: int) const
void	set_flag(flag: int, enable: bool)
void	set_param(param: int, value: float)
void	set_param_randomness(param: int, randomness: float)
void	set_param_texture(param: int, texture: Texture)

枚举

enum Parameter:

• **PARAM_INITIAL_LINEAR_VELOCITY = 0**

与set_param，set_param_randomness和set_param_texture一起使用以设置初始速度属性。

• **PARAM_ANGULAR_VELOCITY = 1**

与set_param，set_param_randomness和set_param_texture一起使用以设置角速度属性。

• **PARAM_ORBIT_VELOCITY = 2**

与set_param，set_param_randomness和set_param_texture一起使用来设置轨道速度属性。

• **PARAM_LINEAR_ACCEL = 3**

与set_param，set_param_randomness和set_param_texture一起使用以设置线性加速度属性。

• **PARAM_RADIAL_ACCEL = 4**

与set_param，set_param_randomness和set_param_texture一起使用以设置径向加速度属性。

• **PARAM_TANGENTIAL_ACCEL = 5**

与set_param，set_param_randomness和set_param_texture一起使用可设置切向加速度属性。

• **PARAM_DAMPING = 6**

与set_param，set_param_randomness和set_param_texture一起使用以设置阻尼属性。

• **PARAM_ANGLE = 7**

与set_param，set_param_randomness和set_param_texture一起使用以设置角度属性。

• **PARAM_SCALE = 8**

与set_param，set_param_randomness和set_param_texture一起使用以设置比例属性。

• **PARAM_HUE_VARIATION = 9**

与set_param，set_param_randomness和set_param_texture一起使用以设置色调变化属性。

• **PARAM_ANIM_SPEED = 10**

与set_param，set_param_randomness和set_param_texture一起使用以设置动画速度属性。

• **PARAM_ANIM_OFFSET = 11**

与set_param，set_param_randomness和set_param_texture一起使用以设置动画偏移属性。

• **PARAM_MAX = 12**

表示Parameter枚举的大小。

---

enum Flags:

• **FLAG_ALIGN_Y_TO_VELOCITY = 0**

与set_flag一起使用来设置flag_align_y。

• **FLAG_ROTATE_Y = 1**

与set_flag一起使用来设置flag_rotate_y。

• **FLAG_DISABLE_Z = 2**

与set_flag一起使用来设置flag_disable_z。

• **FLAG_MAX = 3**

表示Flags枚举的大小。

---

enum EmissionShape:

• **EMISSION_SHAPE_POINT = 0**

所有粒子将从一个点发射。

• **EMISSION_SHAPE_SPHERE = 1**

粒子将在球体的体积中发射。

• **EMISSION_SHAPE_BOX = 2**

粒子将在盒子的体积内发射。

• **EMISSION_SHAPE_POINTS = 3**

粒子将在通过对membermission_point_texture(#membermission_point_texture)上的随机点进行采样而确定的位置处发射。粒子颜色将通过membermission_color_texture(#membermission_color_texture)进行调制。

• **EMISSION_SHAPE_DIRECTED_POINTS = 4**

粒子将在通过对membermission_point_texture(#membermission_point_texture)上的随机点进行采样而确定的位置处发射。粒子的速度和旋转将基于membermission_normal_texture进行设置。 粒子颜色将通过membermission_color_texture(#membermission_color_texture)进行调制。

• **EMISSION_SHAPE_MAX = 5**

表示EmissionShape枚举的大小。

---

常量

成员说明

• float angle

Default	0.0
setter	set_param(value)
getter	get_param

• Texture angle_curve

setter	set_param_texture(value)
getter	get_param_texture

• float angle_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

• float angular_velocity

Default	0.0
setter	set_param(value)
getter	get_param

• Texture angular_velocity_curve

setter	set_param_texture(value)
getter	get_param_texture

• float angular_velocity_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

• float anim_offset

Default	0.0
setter	set_param(value)
getter	get_param

• Texture anim_offset_curve

setter	set_param_texture(value)
getter	get_param_texture

• float anim_offset_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

• float anim_speed

Default	0.0
setter	set_param(value)
getter	get_param

• Texture anim_speed_curve

setter	set_param_texture(value)
getter	get_param_texture

• float anim_speed_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

• Color color

Default	Color( 1, 1, 1, 1 )
setter	set_color(value)
getter	get_color

• Texture color_ramp

setter	set_color_ramp(value)
getter	get_color_ramp

• float damping

Default	0.0
setter	set_param(value)
getter	get_param

• Texture damping_curve

setter	set_param_texture(value)
getter	get_param_texture

• float damping_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

• Vector3 direction

Default	Vector3( 1, 0, 0 )
setter	set_direction(value)
getter	get_direction

• Vector3 emission_box_extents

setter	set_emission_box_extents(value)
getter	get_emission_box_extents

• Texture emission_color_texture

setter	set_emission_color_texture(value)
getter	get_emission_color_texture

• Texture emission_normal_texture

setter	set_emission_normal_texture(value)
getter	get_emission_normal_texture

• int emission_point_count

setter	set_emission_point_count(value)
getter	get_emission_point_count

• Texture emission_point_texture

setter	set_emission_point_texture(value)
getter	get_emission_point_texture

• int emission_shape

Default	0
setter	set_emission_shape(value)
getter	get_emission_shape

• float emission_sphere_radius

setter	set_emission_sphere_radius(value)
getter	get_emission_sphere_radius

• bool flag_align_y

Default	false
setter	set_flag(value)
getter	get_flag

• bool flag_disable_z

Default	false
setter	set_flag(value)
getter	get_flag

• bool flag_rotate_y

Default	false
setter	set_flag(value)
getter	get_flag

• float flatness

Default	0.0
setter	set_flatness(value)
getter	get_flatness

• Vector3 gravity

Default	Vector3( 0, -9.8, 0 )
setter	set_gravity(value)
getter	get_gravity

• float hue_variation

Default	0.0
setter	set_param(value)
getter	get_param

• Texture hue_variation_curve

setter	set_param_texture(value)
getter	get_param_texture

• float hue_variation_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

• float initial_velocity

Default	0.0
setter	set_param(value)
getter	get_param

• float initial_velocity_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

• float lifetime_randomness

Default	0.0
setter	set_lifetime_randomness(value)
getter	get_lifetime_randomness

• float linear_accel

Default	0.0
setter	set_param(value)
getter	get_param

• Texture linear_accel_curve

setter	set_param_texture(value)
getter	get_param_texture

• float linear_accel_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

• float orbit_velocity

setter	set_param(value)
getter	get_param

• Texture orbit_velocity_curve

setter	set_param_texture(value)
getter	get_param_texture

• float orbit_velocity_random

setter	set_param_randomness(value)
getter	get_param_randomness

• float radial_accel

Default	0.0
setter	set_param(value)
getter	get_param

• Texture radial_accel_curve

setter	set_param_texture(value)
getter	get_param_texture

• float radial_accel_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

• float scale

Default	1.0
setter	set_param(value)
getter	get_param

• Texture scale_curve

setter	set_param_texture(value)
getter	get_param_texture

• float scale_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

• float spread

Default	45.0
setter	set_spread(value)
getter	get_spread

• float tangential_accel

Default	0.0
setter	set_param(value)
getter	get_param

• Texture tangential_accel_curve

setter	set_param_texture(value)
getter	get_param_texture

• float tangential_accel_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

• GradientTexture trail_color_modifier

setter	set_trail_color_modifier(value)
getter	get_trail_color_modifier

• int trail_divisor

Default	1
setter	set_trail_divisor(value)
getter	get_trail_divisor

• CurveTexture trail_size_modifier

setter	set_trail_size_modifier(value)
getter	get_trail_size_modifier

方法说明

• get_flag get_flag(flag: int) const

如果启用了指定的标志，则返回true。

---

• get_param get_param(param: int) const

返回指定参数的值。

---

• get_param_randomness get_param_randomness(param: int) const

返回与指定参数关联的随机率。

---

• get_param_texture get_param_texture(param: int) const

返回指定参数使用的Texture。

---

• set_flag set_flag(flag: int, enable: bool)

如果为true，则启用指定的标志。有关选项，请参见Flags。

---

• set_param set_param(param: int, value: float)

设置指定的Parameter。

---

• set_param_randomness set_param_randomness(param: int, randomness: float)

设置指定的Parameter的随机率。

---

• set_param_texture set_param_texture(param: int, texture: Texture)

为指定的Parameter设置Texture。

---