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。