@tsparticles/plugin-polygon-mask 3.0.0-alpha.0

package/umd/Options/Classes/PolygonMaskLocalSvg.js

@@ -0,0 +1,39 @@
+(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"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.PolygonMaskLocalSvg = void 0;
+    class PolygonMaskLocalSvg {
+        constructor() {
+            this.path = [];
+            this.size = {
+                height: 0,
+                width: 0,
+            };
+        }
+        load(data) {
+            if (!data) {
+                return;
+            }
+            if (data.path !== undefined) {
+                this.path = data.path;
+            }
+            if (data.size !== undefined) {
+                if (data.size.width !== undefined) {
+                    this.size.width = data.size.width;
+                }
+                if (data.size.height !== undefined) {
+                    this.size.height = data.size.height;
+                }
+            }
+        }
+    }
+    exports.PolygonMaskLocalSvg = PolygonMaskLocalSvg;
+});

package/umd/Options/Classes/PolygonMaskMove.js

@@ -0,0 +1,31 @@
+(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"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.PolygonMaskMove = void 0;
+    class PolygonMaskMove {
+        constructor() {
+            this.radius = 10;
+            this.type = "path";
+        }
+        load(data) {
+            if (!data) {
+                return;
+            }
+            if (data.radius !== undefined) {
+                this.radius = data.radius;
+            }
+            if (data.type !== undefined) {
+                this.type = data.type;
+            }
+        }
+    }
+    exports.PolygonMaskMove = PolygonMaskMove;
+});

package/umd/Options/Interfaces/IPolygonMask.js

@@ -0,0 +1,12 @@
+(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"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/umd/Options/Interfaces/IPolygonMaskDraw.js

@@ -0,0 +1,12 @@
+(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"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/umd/Options/Interfaces/IPolygonMaskDrawStroke.js

@@ -0,0 +1,12 @@
+(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"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/umd/Options/Interfaces/IPolygonMaskInline.js

@@ -0,0 +1,12 @@
+(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"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/umd/Options/Interfaces/IPolygonMaskLocalSvg.js

@@ -0,0 +1,12 @@
+(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"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/umd/Options/Interfaces/IPolygonMaskMove.js

@@ -0,0 +1,12 @@
+(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"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+});

package/umd/PolygonMaskInstance.js

@@ -0,0 +1,402 @@
+(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", "@tsparticles/engine"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.PolygonMaskInstance = void 0;
+    const utils_1 = require("./utils");
+    const engine_1 = require("@tsparticles/engine");
+    const noPolygonDataLoaded = "No polygon data loaded.", noPolygonFound = "No polygon found, you need to specify SVG url in config.";
+    class PolygonMaskInstance {
+        constructor(container, engine) {
+            this._container = container;
+            this._engine = engine;
+            this.dimension = {
+                height: 0,
+                width: 0,
+            };
+            this._moveRadius = 0;
+            this._scale = 1;
+        }
+        clickPositionValid(position) {
+            const options = this._container.actualOptions.polygon;
+            return (!!(options === null || options === void 0 ? void 0 : options.enable) &&
+                options.type !== "none" &&
+                options.type !== "inline" &&
+                this.checkInsidePolygon(position));
+        }
+        draw(context) {
+            var _a;
+            if (!((_a = this.paths) === null || _a === void 0 ? void 0 : _a.length)) {
+                return;
+            }
+            const options = this._container.actualOptions.polygon;
+            if (!(options === null || options === void 0 ? void 0 : options.enable)) {
+                return;
+            }
+            const polygonDraw = options.draw;
+            if (!polygonDraw.enable) {
+                return;
+            }
+            const rawData = this.raw;
+            for (const path of this.paths) {
+                const path2d = path.path2d;
+                if (!context) {
+                    continue;
+                }
+                if (path2d && this.offset) {
+                    (0, utils_1.drawPolygonMaskPath)(context, path2d, polygonDraw.stroke, this.offset);
+                }
+                else if (rawData) {
+                    (0, utils_1.drawPolygonMask)(context, rawData, polygonDraw.stroke);
+                }
+            }
+        }
+        async init() {
+            const container = this._container, polygonMaskOptions = container.actualOptions.polygon, pxRatio = container.retina.pixelRatio;
+            if (!polygonMaskOptions) {
+                return;
+            }
+            this._moveRadius = polygonMaskOptions.move.radius * pxRatio;
+            this._scale = polygonMaskOptions.scale * pxRatio;
+            if (polygonMaskOptions.enable) {
+                await this.initRawData();
+            }
+        }
+        particleBounce(particle, delta, direction) {
+            return this.polygonBounce(particle, delta, direction);
+        }
+        particlePosition(position) {
+            var _a, _b;
+            const options = this._container.actualOptions.polygon;
+            if (!((options === null || options === void 0 ? void 0 : options.enable) && ((_b = (_a = this.raw) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) > 0)) {
+                return;
+            }
+            return (0, engine_1.deepExtend)({}, position ? position : this.randomPoint());
+        }
+        particlesInitialization() {
+            const options = this._container.actualOptions.polygon;
+            if ((options === null || options === void 0 ? void 0 : options.enable) &&
+                options.type === "inline" &&
+                (options.inline.arrangement === "one-per-point" ||
+                    options.inline.arrangement === "per-point")) {
+                this.drawPoints();
+                return true;
+            }
+            return false;
+        }
+        resize() {
+            const container = this._container, options = container.actualOptions.polygon;
+            if (!((options === null || options === void 0 ? void 0 : options.enable) && options.type !== "none")) {
+                return;
+            }
+            if (this.redrawTimeout) {
+                clearTimeout(this.redrawTimeout);
+            }
+            this.redrawTimeout = window.setTimeout(async () => {
+                await this.initRawData(true);
+                await container.particles.redraw();
+            }, 250);
+        }
+        stop() {
+            delete this.raw;
+            delete this.paths;
+        }
+        checkInsidePolygon(position) {
+            var _a, _b;
+            const container = this._container, options = container.actualOptions.polygon;
+            if (!(options === null || options === void 0 ? void 0 : options.enable) || options.type === "none" || options.type === "inline") {
+                return true;
+            }
+            if (!this.raw) {
+                throw new Error(noPolygonFound);
+            }
+            const canvasSize = container.canvas.size, x = (_a = position === null || position === void 0 ? void 0 : position.x) !== null && _a !== void 0 ? _a : (0, engine_1.getRandom)() * canvasSize.width, y = (_b = position === null || position === void 0 ? void 0 : position.y) !== null && _b !== void 0 ? _b : (0, engine_1.getRandom)() * canvasSize.height;
+            let inside = false;
+            for (let i = 0, j = this.raw.length - 1; i < this.raw.length; j = i++) {
+                const pi = this.raw[i], pj = this.raw[j], intersect = pi.y > y !== pj.y > y && x < ((pj.x - pi.x) * (y - pi.y)) / (pj.y - pi.y) + pi.x;
+                if (intersect) {
+                    inside = !inside;
+                }
+            }
+            return options.type === "inside"
+                ? inside
+                : options.type === "outside"
+                    ? !inside
+                    : false;
+        }
+        createPath2D() {
+            var _a, _b;
+            const container = this._container, options = container.actualOptions.polygon;
+            if (!options || !((_a = this.paths) === null || _a === void 0 ? void 0 : _a.length)) {
+                return;
+            }
+            for (const path of this.paths) {
+                const pathData = (_b = path.element) === null || _b === void 0 ? void 0 : _b.getAttribute("d");
+                if (pathData) {
+                    const path2d = new Path2D(pathData), matrix = document.createElementNS("http://www.w3.org/2000/svg", "svg").createSVGMatrix(), finalPath = new Path2D(), transform = matrix.scale(this._scale);
+                    if (finalPath.addPath) {
+                        finalPath.addPath(path2d, transform);
+                        path.path2d = finalPath;
+                    }
+                    else {
+                        delete path.path2d;
+                    }
+                }
+                else {
+                    delete path.path2d;
+                }
+                if (path.path2d || !this.raw) {
+                    continue;
+                }
+                path.path2d = new Path2D();
+                path.path2d.moveTo(this.raw[0].x, this.raw[0].y);
+                this.raw.forEach((pos, i) => {
+                    var _a;
+                    if (i > 0) {
+                        (_a = path.path2d) === null || _a === void 0 ? void 0 : _a.lineTo(pos.x, pos.y);
+                    }
+                });
+                path.path2d.closePath();
+            }
+        }
+        async downloadSvgPath(svgUrl, force) {
+            const options = this._container.actualOptions.polygon;
+            if (!options) {
+                return;
+            }
+            const url = svgUrl || options.url, forceDownload = force !== null && force !== void 0 ? force : false;
+            if (!url || (this.paths !== undefined && !forceDownload)) {
+                return this.raw;
+            }
+            const req = await fetch(url);
+            if (!req.ok) {
+                throw new Error("tsParticles Error - Error occurred during polygon mask download");
+            }
+            return this.parseSvgPath(await req.text(), force);
+        }
+        drawPoints() {
+            if (!this.raw) {
+                return;
+            }
+            for (const item of this.raw) {
+                this._container.particles.addParticle({
+                    x: item.x,
+                    y: item.y,
+                });
+            }
+        }
+        getEquidistantPointByIndex(index) {
+            var _a, _b, _c, _d, _e, _f, _g;
+            const container = this._container, options = container.actualOptions, polygonMaskOptions = options.polygon;
+            if (!polygonMaskOptions) {
+                return;
+            }
+            if (!this.raw || !this.raw.length || !((_a = this.paths) === null || _a === void 0 ? void 0 : _a.length))
+                throw new Error(noPolygonDataLoaded);
+            let offset = 0, point;
+            const totalLength = this.paths.reduce((tot, path) => tot + path.length, 0), distance = totalLength / options.particles.number.value;
+            for (const path of this.paths) {
+                const pathDistance = distance * index - offset;
+                if (pathDistance <= path.length) {
+                    point = path.element.getPointAtLength(pathDistance);
+                    break;
+                }
+                else {
+                    offset += path.length;
+                }
+            }
+            const scale = this._scale;
+            return {
+                x: ((_b = point === null || point === void 0 ? void 0 : point.x) !== null && _b !== void 0 ? _b : 0) * scale + ((_d = (_c = this.offset) === null || _c === void 0 ? void 0 : _c.x) !== null && _d !== void 0 ? _d : 0),
+                y: ((_e = point === null || point === void 0 ? void 0 : point.y) !== null && _e !== void 0 ? _e : 0) * scale + ((_g = (_f = this.offset) === null || _f === void 0 ? void 0 : _f.y) !== null && _g !== void 0 ? _g : 0),
+            };
+        }
+        getPointByIndex(index) {
+            if (!this.raw || !this.raw.length) {
+                throw new Error(noPolygonDataLoaded);
+            }
+            const coords = this.raw[index % this.raw.length];
+            return {
+                x: coords.x,
+                y: coords.y,
+            };
+        }
+        getRandomPoint() {
+            if (!this.raw || !this.raw.length) {
+                throw new Error(noPolygonDataLoaded);
+            }
+            const coords = (0, engine_1.itemFromArray)(this.raw);
+            return {
+                x: coords.x,
+                y: coords.y,
+            };
+        }
+        getRandomPointByLength() {
+            var _a, _b, _c;
+            const container = this._container, options = container.actualOptions.polygon;
+            if (!options) {
+                return;
+            }
+            if (!this.raw || !this.raw.length || !((_a = this.paths) === null || _a === void 0 ? void 0 : _a.length)) {
+                throw new Error(noPolygonDataLoaded);
+            }
+            const path = (0, engine_1.itemFromArray)(this.paths), distance = Math.floor((0, engine_1.getRandom)() * path.length) + 1, point = path.element.getPointAtLength(distance), scale = this._scale;
+            return {
+                x: point.x * scale + (((_b = this.offset) === null || _b === void 0 ? void 0 : _b.x) || 0),
+                y: point.y * scale + (((_c = this.offset) === null || _c === void 0 ? void 0 : _c.y) || 0),
+            };
+        }
+        async initRawData(force) {
+            const options = this._container.actualOptions.polygon;
+            if (!options) {
+                return;
+            }
+            if (options.url) {
+                this.raw = await this.downloadSvgPath(options.url, force);
+            }
+            else if (options.data) {
+                const data = options.data;
+                let svg;
+                if (typeof data !== "string") {
+                    const path = data.path instanceof Array
+                        ? data.path.map((t) => `<path d="${t}" />`).join("")
+                        : `<path d="${data.path}" />`;
+                    const namespaces = 'xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"';
+                    svg = `<svg ${namespaces} width="${data.size.width}" height="${data.size.height}">${path}</svg>`;
+                }
+                else {
+                    svg = data;
+                }
+                this.raw = this.parseSvgPath(svg, force);
+            }
+            this.createPath2D();
+            this._engine.dispatchEvent("polygonMaskLoaded", {
+                container: this._container,
+            });
+        }
+        parseSvgPath(xml, force) {
+            var _a, _b, _c;
+            const forceDownload = force !== null && force !== void 0 ? force : false;
+            if (this.paths !== undefined && !forceDownload) {
+                return this.raw;
+            }
+            const container = this._container, options = container.actualOptions.polygon;
+            if (!options) {
+                return;
+            }
+            const parser = new DOMParser(), doc = parser.parseFromString(xml, "image/svg+xml"), svg = doc.getElementsByTagName("svg")[0];
+            let svgPaths = svg.getElementsByTagName("path");
+            if (!svgPaths.length) {
+                svgPaths = doc.getElementsByTagName("path");
+            }
+            this.paths = [];
+            for (let i = 0; i < svgPaths.length; i++) {
+                const path = svgPaths.item(i);
+                if (path) {
+                    this.paths.push({
+                        element: path,
+                        length: path.getTotalLength(),
+                    });
+                }
+            }
+            const scale = this._scale;
+            this.dimension.width = parseFloat((_a = svg.getAttribute("width")) !== null && _a !== void 0 ? _a : "0") * scale;
+            this.dimension.height = parseFloat((_b = svg.getAttribute("height")) !== null && _b !== void 0 ? _b : "0") * scale;
+            const position = (_c = options.position) !== null && _c !== void 0 ? _c : {
+                x: 50,
+                y: 50,
+            };
+            this.offset = {
+                x: (container.canvas.size.width * position.x) / 100 - this.dimension.width / 2,
+                y: (container.canvas.size.height * position.y) / 100 - this.dimension.height / 2,
+            };
+            return (0, utils_1.parsePaths)(this.paths, scale, this.offset);
+        }
+        polygonBounce(particle, _delta, direction) {
+            const options = this._container.actualOptions.polygon;
+            if (!this.raw || !(options === null || options === void 0 ? void 0 : options.enable) || direction !== "top") {
+                return false;
+            }
+            if (options.type === "inside" || options.type === "outside") {
+                let closest, dx, dy;
+                const pos = particle.getPosition(), radius = particle.getRadius();
+                for (let i = 0, j = this.raw.length - 1; i < this.raw.length; j = i++) {
+                    const pi = this.raw[i], pj = this.raw[j];
+                    closest = (0, utils_1.calcClosestPtOnSegment)(pi, pj, pos);
+                    const dist = (0, engine_1.getDistances)(pos, closest);
+                    [dx, dy] = [dist.dx, dist.dy];
+                    if (dist.distance < radius) {
+                        (0, utils_1.segmentBounce)(pi, pj, particle.velocity);
+                        return true;
+                    }
+                }
+                if (closest && dx !== undefined && dy !== undefined && !this.checkInsidePolygon(pos)) {
+                    const factor = { x: 1, y: 1 };
+                    if (particle.position.x >= closest.x) {
+                        factor.x = -1;
+                    }
+                    if (particle.position.y >= closest.y) {
+                        factor.y = -1;
+                    }
+                    particle.position.x = closest.x + radius * 2 * factor.x;
+                    particle.position.y = closest.y + radius * 2 * factor.y;
+                    particle.velocity.mult(-1);
+                    return true;
+                }
+            }
+            else if (options.type === "inline" && particle.initialPosition) {
+                const dist = (0, engine_1.getDistance)(particle.initialPosition, particle.getPosition());
+                if (dist > this._moveRadius) {
+                    particle.velocity.x = particle.velocity.y / 2 - particle.velocity.x;
+                    particle.velocity.y = particle.velocity.x / 2 - particle.velocity.y;
+                    return true;
+                }
+            }
+            return false;
+        }
+        randomPoint() {
+            const container = this._container, options = container.actualOptions.polygon;
+            if (!options) {
+                return;
+            }
+            let position;
+            if (options.type === "inline") {
+                switch (options.inline.arrangement) {
+                    case "random-point":
+                        position = this.getRandomPoint();
+                        break;
+                    case "random-length":
+                        position = this.getRandomPointByLength();
+                        break;
+                    case "equidistant":
+                        position = this.getEquidistantPointByIndex(container.particles.count);
+                        break;
+                    case "one-per-point":
+                    case "per-point":
+                    default:
+                        position = this.getPointByIndex(container.particles.count);
+                }
+            }
+            else {
+                position = {
+                    x: (0, engine_1.getRandom)() * container.canvas.size.width,
+                    y: (0, engine_1.getRandom)() * container.canvas.size.height,
+                };
+            }
+            if (this.checkInsidePolygon(position)) {
+                return position;
+            }
+            else {
+                return this.randomPoint();
+            }
+        }
+    }
+    exports.PolygonMaskInstance = PolygonMaskInstance;
+});

package/umd/index.js

@@ -0,0 +1,61 @@
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+(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", "./pathseg", "./Options/Classes/PolygonMask", "./PolygonMaskInstance", "./Enums/PolygonMaskInlineArrangement", "./Enums/PolygonMaskMoveType", "./Enums/PolygonMaskType"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.loadPolygonMaskPlugin = void 0;
+    require("./pathseg");
+    const PolygonMask_1 = require("./Options/Classes/PolygonMask");
+    const PolygonMaskInstance_1 = require("./PolygonMaskInstance");
+    class PolygonMaskPlugin {
+        constructor(engine) {
+            this.id = "polygonMask";
+            this._engine = engine;
+        }
+        getPlugin(container) {
+            return new PolygonMaskInstance_1.PolygonMaskInstance(container, this._engine);
+        }
+        loadOptions(options, source) {
+            if (!this.needsPlugin(source)) {
+                return;
+            }
+            let polygonOptions = options.polygon;
+            if ((polygonOptions === null || polygonOptions === void 0 ? void 0 : polygonOptions.load) === undefined) {
+                options.polygon = polygonOptions = new PolygonMask_1.PolygonMask();
+            }
+            polygonOptions.load(source === null || source === void 0 ? void 0 : source.polygon);
+        }
+        needsPlugin(options) {
+            var _a, _b, _c;
+            return ((_b = (_a = options === null || options === void 0 ? void 0 : options.polygon) === null || _a === void 0 ? void 0 : _a.enable) !== null && _b !== void 0 ? _b : (((_c = options === null || options === void 0 ? void 0 : options.polygon) === null || _c === void 0 ? void 0 : _c.type) !== undefined && options.polygon.type !== "none"));
+        }
+    }
+    async function loadPolygonMaskPlugin(engine) {
+        const plugin = new PolygonMaskPlugin(engine);
+        await engine.addPlugin(plugin);
+    }
+    exports.loadPolygonMaskPlugin = loadPolygonMaskPlugin;
+    __exportStar(require("./Enums/PolygonMaskInlineArrangement"), exports);
+    __exportStar(require("./Enums/PolygonMaskMoveType"), exports);
+    __exportStar(require("./Enums/PolygonMaskType"), exports);
+});