Interface IParticleSystem
Hierarchy
- IParticleSystem
Implemented by
Index
Properties
- animations
- begin
Animation From - begin
Animation Loop - begin
Animation OnStart - begin
Animation To - billboard
Mode - blend
Mode - color1
- color2
- color
Dead - default
Projection Matrix - dispose
OnStop - emit
Rate - emitter
- end
Sprite CellID - gravity
- id
- is
Animation Sheet Enabled - is
Billboard Based - is
Local - layer
Mask - limit
Velocity Damping - manual
Emit Count - max
Angular Speed - max
Emit Power - max
Initial Rotation - max
Life Time - max
ScaleX - max
ScaleY - max
Size - min
Angular Speed - min
Emit Power - min
Initial Rotation - min
Life Time - min
ScaleX - min
ScaleY - min
Size - name
- noise
Strength - noise
Texture - on
Before Draw Particles Observable - on
Dispose Observable - on
Stopped Observable - particle
Emitter Type - particle
Texture - pre
Warm Cycles - pre
Warm Step Offset - rendering
Group Id - snippet
Id - sprite
Cell Change Speed - sprite
Cell Height - sprite
Cell Loop - sprite
Cell Width - sprite
Random Start Cell - start
Delay - start
Sprite CellID - target
Stop Duration - translation
Pivot - update
Speed - use
Ramp Gradients - vertex
Shader Name
Methods
- add
Alpha Remap Gradient - add
Angular Speed Gradient - add
Color Gradient - add
Color Remap Gradient - add
Drag Gradient - add
Emit Rate Gradient - add
Life Time Gradient - add
Limit Velocity Gradient - add
Ramp Gradient - add
Size Gradient - add
Start Size Gradient - add
Velocity Gradient - animate
- clone
- create
Box Emitter - create
Cone Emitter - create
Cylinder Emitter - create
Directed Cylinder Emitter - create
Directed Sphere Emitter - create
Hemispheric Emitter - create
Point Emitter - create
Sphere Emitter - dispose
- fill
Defines - fill
Uniforms Attributes And Sampler Names - force
Refresh Gradients - get
Active Count - get
Alpha Remap Gradients - get
Angular Speed Gradients - get
Capacity - get
Class Name - get
Color Gradients - get
Color Remap Gradients - get
Custom Effect - get
Drag Gradients - get
Emit Rate Gradients - get
Life Time Gradients - get
Limit Velocity Gradients - get
Ramp Gradients - get
Scene - get
Size Gradients - get
Start Size Gradients - get
Velocity Gradients - is
Ready - is
Started - is
Stopping - rebuild
- remove
Angular Speed Gradient - remove
Color Gradient - remove
Drag Gradient - remove
Emit Rate Gradient - remove
Life Time Gradient - remove
Limit Velocity Gradient - remove
Size Gradient - remove
Start Size Gradient - remove
Velocity Gradient - render
- reset
- serialize
- set
Custom Effect - start
- stop
Properties
animationsSearch playground for animations
List of animations used by the particle system.
begin
Gets or sets the frame to start the animation from when beginAnimationOnStart is true
begin
Gets or sets a boolean indicating if animations must loop when beginAnimationOnStart is true
begin
Gets or sets a boolean indicating that hosted animations (in the system.animations array) must be started when system.start() is called
begin
Gets or sets the frame to end the animation on when beginAnimationOnStart is true
billboard
Gets or sets the billboard mode to use when isBillboardBased = true. Value can be: ParticleSystem.BILLBOARDMODE_ALL, ParticleSystem.BILLBOARDMODE_Y, ParticleSystem.BILLBOARDMODE_STRETCHED
blend
Blend mode use to render the particle, it can be either ParticleSystem.BLENDMODE_ONEONE, ParticleSystem.BLENDMODE_STANDARD or ParticleSystem.BLENDMODE_ADD.
color1Search playground for color1
Random color of each particle after it has been emitted, between color1 and color2 vectors.
color2Search playground for color2
Random color of each particle after it has been emitted, between color1 and color2 vectors.
color
Color the particle will have at the end of its lifetime.
default
Gets or sets a matrix to use to compute projection
dispose
Specifies whether the particle system will be disposed once it reaches the end of the animation.
emit
The maximum number of particles to emit per frame until we reach the activeParticleCount value
emitterSearch playground for emitter
The emitter represents the Mesh or position we are attaching the particle system to.
end
If using a spritesheet (isAnimationSheetEnabled) defines the last sprite cell to display
gravitySearch playground for gravity
You can use gravity if you want to give an orientation to your particles.
idSearch playground for id
The id of the Particle system.
is
Gets or sets a boolean indicating if a spritesheet is used to animate the particles texture
is
Gets or sets a boolean indicating if the particles must be rendered as billboard or aligned with the direction
is
Specifies if the particles are updated in emitter local space or world space
layer
The layer mask we are rendering the particles through.
limit
Gets or sets a value indicating the damping to apply if the limit velocity factor is reached
manual
If you want to launch only a few particles at once, that can be done, as well.
max
Maximum angular speed of emitting particles (Z-axis rotation for each particle).
max
Maximum power of emitting particles.
max
Gets or sets the maximal initial rotation in radians.
max
Maximum life time of emitting particles.
max
Maximum scale of emitting particles on X axis.
max
Maximum scale of emitting particles on Y axis.
max
Maximum Size of emitting particles.
min
Minimum angular speed of emitting particles (Z-axis rotation for each particle).
min
Minimum power of emitting particles.
min
Gets or sets the minimal initial rotation in radians.
min
Minimum life time of emitting particles.
min
Minimum scale of emitting particles on X axis.
min
Minimum scale of emitting particles on Y axis.
min
Minimum Size of emitting particles.
nameSearch playground for name
The name of the Particle system.
noise
Gets or sets the strength to apply to the noise value (default is (10, 10, 10))
noise
Gets or sets a texture used to add random noise to particle positions
on
Observable that will be called just before the particles are drawn
on
An event triggered when the system is disposed
on
An event triggered when the system is stopped
particle
The particle emitter type defines the emitter used by the particle system. It can be for example box, sphere, or cone...
particle
The texture used to render each particle. (this can be a spritesheet)
pre
Gets or sets a value indicating how many cycles (or frames) must be executed before first rendering (this value has to be set before starting the system). Default is 0
pre
Gets or sets a value indicating the time step multiplier to use in pre-warm mode (default is 1)
rendering
The rendering group used by the Particle system to chose when to render.
snippet
Snippet ID if the particle system was created from the snippet server
sprite
If using a spritesheet (isAnimationSheetEnabled) defines the speed of the sprite loop (default is 1 meaning the animation will play once during the entire particle lifetime)
sprite
If using a spritesheet (isAnimationSheetEnabled), defines the sprite cell height to use
sprite
If using a spritesheet (isAnimationSheetEnabled), defines whether the sprite animation is looping
sprite
If using a spritesheet (isAnimationSheetEnabled), defines the sprite cell width to use
sprite
This allows the system to random pick the start cell ID between startSpriteCellID and endSpriteCellID
start
Defines the delay in milliseconds before starting the system (0 by default)
start
If using a spritesheet (isAnimationSheetEnabled) defines the first sprite cell to display
target
The amount of time the particle system is running (depends of the overall update speed).
translation
Gets or sets a Vector2 used to move the pivot (by default (0,0))
update
The overall motion speed (0.01 is default update speed, faster updates = faster animation)
use
Gets or sets a boolean indicating that ramp gradients must be used
vertex
Gets the name of the particle vertex shader
Methods
add
-
Adds a new alpha remap gradient
Parameters
-
gradient: number
defines the gradient to use (between 0 and 1)
-
min: number
defines the alpha remap minimal range
-
max: number
defines the alpha remap maximal range
Returns IParticleSystem
the current particle system
-
add
-
Adds a new angular speed gradient
Parameters
-
gradient: number
defines the gradient to use (between 0 and 1)
-
factor: number
defines the angular speed to affect to the specified gradient
-
Optional factor2: number
defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from
Returns IParticleSystem
the current particle system
-
add
-
Adds a new color gradient
Parameters
-
gradient: number
defines the gradient to use (between 0 and 1)
-
color1: Color4
defines the color to affect to the specified gradient
-
Optional color2: Color4
defines an additional color used to define a range ([color, color2]) with main color to pick the final color from
Returns IParticleSystem
the current particle system
-
add
-
Adds a new color remap gradient
Parameters
-
gradient: number
defines the gradient to use (between 0 and 1)
-
min: number
defines the color remap minimal range
-
max: number
defines the color remap maximal range
Returns IParticleSystem
the current particle system
-
add
-
Adds a new drag gradient
Parameters
-
gradient: number
defines the gradient to use (between 0 and 1)
-
factor: number
defines the drag to affect to the specified gradient
-
Optional factor2: number
defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from
Returns IParticleSystem
the current particle system
-
add
-
Adds a new emit rate gradient (please note that this will only work if you set the targetStopDuration property)
Parameters
-
gradient: number
defines the gradient to use (between 0 and 1)
-
factor: number
defines the emit rate to affect to the specified gradient
-
Optional factor2: number
defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from
Returns IParticleSystem
the current particle system
-
add
-
Adds a new life time gradient
Parameters
-
gradient: number
defines the gradient to use (between 0 and 1)
-
factor: number
defines the life time factor to affect to the specified gradient
-
Optional factor2: number
defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from
Returns IParticleSystem
the current particle system
-
add
-
Adds a new limit velocity gradient
Parameters
-
gradient: number
defines the gradient to use (between 0 and 1)
-
factor: number
defines the limit velocity to affect to the specified gradient
-
Optional factor2: number
defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from
Returns IParticleSystem
the current particle system
-
add
-
Adds a new ramp gradient used to remap particle colors
Parameters
-
gradient: number
defines the gradient to use (between 0 and 1)
-
color: Color3
defines the color to affect to the specified gradient
Returns IParticleSystem
the current particle system
-
add
-
Adds a new size gradient
Parameters
-
gradient: number
defines the gradient to use (between 0 and 1)
-
factor: number
defines the size factor to affect to the specified gradient
-
Optional factor2: number
defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from
Returns IParticleSystem
the current particle system
-
add
-
Adds a new start size gradient (please note that this will only work if you set the targetStopDuration property)
Parameters
-
gradient: number
defines the gradient to use (between 0 and 1)
-
factor: number
defines the start size to affect to the specified gradient
-
Optional factor2: number
defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from
Returns IParticleSystem
the current particle system
-
add
-
Adds a new velocity gradient
Parameters
-
gradient: number
defines the gradient to use (between 0 and 1)
-
factor: number
defines the velocity to affect to the specified gradient
-
Optional factor2: number
defines an additional factor used to define a range ([factor, factor2]) with main value to pick the final value from
Returns IParticleSystem
the current particle system
-
animateSearch playground for animate
-
Animates the particle system for this frame.
Returns void
cloneSearch playground for clone
-
Clones the particle system.
Parameters
-
name: string
The name of the cloned object
-
newEmitter: any
The new emitter to use
Returns Nullable<IParticleSystem>
the cloned particle system
-
create
-
Creates a Box Emitter for the particle system. (emits between direction1 and direction2 from withing the box defined by minEmitBox and maxEmitBox)
Parameters
-
direction1: Vector3
Particles are emitted between the direction1 and direction2 from within the box
-
direction2: Vector3
Particles are emitted between the direction1 and direction2 from within the box
-
minEmitBox: Vector3
Particles are emitted from the box between minEmitBox and maxEmitBox
-
maxEmitBox: Vector3
Particles are emitted from the box between minEmitBox and maxEmitBox
Returns BoxParticleEmitter
the emitter
-
create
-
Creates a Cone Emitter for the particle system (emits from the cone to the particle position)
Parameters
-
radius: number
The radius of the cone to emit from
-
angle: number
The base angle of the cone
Returns ConeParticleEmitter
the emitter
-
create
-
Creates a Cylinder Emitter for the particle system (emits from the cylinder to the particle position)
Parameters
-
radius: number
The radius of the emission cylinder
-
height: number
The height of the emission cylinder
-
radiusRange: number
The range of emission [0-1] 0 Surface only, 1 Entire Radius
-
directionRandomizer: number
How much to randomize the particle direction [0-1]
Returns CylinderParticleEmitter
the emitter
-
create
-
Creates a Directed Cylinder Emitter for the particle system (emits between direction1 and direction2)
Parameters
-
radius: number
The radius of the cylinder to emit from
-
height: number
The height of the emission cylinder
-
radiusRange: number
the range of the emission cylinder [0-1] 0 Surface only, 1 Entire Radius (1 by default)
-
direction1: Vector3
Particles are emitted between the direction1 and direction2 from within the cylinder
-
direction2: Vector3
Particles are emitted between the direction1 and direction2 from within the cylinder
Returns SphereDirectedParticleEmitter
the emitter
-
create
-
Creates a Directed Sphere Emitter for the particle system (emits between direction1 and direction2)
Parameters
-
radius: number
The radius of the sphere to emit from
-
direction1: Vector3
Particles are emitted between the direction1 and direction2 from within the sphere
-
direction2: Vector3
Particles are emitted between the direction1 and direction2 from within the sphere
Returns SphereDirectedParticleEmitter
the emitter
-
create
-
Creates a Hemisphere Emitter for the particle system (emits along the hemisphere radius)
Parameters
-
radius: number
The radius of the hemisphere to emit from
-
radiusRange: number
The range of the hemisphere to emit from [0-1] 0 Surface Only, 1 Entire Radius
Returns HemisphericParticleEmitter
the emitter
-
create
-
Creates a Point Emitter for the particle system (emits directly from the emitter position)
Parameters
-
direction1: Vector3
Particles are emitted between the direction1 and direction2 from within the box
-
direction2: Vector3
Particles are emitted between the direction1 and direction2 from within the box
Returns PointParticleEmitter
the emitter
-
create
-
Creates a Sphere Emitter for the particle system (emits along the sphere radius)
Parameters
-
radius: number
The radius of the sphere to emit from
-
radiusRange: number
The range of the sphere to emit from [0-1] 0 Surface Only, 1 Entire Radius
Returns SphereParticleEmitter
the emitter
-
disposeSearch playground for dispose
-
Dispose the particle system and frees its associated resources.
Parameters
-
Optional disposeTexture: boolean
defines if the particle texture must be disposed as well (true by default)
Returns void
-
fill
-
Fill the defines array according to the current settings of the particle system
Parameters
-
defines: Array<string>
Array to be updated
-
blendMode: number
blend mode to take into account when updating the array
Returns void
-
fill
-
Fill the uniforms, attributes and samplers arrays according to the current settings of the particle system
Parameters
-
uniforms: Array<string>
Uniforms array to fill
-
attributes: Array<string>
Attributes array to fill
-
samplers: Array<string>
Samplers array to fill
Returns void
-
force
-
Force the system to rebuild all gradients that need to be resync
Returns void
get
-
Gets the number of particles active at the same time.
Returns number
The number of active particles.
get
-
Gets the current list of alpha remap gradients. You must use addAlphaRemapGradient and removeAlphaRemapGradient to update this list
Returns Nullable<Array<FactorGradient>>
the list of alpha remap gradients
get
-
Gets the current list of angular speed gradients. You must use addAngularSpeedGradient and removeAngularSpeedGradient to update this list
Returns Nullable<Array<FactorGradient>>
the list of angular speed gradients
get
-
Gets the maximum number of particles active at the same time.
Returns number
The max number of active particles.
get
-
Returns the string "ParticleSystem"
Returns string
a string containing the class name
get
-
Gets the current list of color gradients. You must use addColorGradient and removeColorGradient to update this list
Returns Nullable<Array<ColorGradient>>
the list of color gradients
-
Gets the current list of color gradients. You must use addColorGradient and removeColorGradient to update this list
Returns Nullable<Array<ColorGradient>>
the list of color gradients
get
-
Gets the current list of color remap gradients. You must use addColorRemapGradient and removeColorRemapGradient to update this list
Returns Nullable<Array<FactorGradient>>
the list of color remap gradients
get
get
-
Gets the current list of drag gradients. You must use addDragGradient and removeDragGradient to update this list
Returns Nullable<Array<FactorGradient>>
the list of drag gradients
get
-
Gets the current list of emit rate gradients. You must use addEmitRateGradient and removeEmitRateGradient to update this list
Returns Nullable<Array<FactorGradient>>
the list of emit rate gradients
get
-
Gets the current list of life time gradients. You must use addLifeTimeGradient and removeLifeTimeGradient to update this list
Returns Nullable<Array<FactorGradient>>
the list of life time gradients
get
-
Gets the current list of limit velocity gradients. You must use addLimitVelocityGradient and removeLimitVelocityGradient to update this list
Returns Nullable<Array<FactorGradient>>
the list of limit velocity gradients
get
-
Gets the current list of ramp gradients. You must use addRampGradient and removeRampGradient to update this list
Returns Nullable<Array<Color3Gradient>>
the list of ramp gradients
get
get
-
Gets the current list of size gradients. You must use addSizeGradient and removeSizeGradient to update this list
Returns Nullable<Array<FactorGradient>>
the list of size gradients
get
-
Gets the current list of start size gradients. You must use addStartSizeGradient and removeStartSizeGradient to update this list
Returns Nullable<Array<FactorGradient>>
the list of start size gradients
get
-
Gets the current list of velocity gradients. You must use addVelocityGradient and removeVelocityGradient to update this list
Returns Nullable<Array<FactorGradient>>
the list of velocity gradients
is
-
Is this system ready to be used/rendered
Returns boolean
true if the system is ready
is
-
Gets if the system has been started. (Note: this will still be true after stop is called)
Returns boolean
True if it has been started, otherwise false.
is
-
Gets a boolean indicating that the system is stopping
Returns boolean
true if the system is currently stopping
rebuildSearch playground for rebuild
-
Rebuild the particle system
Returns void
remove
-
Remove a specific angular speed gradient
Parameters
-
gradient: number
defines the gradient to remove
Returns IParticleSystem
the current particle system
-
remove
-
Remove a specific color gradient
Parameters
-
gradient: number
defines the gradient to remove
Returns IParticleSystem
the current particle system
-
remove
-
Remove a specific drag gradient
Parameters
-
gradient: number
defines the gradient to remove
Returns IParticleSystem
the current particle system
-
remove
-
Remove a specific emit rate gradient
Parameters
-
gradient: number
defines the gradient to remove
Returns IParticleSystem
the current particle system
-
remove
-
Remove a specific life time gradient
Parameters
-
gradient: number
defines the gradient to remove
Returns IParticleSystem
the current particle system
-
remove
-
Remove a specific limit velocity gradient
Parameters
-
gradient: number
defines the gradient to remove
Returns IParticleSystem
the current particle system
-
remove
-
Remove a specific size gradient
Parameters
-
gradient: number
defines the gradient to remove
Returns IParticleSystem
the current particle system
-
remove
-
Remove a specific start size gradient
Parameters
-
gradient: number
defines the gradient to remove
Returns IParticleSystem
the current particle system
-
remove
-
Remove a specific velocity gradient
Parameters
-
gradient: number
defines the gradient to remove
Returns IParticleSystem
the current particle system
-
renderSearch playground for render
-
Renders the particle system in its current state.
Returns number
the current number of particles
resetSearch playground for reset
-
Remove all active particles
Returns void
serializeSearch playground for serialize
-
Serializes the particle system to a JSON object
Parameters
-
serializeTexture: boolean
defines if the texture must be serialized as well
Returns any
the JSON object
-
set
startSearch playground for start
-
Starts the particle system and begins to emit
Parameters
-
Optional delay: number
defines the delay in milliseconds before starting the system (0 by default)
Returns void
-
stopSearch playground for stop
-
Stops the particle system.
Returns void
Interface representing a particle system in Babylon.js. This groups the common functionalities that needs to be implemented in order to create a particle system. A particle system represents a way to manage particles from their emission to their animation and rendering.