Inherits: Node2D < CanvasItem < Node < Object
CPU-based 2D particle emitter.
CPU-based 2D particle node used to create a variety of particle systems and effects.
See also Particles2D, which provides the same functionality with hardware acceleration, but may not run on older devices.
void | 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 |
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 ) |
enum DrawOrder:
enum Parameter:
enum Flags:
enum EmissionShape:
Default | 8 |
Setter | set_amount(value) |
Getter | get_amount() |
Number of particles emitted in one emission cycle.
Default | 0.0 |
Setter | set_param(value) |
Getter | get_param() |
Initial rotation applied to each particle, in degrees.
Setter | set_param_curve(value) |
Getter | get_param_curve() |
Each particle's rotation will be animated along this Curve.
Default | 0.0 |
Setter | set_param_randomness(value) |
Getter | get_param_randomness() |
Rotation randomness ratio.
Default | 0.0 |
Setter | set_param(value) |
Getter | get_param() |
Initial angular velocity applied to each particle. Sets the speed of rotation of the particle.
Setter | set_param_curve(value) |
Getter | get_param_curve() |
Each particle's angular velocity will vary along this Curve.
Default | 0.0 |
Setter | set_param_randomness(value) |
Getter | get_param_randomness() |
Angular velocity randomness ratio.
Default | 0.0 |
Setter | set_param(value) |
Getter | get_param() |
Particle animation offset.
Setter | set_param_curve(value) |
Getter | get_param_curve() |
Each particle's animation offset will vary along this Curve.
Default | 0.0 |
Setter | set_param_randomness(value) |
Getter | get_param_randomness() |
Animation offset randomness ratio.
Default | 0.0 |
Setter | set_param(value) |
Getter | get_param() |
Particle animation speed.
Setter | set_param_curve(value) |
Getter | get_param_curve() |
Each particle's animation speed will vary along this Curve.
Default | 0.0 |
Setter | set_param_randomness(value) |
Getter | get_param_randomness() |
Animation speed randomness ratio.
Default | Color( 1, 1, 1, 1 ) |
Setter | set_color(value) |
Getter | get_color() |
Each particle's initial color. If texture is defined, it will be multiplied by this color.
Setter | set_color_ramp(value) |
Getter | get_color_ramp() |
Each particle's color will vary along this Gradient.
Default | 0.0 |
Setter | set_param(value) |
Getter | get_param() |
The rate at which particles lose velocity.
Setter | set_param_curve(value) |
Getter | get_param_curve() |
Damping will vary along this Curve.
Default | 0.0 |
Setter | set_param_randomness(value) |
Getter | get_param_randomness() |
Damping randomness ratio.
Default | Vector2( 1, 0 ) |
Setter | set_direction(value) |
Getter | get_direction() |
Unit vector specifying the particles' emission direction.
Default | 0 |
Setter | set_draw_order(value) |
Getter | get_draw_order() |
Particle draw order. Uses DrawOrder values.
Setter | set_emission_colors(value) |
Getter | get_emission_colors() |
Sets the Colors to modulate particles by when using EMISSION_SHAPE_POINTS or EMISSION_SHAPE_DIRECTED_POINTS.
Setter | set_emission_normals(value) |
Getter | get_emission_normals() |
Sets the direction the particles will be emitted in when using EMISSION_SHAPE_DIRECTED_POINTS.
Setter | set_emission_points(value) |
Getter | get_emission_points() |
Sets the initial positions to spawn particles when using EMISSION_SHAPE_POINTS or EMISSION_SHAPE_DIRECTED_POINTS.
Setter | set_emission_rect_extents(value) |
Getter | get_emission_rect_extents() |
The rectangle's extents if emission_shape is set to EMISSION_SHAPE_RECTANGLE.
Default | 0 |
Setter | set_emission_shape(value) |
Getter | get_emission_shape() |
Particles will be emitted inside this region. See EmissionShape for possible values.
Setter | set_emission_sphere_radius(value) |
Getter | get_emission_sphere_radius() |
The sphere's radius if emission_shape is set to EMISSION_SHAPE_SPHERE.
Default | true |
Setter | set_emitting(value) |
Getter | is_emitting() |
If true
, particles are being emitted.
Default | 0.0 |
Setter | set_explosiveness_ratio(value) |
Getter | get_explosiveness_ratio() |
How rapidly particles in an emission cycle are emitted. If greater than 0
, there will be a gap in emissions before the next cycle begins.
Default | 0 |
Setter | set_fixed_fps(value) |
Getter | get_fixed_fps() |
The particle system's frame rate is fixed to a value. For instance, changing the value to 2 will make the particles render at 2 frames per second. Note this does not slow down the simulation of the particle system itself.
Default | false |
Setter | set_particle_flag(value) |
Getter | get_particle_flag() |
Align Y axis of particle with the direction of its velocity.
Default | true |
Setter | set_fractional_delta(value) |
Getter | get_fractional_delta() |
If true
, results in fractional delta calculation which has a smoother particles display effect.
Default | Vector2( 0, 98 ) |
Setter | set_gravity(value) |
Getter | get_gravity() |
Gravity applied to every particle.
Default | 0.0 |
Setter | set_param(value) |
Getter | get_param() |
Initial hue variation applied to each particle.
Setter | set_param_curve(value) |
Getter | get_param_curve() |
Each particle's hue will vary along this Curve.
Default | 0.0 |
Setter | set_param_randomness(value) |
Getter | get_param_randomness() |
Hue variation randomness ratio.
Default | 0.0 |
Setter | set_param(value) |
Getter | get_param() |
Initial velocity magnitude for each particle. Direction comes from spread and the node's orientation.
Default | 0.0 |
Setter | set_param_randomness(value) |
Getter | get_param_randomness() |
Initial velocity randomness ratio.
Default | 1.0 |
Setter | set_lifetime(value) |
Getter | get_lifetime() |
Amount of time each particle will exist.
Default | 0.0 |
Setter | set_lifetime_randomness(value) |
Getter | get_lifetime_randomness() |
Particle lifetime randomness ratio.
Default | 0.0 |
Setter | set_param(value) |
Getter | get_param() |
Linear acceleration applied to each particle in the direction of motion.
Setter | set_param_curve(value) |
Getter | get_param_curve() |
Each particle's linear acceleration will vary along this Curve.
Default | 0.0 |
Setter | set_param_randomness(value) |
Getter | get_param_randomness() |
Linear acceleration randomness ratio.
Default | true |
Setter | set_use_local_coordinates(value) |
Getter | get_use_local_coordinates() |
If true
, particles use the parent node's coordinate space. If false
, they use global coordinates.
Setter | set_normalmap(value) |
Getter | get_normalmap() |
Normal map to be used for the texture property.
Note: Godot expects the normal map to use X+, Y-, and Z+ coordinates. See this page for a comparison of normal map coordinates expected by popular engines.
Default | false |
Setter | set_one_shot(value) |
Getter | get_one_shot() |
If true
, only one emission cycle occurs. If set true
during a cycle, emission will stop at the cycle's end.
Default | 0.0 |
Setter | set_param(value) |
Getter | get_param() |
Orbital velocity applied to each particle. Makes the particles circle around origin. Specified in number of full rotations around origin per second.
Setter | set_param_curve(value) |
Getter | get_param_curve() |
Each particle's orbital velocity will vary along this Curve.
Default | 0.0 |
Setter | set_param_randomness(value) |
Getter | get_param_randomness() |
Orbital velocity randomness ratio.
Default | 0.0 |
Setter | set_pre_process_time(value) |
Getter | get_pre_process_time() |
Particle system starts as if it had already run for this many seconds.
Default | 0.0 |
Setter | set_param(value) |
Getter | get_param() |
Radial acceleration applied to each particle. Makes particle accelerate away from origin.
Setter | set_param_curve(value) |
Getter | get_param_curve() |
Each particle's radial acceleration will vary along this Curve.
Default | 0.0 |
Setter | set_param_randomness(value) |
Getter | get_param_randomness() |
Radial acceleration randomness ratio.
Default | 0.0 |
Setter | set_randomness_ratio(value) |
Getter | get_randomness_ratio() |
Emission lifetime randomness ratio.
Default | 1.0 |
Setter | set_param(value) |
Getter | get_param() |
Initial scale applied to each particle.
Setter | set_param_curve(value) |
Getter | get_param_curve() |
Each particle's scale will vary along this Curve.
Default | 0.0 |
Setter | set_param_randomness(value) |
Getter | get_param_randomness() |
Scale randomness ratio.
Default | 1.0 |
Setter | set_speed_scale(value) |
Getter | get_speed_scale() |
Particle system's running speed scaling ratio. A value of 0
can be used to pause the particles.
Default | 45.0 |
Setter | set_spread(value) |
Getter | get_spread() |
Each particle's initial direction range from +spread
to -spread
degrees.
Default | 0.0 |
Setter | set_param(value) |
Getter | get_param() |
Tangential acceleration applied to each particle. Tangential acceleration is perpendicular to the particle's velocity giving the particles a swirling motion.
Setter | set_param_curve(value) |
Getter | get_param_curve() |
Each particle's tangential acceleration will vary along this Curve.
Default | 0.0 |
Setter | set_param_randomness(value) |
Getter | get_param_randomness() |
Tangential acceleration randomness ratio.
Setter | set_texture(value) |
Getter | get_texture() |
Particle texture. If null
, particles will be squares.
Sets this node's properties to match a given Particles2D node with an assigned ParticlesMaterial.
Returns the base value of the parameter specified by Parameter.
Returns the Curve of the parameter specified by Parameter.
Returns the randomness factor of the parameter specified by Parameter.
Returns the enabled state of the given flag (see Flags for options).
Restarts the particle emitter.
Sets the base value of the parameter specified by Parameter.
Sets the Curve of the parameter specified by Parameter.
Sets the randomness factor of the parameter specified by Parameter.
Enables or disables the given flag (see Flags for options).
© 2014–2020 Juan Linietsky, Ariel Manzur, Godot Engine contributors
Licensed under the MIT License.
https://docs.godotengine.org/en/3.2/classes/class_cpuparticles2d.html