@newkrok/three-particles 1.0.3 → 2.0.1

package/dist/js/effects/three-particles/three-particles.js

@@ -0,0 +1,643 @@
+import { ObjectUtils } from '@newkrok/three-utils';
+import * as THREE from 'three';
+import { Gyroscope } from 'three/examples/jsm/misc/Gyroscope.js';
+import { FBM } from 'three-noise/build/three-noise.module.js';
+import ParticleSystemFragmentShader from './shaders/particle-system-fragment-shader.glsl.js';
+import ParticleSystemVertexShader from './shaders/particle-system-vertex-shader.glsl.js';
+import { removeBezierCurveFunction } from './three-particles-bezier.js';
+import { applyModifiers } from './three-particles-modifiers.js';
+import { calculateRandomPositionAndVelocityOnBox, calculateRandomPositionAndVelocityOnCircle, calculateRandomPositionAndVelocityOnCone, calculateRandomPositionAndVelocityOnRectangle, calculateRandomPositionAndVelocityOnSphere, calculateValue, getCurveFunctionFromConfig, isLifeTimeCurve, createDefaultParticleTexture, } from './three-particles-utils.js';
+export * from './types.js';
+let _particleSystemId = 0;
+let createdParticleSystems = [];
+export const blendingMap = {
+    'THREE.NoBlending': THREE.NoBlending,
+    'THREE.NormalBlending': THREE.NormalBlending,
+    'THREE.AdditiveBlending': THREE.AdditiveBlending,
+    'THREE.SubtractiveBlending': THREE.SubtractiveBlending,
+    'THREE.MultiplyBlending': THREE.MultiplyBlending,
+};
+export const getDefaultParticleSystemConfig = () => JSON.parse(JSON.stringify(DEFAULT_PARTICLE_SYSTEM_CONFIG));
+const DEFAULT_PARTICLE_SYSTEM_CONFIG = {
+    transform: {
+        position: new THREE.Vector3(),
+        rotation: new THREE.Vector3(),
+        scale: new THREE.Vector3(1, 1, 1),
+    },
+    duration: 5.0,
+    looping: true,
+    startDelay: 0,
+    startLifetime: 5.0,
+    startSpeed: 1.0,
+    startSize: 1.0,
+    startOpacity: 1.0,
+    startRotation: 0.0,
+    startColor: {
+        min: { r: 1.0, g: 1.0, b: 1.0 },
+        max: { r: 1.0, g: 1.0, b: 1.0 },
+    },
+    gravity: 0.0,
+    simulationSpace: "LOCAL" /* SimulationSpace.LOCAL */,
+    maxParticles: 100.0,
+    emission: {
+        rateOverTime: 10.0,
+        rateOverDistance: 0.0,
+    },
+    shape: {
+        shape: "SPHERE" /* Shape.SPHERE */,
+        sphere: {
+            radius: 1.0,
+            radiusThickness: 1.0,
+            arc: 360.0,
+        },
+        cone: {
+            angle: 25.0,
+            radius: 1.0,
+            radiusThickness: 1.0,
+            arc: 360.0,
+        },
+        circle: {
+            radius: 1.0,
+            radiusThickness: 1.0,
+            arc: 360.0,
+        },
+        rectangle: {
+            rotation: { x: 0.0, y: 0.0 }, // TODO: add z rotation
+            scale: { x: 1.0, y: 1.0 },
+        },
+        box: {
+            scale: { x: 1.0, y: 1.0, z: 1.0 },
+            emitFrom: "VOLUME" /* EmitFrom.VOLUME */,
+        },
+    },
+    map: undefined,
+    renderer: {
+        blending: THREE.NormalBlending,
+        discardBackgroundColor: false,
+        backgroundColorTolerance: 1.0,
+        backgroundColor: { r: 1.0, g: 1.0, b: 1.0 },
+        transparent: true,
+        depthTest: true,
+        depthWrite: false,
+    },
+    velocityOverLifetime: {
+        isActive: false,
+        linear: {
+            x: 0,
+            y: 0,
+            z: 0,
+        },
+        orbital: {
+            x: 0,
+            y: 0,
+            z: 0,
+        },
+    },
+    sizeOverLifetime: {
+        isActive: false,
+        lifetimeCurve: {
+            type: "BEZIER" /* LifeTimeCurve.BEZIER */,
+            scale: 1,
+            bezierPoints: [
+                { x: 0, y: 0, percentage: 0 },
+                { x: 1, y: 1, percentage: 1 },
+            ],
+        },
+    },
+    /* colorOverLifetime: {
+      isActive: false,
+      lifetimeCurve: {
+        type: LifeTimeCurve.EASING,
+        scale: 1,
+        curveFunction: CurveFunctionId.LINEAR,
+      },
+    }, */
+    opacityOverLifetime: {
+        isActive: false,
+        lifetimeCurve: {
+            type: "BEZIER" /* LifeTimeCurve.BEZIER */,
+            scale: 1,
+            bezierPoints: [
+                { x: 0, y: 0, percentage: 0 },
+                { x: 1, y: 1, percentage: 1 },
+            ],
+        },
+    },
+    rotationOverLifetime: {
+        isActive: false,
+        min: 0.0,
+        max: 0.0,
+    },
+    noise: {
+        isActive: false,
+        useRandomOffset: false,
+        strength: 1.0,
+        frequency: 0.5,
+        octaves: 1,
+        positionAmount: 1.0,
+        rotationAmount: 0.0,
+        sizeAmount: 0.0,
+    },
+    textureSheetAnimation: {
+        tiles: new THREE.Vector2(1.0, 1.0),
+        timeMode: "LIFETIME" /* TimeMode.LIFETIME */,
+        fps: 30.0,
+        startFrame: 0,
+    },
+};
+const createFloat32Attributes = ({ geometry, propertyName, maxParticles, factory, }) => {
+    geometry.setAttribute(propertyName, new THREE.BufferAttribute(new Float32Array(Array.from({ length: maxParticles }, typeof factory === 'function' ? factory : () => factory)), 1));
+};
+const calculatePositionAndVelocity = (generalData, { shape, sphere, cone, circle, rectangle, box }, startSpeed, position, velocity) => {
+    const calculatedStartSpeed = calculateValue(generalData.particleSystemId, startSpeed, generalData.normalizedLifetimePercentage);
+    switch (shape) {
+        case "SPHERE" /* Shape.SPHERE */:
+            calculateRandomPositionAndVelocityOnSphere(position, generalData.wrapperQuaternion, velocity, calculatedStartSpeed, sphere);
+            break;
+        case "CONE" /* Shape.CONE */:
+            calculateRandomPositionAndVelocityOnCone(position, generalData.wrapperQuaternion, velocity, calculatedStartSpeed, cone);
+            break;
+        case "CIRCLE" /* Shape.CIRCLE */:
+            calculateRandomPositionAndVelocityOnCircle(position, generalData.wrapperQuaternion, velocity, calculatedStartSpeed, circle);
+            break;
+        case "RECTANGLE" /* Shape.RECTANGLE */:
+            calculateRandomPositionAndVelocityOnRectangle(position, generalData.wrapperQuaternion, velocity, calculatedStartSpeed, rectangle);
+            break;
+        case "BOX" /* Shape.BOX */:
+            calculateRandomPositionAndVelocityOnBox(position, generalData.wrapperQuaternion, velocity, calculatedStartSpeed, box);
+            break;
+    }
+};
+const destroyParticleSystem = (particleSystem) => {
+    createdParticleSystems = createdParticleSystems.filter(({ particleSystem: savedParticleSystem, wrapper, generalData: { particleSystemId }, }) => {
+        if (savedParticleSystem !== particleSystem &&
+            wrapper !== particleSystem) {
+            return true;
+        }
+        removeBezierCurveFunction(particleSystemId);
+        savedParticleSystem.geometry.dispose();
+        if (Array.isArray(savedParticleSystem.material))
+            savedParticleSystem.material.forEach((material) => material.dispose());
+        else
+            savedParticleSystem.material.dispose();
+        if (savedParticleSystem.parent)
+            savedParticleSystem.parent.remove(savedParticleSystem);
+        return false;
+    });
+};
+export const createParticleSystem = (config = DEFAULT_PARTICLE_SYSTEM_CONFIG, externalNow) => {
+    const now = externalNow || Date.now();
+    const generalData = {
+        particleSystemId: _particleSystemId++,
+        normalizedLifetimePercentage: 0,
+        distanceFromLastEmitByDistance: 0,
+        lastWorldPosition: new THREE.Vector3(-99999),
+        currentWorldPosition: new THREE.Vector3(-99999),
+        worldPositionChange: new THREE.Vector3(),
+        worldQuaternion: new THREE.Quaternion(),
+        wrapperQuaternion: new THREE.Quaternion(),
+        lastWorldQuaternion: new THREE.Quaternion(-99999),
+        worldEuler: new THREE.Euler(),
+        gravityVelocity: new THREE.Vector3(0, 0, 0),
+        startValues: {},
+        linearVelocityData: undefined,
+        orbitalVelocityData: undefined,
+        lifetimeValues: {},
+        creationTimes: [],
+        noise: {
+            isActive: false,
+            strength: 0,
+            positionAmount: 0,
+            rotationAmount: 0,
+            sizeAmount: 0,
+        },
+        isEnabled: true,
+    };
+    const normalizedConfig = ObjectUtils.patchObject(DEFAULT_PARTICLE_SYSTEM_CONFIG, config);
+    let particleMap = normalizedConfig.map || createDefaultParticleTexture();
+    const { transform, duration, looping, startDelay, startLifetime, startSpeed, startSize, startRotation, startColor, startOpacity, gravity, simulationSpace, maxParticles, emission, shape, renderer, noise, velocityOverLifetime, onUpdate, onComplete, textureSheetAnimation, } = normalizedConfig;
+    if (typeof renderer?.blending === 'string')
+        renderer.blending = blendingMap[renderer.blending];
+    const startPositions = Array.from({ length: maxParticles }, () => new THREE.Vector3());
+    const velocities = Array.from({ length: maxParticles }, () => new THREE.Vector3());
+    generalData.creationTimes = Array.from({ length: maxParticles }, () => 0);
+    if (velocityOverLifetime.isActive) {
+        generalData.linearVelocityData = Array.from({ length: maxParticles }, () => ({
+            speed: new THREE.Vector3(velocityOverLifetime.linear.x
+                ? calculateValue(generalData.particleSystemId, velocityOverLifetime.linear.x, 0)
+                : 0, velocityOverLifetime.linear.y
+                ? calculateValue(generalData.particleSystemId, velocityOverLifetime.linear.y, 0)
+                : 0, velocityOverLifetime.linear.z
+                ? calculateValue(generalData.particleSystemId, velocityOverLifetime.linear.z, 0)
+                : 0),
+            valueModifiers: {
+                x: isLifeTimeCurve(velocityOverLifetime.linear.x || 0)
+                    ? getCurveFunctionFromConfig(generalData.particleSystemId, velocityOverLifetime.linear.x)
+                    : undefined,
+                y: isLifeTimeCurve(velocityOverLifetime.linear.y || 0)
+                    ? getCurveFunctionFromConfig(generalData.particleSystemId, velocityOverLifetime.linear.y)
+                    : undefined,
+                z: isLifeTimeCurve(velocityOverLifetime.linear.z || 0)
+                    ? getCurveFunctionFromConfig(generalData.particleSystemId, velocityOverLifetime.linear.z)
+                    : undefined,
+            },
+        }));
+        generalData.orbitalVelocityData = Array.from({ length: maxParticles }, () => ({
+            speed: new THREE.Vector3(velocityOverLifetime.orbital.x
+                ? calculateValue(generalData.particleSystemId, velocityOverLifetime.orbital.x, 0)
+                : 0, velocityOverLifetime.orbital.y
+                ? calculateValue(generalData.particleSystemId, velocityOverLifetime.orbital.y, 0)
+                : 0, velocityOverLifetime.orbital.z
+                ? calculateValue(generalData.particleSystemId, velocityOverLifetime.orbital.z, 0)
+                : 0),
+            valueModifiers: {
+                x: isLifeTimeCurve(velocityOverLifetime.orbital.x || 0)
+                    ? getCurveFunctionFromConfig(generalData.particleSystemId, velocityOverLifetime.orbital.x)
+                    : undefined,
+                y: isLifeTimeCurve(velocityOverLifetime.orbital.y || 0)
+                    ? getCurveFunctionFromConfig(generalData.particleSystemId, velocityOverLifetime.orbital.y)
+                    : undefined,
+                z: isLifeTimeCurve(velocityOverLifetime.orbital.z || 0)
+                    ? getCurveFunctionFromConfig(generalData.particleSystemId, velocityOverLifetime.orbital.z)
+                    : undefined,
+            },
+            positionOffset: new THREE.Vector3(),
+        }));
+    }
+    const startValueKeys = [
+        'startSize',
+        'startOpacity',
+    ];
+    startValueKeys.forEach((key) => {
+        generalData.startValues[key] = Array.from({ length: maxParticles }, () => calculateValue(generalData.particleSystemId, normalizedConfig[key], 0));
+    });
+    const lifetimeValueKeys = [
+        'rotationOverLifetime',
+    ];
+    lifetimeValueKeys.forEach((key) => {
+        const value = normalizedConfig[key];
+        if (value.isActive)
+            generalData.lifetimeValues[key] = Array.from({ length: maxParticles }, () => THREE.MathUtils.randFloat(value.min, value.max));
+    });
+    generalData.noise = {
+        isActive: noise.isActive,
+        strength: noise.strength,
+        positionAmount: noise.positionAmount,
+        rotationAmount: noise.rotationAmount,
+        sizeAmount: noise.sizeAmount,
+        sampler: noise.isActive
+            ? new FBM({
+                seed: Math.random(),
+                scale: noise.frequency,
+                octaves: noise.octaves,
+            })
+            : undefined,
+        offsets: noise.useRandomOffset
+            ? Array.from({ length: maxParticles }, () => Math.random() * 100)
+            : undefined,
+    };
+    const material = new THREE.ShaderMaterial({
+        uniforms: {
+            elapsed: {
+                value: 0.0,
+            },
+            map: {
+                value: particleMap,
+            },
+            tiles: {
+                value: textureSheetAnimation.tiles,
+            },
+            fps: {
+                value: textureSheetAnimation.fps,
+            },
+            useFPSForFrameIndex: {
+                value: textureSheetAnimation.timeMode === "FPS" /* TimeMode.FPS */,
+            },
+            backgroundColor: {
+                value: renderer.backgroundColor,
+            },
+            discardBackgroundColor: {
+                value: renderer.discardBackgroundColor,
+            },
+            backgroundColorTolerance: {
+                value: renderer.backgroundColorTolerance,
+            },
+        },
+        vertexShader: ParticleSystemVertexShader,
+        fragmentShader: ParticleSystemFragmentShader,
+        transparent: renderer.transparent,
+        blending: renderer.blending,
+        depthTest: renderer.depthTest,
+        depthWrite: renderer.depthWrite,
+    });
+    const geometry = new THREE.BufferGeometry();
+    for (let i = 0; i < maxParticles; i++)
+        calculatePositionAndVelocity(generalData, shape, startSpeed, startPositions[i], velocities[i]);
+    geometry.setFromPoints(Array.from({ length: maxParticles }, (_, index) => startPositions[index].clone()));
+    const createFloat32AttributesRequest = (propertyName, factory) => {
+        createFloat32Attributes({
+            geometry,
+            propertyName,
+            maxParticles,
+            factory,
+        });
+    };
+    createFloat32AttributesRequest('isActive', 0);
+    createFloat32AttributesRequest('lifetime', 0);
+    createFloat32AttributesRequest('startLifetime', () => calculateValue(generalData.particleSystemId, startLifetime, 0) * 1000);
+    createFloat32AttributesRequest('startFrame', () => textureSheetAnimation.startFrame
+        ? calculateValue(generalData.particleSystemId, textureSheetAnimation.startFrame, 0)
+        : 0);
+    createFloat32AttributesRequest('opacity', () => calculateValue(generalData.particleSystemId, startOpacity, 0));
+    createFloat32AttributesRequest('rotation', () => calculateValue(generalData.particleSystemId, startRotation, 0));
+    createFloat32AttributesRequest('size', (_, index) => generalData.startValues.startSize[index]);
+    createFloat32AttributesRequest('rotation', 0);
+    const colorRandomRatio = Math.random();
+    createFloat32AttributesRequest('colorR', () => startColor.min.r +
+        colorRandomRatio * (startColor.max.r - startColor.min.r));
+    createFloat32AttributesRequest('colorG', () => startColor.min.g +
+        colorRandomRatio * (startColor.max.g - startColor.min.g));
+    createFloat32AttributesRequest('colorB', () => startColor.min.b +
+        colorRandomRatio * (startColor.max.b - startColor.min.b));
+    createFloat32AttributesRequest('colorA', 0);
+    const deactivateParticle = (particleIndex) => {
+        geometry.attributes.isActive.array[particleIndex] = 0;
+        geometry.attributes.colorA.array[particleIndex] = 0;
+        geometry.attributes.colorA.needsUpdate = true;
+    };
+    const activateParticle = ({ particleIndex, activationTime, position, }) => {
+        geometry.attributes.isActive.array[particleIndex] = 1;
+        generalData.creationTimes[particleIndex] = activationTime;
+        if (generalData.noise.offsets)
+            generalData.noise.offsets[particleIndex] = Math.random() * 100;
+        const colorRandomRatio = Math.random();
+        geometry.attributes.colorR.array[particleIndex] =
+            startColor.min.r +
+                colorRandomRatio * (startColor.max.r - startColor.min.r);
+        geometry.attributes.colorR.needsUpdate = true;
+        geometry.attributes.colorG.array[particleIndex] =
+            startColor.min.g +
+                colorRandomRatio * (startColor.max.g - startColor.min.g);
+        geometry.attributes.colorG.needsUpdate = true;
+        geometry.attributes.colorB.array[particleIndex] =
+            startColor.min.b +
+                colorRandomRatio * (startColor.max.b - startColor.min.b);
+        geometry.attributes.colorB.needsUpdate = true;
+        geometry.attributes.startFrame.array[particleIndex] =
+            textureSheetAnimation.startFrame
+                ? calculateValue(generalData.particleSystemId, textureSheetAnimation.startFrame, 0)
+                : 0;
+        geometry.attributes.startFrame.needsUpdate = true;
+        geometry.attributes.startLifetime.array[particleIndex] =
+            calculateValue(generalData.particleSystemId, startLifetime, generalData.normalizedLifetimePercentage) * 1000;
+        geometry.attributes.startLifetime.needsUpdate = true;
+        generalData.startValues.startSize[particleIndex] = calculateValue(generalData.particleSystemId, startSize, generalData.normalizedLifetimePercentage);
+        geometry.attributes.size.array[particleIndex] =
+            generalData.startValues.startSize[particleIndex];
+        geometry.attributes.size.needsUpdate = true;
+        generalData.startValues.startOpacity[particleIndex] = calculateValue(generalData.particleSystemId, startOpacity, generalData.normalizedLifetimePercentage);
+        geometry.attributes.colorA.array[particleIndex] =
+            generalData.startValues.startOpacity[particleIndex];
+        geometry.attributes.colorA.needsUpdate = true;
+        geometry.attributes.rotation.array[particleIndex] = calculateValue(generalData.particleSystemId, startRotation, generalData.normalizedLifetimePercentage);
+        geometry.attributes.rotation.needsUpdate = true;
+        if (normalizedConfig.rotationOverLifetime.isActive)
+            generalData.lifetimeValues.rotationOverLifetime[particleIndex] =
+                THREE.MathUtils.randFloat(normalizedConfig.rotationOverLifetime.min, normalizedConfig.rotationOverLifetime.max);
+        calculatePositionAndVelocity(generalData, shape, startSpeed, startPositions[particleIndex], velocities[particleIndex]);
+        const positionIndex = Math.floor(particleIndex * 3);
+        geometry.attributes.position.array[positionIndex] =
+            position.x + startPositions[particleIndex].x;
+        geometry.attributes.position.array[positionIndex + 1] =
+            position.y + startPositions[particleIndex].y;
+        geometry.attributes.position.array[positionIndex + 2] =
+            position.z + startPositions[particleIndex].z;
+        geometry.attributes.position.needsUpdate = true;
+        if (generalData.linearVelocityData) {
+            generalData.linearVelocityData[particleIndex].speed.set(normalizedConfig.velocityOverLifetime.linear.x
+                ? calculateValue(generalData.particleSystemId, normalizedConfig.velocityOverLifetime.linear.x, 0)
+                : 0, normalizedConfig.velocityOverLifetime.linear.y
+                ? calculateValue(generalData.particleSystemId, normalizedConfig.velocityOverLifetime.linear.y, 0)
+                : 0, normalizedConfig.velocityOverLifetime.linear.z
+                ? calculateValue(generalData.particleSystemId, normalizedConfig.velocityOverLifetime.linear.z, 0)
+                : 0);
+        }
+        if (generalData.orbitalVelocityData) {
+            generalData.orbitalVelocityData[particleIndex].speed.set(normalizedConfig.velocityOverLifetime.orbital.x
+                ? calculateValue(generalData.particleSystemId, normalizedConfig.velocityOverLifetime.orbital.x, 0)
+                : 0, normalizedConfig.velocityOverLifetime.orbital.y
+                ? calculateValue(generalData.particleSystemId, normalizedConfig.velocityOverLifetime.orbital.y, 0)
+                : 0, normalizedConfig.velocityOverLifetime.orbital.z
+                ? calculateValue(generalData.particleSystemId, normalizedConfig.velocityOverLifetime.orbital.z, 0)
+                : 0);
+            generalData.orbitalVelocityData[particleIndex].positionOffset.set(startPositions[particleIndex].x, startPositions[particleIndex].y, startPositions[particleIndex].z);
+        }
+        geometry.attributes.lifetime.array[particleIndex] = 0;
+        geometry.attributes.lifetime.needsUpdate = true;
+        applyModifiers({
+            delta: 0,
+            generalData,
+            normalizedConfig,
+            attributes: particleSystem.geometry.attributes,
+            particleLifetimePercentage: 0,
+            particleIndex,
+        });
+    };
+    let particleSystem = new THREE.Points(geometry, material);
+    particleSystem.position.copy(transform.position);
+    particleSystem.rotation.x = THREE.MathUtils.degToRad(transform.rotation.x);
+    particleSystem.rotation.y = THREE.MathUtils.degToRad(transform.rotation.y);
+    particleSystem.rotation.z = THREE.MathUtils.degToRad(transform.rotation.z);
+    particleSystem.scale.copy(transform.scale);
+    const calculatedCreationTime = now + calculateValue(generalData.particleSystemId, startDelay) * 1000;
+    let wrapper;
+    if (normalizedConfig.simulationSpace === "WORLD" /* SimulationSpace.WORLD */) {
+        wrapper = new Gyroscope();
+        wrapper.add(particleSystem);
+    }
+    createdParticleSystems.push({
+        particleSystem,
+        wrapper,
+        generalData,
+        onUpdate,
+        onComplete,
+        creationTime: calculatedCreationTime,
+        lastEmissionTime: calculatedCreationTime,
+        duration,
+        looping,
+        simulationSpace,
+        gravity,
+        emission,
+        normalizedConfig,
+        iterationCount: 0,
+        velocities,
+        deactivateParticle,
+        activateParticle,
+    });
+    const resumeEmitter = () => (generalData.isEnabled = true);
+    const pauseEmitter = () => (generalData.isEnabled = false);
+    const dispose = () => destroyParticleSystem(particleSystem);
+    return {
+        instance: wrapper || particleSystem,
+        resumeEmitter,
+        pauseEmitter,
+        dispose,
+    };
+};
+export const updateParticleSystems = ({ now, delta, elapsed }) => {
+    createdParticleSystems.forEach((props) => {
+        const { onUpdate, generalData, onComplete, particleSystem, wrapper, creationTime, lastEmissionTime, duration, looping, emission, normalizedConfig, iterationCount, velocities, deactivateParticle, activateParticle, simulationSpace, gravity, } = props;
+        const lifetime = now - creationTime;
+        const normalizedLifetime = lifetime % (duration * 1000);
+        generalData.normalizedLifetimePercentage = Math.max(Math.min(normalizedLifetime / (duration * 1000), 1), 0);
+        const { lastWorldPosition, currentWorldPosition, worldPositionChange, lastWorldQuaternion, worldQuaternion, worldEuler, gravityVelocity, isEnabled, } = generalData;
+        if (wrapper?.parent)
+            generalData.wrapperQuaternion.copy(wrapper.parent.quaternion);
+        const lastWorldPositionSnapshot = { ...lastWorldPosition };
+        if (Array.isArray(particleSystem.material))
+            particleSystem.material.forEach((material) => {
+                if (material instanceof THREE.ShaderMaterial)
+                    material.uniforms.elapsed.value = elapsed;
+            });
+        else {
+            if (particleSystem.material instanceof THREE.ShaderMaterial)
+                particleSystem.material.uniforms.elapsed.value = elapsed;
+        }
+        particleSystem.getWorldPosition(currentWorldPosition);
+        if (lastWorldPosition.x !== -99999) {
+            worldPositionChange.set(currentWorldPosition.x - lastWorldPosition.x, currentWorldPosition.y - lastWorldPosition.y, currentWorldPosition.z - lastWorldPosition.z);
+        }
+        generalData.distanceFromLastEmitByDistance += worldPositionChange.length();
+        particleSystem.getWorldPosition(lastWorldPosition);
+        particleSystem.getWorldQuaternion(worldQuaternion);
+        if (lastWorldQuaternion.x === -99999 ||
+            lastWorldQuaternion.x !== worldQuaternion.x ||
+            lastWorldQuaternion.y !== worldQuaternion.y ||
+            lastWorldQuaternion.z !== worldQuaternion.z) {
+            worldEuler.setFromQuaternion(worldQuaternion);
+            lastWorldQuaternion.copy(worldQuaternion);
+            gravityVelocity.set(lastWorldPosition.x, lastWorldPosition.y + gravity, lastWorldPosition.z);
+            particleSystem.worldToLocal(gravityVelocity);
+        }
+        generalData.creationTimes.forEach((entry, index) => {
+            if (particleSystem.geometry.attributes.isActive.array[index]) {
+                const particleLifetime = now - entry;
+                if (particleLifetime >
+                    particleSystem.geometry.attributes.startLifetime.array[index])
+                    deactivateParticle(index);
+                else {
+                    const velocity = velocities[index];
+                    velocity.x -= gravityVelocity.x * delta;
+                    velocity.y -= gravityVelocity.y * delta;
+                    velocity.z -= gravityVelocity.z * delta;
+                    if (gravity !== 0 ||
+                        velocity.x !== 0 ||
+                        velocity.y !== 0 ||
+                        velocity.z !== 0 ||
+                        worldPositionChange.x !== 0 ||
+                        worldPositionChange.y !== 0 ||
+                        worldPositionChange.z !== 0) {
+                        const positionIndex = index * 3;
+                        const positionArr = particleSystem.geometry.attributes.position.array;
+                        if (simulationSpace === "WORLD" /* SimulationSpace.WORLD */) {
+                            positionArr[positionIndex] -= worldPositionChange.x;
+                            positionArr[positionIndex + 1] -= worldPositionChange.y;
+                            positionArr[positionIndex + 2] -= worldPositionChange.z;
+                        }
+                        positionArr[positionIndex] += velocity.x * delta;
+                        positionArr[positionIndex + 1] += velocity.y * delta;
+                        positionArr[positionIndex + 2] += velocity.z * delta;
+                        particleSystem.geometry.attributes.position.needsUpdate = true;
+                    }
+                    particleSystem.geometry.attributes.lifetime.array[index] =
+                        particleLifetime;
+                    particleSystem.geometry.attributes.lifetime.needsUpdate = true;
+                    const particleLifetimePercentage = particleLifetime /
+                        particleSystem.geometry.attributes.startLifetime.array[index];
+                    applyModifiers({
+                        delta,
+                        generalData,
+                        normalizedConfig,
+                        attributes: particleSystem.geometry.attributes,
+                        particleLifetimePercentage,
+                        particleIndex: index,
+                    });
+                }
+            }
+        });
+        if (isEnabled && (looping || lifetime < duration * 1000)) {
+            const emissionDelta = now - lastEmissionTime;
+            const neededParticlesByTime = emission.rateOverTime
+                ? Math.floor(calculateValue(generalData.particleSystemId, emission.rateOverTime, generalData.normalizedLifetimePercentage) *
+                    (emissionDelta / 1000))
+                : 0;
+            const rateOverDistance = emission.rateOverDistance
+                ? calculateValue(generalData.particleSystemId, emission.rateOverDistance, generalData.normalizedLifetimePercentage)
+                : 0;
+            const neededParticlesByDistance = rateOverDistance > 0 && generalData.distanceFromLastEmitByDistance > 0
+                ? Math.floor(generalData.distanceFromLastEmitByDistance /
+                    (1 / rateOverDistance))
+                : 0;
+            const distanceStep = neededParticlesByDistance > 0
+                ? {
+                    x: (currentWorldPosition.x - lastWorldPositionSnapshot.x) /
+                        neededParticlesByDistance,
+                    y: (currentWorldPosition.y - lastWorldPositionSnapshot.y) /
+                        neededParticlesByDistance,
+                    z: (currentWorldPosition.z - lastWorldPositionSnapshot.z) /
+                        neededParticlesByDistance,
+                }
+                : null;
+            const neededParticles = neededParticlesByTime + neededParticlesByDistance;
+            if (rateOverDistance > 0 && neededParticlesByDistance >= 1) {
+                generalData.distanceFromLastEmitByDistance = 0;
+            }
+            if (neededParticles > 0) {
+                let generatedParticlesByDistanceNeeds = 0;
+                for (let i = 0; i < neededParticles; i++) {
+                    let particleIndex = -1;
+                    particleSystem.geometry.attributes.isActive.array.find((isActive, index) => {
+                        if (!isActive) {
+                            particleIndex = index;
+                            return true;
+                        }
+                        return false;
+                    });
+                    if (particleIndex !== -1 &&
+                        particleIndex <
+                            particleSystem.geometry.attributes.isActive.array.length) {
+                        let position = { x: 0, y: 0, z: 0 };
+                        if (distanceStep &&
+                            generatedParticlesByDistanceNeeds < neededParticlesByDistance) {
+                            position = {
+                                x: distanceStep.x * generatedParticlesByDistanceNeeds,
+                                y: distanceStep.y * generatedParticlesByDistanceNeeds,
+                                z: distanceStep.z * generatedParticlesByDistanceNeeds,
+                            };
+                            generatedParticlesByDistanceNeeds++;
+                        }
+                        activateParticle({
+                            particleIndex,
+                            activationTime: now,
+                            position,
+                        });
+                        props.lastEmissionTime = now;
+                    }
+                }
+            }
+            if (onUpdate)
+                onUpdate({
+                    particleSystem,
+                    delta,
+                    elapsed,
+                    lifetime,
+                    normalizedLifetime,
+                    iterationCount: iterationCount + 1,
+                });
+        }
+        else if (onComplete)
+            onComplete({
+                particleSystem,
+            });
+    });
+};