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

NameTypeDescription
amount[get, set] longNumber of particles to emit.
drawOrder[get, set] Particles.DrawOrderParticle draw order. Uses draworder values.
drawPass1[get, set] MeshMesh that is drawn for the first draw pass.
drawPass2[get, set] MeshMesh that is drawn for the second draw pass.
drawPass3[get, set] MeshMesh that is drawn for the third draw pass.
drawPass4[get, set] MeshMesh that is drawn for the fourth draw pass.
drawPasses[get, set] longThe number of draw passes when rendering particles.
emitting[get, set] boolIf true, particles are being emitted.
explosiveness[get, set] doubleTime ratio between each emission. If 0, particles are emitted continuously. If 1, all particles are emitted simultaneously.
fixedFps[get, set] longThe 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] boolIf true, results in fractional delta calculation which has a smoother particles display effect.
lifetime[get, set] doubleAmount of time each particle will exist.
localCoords[get, set] boolIf true, particles use the parent node's coordinate space. If false, they use global coordinates.
oneShot[get, set] boolIf true, only amount particles will be emitted.
preprocess[get, set] doubleAmount of time to preprocess the particles before animation starts. Lets you start the animation some time after particles have started emitting.
randomness[get, set] doubleEmission randomness ratio.
speedScale[get, set] doubleSpeed scaling ratio. A value of 0 can be used to pause the particles.
visibilityAabb[get, set] AABBThe 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

NameDescription
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

NameDescription
Constants
DrawOrder