Struct Particles
3D particle emitter.
struct Particles
;
3D particle node used to create a variety of particle systems and effects. Particles
features an emitter that generates some number of particles at a given rate.
Use the process_material
property to add a ParticlesMaterial
to configure particle appearance and behavior. Alternatively, you can add a ShaderMaterial
which will be applied to all particles.
Properties
Name | Type | Description |
---|---|---|
amount [get, set]
|
long | Number of particles to emit. |
drawOrder [get, set]
|
Particles | Particle draw order. Uses draworder values.
|
drawPass1 [get, set]
|
Mesh | Mesh that is drawn for the first draw pass.
|
drawPass2 [get, set]
|
Mesh | Mesh that is drawn for the second draw pass.
|
drawPass3 [get, set]
|
Mesh | Mesh that is drawn for the third draw pass.
|
drawPass4 [get, set]
|
Mesh | Mesh that is drawn for the fourth draw pass.
|
drawPasses [get, set]
|
long | The number of draw passes when rendering particles. |
emitting [get, set]
|
bool | If true , particles are being emitted.
|
explosiveness [get, set]
|
double | Time ratio between each emission. If 0 , particles are emitted continuously. If 1 , all particles are emitted simultaneously.
|
fixedFps [get, set]
|
long | 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. |
fractDelta [get, set]
|
bool | If true , results in fractional delta calculation which has a smoother particles display effect.
|
lifetime [get, set]
|
double | Amount of time each particle will exist. |
localCoords [get, set]
|
bool | If true , particles use the parent node's coordinate space. If false , they use global coordinates.
|
oneShot [get, set]
|
bool | If true , only amount particles will be emitted.
|
preprocess [get, set]
|
double | Amount of time to preprocess the particles before animation starts. Lets you start the animation some time after particles have started emitting. |
randomness [get, set]
|
double | Emission randomness ratio. |
speedScale [get, set]
|
double | Speed scaling ratio. A value of 0 can be used to pause the particles.
|
visibilityAabb [get, set]
|
AABB | The AABB that determines the area of the world part of which needs to be visible on screen for the particle system to be active.
|
Methods
Name | Description |
---|---|
captureAabb
|
Returns the axis-aligned bounding box that contains all the particles that are active in the current frame. |
getAmount
|
|
getDrawOrder
|
|
getDrawPasses
|
|
getDrawPassMesh
|
Returns the Mesh that is drawn at index pass .
|
getExplosivenessRatio
|
|
getFixedFps
|
|
getFractionalDelta
|
|
getLifetime
|
|
getOneShot
|
|
getPreProcessTime
|
|
getProcessMaterial
|
|
getRandomnessRatio
|
|
getSpeedScale
|
|
getUseLocalCoordinates
|
|
getVisibilityAabb
|
|
isEmitting
|
|
restart
|
Restarts the particle emission, clearing existing particles. |
setAmount
|
|
setDrawOrder
|
|
setDrawPasses
|
|
setDrawPassMesh
|
Sets the Mesh that is drawn at index pass .
|
setEmitting
|
|
setExplosivenessRatio
|
|
setFixedFps
|
|
setFractionalDelta
|
|
setLifetime
|
|
setOneShot
|
|
setPreProcessTime
|
|
setProcessMaterial
|
|
setRandomnessRatio
|
|
setSpeedScale
|
|
setUseLocalCoordinates
|
|
setVisibilityAabb
|
Enums
Name | Description |
---|---|
Constants
|
|
DrawOrder
|