custom-pixi-particles 4.19.3 → 4.20.0

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

@@ -18,5 +18,6 @@ declare const behaviourNames: {
     LIGHT_EFFECT_BEHAVIOUR: string;
     STRETCH_BEHAVIOUR: string;
     TEMPERATURE_BEHAVIOUR: string;
+    MOVE_TO_POINT_BEHAVIOUR: string;
 };
 export default behaviourNames;

package/dist/lib/behaviour/BehaviourNames.js

@@ -18,6 +18,7 @@ const behaviourNames = {
     LIGHT_EFFECT_BEHAVIOUR: 'LightEffectBehaviour',
     STRETCH_BEHAVIOUR: 'StretchBehaviour',
     TEMPERATURE_BEHAVIOUR: 'TemperatureBehaviour',
+    MOVE_TO_POINT_BEHAVIOUR: 'MoveToPointBehaviour',
 };
 export default behaviourNames;
 //# sourceMappingURL=BehaviourNames.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"BehaviourNames.js","sourceRoot":"","sources":["../../../src/lib/behaviour/BehaviourNames.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG;IACrB,iBAAiB,EAAE,0BAA0B;IAC7C,cAAc,EAAE,eAAe;IAC/B,eAAe,EAAE,gBAAgB;IACjC,kBAAkB,EAAE,mBAAmB;IACvC,cAAc,EAAE,eAAe;IAC/B,cAAc,EAAE,wBAAwB;IACxC,kBAAkB,EAAE,mBAAmB;IACvC,oBAAoB,EAAE,qBAAqB;IAC3C,mBAAmB,EAAE,oBAAoB;IACzC,8BAA8B,EAAE,8BAA8B;IAC9D,4BAA4B,EAAE,2BAA2B;IACzD,sBAAsB,EAAE,sBAAsB;IAC9C,eAAe,EAAE,gBAAgB;IACjC,kBAAkB,EAAE,mBAAmB;IACvC,kBAAkB,EAAE,mBAAmB;IACvC,wBAAwB,EAAE,wBAAwB;IAClD,sBAAsB,EAAE,sBAAsB;IAC9C,iBAAiB,EAAE,kBAAkB;IACrC,qBAAqB,EAAE,sBAAsB;CAC9C,CAAA;AAED,eAAe,cAAc,CAAA"}
+{"version":3,"file":"BehaviourNames.js","sourceRoot":"","sources":["../../../src/lib/behaviour/BehaviourNames.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG;IACrB,iBAAiB,EAAE,0BAA0B;IAC7C,cAAc,EAAE,eAAe;IAC/B,eAAe,EAAE,gBAAgB;IACjC,kBAAkB,EAAE,mBAAmB;IACvC,cAAc,EAAE,eAAe;IAC/B,cAAc,EAAE,wBAAwB;IACxC,kBAAkB,EAAE,mBAAmB;IACvC,oBAAoB,EAAE,qBAAqB;IAC3C,mBAAmB,EAAE,oBAAoB;IACzC,8BAA8B,EAAE,8BAA8B;IAC9D,4BAA4B,EAAE,2BAA2B;IACzD,sBAAsB,EAAE,sBAAsB;IAC9C,eAAe,EAAE,gBAAgB;IACjC,kBAAkB,EAAE,mBAAmB;IACvC,kBAAkB,EAAE,mBAAmB;IACvC,wBAAwB,EAAE,wBAAwB;IAClD,sBAAsB,EAAE,sBAAsB;IAC9C,iBAAiB,EAAE,kBAAkB;IACrC,qBAAqB,EAAE,sBAAsB;IAC7C,uBAAuB,EAAE,sBAAsB;CAChD,CAAA;AAED,eAAe,cAAc,CAAA"}

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

@@ -0,0 +1,64 @@
+import { Behaviour } from './index';
+import Particle from '../Particle';
+import { Point } from '../util';
+/**
+ * MoveToPointBehaviour makes particles move towards a specified target point
+ * when active.
+ * @extends Behaviour
+ */
+export default class MoveToPointBehaviour extends Behaviour {
+    enabled: boolean;
+    /**
+     * When true, particles will move towards the targetPoint.
+     */
+    active: boolean;
+    /**
+     * The target (x, y) coordinates for the particles.
+     */
+    targetPoint: Point;
+    /**
+     * The speed at which particles move towards the target point (units per second).
+     */
+    speed: number;
+    /**
+     * Priority determines execution order. A lower number means it runs later.
+     * This should run after default position behaviours to override the particle's position.
+     * PositionBehaviour is 100, EmitDirection is 0. Set to -10 to run after them.
+     */
+    priority: number;
+    constructor();
+    /**
+     * Initializes particle properties for the behaviour.
+     * This behaviour doesn't require specific per-particle initialization at creation time,
+     * as its effect is mostly global and trigger-based.
+     * @param {Particle} particle - The particle to initialize.
+     */
+    init: (particle: Particle) => void;
+    /**
+     * Applies the behaviour to the particle. If active, moves the particle
+     * towards the targetPoint.
+     * @param {Particle} particle - The particle to apply the behaviour to.
+     * @param {number} deltaTime - Time elapsed since the last frame.
+     */
+    apply: (particle: Particle, deltaTime: number) => void;
+    /**
+     * Gets the name of the behaviour.
+     * @returns {string} - The name of the behaviour.
+     */
+    getName(): string;
+    /**
+     * Gets the properties of the behaviour for configuration.
+     * @returns {object} - The properties of the behaviour.
+     */
+    getProps(): {
+        enabled: boolean;
+        active: boolean;
+        targetPoint: {
+            x: number;
+            y: number;
+        };
+        speed: number;
+        priority: number;
+        name: string;
+    };
+}

package/dist/lib/behaviour/MoveToPointBehaviour.js

@@ -0,0 +1,110 @@
+import { Behaviour, BehaviourNames } from './index';
+import { Point } from '../util';
+/**
+ * MoveToPointBehaviour makes particles move towards a specified target point
+ * when active.
+ * @extends Behaviour
+ */
+export default class MoveToPointBehaviour extends Behaviour {
+    constructor() {
+        super();
+        this.enabled = true;
+        /**
+         * When true, particles will move towards the targetPoint.
+         */
+        this.active = false;
+        /**
+         * The target (x, y) coordinates for the particles.
+         */
+        this.targetPoint = new Point(0, 0);
+        /**
+         * The speed at which particles move towards the target point (units per second).
+         */
+        this.speed = 100;
+        /**
+         * Priority determines execution order. A lower number means it runs later.
+         * This should run after default position behaviours to override the particle's position.
+         * PositionBehaviour is 100, EmitDirection is 0. Set to -10 to run after them.
+         */
+        this.priority = -10;
+        /**
+         * Initializes particle properties for the behaviour.
+         * This behaviour doesn't require specific per-particle initialization at creation time,
+         * as its effect is mostly global and trigger-based.
+         * @param {Particle} particle - The particle to initialize.
+         */
+        this.init = (particle) => {
+            // No particle-specific setup needed when it's created,
+            // as the movement is controlled by the 'active' state of the behaviour.
+        };
+        /**
+         * Applies the behaviour to the particle. If active, moves the particle
+         * towards the targetPoint.
+         * @param {Particle} particle - The particle to apply the behaviour to.
+         * @param {number} deltaTime - Time elapsed since the last frame.
+         */
+        this.apply = (particle, deltaTime) => {
+            if (!this.enabled || !this.active) {
+                // If the behaviour is not enabled or not active, do nothing.
+                // The particle will continue its movement based on other behaviours.
+                return;
+            }
+            const dx = this.targetPoint.x - particle.x;
+            const dy = this.targetPoint.y - particle.y;
+            const distance = Math.sqrt(dx * dx + dy * dy);
+            // When this behaviour is active, it takes full control of the particle's position.
+            // We also zero out current velocity and acceleration to prevent interference
+            // from other behaviours for this frame's positioning.
+            particle.velocity.set(0, 0);
+            particle.acceleration.set(0, 0);
+            // If particle is already at or very close to the target
+            if (distance < 1.0) {
+                // Using a small threshold to prevent jittering
+                particle.x = this.targetPoint.x;
+                particle.y = this.targetPoint.y;
+            }
+            else {
+                const moveAmount = this.speed * deltaTime;
+                if (moveAmount >= distance) {
+                    // If the movement step is enough to reach the target, snap to target
+                    particle.x = this.targetPoint.x;
+                    particle.y = this.targetPoint.y;
+                }
+                else {
+                    // Move towards the target
+                    particle.x += (dx / distance) * moveAmount;
+                    particle.y += (dy / distance) * moveAmount;
+                }
+            }
+            // Sync particle.movement to the new x, y. This helps if this behaviour
+            // becomes inactive, allowing other behaviours like PositionBehaviour
+            // to resume more smoothly from the particle's current position.
+            particle.movement.x = particle.x;
+            particle.movement.y = particle.y;
+        };
+        // Ensure targetPoint is initialized as a Point instance for copyFromRawData in parser
+        this.targetPoint = new Point(0, 0);
+    }
+    /**
+     * Gets the name of the behaviour.
+     * @returns {string} - The name of the behaviour.
+     */
+    getName() {
+        return BehaviourNames.MOVE_TO_POINT_BEHAVIOUR;
+    }
+    /**
+     * Gets the properties of the behaviour for configuration.
+     * @returns {object} - The properties of the behaviour.
+     */
+    getProps() {
+        return {
+            enabled: this.enabled,
+            active: this.active,
+            targetPoint: { x: this.targetPoint.x, y: this.targetPoint.y },
+            speed: this.speed,
+            priority: this.priority,
+            name: this.getName(),
+        };
+    }
+}
+//# sourceMappingURL=MoveToPointBehaviour.js.map

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

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

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

@@ -20,4 +20,5 @@ import SoundReactiveBehaviour from './SoundReactiveBehaviour';
 import LightEffectBehaviour from './LightEffectBehaviour';
 import StretchBehaviour from './StretchBehaviour';
 import TemperatureBehaviour from './TemperatureBehaviour';
-export { EmitterBehaviours, Behaviour, SpawnBehaviour, LifeBehaviour, PositionBehaviour, ColorBehaviour, SizeBehaviour, AngularVelocityBehaviour, EmitDirectionBehaviour, RotationBehaviour, TurbulenceBehaviour, CollisionBehaviour, AttractionRepulsionBehaviour, NoiseBasedMotionBehaviour, ForceFieldsBehaviour, TimelineBehaviour, GroupingBehaviour, SoundReactiveBehaviour, LightEffectBehaviour, StretchBehaviour, TemperatureBehaviour, BehaviourNames, };
+import MoveToPointBehaviour from './MoveToPointBehaviour';
+export { EmitterBehaviours, Behaviour, SpawnBehaviour, LifeBehaviour, PositionBehaviour, ColorBehaviour, SizeBehaviour, AngularVelocityBehaviour, EmitDirectionBehaviour, RotationBehaviour, TurbulenceBehaviour, CollisionBehaviour, AttractionRepulsionBehaviour, NoiseBasedMotionBehaviour, ForceFieldsBehaviour, TimelineBehaviour, GroupingBehaviour, SoundReactiveBehaviour, LightEffectBehaviour, StretchBehaviour, TemperatureBehaviour, BehaviourNames, MoveToPointBehaviour, };

package/dist/lib/behaviour/index.js

@@ -20,5 +20,6 @@ import SoundReactiveBehaviour from './SoundReactiveBehaviour';
 import LightEffectBehaviour from './LightEffectBehaviour';
 import StretchBehaviour from './StretchBehaviour';
 import TemperatureBehaviour from './TemperatureBehaviour';
-export { EmitterBehaviours, Behaviour, SpawnBehaviour, LifeBehaviour, PositionBehaviour, ColorBehaviour, SizeBehaviour, AngularVelocityBehaviour, EmitDirectionBehaviour, RotationBehaviour, TurbulenceBehaviour, CollisionBehaviour, AttractionRepulsionBehaviour, NoiseBasedMotionBehaviour, ForceFieldsBehaviour, TimelineBehaviour, GroupingBehaviour, SoundReactiveBehaviour, LightEffectBehaviour, StretchBehaviour, TemperatureBehaviour, BehaviourNames, };
+import MoveToPointBehaviour from './MoveToPointBehaviour';
+export { EmitterBehaviours, Behaviour, SpawnBehaviour, LifeBehaviour, PositionBehaviour, ColorBehaviour, SizeBehaviour, AngularVelocityBehaviour, EmitDirectionBehaviour, RotationBehaviour, TurbulenceBehaviour, CollisionBehaviour, AttractionRepulsionBehaviour, NoiseBasedMotionBehaviour, ForceFieldsBehaviour, TimelineBehaviour, GroupingBehaviour, SoundReactiveBehaviour, LightEffectBehaviour, StretchBehaviour, TemperatureBehaviour, BehaviourNames, MoveToPointBehaviour, };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/behaviour/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAC7C,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,SAAS,MAAM,aAAa,CAAA;AACnC,OAAO,aAAa,MAAM,iBAAiB,CAAA;AAC3C,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAC7C,OAAO,4BAA4B,MAAM,gCAAgC,CAAA;AACzE,OAAO,aAAa,MAAM,iBAAiB,CAAA;AAC3C,OAAO,wBAAwB,MAAM,4BAA4B,CAAA;AACjE,OAAO,sBAAsB,MAAM,0BAA0B,CAAA;AAC7D,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,mBAAmB,MAAM,uBAAuB,CAAA;AACvD,OAAO,kBAAkB,MAAM,sBAAsB,CAAA;AACrD,OAAO,yBAAyB,MAAM,6BAA6B,CAAA;AACnE,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AACzD,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAC7C,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,sBAAsB,MAAM,0BAA0B,CAAA;AAC7D,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AACzD,OAAO,gBAAgB,MAAM,oBAAoB,CAAA;AACjD,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AAEzD,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,GACf,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/behaviour/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAC7C,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,SAAS,MAAM,aAAa,CAAA;AACnC,OAAO,aAAa,MAAM,iBAAiB,CAAA;AAC3C,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAC7C,OAAO,4BAA4B,MAAM,gCAAgC,CAAA;AACzE,OAAO,aAAa,MAAM,iBAAiB,CAAA;AAC3C,OAAO,wBAAwB,MAAM,4BAA4B,CAAA;AACjE,OAAO,sBAAsB,MAAM,0BAA0B,CAAA;AAC7D,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,mBAAmB,MAAM,uBAAuB,CAAA;AACvD,OAAO,kBAAkB,MAAM,sBAAsB,CAAA;AACrD,OAAO,yBAAyB,MAAM,6BAA6B,CAAA;AACnE,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AACzD,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAC7C,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,sBAAsB,MAAM,0BAA0B,CAAA;AAC7D,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AACzD,OAAO,gBAAgB,MAAM,oBAAoB,CAAA;AACjD,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AACzD,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AAEzD,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,GACrB,CAAA"}

package/package.json

@@ -42,5 +42,5 @@
     "lint": "tslint 'src/**/*.ts'",
     "lint:fix": "tslint --fix 'src/**/*.ts'"
   },
-  "version": "4.19.3"
+  "version": "4.20.0"
 }