@tsparticles/engine 4.0.0-beta.0 → 4.0.0-beta.2

package/umd/Core/Particle.js

@@ -1,432 +0,0 @@
-(function (factory) {
-    if (typeof module === "object" && typeof module.exports === "object") {
-        var v = factory(require, exports);
-        if (v !== undefined) module.exports = v;
-    }
-    else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./Utils/Vectors.js", "../Utils/ColorUtils.js", "../Utils/MathUtils.js", "../Utils/Utils.js", "./Utils/Constants.js", "../Enums/Types/EventType.js", "../Enums/Directions/MoveDirection.js", "../Enums/Modes/OutMode.js", "../Enums/Types/ParticleOutType.js", "../Utils/OptionsUtils.js"], factory);
-    }
-})(function (require, exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.Particle = void 0;
-    const Vectors_js_1 = require("./Utils/Vectors.js");
-    const ColorUtils_js_1 = require("../Utils/ColorUtils.js");
-    const MathUtils_js_1 = require("../Utils/MathUtils.js");
-    const Utils_js_1 = require("../Utils/Utils.js");
-    const Constants_js_1 = require("./Utils/Constants.js");
-    const EventType_js_1 = require("../Enums/Types/EventType.js");
-    const MoveDirection_js_1 = require("../Enums/Directions/MoveDirection.js");
-    const OutMode_js_1 = require("../Enums/Modes/OutMode.js");
-    const ParticleOutType_js_1 = require("../Enums/Types/ParticleOutType.js");
-    const OptionsUtils_js_1 = require("../Utils/OptionsUtils.js");
-    function loadEffectData(effect, effectOptions, id, reduceDuplicates) {
-        const effectData = effectOptions.options[effect];
-        return (0, Utils_js_1.deepExtend)({
-            close: effectOptions.close,
-        }, (0, Utils_js_1.itemFromSingleOrMultiple)(effectData, id, reduceDuplicates));
-    }
-    function loadShapeData(shape, shapeOptions, id, reduceDuplicates) {
-        const shapeData = shapeOptions.options[shape];
-        return (0, Utils_js_1.deepExtend)({
-            close: shapeOptions.close,
-        }, (0, Utils_js_1.itemFromSingleOrMultiple)(shapeData, id, reduceDuplicates));
-    }
-    function fixOutMode(data) {
-        if (!(0, Utils_js_1.isInArray)(data.outMode, data.checkModes)) {
-            return;
-        }
-        const diameter = data.radius * Constants_js_1.double;
-        if (data.coord > data.maxCoord - diameter) {
-            data.setCb(-data.radius);
-        }
-        else if (data.coord < diameter) {
-            data.setCb(data.radius);
-        }
-    }
-    class Particle {
-        container;
-        backColor;
-        bubble;
-        destroyed;
-        direction;
-        effect;
-        effectClose;
-        effectData;
-        fillColor;
-        fillEnabled;
-        fillOpacity;
-        group;
-        id;
-        ignoresResizeRatio;
-        initialPosition;
-        initialVelocity;
-        isRotating;
-        lastPathTime;
-        misplaced;
-        moveCenter;
-        offset;
-        opacity;
-        options;
-        outType;
-        pathRotation;
-        position;
-        randomIndexData;
-        retina;
-        roll;
-        rotation;
-        shape;
-        shapeClose;
-        shapeData;
-        sides;
-        size;
-        slow;
-        spawning;
-        strokeColor;
-        strokeOpacity;
-        strokeWidth;
-        unbreakable;
-        velocity;
-        zIndexFactor;
-        _cachedOpacityData = {
-            fillOpacity: Constants_js_1.defaultOpacity,
-            opacity: Constants_js_1.defaultOpacity,
-            strokeOpacity: Constants_js_1.defaultOpacity,
-        };
-        _cachedPosition = Vectors_js_1.Vector3d.origin;
-        _cachedRotateData = { sin: 0, cos: 0 };
-        _cachedTransform = {
-            a: 1,
-            b: 0,
-            c: 0,
-            d: 1,
-        };
-        _engine;
-        constructor(engine, container) {
-            this.container = container;
-            this._engine = engine;
-        }
-        destroy(override) {
-            if (this.unbreakable || this.destroyed) {
-                return;
-            }
-            this.destroyed = true;
-            this.bubble.inRange = false;
-            this.slow.inRange = false;
-            const container = this.container, shapeDrawer = this.shape ? container.particles.shapeDrawers.get(this.shape) : undefined;
-            shapeDrawer?.particleDestroy?.(this);
-            for (const plugin of container.particleDestroyedPlugins) {
-                plugin.particleDestroyed?.(this, override);
-            }
-            for (const updater of container.particles.updaters) {
-                updater.particleDestroyed?.(this, override);
-            }
-            this._engine.dispatchEvent(EventType_js_1.EventType.particleDestroyed, {
-                container: this.container,
-                data: {
-                    particle: this,
-                },
-            });
-        }
-        draw(delta) {
-            const container = this.container, canvas = container.canvas;
-            canvas.drawParticlePlugins(this, delta);
-            canvas.drawParticle(this, delta);
-        }
-        getAngle() {
-            return this.rotation + (this.pathRotation ? this.velocity.angle : Constants_js_1.defaultAngle);
-        }
-        getFillColor() {
-            return this._getRollColor(this.bubble.color ?? (0, ColorUtils_js_1.getHslFromAnimation)(this.fillColor));
-        }
-        getMass() {
-            return this.getRadius() ** Constants_js_1.squareExp * Math.PI * Constants_js_1.half;
-        }
-        getOpacity() {
-            const zIndexOptions = this.options.zIndex, zIndexFactor = Constants_js_1.zIndexFactorOffset - this.zIndexFactor, zOpacityFactor = zIndexFactor ** zIndexOptions.opacityRate, opacity = this.bubble.opacity ?? (0, MathUtils_js_1.getRangeValue)(this.opacity?.value ?? Constants_js_1.defaultOpacity), fillOpacity = this.fillOpacity ?? Constants_js_1.defaultOpacity, strokeOpacity = this.strokeOpacity ?? Constants_js_1.defaultOpacity;
-            this._cachedOpacityData.fillOpacity = opacity * fillOpacity * zOpacityFactor;
-            this._cachedOpacityData.opacity = opacity * zOpacityFactor;
-            this._cachedOpacityData.strokeOpacity = opacity * strokeOpacity * zOpacityFactor;
-            return this._cachedOpacityData;
-        }
-        getPosition() {
-            this._cachedPosition.x = this.position.x + this.offset.x;
-            this._cachedPosition.y = this.position.y + this.offset.y;
-            this._cachedPosition.z = this.position.z;
-            return this._cachedPosition;
-        }
-        getRadius() {
-            return this.bubble.radius ?? this.size.value;
-        }
-        getRotateData() {
-            const angle = this.getAngle();
-            this._cachedRotateData.sin = Math.sin(angle);
-            this._cachedRotateData.cos = Math.cos(angle);
-            return this._cachedRotateData;
-        }
-        getStrokeColor() {
-            return this._getRollColor(this.bubble.color ?? (0, ColorUtils_js_1.getHslFromAnimation)(this.strokeColor));
-        }
-        getTransformData(externalTransform) {
-            const rotateData = this.getRotateData(), rotating = this.isRotating;
-            this._cachedTransform.a = rotateData.cos * (externalTransform.a ?? Constants_js_1.defaultTransform.a);
-            this._cachedTransform.b = rotating
-                ? rotateData.sin * (externalTransform.b ?? Constants_js_1.identity)
-                : (externalTransform.b ?? Constants_js_1.defaultTransform.b);
-            this._cachedTransform.c = rotating
-                ? -rotateData.sin * (externalTransform.c ?? Constants_js_1.identity)
-                : (externalTransform.c ?? Constants_js_1.defaultTransform.c);
-            this._cachedTransform.d = rotateData.cos * (externalTransform.d ?? Constants_js_1.defaultTransform.d);
-            return this._cachedTransform;
-        }
-        init(id, position, overrideOptions, group) {
-            const container = this.container;
-            this.id = id;
-            this.group = group;
-            this.effectClose = true;
-            this.shapeClose = true;
-            this.pathRotation = false;
-            this.lastPathTime = 0;
-            this.destroyed = false;
-            this.unbreakable = false;
-            this.isRotating = false;
-            this.rotation = 0;
-            this.misplaced = false;
-            this.retina = {
-                maxDistance: {},
-            };
-            this.outType = ParticleOutType_js_1.ParticleOutType.normal;
-            this.ignoresResizeRatio = true;
-            const pxRatio = container.retina.pixelRatio, mainOptions = container.actualOptions, particlesOptions = (0, OptionsUtils_js_1.loadParticlesOptions)(this._engine, container, mainOptions.particles), reduceDuplicates = particlesOptions.reduceDuplicates, effectType = particlesOptions.effect.type, shapeType = particlesOptions.shape.type;
-            this.effect = (0, Utils_js_1.itemFromSingleOrMultiple)(effectType, this.id, reduceDuplicates);
-            this.shape = (0, Utils_js_1.itemFromSingleOrMultiple)(shapeType, this.id, reduceDuplicates);
-            const effectOptions = particlesOptions.effect, shapeOptions = particlesOptions.shape;
-            if (overrideOptions) {
-                if (overrideOptions.effect?.type) {
-                    const overrideEffectType = overrideOptions.effect.type, effect = (0, Utils_js_1.itemFromSingleOrMultiple)(overrideEffectType, this.id, reduceDuplicates);
-                    if (effect) {
-                        this.effect = effect;
-                        effectOptions.load(overrideOptions.effect);
-                    }
-                }
-                if (overrideOptions.shape?.type) {
-                    const overrideShapeType = overrideOptions.shape.type, shape = (0, Utils_js_1.itemFromSingleOrMultiple)(overrideShapeType, this.id, reduceDuplicates);
-                    if (shape) {
-                        this.shape = shape;
-                        shapeOptions.load(overrideOptions.shape);
-                    }
-                }
-            }
-            if (this.effect === Constants_js_1.randomColorValue) {
-                const availableEffects = [...this.container.particles.effectDrawers.keys()];
-                this.effect = availableEffects[Math.floor((0, MathUtils_js_1.getRandom)() * availableEffects.length)];
-            }
-            if (this.shape === Constants_js_1.randomColorValue) {
-                const availableShapes = [...this.container.particles.shapeDrawers.keys()];
-                this.shape = availableShapes[Math.floor((0, MathUtils_js_1.getRandom)() * availableShapes.length)];
-            }
-            this.effectData = this.effect ? loadEffectData(this.effect, effectOptions, this.id, reduceDuplicates) : undefined;
-            this.shapeData = this.shape ? loadShapeData(this.shape, shapeOptions, this.id, reduceDuplicates) : undefined;
-            particlesOptions.load(overrideOptions);
-            const effectData = this.effectData;
-            if (effectData) {
-                particlesOptions.load(effectData.particles);
-            }
-            const shapeData = this.shapeData;
-            if (shapeData) {
-                particlesOptions.load(shapeData.particles);
-            }
-            this.effectClose = effectData?.close ?? particlesOptions.effect.close;
-            this.shapeClose = shapeData?.close ?? particlesOptions.shape.close;
-            this.options = particlesOptions;
-            container.retina.initParticle(this);
-            this.size = (0, Utils_js_1.initParticleNumericAnimationValue)(this.options.size, pxRatio);
-            this.bubble = {
-                inRange: false,
-            };
-            this.slow = {
-                inRange: false,
-                factor: 1,
-            };
-            this._initPosition(position);
-            this.initialVelocity = this._calculateVelocity();
-            this.velocity = this.initialVelocity.copy();
-            const particles = container.particles;
-            particles.setLastZIndex(this.position.z);
-            this.zIndexFactor = this.position.z / container.zLayers;
-            this.sides = 24;
-            let effectDrawer, shapeDrawer;
-            if (this.effect) {
-                effectDrawer = container.particles.effectDrawers.get(this.effect);
-            }
-            if (effectDrawer?.loadEffect) {
-                effectDrawer.loadEffect(this);
-            }
-            if (this.shape) {
-                shapeDrawer = container.particles.shapeDrawers.get(this.shape);
-            }
-            if (shapeDrawer?.loadShape) {
-                shapeDrawer.loadShape(this);
-            }
-            const sideCountFunc = shapeDrawer?.getSidesCount;
-            if (sideCountFunc) {
-                this.sides = sideCountFunc(this);
-            }
-            this.spawning = false;
-            for (const updater of particles.updaters) {
-                updater.init(this);
-            }
-            effectDrawer?.particleInit?.(container, this);
-            shapeDrawer?.particleInit?.(container, this);
-            for (const plugin of container.particleCreatedPlugins) {
-                plugin.particleCreated?.(this);
-            }
-        }
-        isInsideCanvas() {
-            const radius = this.getRadius(), canvasSize = this.container.canvas.size, position = this.position;
-            return (position.x >= -radius &&
-                position.y >= -radius &&
-                position.y <= canvasSize.height + radius &&
-                position.x <= canvasSize.width + radius);
-        }
-        isShowingBack() {
-            if (!this.roll) {
-                return false;
-            }
-            const angle = this.roll.angle;
-            if (this.roll.horizontal && this.roll.vertical) {
-                const normalizedAngle = angle % Constants_js_1.doublePI, adjustedAngle = normalizedAngle < Constants_js_1.defaultAngle ? normalizedAngle + Constants_js_1.doublePI : normalizedAngle;
-                return adjustedAngle >= Math.PI * Constants_js_1.half && adjustedAngle < Math.PI * Constants_js_1.triple * Constants_js_1.half;
-            }
-            if (this.roll.horizontal) {
-                const normalizedAngle = (angle + Math.PI * Constants_js_1.half) % (Math.PI * Constants_js_1.double), adjustedAngle = normalizedAngle < Constants_js_1.defaultAngle ? normalizedAngle + Math.PI * Constants_js_1.double : normalizedAngle;
-                return adjustedAngle >= Math.PI && adjustedAngle < Math.PI * Constants_js_1.double;
-            }
-            if (this.roll.vertical) {
-                const normalizedAngle = angle % (Math.PI * Constants_js_1.double), adjustedAngle = normalizedAngle < Constants_js_1.defaultAngle ? normalizedAngle + Math.PI * Constants_js_1.double : normalizedAngle;
-                return adjustedAngle >= Math.PI && adjustedAngle < Math.PI * Constants_js_1.double;
-            }
-            return false;
-        }
-        isVisible() {
-            return !this.destroyed && !this.spawning && this.isInsideCanvas();
-        }
-        reset() {
-            for (const updater of this.container.particles.updaters) {
-                updater.reset?.(this);
-            }
-        }
-        _calcPosition = (position, zIndex) => {
-            let tryCount = Constants_js_1.defaultRetryCount, posVec = position ? Vectors_js_1.Vector3d.create(position.x, position.y, zIndex) : undefined;
-            const container = this.container, plugins = container.particlePositionPlugins, outModes = this.options.move.outModes, radius = this.getRadius(), canvasSize = container.canvas.size, abortController = new AbortController(), { signal } = abortController;
-            while (!signal.aborted) {
-                for (const plugin of plugins) {
-                    const pluginPos = plugin.particlePosition?.(posVec, this);
-                    if (pluginPos) {
-                        return Vectors_js_1.Vector3d.create(pluginPos.x, pluginPos.y, zIndex);
-                    }
-                }
-                const exactPosition = (0, MathUtils_js_1.calcExactPositionOrRandomFromSize)({
-                    size: canvasSize,
-                    position: posVec,
-                }), pos = Vectors_js_1.Vector3d.create(exactPosition.x, exactPosition.y, zIndex);
-                this._fixHorizontal(pos, radius, outModes.left ?? outModes.default);
-                this._fixHorizontal(pos, radius, outModes.right ?? outModes.default);
-                this._fixVertical(pos, radius, outModes.top ?? outModes.default);
-                this._fixVertical(pos, radius, outModes.bottom ?? outModes.default);
-                let isValidPosition = true;
-                for (const plugin of container.particles.checkParticlePositionPlugins) {
-                    isValidPosition = plugin.checkParticlePosition?.(this, pos, tryCount) ?? true;
-                    if (!isValidPosition) {
-                        break;
-                    }
-                }
-                if (isValidPosition) {
-                    return pos;
-                }
-                tryCount += Constants_js_1.tryCountIncrement;
-                posVec = undefined;
-            }
-            return posVec;
-        };
-        _calculateVelocity = () => {
-            const baseVelocity = (0, MathUtils_js_1.getParticleBaseVelocity)(this.direction), res = baseVelocity.copy(), moveOptions = this.options.move;
-            if (moveOptions.direction === MoveDirection_js_1.MoveDirection.inside || moveOptions.direction === MoveDirection_js_1.MoveDirection.outside) {
-                return res;
-            }
-            const rad = (0, MathUtils_js_1.degToRad)((0, MathUtils_js_1.getRangeValue)(moveOptions.angle.value)), radOffset = (0, MathUtils_js_1.degToRad)((0, MathUtils_js_1.getRangeValue)(moveOptions.angle.offset)), range = {
-                left: radOffset - rad * Constants_js_1.half,
-                right: radOffset + rad * Constants_js_1.half,
-            };
-            if (!moveOptions.straight) {
-                res.angle += (0, MathUtils_js_1.randomInRangeValue)((0, MathUtils_js_1.setRangeValue)(range.left, range.right));
-            }
-            if (moveOptions.random && typeof moveOptions.speed === "number") {
-                res.length *= (0, MathUtils_js_1.getRandom)();
-            }
-            return res;
-        };
-        _fixHorizontal = (pos, radius, outMode) => {
-            fixOutMode({
-                outMode,
-                checkModes: [OutMode_js_1.OutMode.bounce],
-                coord: pos.x,
-                maxCoord: this.container.canvas.size.width,
-                setCb: (value) => (pos.x += value),
-                radius,
-            });
-        };
-        _fixVertical = (pos, radius, outMode) => {
-            fixOutMode({
-                outMode,
-                checkModes: [OutMode_js_1.OutMode.bounce],
-                coord: pos.y,
-                maxCoord: this.container.canvas.size.height,
-                setCb: (value) => (pos.y += value),
-                radius,
-            });
-        };
-        _getRollColor = color => {
-            if (!color || !this.roll || (!this.backColor && !this.roll.alter)) {
-                return color;
-            }
-            if (!this.isShowingBack()) {
-                return color;
-            }
-            if (this.backColor) {
-                return this.backColor;
-            }
-            if (this.roll.alter) {
-                return (0, ColorUtils_js_1.alterHsl)(color, this.roll.alter.type, this.roll.alter.value);
-            }
-            return color;
-        };
-        _initPosition = position => {
-            const container = this.container, zIndexValue = (0, MathUtils_js_1.getRangeValue)(this.options.zIndex.value), initialPosition = this._calcPosition(position, (0, MathUtils_js_1.clamp)(zIndexValue, Constants_js_1.minZ, container.zLayers));
-            if (!initialPosition) {
-                throw new Error("a valid position cannot be found for particle");
-            }
-            this.position = initialPosition;
-            this.initialPosition = this.position.copy();
-            const canvasSize = container.canvas.size;
-            this.moveCenter = {
-                ...(0, Utils_js_1.getPosition)(this.options.move.center, canvasSize),
-                radius: this.options.move.center.radius,
-                mode: this.options.move.center.mode,
-            };
-            this.direction = (0, MathUtils_js_1.getParticleDirectionAngle)(this.options.move.direction, this.position, this.moveCenter);
-            switch (this.options.move.direction) {
-                case MoveDirection_js_1.MoveDirection.inside:
-                    this.outType = ParticleOutType_js_1.ParticleOutType.inside;
-                    break;
-                case MoveDirection_js_1.MoveDirection.outside:
-                    this.outType = ParticleOutType_js_1.ParticleOutType.outside;
-                    break;
-                default:
-                    break;
-            }
-            this.offset = Vectors_js_1.Vector.origin;
-        };
-    }
-    exports.Particle = Particle;
-});