custom-pixi-particles 8.5.1 → 8.7.0

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import Renderer from './lib/pixi/Renderer';
 import { ICustomPixiParticlesSettings } from './lib/customPixiParticlesSettingsInterface';
 import TestRenderer from './lib/pixi/TestRenderer';
+import { ShatterEffect, DissolveEffect, MagneticAssemblyEffect, GhostEffect, GlitchEffect, MeltEffect } from './lib/effects';
+export type { IShatterEffectOptions, ShatterMode, IDissolveEffectOptions, DissolveDirection, IMagneticAssemblyOptions, AssemblyMode, IGhostEffectOptions, IGlitchEffectOptions, IMeltEffectOptions } from './lib/effects';
 /**
  * Constructs a renderer for custom pixi particles
  * @class Renderer
@@ -12,4 +14,4 @@ declare const customPixiParticles: {
 declare const _customPixiParticlesEditorOnly: {
     create(settings: ICustomPixiParticlesSettings): TestRenderer;
 };
-export { Renderer, customPixiParticles, _customPixiParticlesEditorOnly, ICustomPixiParticlesSettings };
+export { Renderer, customPixiParticles, _customPixiParticlesEditorOnly, ICustomPixiParticlesSettings, ShatterEffect, DissolveEffect, MagneticAssemblyEffect, GhostEffect, GlitchEffect, MeltEffect, };

package/dist/index.js

@@ -1,5 +1,6 @@
 import Renderer from './lib/pixi/Renderer';
 import TestRenderer from './lib/pixi/TestRenderer';
+import { ShatterEffect, DissolveEffect, MagneticAssemblyEffect, GhostEffect, GlitchEffect, MeltEffect } from './lib/effects';
 /**
  * Constructs a renderer for custom pixi particles
  * @class Renderer
@@ -41,5 +42,5 @@ const _customPixiParticlesEditorOnly = {
         });
     },
 };
-export { Renderer, customPixiParticles, _customPixiParticlesEditorOnly };
+export { Renderer, customPixiParticles, _customPixiParticlesEditorOnly, ShatterEffect, DissolveEffect, MagneticAssemblyEffect, GhostEffect, GlitchEffect, MeltEffect, };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,qBAAqB,CAAA;AAE1C,OAAO,YAAY,MAAM,yBAAyB,CAAA;AAElD;;;;GAIG;AACH,MAAM,mBAAmB,GAAG;IAC1B,MAAM,CAAC,QAAsC;QAC3C,MAAM,EACJ,QAAQ,EACR,aAAa,EACb,qBAAqB,GAAG,CAAC,EACzB,0BAA0B,GAAG,CAAC,EAC9B,iBAAiB,GAAG,EAAE,EACtB,QAAQ,GAAG,IAAI,EACf,QAAQ,GAAG,IAAI,EACf,QAAQ,GAAG,IAAI,EACf,GAAG,GAAG,IAAI,EACV,IAAI,GAAG,IAAI,EACX,YAAY,GAAG,KAAK,EACpB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,EACX,WAAW,GAAG,IAAI,GACnB,GAAG,QAAQ,CAAA;QACZ,OAAO,IAAI,QAAQ,CAAC;YAClB,QAAQ;YACR,qBAAqB;YACrB,0BAA0B;YAC1B,aAAa;YACb,iBAAiB;YACjB,QAAQ;YACR,QAAQ;YACR,QAAQ;YACR,GAAG;YACH,IAAI;YACJ,YAAY;YACZ,MAAM;YACN,MAAM;YACN,WAAW;SACZ,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAED,MAAM,8BAA8B,GAAG;IACrC,MAAM,CAAC,QAAsC;QAC3C,MAAM,EACJ,QAAQ,EACR,aAAa,EACb,qBAAqB,GAAG,CAAC,EACzB,0BAA0B,GAAG,CAAC,EAC9B,iBAAiB,GAAG,EAAE,EACtB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,EACX,WAAW,GAAG,IAAI,GACnB,GAAG,QAAQ,CAAA;QACZ,OAAO,IAAI,YAAY,CAAC;YACtB,QAAQ;YACR,qBAAqB;YACrB,0BAA0B;YAC1B,aAAa;YACb,iBAAiB;YACjB,MAAM;YACN,MAAM;YACN,WAAW;SACZ,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAED,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,8BAA8B,EAAgC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,qBAAqB,CAAA;AAE1C,OAAO,YAAY,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAI5H;;;;GAIG;AACH,MAAM,mBAAmB,GAAG;IAC1B,MAAM,CAAC,QAAsC;QAC3C,MAAM,EACJ,QAAQ,EACR,aAAa,EACb,qBAAqB,GAAG,CAAC,EACzB,0BAA0B,GAAG,CAAC,EAC9B,iBAAiB,GAAG,EAAE,EACtB,QAAQ,GAAG,IAAI,EACf,QAAQ,GAAG,IAAI,EACf,QAAQ,GAAG,IAAI,EACf,GAAG,GAAG,IAAI,EACV,IAAI,GAAG,IAAI,EACX,YAAY,GAAG,KAAK,EACpB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,EACX,WAAW,GAAG,IAAI,GACnB,GAAG,QAAQ,CAAA;QACZ,OAAO,IAAI,QAAQ,CAAC;YAClB,QAAQ;YACR,qBAAqB;YACrB,0BAA0B;YAC1B,aAAa;YACb,iBAAiB;YACjB,QAAQ;YACR,QAAQ;YACR,QAAQ;YACR,GAAG;YACH,IAAI;YACJ,YAAY;YACZ,MAAM;YACN,MAAM;YACN,WAAW;SACZ,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAED,MAAM,8BAA8B,GAAG;IACrC,MAAM,CAAC,QAAsC;QAC3C,MAAM,EACJ,QAAQ,EACR,aAAa,EACb,qBAAqB,GAAG,CAAC,EACzB,0BAA0B,GAAG,CAAC,EAC9B,iBAAiB,GAAG,EAAE,EACtB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,EACX,WAAW,GAAG,IAAI,GACnB,GAAG,QAAQ,CAAA;QACZ,OAAO,IAAI,YAAY,CAAC;YACtB,QAAQ;YACR,qBAAqB;YACrB,0BAA0B;YAC1B,aAAa;YACb,iBAAiB;YACjB,MAAM;YACN,MAAM;YACN,WAAW;SACZ,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAED,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,8BAA8B,EAE9B,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,WAAW,EACX,YAAY,EACZ,UAAU,GACX,CAAA"}

package/dist/lib/behaviour/SubEmitterBehaviour.js

@@ -0,0 +1 @@
+//# sourceMappingURL=SubEmitterBehaviour.js.map

package/dist/lib/behaviour/SubEmitterBehaviour.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubEmitterBehaviour.js","sourceRoot":"","sources":["../../../src/lib/behaviour/SubEmitterBehaviour.ts"],"names":[],"mappings":""}

package/dist/lib/effects/DissolveEffect.d.ts

@@ -0,0 +1,28 @@
+import { Container, Sprite } from 'pixi.js';
+export type DissolveDirection = 'left-to-right' | 'right-to-left' | 'top-to-bottom' | 'bottom-to-top' | 'center-out';
+export interface IDissolveEffectOptions {
+    pixelSize?: number;
+    edgeSoftness?: number;
+    driftStrength?: number;
+    noiseIntensity?: number;
+    lifetime?: number;
+    fadeOutDuration?: number;
+    direction?: DissolveDirection;
+    windAngle?: number;
+}
+export default class DissolveEffect extends Container {
+    private sourceSprite;
+    private fragments;
+    private isProcessing;
+    private options;
+    private progress;
+    private dissolveResolve?;
+    constructor(sourceSprite: Sprite, options?: IDissolveEffectOptions);
+    private prepare;
+    start(): Promise<void>;
+    private update;
+    private removeFragment;
+    private finish;
+    destroy(options?: any): void;
+    static dissolve(sprite: Sprite, options?: IDissolveEffectOptions): Promise<void>;
+}

package/dist/lib/effects/DissolveEffect.js

@@ -0,0 +1,198 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { Container, Sprite, Texture, Ticker } from 'pixi.js';
+import ParticlePool from '../ParticlePool';
+export default class DissolveEffect extends Container {
+    constructor(sourceSprite, options = {}) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        super();
+        this.sourceSprite = sourceSprite;
+        this.fragments = [];
+        this.isProcessing = false;
+        this.progress = 0;
+        // Determine bounds to set container size
+        const bounds = sourceSprite.getLocalBounds();
+        const pixelSize = (_a = options.pixelSize) !== null && _a !== void 0 ? _a : 2;
+        this.options = {
+            pixelSize,
+            edgeSoftness: (_b = options.edgeSoftness) !== null && _b !== void 0 ? _b : 0.2,
+            driftStrength: (_c = options.driftStrength) !== null && _c !== void 0 ? _c : 200,
+            noiseIntensity: (_d = options.noiseIntensity) !== null && _d !== void 0 ? _d : 50,
+            lifetime: (_e = options.lifetime) !== null && _e !== void 0 ? _e : 1.5,
+            fadeOutDuration: (_f = options.fadeOutDuration) !== null && _f !== void 0 ? _f : 0.5,
+            direction: (_g = options.direction) !== null && _g !== void 0 ? _g : 'left-to-right',
+            windAngle: ((_h = options.windAngle) !== null && _h !== void 0 ? _h : -45) * (Math.PI / 180), // Support degrees from UI
+        };
+        this.x = sourceSprite.x;
+        this.y = sourceSprite.y;
+        this.rotation = sourceSprite.rotation;
+    }
+    prepare() {
+        const texture = this.sourceSprite.texture;
+        if (!texture || !texture.source)
+            return;
+        const canvas = document.createElement('canvas');
+        const { width, height } = texture.frame;
+        canvas.width = width;
+        canvas.height = height;
+        const ctx = canvas.getContext('2d');
+        const source = texture.source;
+        const resource = source.resource;
+        if (resource && (resource.source || resource.data)) {
+            // tslint:disable-next-line:max-line-length
+            ctx.drawImage(resource.source || resource.data, texture.frame.x, texture.frame.y, width, height, 0, 0, width, height);
+        }
+        const imgData = ctx.getImageData(0, 0, width, height).data;
+        const { pixelSize, edgeSoftness, direction } = this.options;
+        const anchorX = this.sourceSprite.anchor.x;
+        const anchorY = this.sourceSprite.anchor.y;
+        const scale = this.sourceSprite.scale.x;
+        for (let py = 0; py < height; py += pixelSize) {
+            for (let px = 0; px < width; px += pixelSize) {
+                const i = (py * width + px) * 4;
+                if (imgData[i + 3] < 10)
+                    continue;
+                let spatialFactor = 0;
+                switch (direction) {
+                    case 'left-to-right':
+                        spatialFactor = px / width;
+                        break;
+                    case 'right-to-left':
+                        spatialFactor = 1 - px / width;
+                        break;
+                    case 'top-to-bottom':
+                        spatialFactor = py / height;
+                        break;
+                    case 'bottom-to-top':
+                        spatialFactor = 1 - py / height;
+                        break;
+                    case 'center-out':
+                        const dx = px - width / 2;
+                        const dy = py - height / 2;
+                        spatialFactor = Math.sqrt(dx * dx + dy * dy) / (width / 2);
+                        break;
+                }
+                const activationThreshold = spatialFactor * (1 - edgeSoftness) + Math.random() * edgeSoftness;
+                const sprite = new Sprite(Texture.WHITE);
+                sprite.width = sprite.height = pixelSize * scale;
+                // tslint:disable-next-line:no-bitwise
+                sprite.tint = (imgData[i] << 16) | (imgData[i + 1] << 8) | imgData[i + 2];
+                const lx = (px - width * anchorX) * scale;
+                const ly = (py - height * anchorY) * scale;
+                const p = ParticlePool.global.pop();
+                p.reset();
+                p.x = lx;
+                p.y = ly;
+                p.maxLifeTime = this.options.lifetime;
+                this.fragments.push({
+                    sprite,
+                    particle: p,
+                    activationThreshold,
+                    isActive: false,
+                    initialX: lx,
+                    initialY: ly,
+                });
+                this.addChild(sprite);
+            }
+        }
+        this.sourceSprite.visible = false;
+    }
+    start() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.prepare();
+            this.isProcessing = true;
+            return new Promise((resolve) => {
+                this.dissolveResolve = resolve;
+                Ticker.shared.add(this.update, this);
+            });
+        });
+    }
+    update() {
+        if (!this.isProcessing)
+            return;
+        const dt = Ticker.shared.deltaMS / 1000;
+        // progress moves from 0 to 1.2 to ensure all thresholds are met
+        this.progress += dt * 0.6;
+        // Iterate backwards so we can safely splice the array
+        for (let i = this.fragments.length - 1; i >= 0; i--) {
+            const f = this.fragments[i];
+            const p = f.particle;
+            if (!f.isActive && this.progress >= f.activationThreshold) {
+                f.isActive = true;
+            }
+            if (f.isActive) {
+                p.lifeTime += dt;
+                // Movement
+                const windX = Math.cos(this.options.windAngle) * this.options.driftStrength;
+                const windY = Math.sin(this.options.windAngle) * this.options.driftStrength;
+                const noiseX = (Math.random() - 0.5) * this.options.noiseIntensity;
+                const noiseY = (Math.random() - 0.5) * this.options.noiseIntensity;
+                p.x += (windX + noiseX) * dt;
+                p.y += (windY + noiseY) * dt;
+                f.sprite.x = p.x;
+                f.sprite.y = p.y;
+                // Alpha Fade
+                const lifeProg = p.lifeTime / p.maxLifeTime;
+                const fadeThreshold = 1 - this.options.fadeOutDuration / p.maxLifeTime;
+                if (lifeProg > fadeThreshold) {
+                    f.sprite.alpha = Math.max(0, 1 - (lifeProg - fadeThreshold) / (1 - fadeThreshold));
+                }
+                // REMOVAL LOGIC: Check if lifetime ended
+                if (p.lifeTime >= p.maxLifeTime || f.sprite.alpha <= 0) {
+                    this.removeFragment(i);
+                }
+            }
+            else {
+                f.sprite.x = f.initialX;
+                f.sprite.y = f.initialY;
+            }
+        }
+        if (this.fragments.length === 0) {
+            this.finish();
+        }
+    }
+    removeFragment(index) {
+        const f = this.fragments[index];
+        if (f.particle)
+            ParticlePool.global.push(f.particle);
+        if (f.sprite) {
+            this.removeChild(f.sprite);
+            f.sprite.destroy();
+        }
+        this.fragments.splice(index, 1);
+    }
+    finish() {
+        var _a;
+        this.isProcessing = false;
+        Ticker.shared.remove(this.update, this);
+        (_a = this.dissolveResolve) === null || _a === void 0 ? void 0 : _a.call(this);
+    }
+    destroy(options) {
+        Ticker.shared.remove(this.update, this);
+        this.fragments.forEach((f, i) => {
+            if (f.particle)
+                ParticlePool.global.push(f.particle);
+        });
+        this.fragments = [];
+        super.destroy(options);
+    }
+    static dissolve(sprite_1) {
+        return __awaiter(this, arguments, void 0, function* (sprite, options = {}) {
+            if (!sprite.parent)
+                return;
+            const effect = new DissolveEffect(sprite, options);
+            const index = sprite.parent.getChildIndex(sprite);
+            sprite.parent.addChildAt(effect, index);
+            yield effect.start();
+            effect.destroy({ children: true });
+        });
+    }
+}
+//# sourceMappingURL=DissolveEffect.js.map

package/dist/lib/effects/DissolveEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DissolveEffect.js","sourceRoot":"","sources":["../../../src/lib/effects/DissolveEffect.ts"],"names":[],"mappings":"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"}

package/dist/lib/effects/GhostEffect.d.ts

@@ -0,0 +1,32 @@
+import { BLEND_MODES, Container, Sprite } from 'pixi.js';
+export interface IGhostEffectOptions {
+    spawnInterval?: number;
+    ghostLifetime?: number;
+    startAlpha?: number;
+    endAlpha?: number;
+    startTint?: number;
+    endTint?: number;
+    blendMode?: BLEND_MODES;
+    maxGhosts?: number;
+}
+export default class GhostEffect extends Container {
+    private target;
+    private instances;
+    private spawnTimer;
+    private options;
+    private isTracking;
+    constructor(target: Sprite, options?: IGhostEffectOptions);
+    /**
+     * Start generating echoes.
+     */
+    start(): void;
+    /**
+     * Stop generating new echoes (existing ones will finish fading).
+     */
+    stop(): void;
+    private update;
+    private createGhost;
+    private lerpColor;
+    private removeGhost;
+    destroy(options?: any): void;
+}

package/dist/lib/effects/GhostEffect.js

@@ -0,0 +1,125 @@
+import { Container, Sprite, Ticker } from 'pixi.js';
+import ParticlePool from '../ParticlePool';
+export default class GhostEffect extends Container {
+    constructor(target, options = {}) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        super();
+        this.target = target;
+        this.instances = [];
+        this.spawnTimer = 0;
+        this.isTracking = false;
+        this.options = {
+            spawnInterval: (_a = options.spawnInterval) !== null && _a !== void 0 ? _a : 0.05,
+            ghostLifetime: (_b = options.ghostLifetime) !== null && _b !== void 0 ? _b : 0.5,
+            startAlpha: (_c = options.startAlpha) !== null && _c !== void 0 ? _c : 0.6,
+            endAlpha: (_d = options.endAlpha) !== null && _d !== void 0 ? _d : 0,
+            startTint: (_e = options.startTint) !== null && _e !== void 0 ? _e : 0xffffff,
+            endTint: (_f = options.endTint) !== null && _f !== void 0 ? _f : 0x00ffff,
+            blendMode: (_g = options.blendMode) !== null && _g !== void 0 ? _g : 'normal',
+            maxGhosts: (_h = options.maxGhosts) !== null && _h !== void 0 ? _h : 20,
+        };
+    }
+    /**
+     * Start generating echoes.
+     */
+    start() {
+        if (this.isTracking)
+            return;
+        this.isTracking = true;
+        Ticker.shared.add(this.update, this);
+    }
+    /**
+     * Stop generating new echoes (existing ones will finish fading).
+     */
+    stop() {
+        this.isTracking = false;
+    }
+    update() {
+        const dt = Ticker.shared.deltaMS / 1000;
+        // 1. Spawn logic
+        if (this.isTracking) {
+            this.spawnTimer += dt;
+            if (this.spawnTimer >= this.options.spawnInterval) {
+                this.createGhost();
+                this.spawnTimer = 0;
+            }
+        }
+        // 2. Update existing ghosts
+        for (let i = this.instances.length - 1; i >= 0; i--) {
+            const g = this.instances[i];
+            const p = g.particle;
+            p.lifeTime += dt;
+            const progress = Math.min(1, p.lifeTime / p.maxLifeTime);
+            // Apply Fading
+            g.sprite.alpha = this.options.startAlpha + (this.options.endAlpha - this.options.startAlpha) * progress;
+            // Apply Color Shifting
+            if (this.options.startTint !== this.options.endTint || this.options.startTint !== 0xffffff) {
+                g.sprite.tint = this.lerpColor(this.options.startTint, this.options.endTint, progress);
+            }
+            // Removal logic
+            if (progress >= 1 || g.sprite.alpha <= 0) {
+                this.removeGhost(i);
+            }
+        }
+        // Auto-destroy effect container if stopped and no ghosts remain
+        if (!this.isTracking && this.instances.length === 0) {
+            this.destroy();
+        }
+    }
+    createGhost() {
+        if (this.instances.length >= this.options.maxGhosts)
+            return;
+        if (!this.target.texture || !this.target.texture.source)
+            return;
+        const sprite = new Sprite(this.target.texture);
+        sprite.anchor.copyFrom(this.target.anchor);
+        sprite.scale.copyFrom(this.target.scale);
+        sprite.rotation = this.target.rotation;
+        sprite.blendMode = this.options.blendMode;
+        // Convert target global position to local position of this container
+        if (!this.parent)
+            return;
+        const globalPos = this.target.getGlobalPosition();
+        const localPos = this.parent.toLocal(globalPos);
+        sprite.x = localPos.x;
+        sprite.y = localPos.y;
+        const p = ParticlePool.global.pop();
+        p.reset();
+        p.maxLifeTime = this.options.ghostLifetime;
+        p.lifeTime = 0;
+        this.instances.push({
+            sprite,
+            particle: p,
+            initialX: sprite.x,
+            initialY: sprite.y,
+            initialRotation: sprite.rotation,
+            initialScaleX: sprite.scale.x,
+            initialScaleY: sprite.scale.y,
+        });
+        this.addChild(sprite);
+    }
+    lerpColor(start, end, t) {
+        // tslint:disable-next-line:one-variable-per-declaration no-bitwise
+        const r1 = (start >> 16) & 0xff, g1 = (start >> 8) & 0xff, b1 = start & 0xff;
+        // tslint:disable-next-line:one-variable-per-declaration no-bitwise
+        const r2 = (end >> 16) & 0xff, g2 = (end >> 8) & 0xff, b2 = end & 0xff;
+        // tslint:disable-next-line:one-variable-per-declaration no-bitwise
+        const r = r1 + (r2 - r1) * t, g = g1 + (g2 - g1) * t, b = b1 + (b2 - b1) * t;
+        // tslint:disable-next-line:no-bitwise
+        return (r << 16) | (g << 8) | b;
+    }
+    removeGhost(index) {
+        const g = this.instances[index];
+        if (g.particle)
+            ParticlePool.global.push(g.particle);
+        this.removeChild(g.sprite);
+        g.sprite.destroy();
+        this.instances.splice(index, 1);
+    }
+    destroy(options) {
+        Ticker.shared.remove(this.update, this);
+        this.instances.forEach((_, i) => this.removeGhost(i));
+        super.destroy(options);
+    }
+}
+//# sourceMappingURL=GhostEffect.js.map

package/dist/lib/effects/GhostEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GhostEffect.js","sourceRoot":"","sources":["../../../src/lib/effects/GhostEffect.ts"],"names":[],"mappings":"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"}

package/dist/lib/effects/GlitchEffect.d.ts

@@ -0,0 +1,25 @@
+import { Container, Sprite } from 'pixi.js';
+export interface IGlitchEffectOptions {
+    slices?: number;
+    offsetRange?: number;
+    flickerIntensity?: number;
+    rgbSplit?: boolean;
+    rgbOffset?: number;
+    duration?: number;
+    refreshRate?: number;
+}
+export default class GlitchEffect extends Container {
+    private sourceSprite;
+    private fragments;
+    private options;
+    private currentTime;
+    private lastRefreshTime;
+    private glitchResolve?;
+    private isProcessing;
+    constructor(sourceSprite: Sprite, options?: IGlitchEffectOptions);
+    private prepare;
+    play(): Promise<void>;
+    private update;
+    private finish;
+    static glitch(sprite: Sprite, options?: IGlitchEffectOptions): Promise<void>;
+}

package/dist/lib/effects/GlitchEffect.js

@@ -0,0 +1,137 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { Container, Rectangle, Sprite, Texture, Ticker } from 'pixi.js';
+import ParticlePool from '../ParticlePool';
+export default class GlitchEffect extends Container {
+    constructor(sourceSprite, options = {}) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        super();
+        this.sourceSprite = sourceSprite;
+        this.fragments = [];
+        this.currentTime = 0;
+        this.lastRefreshTime = 0;
+        this.isProcessing = false;
+        const slices = (_a = options.slices) !== null && _a !== void 0 ? _a : 15;
+        const isRGB = (_b = options.rgbSplit) !== null && _b !== void 0 ? _b : true;
+        this.options = {
+            slices,
+            offsetRange: (_c = options.offsetRange) !== null && _c !== void 0 ? _c : 30,
+            flickerIntensity: (_d = options.flickerIntensity) !== null && _d !== void 0 ? _d : 0.3,
+            rgbSplit: isRGB,
+            rgbOffset: (_e = options.rgbOffset) !== null && _e !== void 0 ? _e : 10,
+            duration: (_f = options.duration) !== null && _f !== void 0 ? _f : 0.5,
+            refreshRate: (_g = options.refreshRate) !== null && _g !== void 0 ? _g : 0.06,
+        };
+        this.x = sourceSprite.x;
+        this.y = sourceSprite.y;
+        this.rotation = sourceSprite.rotation;
+    }
+    prepare() {
+        const texture = this.sourceSprite.texture;
+        if (!texture || !texture.source)
+            return;
+        const { slices, rgbSplit } = this.options;
+        const texFrame = texture.frame;
+        const sliceHeight = texFrame.height / slices;
+        const scale = this.sourceSprite.scale.x;
+        const anchorX = this.sourceSprite.anchor.x;
+        const anchorY = this.sourceSprite.anchor.y;
+        for (let i = 0; i < slices; i++) {
+            const yOffset = i * sliceHeight;
+            const fragRect = new Rectangle(texFrame.x, texFrame.y + yOffset, texFrame.width, sliceHeight);
+            const fragTex = new Texture({ source: texture.source, frame: fragRect });
+            const sliceSprites = [];
+            const tints = rgbSplit ? [0xff0000, 0x00ff00, 0x0000ff] : [0xffffff];
+            tints.forEach((tint) => {
+                const sprite = new Sprite(fragTex);
+                sprite.anchor.set(anchorX, 0); // Anchor top-left of slice
+                sprite.scale.set(scale);
+                sprite.tint = tint;
+                if (rgbSplit)
+                    sprite.blendMode = 'add';
+                sliceSprites.push(sprite);
+                this.addChild(sprite);
+            });
+            const p = ParticlePool.global.pop();
+            p.reset();
+            this.fragments.push({
+                sprites: sliceSprites,
+                particle: p,
+                initialY: (yOffset - texFrame.height * anchorY) * scale,
+            });
+        }
+        this.sourceSprite.visible = false;
+    }
+    play() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.prepare();
+            this.isProcessing = true;
+            return new Promise((resolve) => {
+                this.glitchResolve = resolve;
+                Ticker.shared.add(this.update, this);
+            });
+        });
+    }
+    update() {
+        if (!this.isProcessing)
+            return;
+        const dt = Ticker.shared.deltaMS / 1000;
+        this.currentTime += dt;
+        this.lastRefreshTime += dt;
+        const shouldRefresh = this.lastRefreshTime >= this.options.refreshRate;
+        for (let i = 0; i < this.fragments.length; i++) {
+            const f = this.fragments[i];
+            if (shouldRefresh) {
+                // Calculate new random glitch state for this slice
+                const isVisible = Math.random() > this.options.flickerIntensity * 0.5;
+                const xShift = (Math.random() - 0.5) * 2 * this.options.offsetRange;
+                f.sprites.forEach((s, index) => {
+                    s.visible = isVisible;
+                    s.y = f.initialY;
+                    // RGB channel drift
+                    let channelOffset = 0;
+                    if (this.options.rgbSplit) {
+                        channelOffset = (index - 1) * (Math.random() * this.options.rgbOffset);
+                    }
+                    s.x = xShift + channelOffset;
+                    // Randomly turn some slices into white blocks (Digital Noise)
+                    if (Math.random() > 0.98) {
+                        s.tint = 0xffffff;
+                        s.texture = Texture.WHITE;
+                    }
+                });
+            }
+        }
+        if (shouldRefresh)
+            this.lastRefreshTime = 0;
+        if (this.currentTime >= this.options.duration) {
+            this.finish();
+        }
+    }
+    finish() {
+        var _a;
+        this.isProcessing = false;
+        Ticker.shared.remove(this.update, this);
+        this.sourceSprite.visible = true;
+        (_a = this.glitchResolve) === null || _a === void 0 ? void 0 : _a.call(this);
+    }
+    static glitch(sprite_1) {
+        return __awaiter(this, arguments, void 0, function* (sprite, options = {}) {
+            if (!sprite.parent)
+                return;
+            const effect = new GlitchEffect(sprite, options);
+            const index = sprite.parent.getChildIndex(sprite);
+            sprite.parent.addChildAt(effect, index);
+            yield effect.play();
+            effect.destroy({ children: true });
+        });
+    }
+}
+//# sourceMappingURL=GlitchEffect.js.map

package/dist/lib/effects/GlitchEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlitchEffect.js","sourceRoot":"","sources":["../../../src/lib/effects/GlitchEffect.ts"],"names":[],"mappings":"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"}