ParticlesMaterial

Inherits: Material < Resource < Reference < Object

类别： 核心

简要说明

的粒子属性 Particles 和 Particles2D 节点。

属性

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	颜色（1，1，1，1）
Texture	color_ramp
float	damping	0.0
Texture	damping_curve
float	damping_random	0.0
Vector3	direction	矢量3（1，0，0）
Vector3	emission_box_extents
Texture	emission_color_texture
Texture	emission_normal_texture
int	emission_point_count
Texture	emission_point_texture
EmissionShape	emission_shape	0
float	emission_sphere_radius
bool	flag_align_y	假
bool	flag_disable_z	假
bool	flag_rotate_y	假
float	flatness	0.0
Vector3	gravity	矢量3（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 ( Flags flag ) const
float	get_param ( Parameter param ) const
float	get_param_randomness ( Parameter param ) const
Texture	get_param_texture ( Parameter param ) const
无效	set_flag ( Flags flag, bool enable )
无效	set_param ( Parameter param, float value )
无效	set_param_randomness ( Parameter param, float randomness )
无效	set_param_texture ( Parameter param, Texture texture )

枚举

枚举 参数 ：

• 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 枚举。

枚举 旗帜 ：

• 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 枚举。

枚举 EmissionShape ：

• EMISSION_SHAPE_POINT = 0 ---所有粒子都将从一个点发射。

• EMISSION_SHAPE_SPHERE = 1 ---粒子将以球体的体积发射。

• EMISSION_SHAPE_BOX = 2 ---粒子将以盒子的体积发射。

• EMISSION_SHAPE_POINTS = 3 ---粒子将在通过在 emission_point_texture . 粒子颜色将通过 emission_color_texture .

• EMISSION_SHAPE_DIRECTED_POINTS = 4 ---粒子将在通过在 emission_point_texture . 粒子速度和旋转将根据 emission_normal_texture . 粒子颜色将通过 emission_color_texture .

描述

粒子材料定义粒子属性和行为。它用于 process_material 属于 Particles 和 Particles2D 发射器节点。

这种材料的某些属性在发射时应用于每个粒子，而其他属性则可以 CurveTexture 应用于在粒子的生命周期中改变值。

当一个随机性比率应用于一个属性时，它被用来以一个随机数缩放该属性。随机比率用于插入 1.0 且随机数小于1时，将结果乘以该属性得到该随机属性。例如，随机比率 0.4 将原始属性缩放到 0.4-1.0 它的原值。

属性描述

• float angle

违约	0.0
设定器	设置参数（值）
吸气剂	获取参数（）

应用于每个粒子的初始旋转（度）。

仅在以下情况下应用 flag_disable_z 或 flag_rotate_y 是 true 或 SpatialMaterial 用于绘制粒子的方法是 SpatialMaterial.BILLBOARD_PARTICLES .

• Texture angle_curve

设定器	设置“参数”纹理（值）
吸气剂	获取纹理参数

每个粒子的旋转都将沿着 CurveTexture .

• float angle_random

违约	0.0
设定器	设置随机性（值）
吸气剂	获取随机性

旋转随机性比。

• float angular_velocity

违约	0.0
设定器	设置参数（值）
吸气剂	获取参数（）

应用于每个粒子的初始角速度。设置粒子的旋转速度。

仅在以下情况下应用 flag_disable_z 或 flag_rotate_y 是 true 或 SpatialMaterial 用于绘制粒子的方法是 SpatialMaterial.BILLBOARD_PARTICLES .

• Texture angular_velocity_curve

设定器	设置“参数”纹理（值）
吸气剂	获取纹理参数

每个粒子的角速度都会随着这个变化。 CurveTexture .

• float angular_velocity_random

违约	0.0
设定器	设置随机性（值）
吸气剂	获取随机性

角速度随机比。

• float anim_offset

违约	0.0
设定器	设置参数（值）
吸气剂	获取参数（）

粒子动画偏移。

• Texture anim_offset_curve

设定器	设置“参数”纹理（值）
吸气剂	获取纹理参数

每个粒子的动画偏移将随此变化 CurveTexture .

• float anim_offset_random

违约	0.0
设定器	设置随机性（值）
吸气剂	获取随机性

动画偏移随机性比率。

• float anim_speed

违约	0.0
设定器	设置参数（值）
吸气剂	获取参数（）

粒子动画速度。

• Texture anim_speed_curve

设定器	设置“参数”纹理（值）
吸气剂	获取纹理参数

每个粒子的动画速度将随此变化 CurveTexture .

• float anim_speed_random

违约	0.0
设定器	设置随机性（值）
吸气剂	获取随机性

动画速度随机比。

• Color color

违约	颜色（1，1，1，1）
设定器	设置颜色（值）
吸气剂	获取颜色（）

每个粒子的初始颜色。如果 Particles2D 的 texture 定义后，它将乘以该颜色。将粒子显示颜色设置为 SpatialMaterial 确保设置 SpatialMaterial.vertex_color_use_as_albedo 到 true .

• Texture color_ramp

设定器	设置颜色渐变（值）
吸气剂	获取颜色渐变（）。

每个粒子的颜色都会随此变化 GradientTexture .

• float damping

违约	0.0
设定器	设置参数（值）
吸气剂	获取参数（）

粒子失去速度的速率。

• Texture damping_curve

设定器	设置“参数”纹理（值）
吸气剂	获取纹理参数

阻尼会随此变化 CurveTexture .

• float damping_random

违约	0.0
设定器	设置随机性（值）
吸气剂	获取随机性

阻尼随机比。

• Vector3 direction

违约	矢量3（1，0，0）
设定器	设置方向（值）
吸气剂	获取方向（）

指定粒子发射方向的单位向量。

• Vector3 emission_box_extents

设定器	设置“发射”框的范围（值）
吸气剂	获取“发射”框的“范围”（）

框的范围如果 emission_shape 设置为 EMISSION_SHAPE_BOX .

• Texture emission_color_texture

设定器	设置发射颜色纹理（值）
吸气剂	获取_发射_颜色_纹理（）

粒子颜色将通过在与 emission_point_texture .

• Texture emission_normal_texture

设定器	设置“发射”正常纹理（值）
吸气剂	获取_emission_normal_纹理（）

粒子速度和旋转将通过在与 emission_point_texture . 仅用于 EMISSION_SHAPE_DIRECTED_POINTS . 通过在工具栏中的“粒子”工具下选择“从网格/节点创建发射点”，可以从网格或节点自动创建。

• int emission_point_count

设定器	设置排放点计数（值）
吸气剂	获取排放点计数（））

如果 emission_shape 设置为 EMISSION_SHAPE_POINTS 或 EMISSION_SHAPE_DIRECTED_POINTS .

• Texture emission_point_texture

设定器	设置发射点纹理（值）
吸气剂	获取发射点纹理

粒子将在随机位置通过采样该纹理确定的位置发射。用于 EMISSION_SHAPE_POINTS 和 EMISSION_SHAPE_DIRECTED_POINTS . 通过在工具栏中的“粒子”工具下选择“从网格/节点创建发射点”，可以从网格或节点自动创建。

• EmissionShape emission_shape

违约	0
设定器	设置排放形状（值）
吸气剂	得到排放物形状

粒子将在此区域内发射。使用 EMISSION_SHAPE_* 值的常量。

• float emission_sphere_radius

设定器	设置发射球半径（值）
吸气剂	获取发射球半径

球体的半径如果 emission_shape 设置为 EMISSION_SHAPE_SPHERE .

• bool flag_align_y

违约	假
设定器	设置_标志（值）
吸气剂	获取_标志（）

将粒子的Y轴与其速度方向对齐。

• bool flag_disable_z

违约	假
设定器	设置_标志（值）
吸气剂	获取_标志（）

如果 true ，粒子不会在Z轴上移动。

• bool flag_rotate_y

违约	假
设定器	设置_标志（值）
吸气剂	获取_标志（）

如果 true ，粒子绕Y轴旋转 angle .

• float flatness

违约	0.0
设定器	设置平面度（值）
吸气剂	得到平面度

金额 spread 在Y/Z平面。值 1 将粒子限制到X/Z平面。

• Vector3 gravity

违约	矢量3（0，-9.8，0）
设定器	设置重力（值）
吸气剂	获得重力

重力作用于每一个粒子。

• float hue_variation

违约	0.0
设定器	设置参数（值）
吸气剂	获取参数（）

应用于每个粒子的初始色调变化。

• Texture hue_variation_curve

设定器	设置“参数”纹理（值）
吸气剂	获取纹理参数

每个粒子的色调都会随着 CurveTexture .

• float hue_variation_random

违约	0.0
设定器	设置随机性（值）
吸气剂	获取随机性

色调变化随机率。

• float initial_velocity

违约	0.0
设定器	设置参数（值）
吸气剂	获取参数（）

每个粒子的初始速度大小。方向来自 spread 以及节点的方向。

• float initial_velocity_random

违约	0.0
设定器	设置随机性（值）
吸气剂	获取随机性

初速度随机比。

• float lifetime_randomness

违约	0.0
设定器	设置寿命随机性（值）
吸气剂	获得终身随机性

粒子寿命随机性比。

• float linear_accel

违约	0.0
设定器	设置参数（值）
吸气剂	获取参数（）

沿运动方向施加在每个粒子上的线加速度。

• Texture linear_accel_curve

设定器	设置“参数”纹理（值）
吸气剂	获取纹理参数

每个粒子的线加速度都会随着这个变化而变化。 CurveTexture .

• float linear_accel_random

违约	0.0
设定器	设置随机性（值）
吸气剂	获取随机性

线加速度随机比。

• float orbit_velocity

设定器	设置参数（值）
吸气剂	获取参数（）

应用于每个粒子的轨道速度。使粒子围绕原点旋转。以每秒围绕原点的完整旋转数指定。

仅在以下情况下可用 flag_disable_z 是 true .

• Texture orbit_velocity_curve

设定器	设置“参数”纹理（值）
吸气剂	获取纹理参数

每个粒子的轨道速度都会随着这个变化。 CurveTexture .

• float orbit_velocity_random

设定器	设置随机性（值）
吸气剂	获取随机性

轨道速度随机比。

• float radial_accel

违约	0.0
设定器	设置参数（值）
吸气剂	获取参数（）

应用于每个粒子的径向加速度。使粒子加速远离原点。

• Texture radial_accel_curve

设定器	设置“参数”纹理（值）
吸气剂	获取纹理参数

每个粒子的径向加速度都会随着这个变化而变化。 CurveTexture .

• float radial_accel_random

违约	0.0
设定器	设置随机性（值）
吸气剂	获取随机性

径向加速度随机比。

• float scale

违约	1.0
设定器	设置参数（值）
吸气剂	获取参数（）

应用于每个粒子的初始比例。

• Texture scale_curve

设定器	设置“参数”纹理（值）
吸气剂	获取纹理参数

每个粒子的尺度都会随着这个变化而变化。 CurveTexture .

• float scale_random

违约	0.0
设定器	设置随机性（值）
吸气剂	获取随机性

尺度随机性比率。

• float spread

违约	45.0
设定器	设置排列（值）
吸气剂	获取u排列（）

每个粒子的初始方向从 +spread 到 -spread 度。应用于X/Z平面和Y/Z平面。

• float tangential_accel

违约	0.0
设定器	设置参数（值）
吸气剂	获取参数（）

切向加速度应用于每个粒子。切向加速度垂直于粒子的速度，使粒子产生旋转运动。

• Texture tangential_accel_curve

设定器	设置“参数”纹理（值）
吸气剂	获取纹理参数

每个粒子的切向加速度都会随着这个变化。 CurveTexture .

• float tangential_accel_random

违约	0.0
设定器	设置随机性（值）
吸气剂	获取随机性

切向加速度随机比。

• GradientTexture trail_color_modifier

设定器	设置_trail_color_修饰符（值）
吸气剂	获取_trail_color_modifier（）

轨迹粒子的颜色将随此变化 GradientTexture .

• int trail_divisor

违约	1
设定器	设置跟踪除数（值）
吸气剂	获取跟踪除数（）

发射器将发射 amount 除以 trail_divisor 颗粒。其余粒子将用作轨迹。

• CurveTexture trail_size_modifier

设定器	设置“轨迹大小”修改器（值）
吸气剂	获取_trail_size_modifier（）

轨迹粒子的大小将随此变化 CurveTexture .

方法说明

• bool get_flag ( Flags flag ) const

• float get_param ( Parameter param ) const

• float get_param_randomness ( Parameter param ) const

• Texture get_param_texture ( Parameter param ) const

• void set_flag ( Flags flag, bool enable )

• void set_param ( Parameter param, float value )

• void set_param_randomness ( Parameter param, float randomness )

• void set_param_texture ( Parameter param, Texture texture )