babylon.quarks - v1.0.0
    Preparing search index...

    Type Alias RingBufferMode

    RingBufferMode: "disabled" | "pauseUntilReplaced" | "loopUntilReplaced"

    What a full system does with the particles it emits next (Unity's Ring Buffer Mode). It needs ParticleSystemParameters.maxParticles; without a limit it is ignored.

    • 'disabled' (the default): particles die at the end of their life, and a full system drops what it would emit.
    • 'pauseUntilReplaced': a particle at the end of its life stays where and as it is, frozen, until a new particle replaces it, the oldest first. For footprints, decals and bullet holes.
    • 'loopUntilReplaced': a particle at the end of its life goes back to an earlier point of it and plays that part again, over and over, until a new particle replaces it; see ParticleSystem.ringBufferLoopRange.

    Particles are never killed by age, so a system in either mode keeps its particles and does not finish while it has any: a non-looping ring effect never fires finished, and an EffectPool copy of it returns to the pool only when it is released. A replaced particle does not fire particleDied, nor Death sub emitters, which never fire in either mode since no particle dies. Lowering maxParticles drops the oldest particles over the new limit, also without particleDied. Particles are replaced oldest first in the order they were emitted; switching a mode on in a system whose particles have already died in a different order replaces them in row order the first time round. 'oldestInFront' and 'youngestInFront' sorting reads age, so a looping particle sorts by its age in the loop. Applies in every render mode but Trail, whose particles always die at the end of their life.