CPUParticles

Inherits: GeometryInstance < VisualInstance < Spatial < Node < Object

类别： 核心

简要说明

基于CPU的3D粒子发射器。

属性

int	amount	8
float	angle	0.0
Curve	angle_curve
float	angle_random	0.0
float	angular_velocity	0.0
Curve	angular_velocity_curve
float	angular_velocity_random	0.0
float	anim_offset	0.0
Curve	anim_offset_curve
float	anim_offset_random	0.0
float	anim_speed	0.0
Curve	anim_speed_curve
float	anim_speed_random	0.0
Color	color	颜色（1，1，1，1）
Gradient	color_ramp
float	damping	0.0
Curve	damping_curve
float	damping_random	0.0
Vector3	direction	矢量3（1，0，0）
DrawOrder	draw_order	0
Vector3	emission_box_extents
PoolColorArray	emission_colors	池颜色数组（）
PoolVector3Array	emission_normals
PoolVector3Array	emission_points	池向量3数组（）
EmissionShape	emission_shape	0
float	emission_sphere_radius
bool	emitting	真
float	explosiveness	0.0
int	fixed_fps	0
bool	flag_align_y	假
bool	flag_disable_z	假
bool	flag_rotate_y	假
float	flatness	0.0
bool	fract_delta	真
Vector3	gravity	矢量3（0，-9.8，0）
float	hue_variation	0.0
Curve	hue_variation_curve
float	hue_variation_random	0.0
float	initial_velocity	0.0
float	initial_velocity_random	0.0
float	lifetime	1.0
float	lifetime_randomness	0.0
float	linear_accel	0.0
Curve	linear_accel_curve
float	linear_accel_random	0.0
bool	local_coords	真
Mesh	mesh
bool	one_shot	假
float	orbit_velocity
Curve	orbit_velocity_curve
float	orbit_velocity_random
float	preprocess	0.0
float	radial_accel	0.0
Curve	radial_accel_curve
float	radial_accel_random	0.0
float	randomness	0.0
float	scale_amount	1.0
Curve	scale_amount_curve
float	scale_amount_random	0.0
float	speed_scale	1.0
float	spread	45.0
float	tangential_accel	0.0
Curve	tangential_accel_curve
float	tangential_accel_random	0.0

方法

无效	convert_from_particles ( Node particles )
float	get_param ( Parameter param ) const
Curve	get_param_curve ( Parameter param ) const
float	get_param_randomness ( Parameter param ) const
bool	get_particle_flag ( Flags flag ) const
无效	restart ( )
无效	set_param ( Parameter param, float value )
无效	set_param_curve ( Parameter param, Curve curve )
无效	set_param_randomness ( Parameter param, float randomness )
无效	set_particle_flag ( Flags flag, bool enable )

枚举

枚举 DrawOrder ：

• DRAW_ORDER_INDEX = 0 ---粒子按发射顺序被抽取。

• DRAW_ORDER_LIFETIME = 1 ---按照剩余寿命的顺序绘制粒子。

• DRAW_ORDER_VIEW_DEPTH = 2 ——颗粒是按深度顺序抽取的。

枚举 参数 ：

• PARAM_INITIAL_LINEAR_VELOCITY = 0 ---与一起使用 set_param ， set_param_randomness 和 set_param_curve 设置初始速度属性。

• PARAM_ANGULAR_VELOCITY = 1 ---与一起使用 set_param ， set_param_randomness 和 set_param_curve 设置角速度属性。

• PARAM_ORBIT_VELOCITY = 2 ---与一起使用 set_param ， set_param_randomness 和 set_param_curve 设置轨道速度属性。

• PARAM_LINEAR_ACCEL = 3 ---与一起使用 set_param ， set_param_randomness 和 set_param_curve 设置线性加速度属性。

• PARAM_RADIAL_ACCEL = 4 ---与一起使用 set_param ， set_param_randomness 和 set_param_curve 设置径向加速度属性。

• PARAM_TANGENTIAL_ACCEL = 5 ---与一起使用 set_param ， set_param_randomness 和 set_param_curve 设置切向加速度属性。

• PARAM_DAMPING = 6 ---与一起使用 set_param ， set_param_randomness 和 set_param_curve 设置阻尼特性。

• PARAM_ANGLE = 7 ---与一起使用 set_param ， set_param_randomness 和 set_param_curve 设置角度属性。

• PARAM_SCALE = 8 ---与一起使用 set_param ， set_param_randomness 和 set_param_curve 设置比例属性。

• PARAM_HUE_VARIATION = 9 ---与一起使用 set_param ， set_param_randomness 和 set_param_curve 设置色调变化属性。

• PARAM_ANIM_SPEED = 10 ---与一起使用 set_param ， set_param_randomness 和 set_param_curve 设置动画速度属性。

• PARAM_ANIM_OFFSET = 11 ---与一起使用 set_param ， set_param_randomness 和 set_param_curve 设置动画偏移属性。

• PARAM_MAX = 12 ---表示 Parameter 枚举。

枚举 旗帜 ：

• FLAG_ALIGN_Y_TO_VELOCITY = 0 ---与一起使用 set_particle_flag 设置 flag_align_y .

• FLAG_ROTATE_Y = 1 ---与一起使用 set_particle_flag 设置 flag_rotate_y .

• FLAG_DISABLE_Z = 2 ---与一起使用 set_particle_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_points . 粒子颜色将通过 emission_colors .

• EMISSION_SHAPE_DIRECTED_POINTS = 4 ---粒子将在随机选择的位置发射。 emission_points . 粒子速度和旋转将根据 emission_normals . 粒子颜色将通过 emission_colors .

描述

基于CPU的三维粒子节点，用于创建各种粒子系统和效果。

也见 Particles 提供相同的硬件加速功能，但不能在旧设备上运行。

属性描述

• int amount

违约	8
设定器	设置金额（值）
吸气剂	获取金额（）

在一个发射循环中发射的粒子数。

• float angle

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

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

• Curve angle_curve

设定器	设置曲线（值）
吸气剂	获取曲线

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

• float angle_random

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

旋转随机性比。

• float angular_velocity

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

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

• Curve angular_velocity_curve

设定器	设置曲线（值）
吸气剂	获取曲线

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

• float angular_velocity_random

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

角速度随机比。

• float anim_offset

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

粒子动画偏移。

• Curve anim_offset_curve

设定器	设置曲线（值）
吸气剂	获取曲线

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

• float anim_offset_random

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

动画偏移随机性比率。

• float anim_speed

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

粒子动画速度。

• Curve anim_speed_curve

设定器	设置曲线（值）
吸气剂	获取曲线

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

• float anim_speed_random

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

动画速度随机比。

• Color color

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

不用于三维粒子。

• Gradient color_ramp

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

不用于三维粒子。

• float damping

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

粒子失去速度的速率。

• Curve damping_curve

设定器	设置曲线（值）
吸气剂	获取曲线

阻尼会随此变化 Curve .

• float damping_random

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

阻尼随机比。

• Vector3 direction

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

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

• DrawOrder draw_order

违约	0
设定器	设置绘制顺序（值）
吸气剂	获取_draw_order（）。

粒子绘制顺序。使用 DrawOrder 价值观。

• Vector3 emission_box_extents

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

矩形的范围如果 emission_shape 设置为 EMISSION_SHAPE_BOX .

• PoolColorArray emission_colors

违约	池颜色数组（）
设定器	设置“发射”颜色（值）
吸气剂	获取“发射颜色”（）

• PoolVector3Array emission_normals

设定器	设置“发射”法线（值）
吸气剂	获取排放标准值

• PoolVector3Array emission_points

违约	池向量3数组（）
设定器	设置排放点（值）
吸气剂	获得排放点

• EmissionShape emission_shape

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

粒子将在此区域内发射。见 EmissionShape 对于可能的值。

• float emission_sphere_radius

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

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

• bool emitting

违约	真
设定器	设置发射（值）
吸气剂	正在发出（）。

如果 true ，正在发射粒子。

• float explosiveness

违约	0.0
设定器	设置爆炸率（值）
吸气剂	得到爆炸率

粒子在发射周期中的发射速度。如果大于 0 在下一个循环开始之前，排放量将有一个缺口。

• int fixed_fps

违约	0
设定器	设置“固定”fps（值）
吸气剂	获取固定的FPS（）。

粒子系统的帧速率固定为一个值。例如，将值更改为2将使粒子以每秒2帧的速度渲染。注意，这不会减慢粒子系统本身的速度。

• 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平面。

• bool fract_delta

违约	真
设定器	设置分数增量（值）
吸气剂	获取分数增量（）

如果 true ，导致分数增量计算，具有更平滑的粒子显示效果。

• Vector3 gravity

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

重力作用于每一个粒子。

• float hue_variation

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

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

• Curve hue_variation_curve

设定器	设置曲线（值）
吸气剂	获取曲线

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

• float hue_variation_random

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

色调变化随机率。

• float initial_velocity

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

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

• float initial_velocity_random

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

初速度随机比。

• float lifetime

违约	1.0
设定器	设置寿命（值）
吸气剂	获取生存期（）

每个粒子存在的时间。

• float lifetime_randomness

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

粒子寿命随机性比。

• float linear_accel

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

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

• Curve linear_accel_curve

设定器	设置曲线（值）
吸气剂	获取曲线

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

• float linear_accel_random

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

线加速度随机比。

• bool local_coords

违约	真
设定器	设置使用本地坐标（值）
吸气剂	获取使用本地坐标

如果 true ，粒子使用父节点的坐标空间。如果 false ，它们使用全局坐标。

• Mesh mesh

设定器	设置网格（值）
吸气剂	获取网格（）

这个 Mesh 用于每个粒子。如果 null ，粒子将是球体。

• bool one_shot

违约	假
设定器	设置一次放炮（值）
吸气剂	获得一张照片

如果 true ，仅发生一个排放循环。如果设置 true 在一个循环中，排放将在循环结束时停止。

• float orbit_velocity

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

应用于每个粒子的轨道速度。使粒子在局部xy平面中围绕原点旋转。以每秒围绕原点的完整旋转数指定。

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

• Curve orbit_velocity_curve

设定器	设置曲线（值）
吸气剂	获取曲线

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

• float orbit_velocity_random

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

轨道速度随机比。

• float preprocess

违约	0.0
设定器	设置预处理时间（值）
吸气剂	获取预处理时间

粒子系统的启动就好像它已经运行了这么多秒。

• float radial_accel

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

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

• Curve radial_accel_curve

设定器	设置曲线（值）
吸气剂	获取曲线

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

• float radial_accel_random

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

径向加速度随机比。

• float randomness

违约	0.0
设定器	设置随机性比率（值）
吸气剂	得到随机性比率

发射寿命随机比。

• float scale_amount

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

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

• Curve scale_amount_curve

设定器	设置曲线（值）
吸气剂	获取曲线

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

• float scale_amount_random

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

尺度随机性比率。

• float speed_scale

违约	1.0
设定器	设置速度刻度（值）
吸气剂	获取速度刻度

粒子系统的运行速度比例。值 0 可用于暂停粒子。

• float spread

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

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

• float tangential_accel

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

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

• Curve tangential_accel_curve

设定器	设置曲线（值）
吸气剂	获取曲线

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

• float tangential_accel_random

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

切向加速度随机比。

方法说明

• void convert_from_particles ( Node particles )

将此节点的属性设置为与给定的 Particles 已分配的节点 ParticlesMaterial .

• float get_param ( Parameter param ) const

• Curve get_param_curve ( Parameter param ) const

• float get_param_randomness ( Parameter param ) const

• bool get_particle_flag ( Flags flag ) const

• void restart ( )

重新启动粒子发射器。

• void set_param ( Parameter param, float value )

• void set_param_curve ( Parameter param, Curve curve )

• void set_param_randomness ( Parameter param, float randomness )

• void set_particle_flag ( Flags flag, bool enable )