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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +70 -0
  3. package/browser/CanvasMaskInstance.js +46 -0
  4. package/browser/Options/Classes/CanvasMask.js +54 -0
  5. package/browser/Options/Classes/CanvasMaskOverride.js +17 -0
  6. package/browser/Options/Classes/CanvasMaskPixels.js +27 -0
  7. package/browser/Options/Classes/FontTextMask.js +26 -0
  8. package/browser/Options/Classes/ImageMask.js +13 -0
  9. package/browser/Options/Classes/TextMask.js +23 -0
  10. package/browser/Options/Classes/TextMaskLine.js +17 -0
  11. package/browser/Options/Interfaces/ICanvasMask.js +1 -0
  12. package/browser/Options/Interfaces/ICanvasMaskOverride.js +1 -0
  13. package/browser/Options/Interfaces/ICanvasMaskPixels.js +1 -0
  14. package/browser/Options/Interfaces/IFontTextMask.js +1 -0
  15. package/browser/Options/Interfaces/IImageMask.js +1 -0
  16. package/browser/Options/Interfaces/ITextMask.js +1 -0
  17. package/browser/Options/Interfaces/ITextMaskLine.js +1 -0
  18. package/browser/index.js +29 -0
  19. package/browser/types.js +1 -0
  20. package/browser/utils.js +119 -0
  21. package/cjs/CanvasMaskInstance.js +61 -0
  22. package/cjs/Options/Classes/CanvasMask.js +58 -0
  23. package/cjs/Options/Classes/CanvasMaskOverride.js +21 -0
  24. package/cjs/Options/Classes/CanvasMaskPixels.js +31 -0
  25. package/cjs/Options/Classes/FontTextMask.js +30 -0
  26. package/cjs/Options/Classes/ImageMask.js +17 -0
  27. package/cjs/Options/Classes/TextMask.js +27 -0
  28. package/cjs/Options/Classes/TextMaskLine.js +21 -0
  29. package/cjs/Options/Interfaces/ICanvasMask.js +2 -0
  30. package/cjs/Options/Interfaces/ICanvasMaskOverride.js +2 -0
  31. package/cjs/Options/Interfaces/ICanvasMaskPixels.js +2 -0
  32. package/cjs/Options/Interfaces/IFontTextMask.js +2 -0
  33. package/cjs/Options/Interfaces/IImageMask.js +2 -0
  34. package/cjs/Options/Interfaces/ITextMask.js +2 -0
  35. package/cjs/Options/Interfaces/ITextMaskLine.js +2 -0
  36. package/cjs/index.js +44 -0
  37. package/cjs/types.js +2 -0
  38. package/cjs/utils.js +128 -0
  39. package/esm/CanvasMaskInstance.js +46 -0
  40. package/esm/Options/Classes/CanvasMask.js +54 -0
  41. package/esm/Options/Classes/CanvasMaskOverride.js +17 -0
  42. package/esm/Options/Classes/CanvasMaskPixels.js +27 -0
  43. package/esm/Options/Classes/FontTextMask.js +26 -0
  44. package/esm/Options/Classes/ImageMask.js +13 -0
  45. package/esm/Options/Classes/TextMask.js +23 -0
  46. package/esm/Options/Classes/TextMaskLine.js +17 -0
  47. package/esm/Options/Interfaces/ICanvasMask.js +1 -0
  48. package/esm/Options/Interfaces/ICanvasMaskOverride.js +1 -0
  49. package/esm/Options/Interfaces/ICanvasMaskPixels.js +1 -0
  50. package/esm/Options/Interfaces/IFontTextMask.js +1 -0
  51. package/esm/Options/Interfaces/IImageMask.js +1 -0
  52. package/esm/Options/Interfaces/ITextMask.js +1 -0
  53. package/esm/Options/Interfaces/ITextMaskLine.js +1 -0
  54. package/esm/index.js +29 -0
  55. package/esm/types.js +1 -0
  56. package/esm/utils.js +119 -0
  57. package/package.json +81 -0
  58. package/report.html +39 -0
  59. package/tsparticles.plugin.canvas-mask.js +505 -0
  60. package/tsparticles.plugin.canvas-mask.min.js +2 -0
  61. package/tsparticles.plugin.canvas-mask.min.js.LICENSE.txt +8 -0
  62. package/types/CanvasMaskInstance.d.ts +8 -0
  63. package/types/Options/Classes/CanvasMask.d.ts +19 -0
  64. package/types/Options/Classes/CanvasMaskOverride.d.ts +8 -0
  65. package/types/Options/Classes/CanvasMaskPixels.d.ts +8 -0
  66. package/types/Options/Classes/FontTextMask.d.ts +11 -0
  67. package/types/Options/Classes/ImageMask.d.ts +7 -0
  68. package/types/Options/Classes/TextMask.d.ts +12 -0
  69. package/types/Options/Classes/TextMaskLine.d.ts +8 -0
  70. package/types/Options/Interfaces/ICanvasMask.d.ts +16 -0
  71. package/types/Options/Interfaces/ICanvasMaskOverride.d.ts +4 -0
  72. package/types/Options/Interfaces/ICanvasMaskPixels.d.ts +5 -0
  73. package/types/Options/Interfaces/IFontTextMask.d.ts +7 -0
  74. package/types/Options/Interfaces/IImageMask.d.ts +3 -0
  75. package/types/Options/Interfaces/ITextMask.d.ts +8 -0
  76. package/types/Options/Interfaces/ITextMaskLine.d.ts +4 -0
  77. package/types/index.d.ts +2 -0
  78. package/types/types.d.ts +12 -0
  79. package/types/utils.d.ts +14 -0
  80. package/umd/CanvasMaskInstance.js +60 -0
  81. package/umd/Options/Classes/CanvasMask.js +68 -0
  82. package/umd/Options/Classes/CanvasMaskOverride.js +31 -0
  83. package/umd/Options/Classes/CanvasMaskPixels.js +41 -0
  84. package/umd/Options/Classes/FontTextMask.js +40 -0
  85. package/umd/Options/Classes/ImageMask.js +27 -0
  86. package/umd/Options/Classes/TextMask.js +37 -0
  87. package/umd/Options/Classes/TextMaskLine.js +31 -0
  88. package/umd/Options/Interfaces/ICanvasMask.js +12 -0
  89. package/umd/Options/Interfaces/ICanvasMaskOverride.js +12 -0
  90. package/umd/Options/Interfaces/ICanvasMaskPixels.js +12 -0
  91. package/umd/Options/Interfaces/IFontTextMask.js +12 -0
  92. package/umd/Options/Interfaces/IImageMask.js +12 -0
  93. package/umd/Options/Interfaces/ITextMask.js +12 -0
  94. package/umd/Options/Interfaces/ITextMaskLine.js +12 -0
  95. package/umd/index.js +43 -0
  96. package/umd/types.js +12 -0
  97. package/umd/utils.js +138 -0
package/esm/utils.js ADDED
@@ -0,0 +1,119 @@
1
+ import { getRandom } from "@tsparticles/engine";
2
+ export function shuffle(array) {
3
+ for (let currentIndex = array.length - 1; currentIndex >= 0; currentIndex--) {
4
+ const randomIndex = Math.floor(getRandom() * currentIndex);
5
+ [array[currentIndex], array[randomIndex]] = [array[randomIndex], array[currentIndex]];
6
+ }
7
+ return array;
8
+ }
9
+ export function addParticlesFromCanvasPixels(container, data, position, scale, override, filter) {
10
+ const { height, width } = data, numPixels = height * width, indexArray = shuffle(range(numPixels)), maxParticles = Math.min(numPixels, container.actualOptions.particles.number.value), canvasSize = container.canvas.size;
11
+ let selectedPixels = 0;
12
+ const positionOffset = {
13
+ x: (canvasSize.width * position.x) / 100 - (width * scale) / 2,
14
+ y: (canvasSize.height * position.y) / 100 - (height * scale) / 2,
15
+ };
16
+ while (selectedPixels < maxParticles && indexArray.length) {
17
+ const nextIndex = indexArray.pop() || 0, pixelPos = {
18
+ x: nextIndex % width,
19
+ y: Math.floor(nextIndex / width),
20
+ }, pixel = data.pixels[pixelPos.y][pixelPos.x], shouldCreateParticle = filter(pixel);
21
+ if (shouldCreateParticle) {
22
+ const pos = {
23
+ x: pixelPos.x * scale + positionOffset.x,
24
+ y: pixelPos.y * scale + positionOffset.y,
25
+ };
26
+ const pOptions = {};
27
+ if (override.color) {
28
+ pOptions.color = {
29
+ value: pixel,
30
+ };
31
+ }
32
+ if (override.opacity) {
33
+ pOptions.opacity = {
34
+ value: pixel.a,
35
+ };
36
+ }
37
+ container.particles.addParticle(pos, pOptions);
38
+ selectedPixels++;
39
+ }
40
+ }
41
+ }
42
+ export function getCanvasImageData(ctx, size, offset, clear = true) {
43
+ const imageData = ctx.getImageData(0, 0, size.width, size.height).data;
44
+ if (clear) {
45
+ ctx.clearRect(0, 0, size.width, size.height);
46
+ }
47
+ const pixels = [];
48
+ for (let i = 0; i < imageData.length; i += offset) {
49
+ const idx = i / offset, pos = {
50
+ x: idx % size.width,
51
+ y: Math.floor(idx / size.width),
52
+ };
53
+ if (!pixels[pos.y]) {
54
+ pixels[pos.y] = [];
55
+ }
56
+ pixels[pos.y][pos.x] = {
57
+ r: imageData[i],
58
+ g: imageData[i + 1],
59
+ b: imageData[i + 2],
60
+ a: imageData[i + 3] / 255,
61
+ };
62
+ }
63
+ return {
64
+ pixels,
65
+ width: Math.min(...pixels.map((row) => row.length)),
66
+ height: pixels.length,
67
+ };
68
+ }
69
+ export function getImageData(src, offset) {
70
+ const image = new Image();
71
+ image.crossOrigin = "Anonymous";
72
+ const p = new Promise((resolve, reject) => {
73
+ image.onerror = reject;
74
+ image.onload = () => {
75
+ const canvas = document.createElement("canvas");
76
+ canvas.width = image.width;
77
+ canvas.height = image.height;
78
+ const context = canvas.getContext("2d");
79
+ if (!context) {
80
+ return reject(new Error("Could not get canvas context"));
81
+ }
82
+ context.drawImage(image, 0, 0, image.width, image.height, 0, 0, canvas.width, canvas.height);
83
+ resolve(getCanvasImageData(context, canvas, offset));
84
+ };
85
+ });
86
+ image.src = src;
87
+ return p;
88
+ }
89
+ export function getTextData(textOptions, offset) {
90
+ const canvas = document.createElement("canvas"), context = canvas.getContext("2d"), { font, text, lines: linesOptions, color } = textOptions;
91
+ if (!text || !context) {
92
+ return;
93
+ }
94
+ const lines = text.split(linesOptions.separator), fontSize = typeof font.size === "number" ? `${font.size}px` : font.size, linesData = [];
95
+ let maxWidth = 0, totalHeight = 0;
96
+ for (const line of lines) {
97
+ context.font = `${font.style || ""} ${font.variant || ""} ${font.weight || ""} ${fontSize} ${font.family}`;
98
+ const measure = context.measureText(line), lineData = {
99
+ measure,
100
+ text: line,
101
+ height: measure.actualBoundingBoxAscent + measure.actualBoundingBoxDescent,
102
+ width: measure.width,
103
+ };
104
+ maxWidth = Math.max(maxWidth || 0, lineData.width);
105
+ totalHeight += lineData.height + linesOptions.spacing;
106
+ linesData.push(lineData);
107
+ }
108
+ canvas.width = maxWidth;
109
+ canvas.height = totalHeight;
110
+ let currentHeight = 0;
111
+ for (const line of linesData) {
112
+ context.font = `${font.style || ""} ${font.variant || ""} ${font.weight || ""} ${fontSize} ${font.family}`;
113
+ context.fillStyle = color;
114
+ context.fillText(line.text, 0, currentHeight + line.measure.actualBoundingBoxAscent);
115
+ currentHeight += line.height + linesOptions.spacing;
116
+ }
117
+ return getCanvasImageData(context, canvas, offset);
118
+ }
119
+ export const range = (n) => [...Array(n).keys()];
package/package.json ADDED
@@ -0,0 +1,81 @@
1
+ {
2
+ "name": "@tsparticles/plugin-canvas-mask",
3
+ "version": "3.0.0-alpha.0",
4
+ "description": "tsParticles canvas mask plugin",
5
+ "homepage": "https://particles.js.org",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/matteobruni/tsparticles.git",
9
+ "directory": "plugins/canvasMask"
10
+ },
11
+ "keywords": [
12
+ "front-end",
13
+ "frontend",
14
+ "tsparticles",
15
+ "particles.js",
16
+ "particlesjs",
17
+ "particles",
18
+ "particle",
19
+ "canvas",
20
+ "jsparticles",
21
+ "xparticles",
22
+ "particles-js",
23
+ "particles-bg",
24
+ "particles-bg-vue",
25
+ "particles-ts",
26
+ "particles.ts",
27
+ "react-particles-js",
28
+ "react-particles.js",
29
+ "react-particles",
30
+ "react",
31
+ "reactjs",
32
+ "vue-particles",
33
+ "ngx-particles",
34
+ "angular-particles",
35
+ "particleground",
36
+ "vue",
37
+ "vuejs",
38
+ "preact",
39
+ "preactjs",
40
+ "jquery",
41
+ "angularjs",
42
+ "angular",
43
+ "typescript",
44
+ "javascript",
45
+ "animation",
46
+ "web",
47
+ "html5",
48
+ "web-design",
49
+ "webdesign",
50
+ "css",
51
+ "html",
52
+ "css3",
53
+ "animated",
54
+ "background",
55
+ "confetti",
56
+ "canvas",
57
+ "fireworks",
58
+ "fireworks-js",
59
+ "confetti-js",
60
+ "confettijs",
61
+ "fireworksjs",
62
+ "canvas-confetti",
63
+ "@tsparticles/plugin"
64
+ ],
65
+ "author": "Matteo Bruni <matteo.bruni@me.com>",
66
+ "license": "MIT",
67
+ "bugs": {
68
+ "url": "https://github.com/matteobruni/tsparticles/issues"
69
+ },
70
+ "main": "cjs/index.js",
71
+ "jsdelivr": "tsparticles.plugin.canvas-mask.min.js",
72
+ "unpkg": "tsparticles.plugin.canvas-mask.min.js",
73
+ "module": "esm/index.js",
74
+ "types": "types/index.d.ts",
75
+ "publishConfig": {
76
+ "access": "public"
77
+ },
78
+ "dependencies": {
79
+ "@tsparticles/engine": "^3.0.0-alpha.0"
80
+ }
81
+ }