CPUParticles

继承

GeometryInstance

简要描述

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

描述

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

另请参见Particles，它提供与硬件加速相同的功能，但可能无法在较旧的设备上运行。

成员

类型	属性名	默认值
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	Color( 1, 1, 1, 1 )
Gradient	color_ramp
float	damping	0.0
Curve	damping_curve
float	damping_random	0.0
Vector3	direction	Vector3( 1, 0, 0 )
int	draw_order	0
Vector3	emission_box_extents
PoolColorArray	emission_colors	PoolColorArray( )
PoolVector3Array	emission_normals
PoolVector3Array	emission_points	PoolVector3Array( )
int	emission_shape	0
float	emission_sphere_radius
bool	emitting	true
float	explosiveness	0.0
int	fixed_fps	0
bool	flag_align_y	false
bool	flag_disable_z	false
bool	flag_rotate_y	false
float	flatness	0.0
bool	fract_delta	true
Vector3	gravity	Vector3( 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	true
Mesh	mesh
bool	one_shot	false
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

方法

返回值类型	方法名称
void	convert_from_particles(particles: Node)
float	get_param(param: int) const
Curve	get_param_curve(param: int) const
float	get_param_randomness(param: int) const
bool	get_particle_flag(flag: int) const
void	restart()
void	set_param(param: int, value: float)
void	set_param_curve(param: int, curve: Curve)
void	set_param_randomness(param: int, randomness: float)
void	set_particle_flag(flag: int, enable: bool)

枚举

enum DrawOrder:

• **DRAW_ORDER_INDEX = 0**

粒子按发射顺序绘制。

• **DRAW_ORDER_LIFETIME = 1**

按照剩余寿命的顺序绘制粒子。

• **DRAW_ORDER_VIEW_DEPTH = 2**

粒子按深度顺序绘制。

---

enum Parameter:

• **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枚举的个数。

---

enum Flags:

• **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枚举的大小。

---

enum 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进行调节。

• **EMISSION_SHAPE_MAX = 5**

表示EmissionShape枚举的个数。

---

常量

成员说明

• int amount

Default	8
setter	set_amount(value)
getter	get_amount

• float angle

Default	0.0
setter	set_param(value)
getter	get_param

• Curve angle_curve

setter	set_param_curve(value)
getter	get_param_curve

• 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

• Curve angular_velocity_curve

setter	set_param_curve(value)
getter	get_param_curve

• 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

• Curve anim_offset_curve

setter	set_param_curve(value)
getter	get_param_curve

• 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

• Curve anim_speed_curve

setter	set_param_curve(value)
getter	get_param_curve

• 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

• Gradient color_ramp

setter	set_color_ramp(value)
getter	get_color_ramp

• float damping

Default	0.0
setter	set_param(value)
getter	get_param

• Curve damping_curve

setter	set_param_curve(value)
getter	get_param_curve

• 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

• int draw_order

Default	0
setter	set_draw_order(value)
getter	get_draw_order

• Vector3 emission_box_extents

setter	set_emission_box_extents(value)
getter	get_emission_box_extents

• PoolColorArray emission_colors

Default	PoolColorArray( )
setter	set_emission_colors(value)
getter	get_emission_colors

• PoolVector3Array emission_normals

setter	set_emission_normals(value)
getter	get_emission_normals

• PoolVector3Array emission_points

Default	PoolVector3Array( )
setter	set_emission_points(value)
getter	get_emission_points

• 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 emitting

Default	true
setter	set_emitting(value)
getter	is_emitting

• float explosiveness

Default	0.0
setter	set_explosiveness_ratio(value)
getter	get_explosiveness_ratio

• int fixed_fps

Default	0
setter	set_fixed_fps(value)
getter	get_fixed_fps

• bool flag_align_y

Default	false
setter	set_particle_flag(value)
getter	get_particle_flag

• bool flag_disable_z

Default	false
setter	set_particle_flag(value)
getter	get_particle_flag

• bool flag_rotate_y

Default	false
setter	set_particle_flag(value)
getter	get_particle_flag

• float flatness

Default	0.0
setter	set_flatness(value)
getter	get_flatness

• bool fract_delta

Default	true
setter	set_fractional_delta(value)
getter	get_fractional_delta

• 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

• Curve hue_variation_curve

setter	set_param_curve(value)
getter	get_param_curve

• 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

Default	1.0
setter	set_lifetime(value)
getter	get_lifetime

• 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

• Curve linear_accel_curve

setter	set_param_curve(value)
getter	get_param_curve

• float linear_accel_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

• bool local_coords

Default	true
setter	set_use_local_coordinates(value)
getter	get_use_local_coordinates

• Mesh mesh

setter	set_mesh(value)
getter	get_mesh

• bool one_shot

Default	false
setter	set_one_shot(value)
getter	get_one_shot

• float orbit_velocity

setter	set_param(value)
getter	get_param

• Curve orbit_velocity_curve

setter	set_param_curve(value)
getter	get_param_curve

• float orbit_velocity_random

setter	set_param_randomness(value)
getter	get_param_randomness

• float preprocess

Default	0.0
setter	set_pre_process_time(value)
getter	get_pre_process_time

• float radial_accel

Default	0.0
setter	set_param(value)
getter	get_param

• Curve radial_accel_curve

setter	set_param_curve(value)
getter	get_param_curve

• float radial_accel_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

• float randomness

Default	0.0
setter	set_randomness_ratio(value)
getter	get_randomness_ratio

• float scale_amount

Default	1.0
setter	set_param(value)
getter	get_param

• Curve scale_amount_curve

setter	set_param_curve(value)
getter	get_param_curve

• float scale_amount_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

• float speed_scale

Default	1.0
setter	set_speed_scale(value)
getter	get_speed_scale

• 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

• Curve tangential_accel_curve

setter	set_param_curve(value)
getter	get_param_curve

• float tangential_accel_random

Default	0.0
setter	set_param_randomness(value)
getter	get_param_randomness

方法说明

• convert_from_particles convert_from_particles(particles: Node)

设置此节点的属性，以使给定的Particles节点与分配的ParticlesMaterial匹配。

---

• get_param get_param(param: int) const

返回由Parameter指定的参数的基值。

---

• get_param_curve get_param_curve(param: int) const

返回由Parameter指定的参数的Curve。

---

• get_param_randomness get_param_randomness(param: int) const

返回由Parameter指定的参数的随机性因子。

---

• get_particle_flag get_particle_flag(flag: int) const

返回给定标志的启用状态（有关选项，请参见Flags）。

---

• restart restart()

重新启动粒子发射器。

---

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

设置Parameter指定的参数的基值。

---

• set_param_curve set_param_curve(param: int, curve: Curve)

设置Parameter指定的参数的Curve。

---

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

设置Parameter指定的参数的随机性因子。

---

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

启用或禁用给定标志（有关选项，请参见Flags）。

---