@tsparticles/engine 4.0.0-alpha.1 → 4.0.0-alpha.14

package/cjs/Core/Particles.js

@@ -1,104 +1,43 @@
 import { countOffset, defaultDensityFactor, defaultRemoveQuantity, deleteCount, lengthOffset, minCount, minIndex, minLimit, posOffset, qTreeCapacity, sizeFactor, squareExp, } from "./Utils/Constants.js";
 import { EventType } from "../Enums/Types/EventType.js";
-import { InteractionManager } from "./Utils/InteractionManager.js";
 import { LimitMode } from "../Enums/Modes/LimitMode.js";
 import { Particle } from "./Particle.js";
 import { Point } from "./Utils/Point.js";
 import { QuadTree } from "./Utils/QuadTree.js";
 import { Rectangle } from "./Utils/Ranges.js";
 import { getLogger } from "../Utils/LogUtils.js";
-import { getPosition } from "../Utils/Utils.js";
 import { loadParticlesOptions } from "../Utils/OptionsUtils.js";
 const qTreeRectangle = (canvasSize) => {
     const { height, width } = canvasSize;
     return new Rectangle(posOffset * width, posOffset * height, sizeFactor * width, sizeFactor * height);
 };
 export class Particles {
+    availablePathGenerators;
+    checkParticlePositionPlugins;
+    effectDrawers;
+    movers;
+    pathGenerators;
+    quadTree;
+    shapeDrawers;
+    updaters;
+    _array;
+    _container;
+    _engine;
+    _groupLimits;
+    _limit;
+    _maxZIndex;
+    _minZIndex;
+    _needsSort;
+    _nextId;
+    _particleResetPlugins;
+    _particleUpdatePlugins;
+    _pool;
+    _postParticleUpdatePlugins;
+    _postUpdatePlugins;
+    _resizeFactor;
+    _updatePlugins;
+    _zArray;
     constructor(engine, container) {
-        this._addToPool = (...particles) => {
-            this._pool.push(...particles);
-        };
-        this._applyDensity = (options, manualCount, group, groupOptions) => {
-            const numberOptions = options.number;
-            if (!numberOptions.density.enable) {
-                if (group === undefined) {
-                    this._limit = numberOptions.limit.value;
-                }
-                else if (groupOptions?.number.limit.value ?? numberOptions.limit.value) {
-                    this._groupLimits.set(group, groupOptions?.number.limit.value ?? numberOptions.limit.value);
-                }
-                return;
-            }
-            const densityFactor = this._initDensityFactor(numberOptions.density), optParticlesNumber = numberOptions.value, optParticlesLimit = numberOptions.limit.value > minLimit ? numberOptions.limit.value : optParticlesNumber, particlesNumber = Math.min(optParticlesNumber, optParticlesLimit) * densityFactor + manualCount, particlesCount = Math.min(this.count, this.filter(t => t.group === group).length);
-            if (group === undefined) {
-                this._limit = numberOptions.limit.value * densityFactor;
-            }
-            else {
-                this._groupLimits.set(group, numberOptions.limit.value * densityFactor);
-            }
-            if (particlesCount < particlesNumber) {
-                this.push(Math.abs(particlesNumber - particlesCount), undefined, options, group);
-            }
-            else if (particlesCount > particlesNumber) {
-                this.removeQuantity(particlesCount - particlesNumber, group);
-            }
-        };
-        this._initDensityFactor = densityOptions => {
-            const container = this._container;
-            if (!container.canvas.element || !densityOptions.enable) {
-                return defaultDensityFactor;
-            }
-            const canvas = container.canvas.element, pxRatio = container.retina.pixelRatio;
-            return (canvas.width * canvas.height) / (densityOptions.height * densityOptions.width * pxRatio ** squareExp);
-        };
-        this._pushParticle = (position, overrideOptions, group, initializer) => {
-            try {
-                const particle = this._pool.pop() ?? new Particle(this._engine, this._container);
-                particle.init(this._nextId, position, overrideOptions, group);
-                let canAdd = true;
-                if (initializer) {
-                    canAdd = initializer(particle);
-                }
-                if (!canAdd) {
-                    return;
-                }
-                this._array.push(particle);
-                this._zArray.push(particle);
-                this._nextId++;
-                this._engine.dispatchEvent(EventType.particleAdded, {
-                    container: this._container,
-                    data: {
-                        particle,
-                    },
-                });
-                return particle;
-            }
-            catch (e) {
-                getLogger().warning(`error adding particle: ${e}`);
-            }
-            return undefined;
-        };
-        this._removeParticle = (index, group, override) => {
-            const particle = this._array[index];
-            if (!particle) {
-                return false;
-            }
-            if (particle.group !== group) {
-                return false;
-            }
-            const zIdx = this._zArray.indexOf(particle);
-            this._array.splice(index, deleteCount);
-            this._zArray.splice(zIdx, deleteCount);
-            particle.destroy(override);
-            this._engine.dispatchEvent(EventType.particleRemoved, {
-                container: this._container,
-                data: {
-                    particle,
-                },
-            });
-            this._addToPool(particle);
-            return true;
-        };
         this._engine = engine;
         this._container = container;
         this._nextId = 0;
@@ -108,21 +47,26 @@ export class Particles {
         this._limit = 0;
         this._groupLimits = new Map();
         this._needsSort = false;
-        this._lastZIndex = 0;
-        this._interactionManager = new InteractionManager(engine, container);
-        this._pluginsInitialized = false;
+        this._minZIndex = 0;
+        this._maxZIndex = 0;
         const canvasSize = container.canvas.size;
         this.quadTree = new QuadTree(qTreeRectangle(canvasSize), qTreeCapacity);
+        this.effectDrawers = new Map();
         this.movers = [];
+        this.availablePathGenerators = new Map();
+        this.pathGenerators = new Map();
+        this.shapeDrawers = new Map();
         this.updaters = [];
+        this.checkParticlePositionPlugins = [];
+        this._particleResetPlugins = [];
+        this._particleUpdatePlugins = [];
+        this._postUpdatePlugins = [];
+        this._postParticleUpdatePlugins = [];
+        this._updatePlugins = [];
     }
     get count() {
         return this._array.length;
     }
-    addManualParticles() {
-        const container = this._container, options = container.actualOptions;
-        options.manualParticles.forEach(p => this.addParticle(p.position ? getPosition(p.position, container.canvas.size) : undefined, p.options));
-    }
     addParticle(position, overrideOptions, group, initializer) {
         const limitMode = this._container.actualOptions.particles.number.limit.mode, limit = group === undefined ? this._limit : (this._groupLimits.get(group) ?? this._limit), currentCount = this.count;
         if (limit > minLimit) {
@@ -139,20 +83,64 @@ export class Particles {
                         return;
                     }
                     break;
+                default:
+                    break;
             }
         }
-        return this._pushParticle(position, overrideOptions, group, initializer);
+        try {
+            const particle = this._pool.pop() ?? new Particle(this._engine, this._container);
+            particle.init(this._nextId, position, overrideOptions, group);
+            let canAdd = true;
+            if (initializer) {
+                canAdd = initializer(particle);
+            }
+            if (!canAdd) {
+                this._pool.push(particle);
+                return;
+            }
+            this._array.push(particle);
+            this._zArray.push(particle);
+            this._nextId++;
+            this._engine.dispatchEvent(EventType.particleAdded, {
+                container: this._container,
+                data: {
+                    particle,
+                },
+            });
+            return particle;
+        }
+        catch (e) {
+            getLogger().warning(`error adding particle: ${e}`);
+        }
+        return undefined;
     }
     clear() {
         this._array = [];
         this._zArray = [];
-        this._pluginsInitialized = false;
     }
     destroy() {
+        const container = this._container;
+        for (const [, effectDrawer] of this.effectDrawers) {
+            effectDrawer.destroy?.(container);
+        }
+        for (const [, shapeDrawer] of this.shapeDrawers) {
+            shapeDrawer.destroy?.(container);
+        }
         this._array = [];
+        this._pool.length = 0;
         this._zArray = [];
+        this.effectDrawers = new Map();
         this.movers = [];
+        this.availablePathGenerators = new Map();
+        this.pathGenerators = new Map();
+        this.shapeDrawers = new Map();
         this.updaters = [];
+        this.checkParticlePositionPlugins = [];
+        this._particleResetPlugins = [];
+        this._particleUpdatePlugins = [];
+        this._postUpdatePlugins = [];
+        this._postParticleUpdatePlugins = [];
+        this._updatePlugins = [];
     }
     drawParticles(delta) {
         for (const particle of this._zArray) {
@@ -168,22 +156,54 @@ export class Particles {
     get(index) {
         return this._array[index];
     }
-    handleClickMode(mode) {
-        this._interactionManager.handleClickMode(mode);
-    }
     async init() {
         const container = this._container, options = container.actualOptions;
-        this._lastZIndex = 0;
+        this._minZIndex = 0;
+        this._maxZIndex = 0;
         this._needsSort = false;
+        this.checkParticlePositionPlugins = [];
+        this._updatePlugins = [];
+        this._particleUpdatePlugins = [];
+        this._postUpdatePlugins = [];
+        this._particleResetPlugins = [];
+        this._postParticleUpdatePlugins = [];
+        for (const plugin of container.plugins) {
+            if (plugin.redrawInit) {
+                await plugin.redrawInit();
+            }
+            if (plugin.checkParticlePosition) {
+                this.checkParticlePositionPlugins.push(plugin);
+            }
+            if (plugin.update) {
+                this._updatePlugins.push(plugin);
+            }
+            if (plugin.particleUpdate) {
+                this._particleUpdatePlugins.push(plugin);
+            }
+            if (plugin.postUpdate) {
+                this._postUpdatePlugins.push(plugin);
+            }
+            if (plugin.particleReset) {
+                this._particleResetPlugins.push(plugin);
+            }
+            if (plugin.postParticleUpdate) {
+                this._postParticleUpdatePlugins.push(plugin);
+            }
+        }
         await this.initPlugins();
+        for (const drawer of this.effectDrawers.values()) {
+            await drawer.init?.(container);
+        }
+        for (const drawer of this.shapeDrawers.values()) {
+            await drawer.init?.(container);
+        }
         let handled = false;
-        for (const plugin of container.plugins.values()) {
+        for (const plugin of container.plugins) {
             handled = plugin.particlesInitialization?.() ?? handled;
             if (handled) {
                 break;
             }
         }
-        this.addManualParticles();
         if (!handled) {
             const particlesOptions = options.particles, groups = particlesOptions.groups;
             for (const group in groups) {
@@ -201,20 +221,20 @@ export class Particles {
         }
     }
     async initPlugins() {
-        if (this._pluginsInitialized) {
-            return;
-        }
         const container = this._container;
+        this.effectDrawers = await this._engine.getEffectDrawers(container, true);
         this.movers = await this._engine.getMovers(container, true);
+        this.availablePathGenerators = await this._engine.getPathGenerators(container, true);
+        this.pathGenerators = new Map();
+        this.shapeDrawers = await this._engine.getShapeDrawers(container, true);
         this.updaters = await this._engine.getUpdaters(container, true);
-        await this._interactionManager.init();
-        for (const pathGenerator of container.pathGenerators.values()) {
-            pathGenerator.init(container);
+        for (const pathGenerator of this.pathGenerators.values()) {
+            pathGenerator.init();
         }
     }
-    push(nb, mouse, overrideOptions, group) {
+    push(nb, position, overrideOptions, group) {
         for (let i = 0; i < nb; i++) {
-            this.addParticle(mouse?.position, overrideOptions, group);
+            this.addParticle(position, overrideOptions, group);
         }
     }
     async redraw() {
@@ -241,20 +261,25 @@ export class Particles {
         this.removeAt(minIndex, quantity, group);
     }
     setDensity() {
-        const options = this._container.actualOptions, groups = options.particles.groups, manualCount = options.manualParticles.length;
+        const options = this._container.actualOptions, groups = options.particles.groups;
+        let pluginsCount = 0;
+        for (const plugin of this._container.plugins) {
+            if (plugin.particlesDensityCount) {
+                pluginsCount += plugin.particlesDensityCount();
+            }
+        }
         for (const group in groups) {
             const groupData = groups[group];
             if (!groupData) {
                 continue;
             }
             const groupDataOptions = loadParticlesOptions(this._engine, this._container, groupData);
-            this._applyDensity(groupDataOptions, manualCount, group);
+            this._applyDensity(groupDataOptions, pluginsCount, group);
         }
-        this._applyDensity(options.particles, manualCount);
+        this._applyDensity(options.particles, pluginsCount);
     }
     setLastZIndex(zIndex) {
-        this._lastZIndex = zIndex;
-        this._needsSort = this._needsSort || this._lastZIndex < zIndex;
+        this._needsSort ||= zIndex >= this._maxZIndex || (zIndex > this._minZIndex && zIndex < this._maxZIndex);
     }
     setResizeFactor(factor) {
         this._resizeFactor = factor;
@@ -262,10 +287,10 @@ export class Particles {
     update(delta) {
         const container = this._container, particlesToDelete = new Set();
         this.quadTree = new QuadTree(qTreeRectangle(container.canvas.size), qTreeCapacity);
-        for (const pathGenerator of container.pathGenerators.values()) {
+        for (const pathGenerator of this.pathGenerators.values()) {
             pathGenerator.update();
         }
-        for (const plugin of container.plugins.values()) {
+        for (const plugin of this._updatePlugins) {
             plugin.update?.(delta);
         }
         const resizeFactor = this._resizeFactor;
@@ -277,8 +302,10 @@ export class Particles {
                 particle.initialPosition.y *= resizeFactor.height;
             }
             particle.ignoresResizeRatio = false;
-            this._interactionManager.reset(particle);
-            for (const plugin of this._container.plugins.values()) {
+            for (const plugin of this._particleResetPlugins) {
+                plugin.particleReset?.(particle);
+            }
+            for (const plugin of this._particleUpdatePlugins) {
                 if (particle.destroyed) {
                     break;
                 }
@@ -309,25 +336,87 @@ export class Particles {
             }
             this._addToPool(...particlesToDelete);
         }
-        this._interactionManager.externalInteract(delta);
+        for (const plugin of this._postUpdatePlugins) {
+            plugin.postUpdate?.(delta);
+        }
         for (const particle of this._array) {
             for (const updater of this.updaters) {
                 updater.update(particle, delta);
             }
             if (!particle.destroyed && !particle.spawning) {
-                this._interactionManager.particlesInteract(particle, delta);
+                for (const plugin of this._postParticleUpdatePlugins) {
+                    plugin.postParticleUpdate?.(particle, delta);
+                }
             }
         }
         delete this._resizeFactor;
         if (this._needsSort) {
             const zArray = this._zArray;
             zArray.sort((a, b) => b.position.z - a.position.z || a.id - b.id);
-            const lastItem = zArray[zArray.length - lengthOffset];
-            if (!lastItem) {
+            const firstItem = zArray[minIndex], lastItem = zArray[zArray.length - lengthOffset];
+            if (!firstItem || !lastItem) {
                 return;
             }
-            this._lastZIndex = lastItem.position.z;
+            this._maxZIndex = firstItem.position.z;
+            this._minZIndex = lastItem.position.z;
             this._needsSort = false;
         }
     }
+    _addToPool = (...particles) => {
+        this._pool.push(...particles);
+    };
+    _applyDensity = (options, pluginsCount, group, groupOptions) => {
+        const numberOptions = options.number;
+        if (!numberOptions.density.enable) {
+            if (group === undefined) {
+                this._limit = numberOptions.limit.value;
+            }
+            else if (groupOptions?.number.limit.value ?? numberOptions.limit.value) {
+                this._groupLimits.set(group, groupOptions?.number.limit.value ?? numberOptions.limit.value);
+            }
+            return;
+        }
+        const densityFactor = this._initDensityFactor(numberOptions.density), optParticlesNumber = numberOptions.value, optParticlesLimit = numberOptions.limit.value > minLimit ? numberOptions.limit.value : optParticlesNumber, particlesNumber = Math.min(optParticlesNumber, optParticlesLimit) * densityFactor + pluginsCount, particlesCount = Math.min(this.count, this.filter(t => t.group === group).length);
+        if (group === undefined) {
+            this._limit = numberOptions.limit.value * densityFactor;
+        }
+        else {
+            this._groupLimits.set(group, numberOptions.limit.value * densityFactor);
+        }
+        if (particlesCount < particlesNumber) {
+            this.push(Math.abs(particlesNumber - particlesCount), undefined, options, group);
+        }
+        else if (particlesCount > particlesNumber) {
+            this.removeQuantity(particlesCount - particlesNumber, group);
+        }
+    };
+    _initDensityFactor = densityOptions => {
+        const container = this._container;
+        if (!container.canvas.element || !densityOptions.enable) {
+            return defaultDensityFactor;
+        }
+        const canvas = container.canvas.element, pxRatio = container.retina.pixelRatio;
+        return (canvas.width * canvas.height) / (densityOptions.height * densityOptions.width * pxRatio ** squareExp);
+    };
+    _removeParticle = (index, group, override) => {
+        const particle = this._array[index];
+        if (!particle) {
+            return false;
+        }
+        if (particle.group !== group) {
+            return false;
+        }
+        const zIdx = this._zArray.indexOf(particle);
+        this._array.splice(index, deleteCount);
+        this._zArray.splice(zIdx, deleteCount);
+        particle.destroy(override);
+        this._engine.dispatchEvent(EventType.particleRemoved, {
+            container: this._container,
+            data: {
+                particle,
+            },
+        });
+        this._addToPool(particle);
+        return true;
+    };
 }

package/cjs/Core/Retina.js

@@ -1,6 +1,11 @@
 import { defaultRatio, defaultReduceFactor } from "./Utils/Constants.js";
 import { getRangeValue } from "../Utils/MathUtils.js";
 export class Retina {
+    container;
+    maxSpeed;
+    pixelRatio;
+    reduceFactor;
+    sizeAnimationSpeed;
     constructor(container) {
         this.container = container;
         this.pixelRatio = defaultRatio;

package/cjs/Core/Utils/Constants.js

@@ -1,4 +1,4 @@
-export const generatedAttribute = "generated", mouseDownEvent = "pointerdown", mouseUpEvent = "pointerup", mouseLeaveEvent = "pointerleave", mouseOutEvent = "pointerout", mouseMoveEvent = "pointermove", touchStartEvent = "touchstart", touchEndEvent = "touchend", touchMoveEvent = "touchmove", touchCancelEvent = "touchcancel", resizeEvent = "resize", visibilityChangeEvent = "visibilitychange", percentDenominator = 100, half = 0.5, millisecondsToSeconds = 1000, originPoint = {
+export const generatedAttribute = "generated", resizeEvent = "resize", visibilityChangeEvent = "visibilitychange", percentDenominator = 100, half = 0.5, millisecondsToSeconds = 1000, originPoint = {
     x: 0,
     y: 0,
     z: 0,
@@ -7,4 +7,4 @@ export const generatedAttribute = "generated", mouseDownEvent = "pointerdown", m
     b: 0,
     c: 0,
     d: 1,
-}, randomColorValue = "random", midColorValue = "mid", double = 2, doublePI = Math.PI * double, defaultFps = 60, defaultAlpha = 1, generatedTrue = "true", generatedFalse = "false", canvasTag = "canvas", defaultRetryCount = 0, squareExp = 2, qTreeCapacity = 4, defaultRemoveQuantity = 1, defaultRatio = 1, defaultReduceFactor = 1, subdivideCount = 4, inverseFactorNumerator = 1.0, rgbMax = 255, hMax = 360, sMax = 100, lMax = 100, hMin = 0, sMin = 0, hPhase = 60, empty = 0, quarter = 0.25, threeQuarter = half + quarter, minVelocity = 0, defaultTransformValue = 1, minimumSize = 0, minimumLength = 0, zIndexFactorOffset = 1, defaultOpacity = 1, clickRadius = 1, touchEndLengthOffset = 1, minCoordinate = 0, removeDeleteCount = 1, removeMinIndex = 0, defaultFpsLimit = 120, minFpsLimit = 0, canvasFirstIndex = 0, loadRandomFactor = 10000, loadMinIndex = 0, one = 1, none = 0, decayOffset = 1, tryCountIncrement = 1, minRetries = 0, rollFactor = 1, minZ = 0, defaultRadius = 0, posOffset = -quarter, sizeFactor = 1.5, minLimit = 0, countOffset = 1, minCount = 0, minIndex = 0, manualCount = 0, lengthOffset = 1, defaultDensityFactor = 1, deleteCount = 1, touchDelay = 500, manualDefaultPosition = 50, defaultAngle = 0, identity = 1, minStrokeWidth = 0, lFactor = 1, lMin = 0, triple = 3, sextuple = 6, sNormalizedOffset = 1, phaseNumerator = 1, defaultRgbMin = 0, defaultVelocity = 0, defaultLoops = 0, defaultTime = 0;
+}, randomColorValue = "random", midColorValue = "mid", double = 2, doublePI = Math.PI * double, defaultFps = 60, defaultAlpha = 1, generatedTrue = "true", generatedFalse = "false", canvasTag = "canvas", defaultRetryCount = 0, squareExp = 2, qTreeCapacity = 4, defaultRemoveQuantity = 1, defaultRatio = 1, defaultReduceFactor = 1, subdivideCount = 4, inverseFactorNumerator = 1.0, rgbMax = 255, hMax = 360, sMax = 100, lMax = 100, hMin = 0, sMin = 0, hPhase = 60, empty = 0, quarter = 0.25, threeQuarter = half + quarter, minVelocity = 0, defaultTransformValue = 1, minimumSize = 0, minimumLength = 0, zIndexFactorOffset = 1, defaultOpacity = 1, clickRadius = 1, touchEndLengthOffset = 1, minCoordinate = 0, removeDeleteCount = 1, removeMinIndex = 0, defaultFpsLimit = 120, minFpsLimit = 0, canvasFirstIndex = 0, loadRandomFactor = 10000, loadMinIndex = 0, one = 1, none = 0, decayOffset = 1, tryCountIncrement = 1, minRetries = 0, minZ = 0, defaultRadius = 0, posOffset = -quarter, sizeFactor = 1.5, minLimit = 0, countOffset = 1, minCount = 0, minIndex = 0, lengthOffset = 1, defaultDensityFactor = 1, deleteCount = 1, touchDelay = 500, manualDefaultPosition = 50, defaultAngle = 0, identity = 1, minStrokeWidth = 0, lFactor = 1, lMin = 0, triple = 3, sextuple = 6, sNormalizedOffset = 1, phaseNumerator = 1, defaultRgbMin = 0, defaultVelocity = 0, defaultLoops = 0, defaultTime = 0;