@tsparticles/path-fractal-noise 3.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Matteo Bruni
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+[![banner](https://particles.js.org/images/banner3.png)](https://particles.js.org)
+
+# tsParticles Fractal Noise Path
+
+[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/@tsparticles/path-fractal-noise/badge)](https://www.jsdelivr.com/package/npm/@tsparticles/path-fractal-noise)
+[![npmjs](https://badge.fury.io/js/@tsparticles/path-fractal-noise.svg)](https://www.npmjs.com/package/@tsparticles/path-fractal-noise)
+[![npmjs](https://img.shields.io/npm/dt/@tsparticles/path-fractal-noise)](https://www.npmjs.com/package/@tsparticles/path-fractal-noise) [![GitHub Sponsors](https://img.shields.io/github/sponsors/matteobruni)](https://github.com/sponsors/matteobruni)
+
+[tsParticles](https://github.com/tsparticles/tsparticles) path plugin for fractal noise movement.
+
+## How to use it
+
+### CDN / Vanilla JS / jQuery
+
+The CDN/Vanilla version JS has one required file in vanilla configuration:
+
+Including the `tsparticles.path.fractal.noise.min.js` file will export the function to load the path plugin:
+
+```text
+loadFractalNoisePath
+```
+
+### Usage
+
+Once the scripts are loaded you can set up `tsParticles` and the path plugin like this:
+
+```javascript
+(async () => {
+  await loadFractalNoisePath(tsParticles);
+
+  await tsParticles.load({
+    id: "tsparticles",
+    options: {
+      /* options */
+    },
+  });
+})();
+```
+
+### ESM / CommonJS
+
+This package is compatible also with ES or CommonJS modules, firstly this needs to be installed, like this:
+
+```shell
+$ npm install @tsparticles/path-fractal-noise
+```
+
+or
+
+```shell
+$ yarn add @tsparticles/path-fractal-noise
+```
+
+Then you need to import it in the app, like this:
+
+```javascript
+const { tsParticles } = require("@tsparticles/engine");
+const { loadFractalNoisePath } = require("@tsparticles/path-fractal-noise");
+
+(async () => {
+  await loadFractalNoisePath(tsParticles);
+})();
+```
+
+or
+
+```javascript
+import { tsParticles } from "@tsparticles/engine";
+import { loadFractalNoisePath } from "@tsparticles/path-fractal-noise";
+
+(async () => {
+  await loadFractalNoisePath(tsParticles);
+})();
+```

package/browser/FractalNoiseGenerator.js

@@ -0,0 +1,100 @@
+import { Vector, deepExtend, getRandom, } from "@tsparticles/engine";
+import { FractalNoise } from "@tsparticles/fractal-noise";
+const defaultOptions = {
+    size: 20,
+    increment: 0.004,
+    columns: 0,
+    rows: 0,
+    layers: 0,
+    width: 0,
+    height: 0,
+    offset: {
+        x: 40000,
+        y: 40000,
+        z: 40000,
+    },
+};
+export class FractalNoiseGenerator {
+    constructor() {
+        this._fractal = new FractalNoise();
+        this.field = [];
+        this.noiseW = 0;
+        this.options = deepExtend({}, defaultOptions);
+    }
+    generate(particle) {
+        const pos = particle.getPosition(), point = {
+            x: Math.max(Math.floor(pos.x / this.options.size), 0),
+            y: Math.max(Math.floor(pos.y / this.options.size), 0),
+            z: Math.max(Math.floor(pos.z / this.options.size), 0),
+        }, v = Vector.origin;
+        if (!this.field?.[point.x]?.[point.y]?.[point.z]) {
+            return v;
+        }
+        v.setTo(this.field[point.x][point.y][point.z]);
+        return v;
+    }
+    init(container) {
+        this.container = container;
+        this._setup();
+    }
+    reset() {
+    }
+    update() {
+        if (!this.container) {
+            return;
+        }
+        this._calculateField();
+        this.noiseW += this.options.increment;
+    }
+    _calculateField() {
+        const options = this.options;
+        for (let x = 0; x < options.columns; x++) {
+            for (let y = 0; y < options.rows; y++) {
+                for (let z = 0; z < options.layers; z++) {
+                    this.field[x][y][z].angle =
+                        this._fractal.noise4d(x / 50, y / 50, z / 50, this.noiseW) * Math.PI * 2;
+                    this.field[x][y][z].length = this._fractal.noise4d(x / 100 + options.offset.x, y / 100 + options.offset.y, z / 100 + options.offset.z, this.noiseW);
+                }
+            }
+        }
+    }
+    _initField() {
+        this.field = new Array(this.options.columns);
+        for (let x = 0; x < this.options.columns; x++) {
+            this.field[x] = new Array(this.options.rows);
+            for (let y = 0; y < this.options.rows; y++) {
+                this.field[x][y] = new Array(this.options.layers);
+                for (let z = 0; z < this.options.layers; z++) {
+                    this.field[x][y][z] = Vector.origin;
+                }
+            }
+        }
+    }
+    _resetField() {
+        const container = this.container;
+        if (!container) {
+            return;
+        }
+        const sourceOptions = container.actualOptions.particles.move.path.options;
+        this.options.size = sourceOptions.size > 0 ? sourceOptions.size : defaultOptions.size;
+        this.options.increment =
+            sourceOptions.increment > 0 ? sourceOptions.increment : defaultOptions.increment;
+        this.options.width = container.canvas.size.width;
+        this.options.height = container.canvas.size.height;
+        const offset = sourceOptions.offset;
+        this.options.offset.x = offset?.x ?? defaultOptions.offset.x;
+        this.options.offset.y = offset?.y ?? defaultOptions.offset.y;
+        this.options.offset.z = offset?.z ?? defaultOptions.offset.z;
+        this.options.seed = sourceOptions.seed;
+        this._fractal.seed(this.options.seed ?? getRandom());
+        this.options.columns = Math.floor(this.options.width / this.options.size) + 1;
+        this.options.rows = Math.floor(this.options.height / this.options.size) + 1;
+        this.options.layers = Math.floor(container.zLayers / this.options.size) + 1;
+        this._initField();
+    }
+    _setup() {
+        this.noiseW = 0;
+        this._resetField();
+        addEventListener("resize", () => this._resetField());
+    }
+}

package/browser/IFractalOptions.js

@@ -0,0 +1 @@
+export {};

package/browser/IOffsetValues.js

@@ -0,0 +1 @@
+export {};

package/browser/index.js

@@ -0,0 +1,6 @@
+import { FractalNoiseGenerator } from "./FractalNoiseGenerator.js";
+export const fractalNoisePathName = "fractalNoise";
+export async function loadFractalNoisePath(engine, refresh = true) {
+    engine.checkVersion("3.9.0");
+    await engine.addPathGenerator(fractalNoisePathName, new FractalNoiseGenerator(), refresh);
+}

package/browser/package.json

@@ -0,0 +1 @@
+{ "type": "module" }

package/cjs/FractalNoiseGenerator.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FractalNoiseGenerator = void 0;
+const engine_1 = require("@tsparticles/engine");
+const fractal_noise_1 = require("@tsparticles/fractal-noise");
+const defaultOptions = {
+    size: 20,
+    increment: 0.004,
+    columns: 0,
+    rows: 0,
+    layers: 0,
+    width: 0,
+    height: 0,
+    offset: {
+        x: 40000,
+        y: 40000,
+        z: 40000,
+    },
+};
+class FractalNoiseGenerator {
+    constructor() {
+        this._fractal = new fractal_noise_1.FractalNoise();
+        this.field = [];
+        this.noiseW = 0;
+        this.options = (0, engine_1.deepExtend)({}, defaultOptions);
+    }
+    generate(particle) {
+        const pos = particle.getPosition(), point = {
+            x: Math.max(Math.floor(pos.x / this.options.size), 0),
+            y: Math.max(Math.floor(pos.y / this.options.size), 0),
+            z: Math.max(Math.floor(pos.z / this.options.size), 0),
+        }, v = engine_1.Vector.origin;
+        if (!this.field?.[point.x]?.[point.y]?.[point.z]) {
+            return v;
+        }
+        v.setTo(this.field[point.x][point.y][point.z]);
+        return v;
+    }
+    init(container) {
+        this.container = container;
+        this._setup();
+    }
+    reset() {
+    }
+    update() {
+        if (!this.container) {
+            return;
+        }
+        this._calculateField();
+        this.noiseW += this.options.increment;
+    }
+    _calculateField() {
+        const options = this.options;
+        for (let x = 0; x < options.columns; x++) {
+            for (let y = 0; y < options.rows; y++) {
+                for (let z = 0; z < options.layers; z++) {
+                    this.field[x][y][z].angle =
+                        this._fractal.noise4d(x / 50, y / 50, z / 50, this.noiseW) * Math.PI * 2;
+                    this.field[x][y][z].length = this._fractal.noise4d(x / 100 + options.offset.x, y / 100 + options.offset.y, z / 100 + options.offset.z, this.noiseW);
+                }
+            }
+        }
+    }
+    _initField() {
+        this.field = new Array(this.options.columns);
+        for (let x = 0; x < this.options.columns; x++) {
+            this.field[x] = new Array(this.options.rows);
+            for (let y = 0; y < this.options.rows; y++) {
+                this.field[x][y] = new Array(this.options.layers);
+                for (let z = 0; z < this.options.layers; z++) {
+                    this.field[x][y][z] = engine_1.Vector.origin;
+                }
+            }
+        }
+    }
+    _resetField() {
+        const container = this.container;
+        if (!container) {
+            return;
+        }
+        const sourceOptions = container.actualOptions.particles.move.path.options;
+        this.options.size = sourceOptions.size > 0 ? sourceOptions.size : defaultOptions.size;
+        this.options.increment =
+            sourceOptions.increment > 0 ? sourceOptions.increment : defaultOptions.increment;
+        this.options.width = container.canvas.size.width;
+        this.options.height = container.canvas.size.height;
+        const offset = sourceOptions.offset;
+        this.options.offset.x = offset?.x ?? defaultOptions.offset.x;
+        this.options.offset.y = offset?.y ?? defaultOptions.offset.y;
+        this.options.offset.z = offset?.z ?? defaultOptions.offset.z;
+        this.options.seed = sourceOptions.seed;
+        this._fractal.seed(this.options.seed ?? (0, engine_1.getRandom)());
+        this.options.columns = Math.floor(this.options.width / this.options.size) + 1;
+        this.options.rows = Math.floor(this.options.height / this.options.size) + 1;
+        this.options.layers = Math.floor(container.zLayers / this.options.size) + 1;
+        this._initField();
+    }
+    _setup() {
+        this.noiseW = 0;
+        this._resetField();
+        addEventListener("resize", () => this._resetField());
+    }
+}
+exports.FractalNoiseGenerator = FractalNoiseGenerator;

package/cjs/IFractalOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/IOffsetValues.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fractalNoisePathName = void 0;
+exports.loadFractalNoisePath = loadFractalNoisePath;
+const FractalNoiseGenerator_js_1 = require("./FractalNoiseGenerator.js");
+exports.fractalNoisePathName = "fractalNoise";
+async function loadFractalNoisePath(engine, refresh = true) {
+    engine.checkVersion("3.9.0");
+    await engine.addPathGenerator(exports.fractalNoisePathName, new FractalNoiseGenerator_js_1.FractalNoiseGenerator(), refresh);
+}

package/cjs/package.json

@@ -0,0 +1 @@
+{ "type": "commonjs" }

package/esm/FractalNoiseGenerator.js

@@ -0,0 +1,100 @@
+import { Vector, deepExtend, getRandom, } from "@tsparticles/engine";
+import { FractalNoise } from "@tsparticles/fractal-noise";
+const defaultOptions = {
+    size: 20,
+    increment: 0.004,
+    columns: 0,
+    rows: 0,
+    layers: 0,
+    width: 0,
+    height: 0,
+    offset: {
+        x: 40000,
+        y: 40000,
+        z: 40000,
+    },
+};
+export class FractalNoiseGenerator {
+    constructor() {
+        this._fractal = new FractalNoise();
+        this.field = [];
+        this.noiseW = 0;
+        this.options = deepExtend({}, defaultOptions);
+    }
+    generate(particle) {
+        const pos = particle.getPosition(), point = {
+            x: Math.max(Math.floor(pos.x / this.options.size), 0),
+            y: Math.max(Math.floor(pos.y / this.options.size), 0),
+            z: Math.max(Math.floor(pos.z / this.options.size), 0),
+        }, v = Vector.origin;
+        if (!this.field?.[point.x]?.[point.y]?.[point.z]) {
+            return v;
+        }
+        v.setTo(this.field[point.x][point.y][point.z]);
+        return v;
+    }
+    init(container) {
+        this.container = container;
+        this._setup();
+    }
+    reset() {
+    }
+    update() {
+        if (!this.container) {
+            return;
+        }
+        this._calculateField();
+        this.noiseW += this.options.increment;
+    }
+    _calculateField() {
+        const options = this.options;
+        for (let x = 0; x < options.columns; x++) {
+            for (let y = 0; y < options.rows; y++) {
+                for (let z = 0; z < options.layers; z++) {
+                    this.field[x][y][z].angle =
+                        this._fractal.noise4d(x / 50, y / 50, z / 50, this.noiseW) * Math.PI * 2;
+                    this.field[x][y][z].length = this._fractal.noise4d(x / 100 + options.offset.x, y / 100 + options.offset.y, z / 100 + options.offset.z, this.noiseW);
+                }
+            }
+        }
+    }
+    _initField() {
+        this.field = new Array(this.options.columns);
+        for (let x = 0; x < this.options.columns; x++) {
+            this.field[x] = new Array(this.options.rows);
+            for (let y = 0; y < this.options.rows; y++) {
+                this.field[x][y] = new Array(this.options.layers);
+                for (let z = 0; z < this.options.layers; z++) {
+                    this.field[x][y][z] = Vector.origin;
+                }
+            }
+        }
+    }
+    _resetField() {
+        const container = this.container;
+        if (!container) {
+            return;
+        }
+        const sourceOptions = container.actualOptions.particles.move.path.options;
+        this.options.size = sourceOptions.size > 0 ? sourceOptions.size : defaultOptions.size;
+        this.options.increment =
+            sourceOptions.increment > 0 ? sourceOptions.increment : defaultOptions.increment;
+        this.options.width = container.canvas.size.width;
+        this.options.height = container.canvas.size.height;
+        const offset = sourceOptions.offset;
+        this.options.offset.x = offset?.x ?? defaultOptions.offset.x;
+        this.options.offset.y = offset?.y ?? defaultOptions.offset.y;
+        this.options.offset.z = offset?.z ?? defaultOptions.offset.z;
+        this.options.seed = sourceOptions.seed;
+        this._fractal.seed(this.options.seed ?? getRandom());
+        this.options.columns = Math.floor(this.options.width / this.options.size) + 1;
+        this.options.rows = Math.floor(this.options.height / this.options.size) + 1;
+        this.options.layers = Math.floor(container.zLayers / this.options.size) + 1;
+        this._initField();
+    }
+    _setup() {
+        this.noiseW = 0;
+        this._resetField();
+        addEventListener("resize", () => this._resetField());
+    }
+}

package/esm/IFractalOptions.js

@@ -0,0 +1 @@
+export {};

package/esm/IOffsetValues.js

@@ -0,0 +1 @@
+export {};

package/esm/index.js

@@ -0,0 +1,6 @@
+import { FractalNoiseGenerator } from "./FractalNoiseGenerator.js";
+export const fractalNoisePathName = "fractalNoise";
+export async function loadFractalNoisePath(engine, refresh = true) {
+    engine.checkVersion("3.9.0");
+    await engine.addPathGenerator(fractalNoisePathName, new FractalNoiseGenerator(), refresh);
+}

package/esm/package.json

@@ -0,0 +1 @@
+{ "type": "module" }

package/package.json

@@ -0,0 +1,110 @@
+{
+  "name": "@tsparticles/path-fractal-noise",
+  "version": "3.9.0",
+  "description": "tsParticles fractal noise path",
+  "homepage": "https://particles.js.org",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tsparticles/tsparticles.git",
+    "directory": "paths/fractalNoise"
+  },
+  "keywords": [
+    "front-end",
+    "frontend",
+    "tsparticles",
+    "particles.js",
+    "particlesjs",
+    "particles",
+    "particle",
+    "canvas",
+    "jsparticles",
+    "xparticles",
+    "particles-js",
+    "particles-bg",
+    "particles-bg-vue",
+    "particles-ts",
+    "particles.ts",
+    "react-particles-js",
+    "react-particles.js",
+    "react-particles",
+    "react",
+    "reactjs",
+    "vue-particles",
+    "ngx-particles",
+    "angular-particles",
+    "particleground",
+    "vue",
+    "vuejs",
+    "preact",
+    "preactjs",
+    "jquery",
+    "angularjs",
+    "angular",
+    "typescript",
+    "javascript",
+    "animation",
+    "web",
+    "html5",
+    "web-design",
+    "webdesign",
+    "css",
+    "html",
+    "css3",
+    "animated",
+    "background",
+    "confetti",
+    "canvas",
+    "fireworks",
+    "fireworks-js",
+    "confetti-js",
+    "confettijs",
+    "fireworksjs",
+    "canvas-confetti",
+    "tsparticles-plugin",
+    "tsparticles-path"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Matteo Bruni <matteo.bruni@me.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/tsparticles/tsparticles/issues"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/matteobruni"
+    },
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/tsparticles"
+    },
+    {
+      "type": "buymeacoffee",
+      "url": "https://www.buymeacoffee.com/matteobruni"
+    }
+  ],
+  "sideEffects": false,
+  "jsdelivr": "tsparticles.path.fractal.noise.min.js",
+  "unpkg": "tsparticles.path.fractal.noise.min.js",
+  "browser": "browser/index.js",
+  "main": "cjs/index.js",
+  "module": "esm/index.js",
+  "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "browser": "./browser/index.js",
+      "import": "./esm/index.js",
+      "require": "./cjs/index.js",
+      "umd": "./umd/index.js",
+      "default": "./cjs/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@tsparticles/engine": "3.9.0",
+    "@tsparticles/fractal-noise": "3.9.0"
+  }
+}