custom-pixi-particles 8.1.1 → 8.2.0

package/dist/lib/behaviour/RotationBehaviour.js

@@ -0,0 +1,100 @@
+import { Behaviour, BehaviourNames } from './index';
+/**
+ * RotationBehaviour is a Behaviour class used to control the rotation of particles.
+ * @extends Behaviour
+ */
+export default class RotationBehaviour extends Behaviour {
+    constructor() {
+        super(...arguments);
+        this.enabled = false;
+        this.priority = 0;
+        this.rotation = 0; // Base rotation speed
+        this.variance = 0; // Variance in rotation speed
+        this.oscillate = false; // Enable oscillation
+        this.oscillationSpeed = 1; // Speed of oscillation
+        this.oscillationAmplitude = 0; // Amplitude of oscillation
+        this.useNoise = false; // Use Perlin noise for rotation
+        this.noiseScale = 0.1; // Scale of Perlin noise
+        this.acceleration = 0; // Rotation acceleration (positive or negative)
+        this.clockwise = true; // Clockwise or counterclockwise rotation
+        /**
+         * Initialise the Behaviour for a particle
+         * @param {Particle} particle - The particle to be initialised
+         */
+        this.init = (particle) => {
+            if (!this.enabled)
+                return;
+            // Set base rotation delta with variance
+            const baseRotation = this.rotation + this.varianceFrom(this.variance);
+            particle.rotationDelta = this.clockwise ? baseRotation : -baseRotation;
+            // Initialize acceleration if enabled
+            particle.rotationAcceleration = this.acceleration;
+        };
+        /**
+         * Applies the Behaviour to a particle
+         * @param {Particle} particle - The particle to apply the Behaviour to
+         * @param {number} deltaTime - The delta time of the runtime
+         */
+        this.apply = (particle, deltaTime) => {
+            if (!this.enabled)
+                return;
+            if (particle.skipRotationBehaviour)
+                return;
+            let deltaRotation = particle.rotationDelta;
+            // Apply oscillation effect
+            if (this.oscillate) {
+                const oscillation = Math.sin(particle.lifeTime * this.oscillationSpeed) * this.oscillationAmplitude;
+                deltaRotation += oscillation;
+            }
+            // Apply noise-based rotation
+            if (this.useNoise) {
+                const noiseValue = this.pseudoRandomNoise(particle.lifeTime * this.noiseScale);
+                deltaRotation += noiseValue * 2 - 1; // Map noise from [0,1] to [-1,1]
+            }
+            // Apply rotation acceleration
+            if (particle.rotationAcceleration) {
+                particle.rotationDelta += particle.rotationAcceleration * deltaTime;
+                deltaRotation = particle.rotationDelta;
+            }
+            // Update particle rotation
+            particle.rotation += deltaRotation * deltaTime;
+        };
+    }
+    /**
+     * Pseudo-random noise generator for smooth transitions
+     * @param {number} seed - Input seed for generating noise
+     * @returns {number} - Noise value between 0 and 1
+     */
+    pseudoRandomNoise(seed) {
+        const x = Math.sin(seed * 10000) * 10000;
+        return x - Math.floor(x);
+    }
+    /**
+     * Gets the name of the Behaviour
+     * @returns {string} - The name of the Behaviour
+     */
+    getName() {
+        return BehaviourNames.ROTATION_BEHAVIOUR;
+    }
+    /**
+     * Gets the properties of the Behaviour
+     * @returns {object} - The properties of the Behaviour
+     */
+    getProps() {
+        return {
+            enabled: this.enabled,
+            priority: this.priority,
+            rotation: this.rotation,
+            variance: this.variance,
+            oscillate: this.oscillate,
+            oscillationSpeed: this.oscillationSpeed,
+            oscillationAmplitude: this.oscillationAmplitude,
+            useNoise: this.useNoise,
+            noiseScale: this.noiseScale,
+            acceleration: this.acceleration,
+            clockwise: this.clockwise,
+            name: this.getName(),
+        };
+    }
+}
+//# sourceMappingURL=RotationBehaviour.js.map

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

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

package/dist/lib/behaviour/SizeBehaviour.d.ts

@@ -0,0 +1,61 @@
+import { Point } from '../util';
+import { Behaviour } from './index';
+import Particle from '../Particle';
+export default class SizeBehaviour extends Behaviour {
+    enabled: boolean;
+    priority: number;
+    sizeStart: Point;
+    sizeEnd: Point;
+    startVariance: number;
+    endVariance: number;
+    maxSize: Point;
+    uniformScaling: boolean;
+    pulsate: boolean;
+    pulsationSpeed: number;
+    pulsationAmplitude: number;
+    useNoise: boolean;
+    noiseScale: number;
+    invertAtMidpoint: boolean;
+    sizeSteps: never[];
+    timeOffset: number;
+    xScalingFunction: string;
+    yScalingFunction: string;
+    sizeAlphaDependency: boolean;
+    init: (particle: Particle) => void;
+    apply: (particle: Particle, deltaTime: number) => void;
+    applyMultiStepSize: (particle: Particle, lifeProgress: number) => void;
+    applyEasing: (progress: number, easingType: string) => number;
+    pseudoRandomNoise: (seed: number) => number;
+    getName(): string;
+    getProps(): {
+        enabled: boolean;
+        priority: number;
+        sizeStart: {
+            x: number;
+            y: number;
+        };
+        sizeEnd: {
+            x: number;
+            y: number;
+        };
+        startVariance: number;
+        endVariance: number;
+        maxSize: {
+            x: number;
+            y: number;
+        };
+        uniformScaling: boolean;
+        pulsate: boolean;
+        pulsationSpeed: number;
+        pulsationAmplitude: number;
+        useNoise: boolean;
+        noiseScale: number;
+        invertAtMidpoint: boolean;
+        sizeSteps: never[];
+        timeOffset: number;
+        xScalingFunction: string;
+        yScalingFunction: string;
+        sizeAlphaDependency: boolean;
+        name: string;
+    };
+}

package/dist/lib/behaviour/SizeBehaviour.js

@@ -0,0 +1,156 @@
+import { Point } from '../util';
+import { Behaviour, BehaviourNames } from './index';
+export default class SizeBehaviour extends Behaviour {
+    constructor() {
+        super(...arguments);
+        this.enabled = true;
+        this.priority = 0;
+        this.sizeStart = new Point(1, 1);
+        this.sizeEnd = new Point(1, 1);
+        this.startVariance = 0;
+        this.endVariance = 0;
+        this.maxSize = new Point(2, 2); // Maximum size clamp
+        this.uniformScaling = true; // Toggle for uniform scaling
+        this.pulsate = false; // Enable pulsating size effect
+        this.pulsationSpeed = 1; // Speed of pulsation
+        this.pulsationAmplitude = 0.2; // Amplitude of pulsation
+        this.useNoise = false; // Use noise for size modulation
+        this.noiseScale = 0.1; // Scale of the noise effect
+        this.invertAtMidpoint = false; // Invert size at midpoint
+        this.sizeSteps = []; // Array of size points for multi-step transitions
+        this.timeOffset = 0; // Delay or advance size scaling
+        this.xScalingFunction = 'linear'; // Easing for x-axis
+        this.yScalingFunction = 'linear'; // Easing for y-axis
+        this.sizeAlphaDependency = false; // Link size to alpha value
+        this.init = (particle) => {
+            if (!this.enabled)
+                return;
+            let variance = this.varianceFrom(this.startVariance);
+            const sizeStartX = this.sizeStart.x + variance;
+            const sizeStartY = this.sizeStart.y + variance;
+            variance = this.varianceFrom(this.endVariance);
+            const sizeEndX = this.sizeEnd.x + variance;
+            const sizeEndY = this.sizeEnd.y + variance;
+            particle.sizeDifference = {
+                x: sizeEndX - sizeStartX,
+                y: sizeEndY - sizeStartY,
+            };
+            particle.sizeStart.x = sizeStartX;
+            particle.sizeStart.y = sizeStartY;
+            particle.sizeEnd.x = sizeEndX;
+            particle.sizeEnd.y = sizeEndY;
+            particle.size.copyFrom(particle.sizeStart);
+        };
+        this.apply = (particle, deltaTime) => {
+            if (!this.enabled || particle.skipSizeBehaviour)
+                return;
+            let lifeProgress = particle.lifeProgress - this.timeOffset;
+            if (lifeProgress < 0)
+                return; // Skip if delayed
+            if (this.invertAtMidpoint && lifeProgress > 0.5) {
+                lifeProgress = 1 - lifeProgress; // Invert at midpoint
+            }
+            // Handle multi-step transitions
+            if (this.sizeSteps.length > 0) {
+                this.applyMultiStepSize(particle, lifeProgress);
+                return;
+            }
+            let sizeX = particle.sizeStart.x + particle.sizeDifference.x * this.applyEasing(lifeProgress, this.xScalingFunction);
+            let sizeY = this.uniformScaling
+                ? sizeX
+                : particle.sizeStart.y + particle.sizeDifference.y * this.applyEasing(lifeProgress, this.yScalingFunction);
+            // Apply pulsation effect
+            if (this.pulsate) {
+                const pulseFactor = 1 + Math.sin(particle.lifeTime * this.pulsationSpeed * Math.PI * 2) * this.pulsationAmplitude;
+                sizeX *= pulseFactor;
+                sizeY *= pulseFactor;
+            }
+            // Apply noise modulation
+            if (this.useNoise) {
+                const noiseFactor = this.pseudoRandomNoise(particle.lifeTime * this.noiseScale);
+                sizeX *= noiseFactor;
+                sizeY *= noiseFactor;
+            }
+            // Size linked to alpha
+            if (this.sizeAlphaDependency) {
+                const alphaFactor = particle.color.alpha;
+                sizeX *= alphaFactor;
+                sizeY *= alphaFactor;
+            }
+            // Clamp to maximum size
+            sizeX = Math.min(sizeX, this.maxSize.x);
+            sizeY = Math.min(sizeY, this.maxSize.y);
+            particle.size.x = sizeX;
+            particle.size.y = sizeY;
+        };
+        this.applyMultiStepSize = (particle, lifeProgress) => {
+            const stepCount = this.sizeSteps.length - 1;
+            if (stepCount < 1)
+                return; // Skip if fewer than two steps
+            const currentStep = Math.floor(lifeProgress * stepCount);
+            const nextStep = Math.min(currentStep + 1, stepCount);
+            const t = (lifeProgress * stepCount) % 1;
+            const sizeStart = this.sizeSteps[currentStep];
+            const sizeEnd = this.sizeSteps[nextStep];
+            // @ts-ignore
+            particle.size.x = sizeStart.x + (sizeEnd.x - sizeStart.x) * this.applyEasing(t, this.xScalingFunction);
+            // @ts-ignore
+            particle.size.y = sizeStart.y + (sizeEnd.y - sizeStart.y) * this.applyEasing(t, this.yScalingFunction);
+        };
+        this.applyEasing = (progress, easingType) => {
+            switch (easingType) {
+                case 'easeIn':
+                    return progress * progress;
+                case 'easeOut':
+                    return 1 - Math.pow(1 - progress, 2);
+                case 'easeInOut':
+                    return progress < 0.5 ? 2 * progress * progress : 1 - Math.pow(-2 * progress + 2, 2) / 2;
+                case 'linear':
+                default:
+                    return progress;
+            }
+        };
+        this.pseudoRandomNoise = (seed) => {
+            const prime = 2654435761; // A prime constant
+            const x = Math.sin(seed * prime) * 10000; // Scale the randomness
+            return x - Math.floor(x); // Ensure result is between 0 and 1
+        };
+    }
+    getName() {
+        return BehaviourNames.SIZE_BEHAVIOUR;
+    }
+    getProps() {
+        return {
+            enabled: this.enabled,
+            priority: this.priority,
+            sizeStart: {
+                x: this.sizeStart.x,
+                y: this.sizeStart.y,
+            },
+            sizeEnd: {
+                x: this.sizeEnd.x,
+                y: this.sizeEnd.y,
+            },
+            startVariance: this.startVariance,
+            endVariance: this.endVariance,
+            maxSize: {
+                x: this.maxSize.x,
+                y: this.maxSize.y,
+            },
+            uniformScaling: this.uniformScaling,
+            pulsate: this.pulsate,
+            pulsationSpeed: this.pulsationSpeed,
+            pulsationAmplitude: this.pulsationAmplitude,
+            useNoise: this.useNoise,
+            noiseScale: this.noiseScale,
+            invertAtMidpoint: this.invertAtMidpoint,
+            sizeSteps: this.sizeSteps,
+            timeOffset: this.timeOffset,
+            xScalingFunction: this.xScalingFunction,
+            yScalingFunction: this.yScalingFunction,
+            sizeAlphaDependency: this.sizeAlphaDependency,
+            name: this.getName(),
+        };
+    }
+}
+//# sourceMappingURL=SizeBehaviour.js.map

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

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

package/dist/lib/behaviour/SoundReactiveBehaviour.d.ts

@@ -0,0 +1,58 @@
+import { Behaviour } from './index';
+import Particle from '../Particle';
+import { Color, Point } from '../util';
+export default class SoundReactiveBehaviour extends Behaviour {
+    enabled: boolean;
+    priority: number;
+    isPlaying: boolean;
+    useColor: boolean;
+    useSize: boolean;
+    useVelocity: boolean;
+    useRotation: boolean;
+    useRandomColor: boolean;
+    beatColor: Color;
+    audioContext: AudioContext | null;
+    analyser: AnalyserNode | null;
+    frequencyData: Uint8Array | null;
+    amplitudeFactor: number;
+    frequencyFactor: number;
+    rotationFactor: number;
+    beatSensitivity: number;
+    velocityFactor: Point;
+    init(): void;
+    apply(particle: Particle, deltaTime: number): void;
+    /**
+     * Computes the amplitude (average volume level) from the frequency data.
+     */
+    getAmplitude(): number;
+    /**
+     * Finds the dominant frequency (frequency with the highest amplitude).
+     */
+    getDominantFrequency(): number;
+    /**
+     * Detects a beat based on amplitude and sensitivity.
+     */
+    isBeatDetected(amplitude: number): boolean;
+    /**
+     * Generates a random RGBA color.
+     */
+    getRandomColor(): Color;
+    getName(): string;
+    getProps(): {
+        enabled: boolean;
+        priority: number;
+        isPlaying: boolean;
+        useColor: boolean;
+        useVelocity: boolean;
+        useSize: boolean;
+        useRotation: boolean;
+        useRandomColor: boolean;
+        beatColor: Color;
+        amplitudeFactor: number;
+        frequencyFactor: number;
+        rotationFactor: number;
+        beatSensitivity: number;
+        velocityFactor: Point;
+        name: string;
+    };
+}

package/dist/lib/behaviour/SoundReactiveBehaviour.js

@@ -0,0 +1,132 @@
+import { Behaviour, BehaviourNames } from './index';
+import { Color, Point } from '../util';
+export default class SoundReactiveBehaviour extends Behaviour {
+    constructor() {
+        super(...arguments);
+        this.enabled = true;
+        this.priority = 0;
+        this.isPlaying = false;
+        this.useColor = true;
+        this.useSize = true;
+        this.useVelocity = true;
+        this.useRotation = true; // New property for rotation
+        this.useRandomColor = true; // New property for random colors
+        this.beatColor = new Color(255, 0, 0, 1); // Default beat color (red with full alpha)
+        this.audioContext = null; // Audio context for analysis
+        this.analyser = null; // Audio analyser node
+        this.frequencyData = null; // Frequency data array
+        this.amplitudeFactor = 0.1; // Scale factor for amplitude effects
+        this.frequencyFactor = 1; // Scale factor for frequency effects
+        this.rotationFactor = 0.05; // Scale factor for rotation effects
+        this.beatSensitivity = 1; // Sensitivity to detect beats
+        this.velocityFactor = new Point(1, 1); // Sensitivity to detect beats
+    }
+    init() {
+        //
+    }
+    apply(particle, deltaTime) {
+        if (!this.enabled || !this.analyser || !this.frequencyData || !this.isPlaying)
+            return;
+        // Update frequency data
+        this.analyser.getByteFrequencyData(this.frequencyData);
+        // Compute amplitude and frequency effects
+        const amplitude = this.getAmplitude();
+        const dominantFrequency = this.getDominantFrequency();
+        if (this.useSize) {
+            // Apply amplitude effect to size
+            particle.size.x += amplitude * this.amplitudeFactor * deltaTime;
+            particle.size.y += amplitude * this.amplitudeFactor * deltaTime;
+        }
+        if (this.useVelocity) {
+            // Apply frequency effect to velocity or position
+            particle.velocity.x += dominantFrequency * this.frequencyFactor * deltaTime * this.velocityFactor.x;
+            particle.velocity.y += dominantFrequency * this.frequencyFactor * deltaTime * this.velocityFactor.y;
+        }
+        if (this.useRotation) {
+            // Apply rotation effect based on dominant frequency
+            particle.rotation += dominantFrequency * this.rotationFactor * deltaTime;
+        }
+        if (this.useColor) {
+            // Add beat reaction with color and alpha logic
+            if (this.isBeatDetected(amplitude)) {
+                const color = this.useRandomColor ? this.getRandomColor() : this.beatColor;
+                particle.color.r = color.r;
+                particle.color.g = color.g;
+                particle.color.b = color.b;
+                particle.color.alpha = color.alpha; // Ensure alpha is applied
+            }
+            else {
+                particle.color.r = Math.max(0, particle.color.r - 5); // Fade back to normal
+                particle.color.g = Math.max(0, particle.color.g - 5);
+                particle.color.b = Math.max(0, particle.color.b - 5);
+                particle.color.alpha = Math.max(0, particle.color.alpha - 0.05); // Gradually decrease alpha
+            }
+        }
+    }
+    /**
+     * Computes the amplitude (average volume level) from the frequency data.
+     */
+    getAmplitude() {
+        if (!this.frequencyData)
+            return 0;
+        const sum = this.frequencyData.reduce((a, b) => a + b, 0);
+        return sum / this.frequencyData.length;
+    }
+    /**
+     * Finds the dominant frequency (frequency with the highest amplitude).
+     */
+    getDominantFrequency() {
+        var _a, _b, _c, _d;
+        if (!this.frequencyData)
+            return 0;
+        let maxAmplitude = 0;
+        let dominantIndex = 0;
+        for (let i = 0; i < this.frequencyData.length; i++) {
+            if (this.frequencyData[i] > maxAmplitude) {
+                maxAmplitude = this.frequencyData[i];
+                dominantIndex = i;
+            }
+        }
+        return (dominantIndex * ((_b = (_a = this.analyser) === null || _a === void 0 ? void 0 : _a.context.sampleRate) !== null && _b !== void 0 ? _b : 0)) / ((_d = (_c = this.analyser) === null || _c === void 0 ? void 0 : _c.fftSize) !== null && _d !== void 0 ? _d : 1);
+    }
+    /**
+     * Detects a beat based on amplitude and sensitivity.
+     */
+    isBeatDetected(amplitude) {
+        return amplitude > this.beatSensitivity * 128; // Threshold for beat detection
+    }
+    /**
+     * Generates a random RGBA color.
+     */
+    getRandomColor() {
+        // Generate a random color if allTheSameColor is false
+        const r = Math.floor(Math.random() * 256);
+        const g = Math.floor(Math.random() * 256);
+        const b = Math.floor(Math.random() * 256);
+        const a = 1; // Ensure alpha is explicitly set
+        return new Color(r, g, b, a);
+    }
+    getName() {
+        return BehaviourNames.SOUND_REACTIVE_BEHAVIOUR;
+    }
+    getProps() {
+        return {
+            enabled: this.enabled,
+            priority: this.priority,
+            isPlaying: this.isPlaying,
+            useColor: this.useColor,
+            useVelocity: this.useVelocity,
+            useSize: this.useSize,
+            useRotation: this.useRotation,
+            useRandomColor: this.useRandomColor, // Include random color toggle in props
+            beatColor: this.beatColor, // Include beat color with alpha in props
+            amplitudeFactor: this.amplitudeFactor,
+            frequencyFactor: this.frequencyFactor,
+            rotationFactor: this.rotationFactor,
+            beatSensitivity: this.beatSensitivity,
+            velocityFactor: this.velocityFactor,
+            name: this.getName(),
+        };
+    }
+}
+//# sourceMappingURL=SoundReactiveBehaviour.js.map

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

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

package/dist/lib/behaviour/SpawnBehaviour.d.ts

@@ -0,0 +1,89 @@
+import { Behaviour } from './index';
+import Particle from '../Particle';
+export default class SpawnBehaviour extends Behaviour {
+    enabled: boolean;
+    priority: number;
+    overOne: boolean;
+    trailProgress: number;
+    trailingEnabled: boolean;
+    spawnAlongTrail: boolean;
+    trailSpeed: number;
+    trailRepeat: boolean;
+    trailStart: number;
+    currentProgress: number;
+    customPoints: any[];
+    lastWordSettings: any;
+    /**
+     * Initialize particles for each custom point.
+     * @param {Particle} particle - The particle to initialize.
+     */
+    init: (particle: Particle) => void;
+    apply: () => void;
+    /**
+     * Calculate trail positions along the range from trailStart to currentProgress.
+     * @param {Object} point - The custom point configuration.
+     * @returns {Point[]} List of positions along the trail.
+     */
+    calculateTrailRangePositions: (point: any) => {
+        positions: {
+            x: any;
+            y: any;
+            z: any;
+        }[];
+        probabilities: number[];
+    };
+    /**
+     * Spawn particle at the specified point configuration.
+     * @param {Particle} particle - The particle to be initialized.
+     * @param {Object} point - The custom point configuration.
+     */
+    spawnParticleAtPoint: (particle: Particle, point: any) => void;
+    /**
+     * Calculate canvas context for rendering text-based particles.
+     * @param {Object} point - The custom point configuration.
+     */
+    calculateCtx: (point: any) => void;
+    calculateTrailPosition: (point: any, overrideProgress?: number) => {
+        x: any;
+        y: any;
+        z: any;
+    };
+    /**
+     * Update trail progress once per frame.
+     * @param {number} deltaTime - Time since the last update
+     */
+    updateTrailProgress: (deltaTime: number) => void;
+    weightedRandomIndex: (probabilities: any) => any;
+    /**
+     * Update method to be called once per frame.
+     * @param {number} deltaTime - Time since the last frame
+     */
+    update: (deltaTime: number) => void;
+    /**
+     * Adds a random variance to the given value
+     * @param {number} value - The value to calculate
+     * @param {number} variance - The random variance to add
+     * @returns {number} The calculated value
+     */
+    calculate: (value: number, variance: number) => number;
+    /**
+     * Gets the name of the behaviour
+     * @return {string} The name of the behaviour
+     */
+    getName(): string;
+    /**
+     * Retrieves the properties of the custom points.
+     * @returns {Object[]} The array of custom points and their properties.
+     */
+    getProps(): {
+        enabled: boolean;
+        priority: number;
+        trailingEnabled: boolean;
+        spawnAlongTrail: boolean;
+        trailSpeed: number;
+        trailRepeat: boolean;
+        trailStart: number;
+        customPoints: any[];
+        name: string;
+    };
+}