Inherits: GeometryInstance < VisualInstance < Spatial < Node < Object
CPU-based 3D particle emitter.
CPU-based 3D particle node used to create a variety of particle systems and effects.
See also Particles, 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() |
Unused for 3D particles.
Setter | set_color_ramp(value) |
Getter | get_color_ramp() |
Unused for 3D particles.
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 | Vector3( 1, 0, 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_box_extents(value) |
Getter | get_emission_box_extents() |
The rectangle's extents if emission_shape is set to EMISSION_SHAPE_BOX.
Default | PoolColorArray( ) |
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.
Default | PoolVector3Array( ) |
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.
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 EmissionShape 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 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 | false |
Setter | set_particle_flag(value) |
Getter | get_particle_flag() |
If true
, particles will not move on the z axis.
Default | false |
Setter | set_particle_flag(value) |
Getter | get_particle_flag() |
If true
, particles rotate around Y axis by angle.
Default | 0.0 |
Setter | set_flatness(value) |
Getter | get_flatness() |
Amount of spread in Y/Z plane. A value of 1
restricts particles to X/Z plane.
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 | Vector3( 0, -9.8, 0 ) |
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_mesh(value) |
Getter | get_mesh() |
The Mesh used for each particle. If null
, particles will be spheres.
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.
Setter | set_param(value) |
Getter | get_param() |
Orbital velocity applied to each particle. Makes the particles circle around origin in the local XY plane. Specified in number of full rotations around origin per second.
This property is only available when flag_disable_z is true
.
Setter | set_param_curve(value) |
Getter | get_param_curve() |
Each particle's orbital velocity will vary along this Curve.
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. Applied to X/Z plane and Y/Z planes.
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.
Sets this node's properties to match a given Particles 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_cpuparticles.html