melonjs 17.4.0 → 18.0.0

package/src/particles/particle.js

@@ -1,182 +0,0 @@
-import pool from "./../system/pooling.js";
-import timer from "./../system/timer.js";
-import { randomFloat, clamp } from "./../math/math.js";
-import Renderable from "./../renderable/renderable.js";
-
-/**
- * @import ParticleEmitter from "./emitter.js";
- */
-
-/**
- * @classdesc
- * Single Particle Object.
- * @augments Renderable
- */
-export default class Particle extends Renderable {
-    /**
-     * @param {ParticleEmitter} emitter - the particle emitter
-     */
-    constructor(emitter) {
-        // Call the super constructor
-        super(
-            emitter.getRandomPointX(),
-            emitter.getRandomPointY(),
-            emitter.settings.image.width,
-            emitter.settings.image.height
-        );
-        this.onResetEvent(emitter, true);
-    }
-
-    /**
-     * @ignore
-     */
-    onResetEvent(emitter, newInstance = false) {
-        if (newInstance === false) {
-            this.pos.set(
-                emitter.getRandomPointX(),
-                emitter.getRandomPointY()
-            );
-            this.resize(
-                emitter.settings.image.width,
-                emitter.settings.image.height
-            );
-            this.currentTransform.identity();
-        } else {
-            // particle velocity
-            this.vel = pool.pull("Vector2d");
-        }
-
-        this.image = emitter.settings.image;
-
-        // Particle will always update
-        this.alwaysUpdate = true;
-
-        if (typeof emitter.settings.tint === "string") {
-            this.tint.parseCSS(emitter.settings.tint);
-        }
-
-        if (emitter.settings.textureAdditive === true) {
-            this.blendMode = "additive";
-        }
-
-        if (emitter.settings.blendMode !== "normal") {
-            this.blendMode = emitter.settings.blendMode;
-        }
-
-        // Set the start particle Angle and Speed as defined in emitter
-        let angle = emitter.settings.angle + ((emitter.settings.angleVariation > 0) ? (randomFloat(0, 2) - 1) * emitter.settings.angleVariation : 0);
-        let speed = emitter.settings.speed + ((emitter.settings.speedVariation > 0) ? (randomFloat(0, 2) - 1) * emitter.settings.speedVariation : 0);
-
-        // Set the start particle Velocity
-        this.vel.set(speed * Math.cos(angle), -speed * Math.sin(angle));
-
-        // Set the start particle Time of Life as defined in emitter
-        this.life = randomFloat(emitter.settings.minLife, emitter.settings.maxLife);
-        this.startLife = this.life;
-
-        // Set the start and end particle Scale as defined in emitter
-        // clamp the values as minimum and maximum scales range
-        this.startScale = clamp(
-            randomFloat(emitter.settings.minStartScale, emitter.settings.maxStartScale),
-            emitter.settings.minStartScale,
-            emitter.settings.maxStartScale
-        );
-        this.endScale = clamp(
-            randomFloat(emitter.settings.minEndScale, emitter.settings.maxEndScale),
-            emitter.settings.minEndScale,
-            emitter.settings.maxEndScale
-        );
-
-        // Set the particle Gravity and Wind (horizontal gravity) as defined in emitter
-        this.gravity = emitter.settings.gravity;
-        this.wind = emitter.settings.wind;
-
-        // Set if the particle update the rotation in accordance the trajectory
-        this.followTrajectory = emitter.settings.followTrajectory;
-
-        // Set if the particle update only in Viewport
-        this.onlyInViewport = emitter.settings.onlyInViewport;
-
-        // cache inverse of the expected delta time
-        this._deltaInv = timer.maxfps / 1000;
-
-        // Set the start particle rotation as defined in emitter
-        // if the particle not follow trajectory
-        if (!emitter.settings.followTrajectory) {
-            this.angle = randomFloat(emitter.settings.minRotation, emitter.settings.maxRotation);
-        }
-    }
-
-    /**
-     * Update the Particle <br>
-     * This is automatically called by the game manager {@link game}
-     * @ignore
-     * @param {number} dt - time since the last update in milliseconds
-     */
-    update(dt) {
-        // move things forward independent of the current frame rate
-        let skew = dt * this._deltaInv;
-
-        // Decrease particle life
-        this.life = this.life > dt ? this.life - dt : 0;
-
-        if (this.life <= 0) {
-            this.ancestor.removeChild(this);
-            return false;
-        }
-
-        // Calculate the particle Age Ratio
-        let ageRatio = this.life / this.startLife;
-
-        // Resize the particle as particle Age Ratio
-        let scale = this.startScale;
-        if (this.startScale > this.endScale) {
-            scale *= ageRatio;
-            scale = (scale < this.endScale) ? this.endScale : scale;
-        }
-        else if (this.startScale < this.endScale) {
-            scale /= ageRatio;
-            scale = (scale > this.endScale) ? this.endScale : scale;
-        }
-
-        // Set the particle opacity as Age Ratio
-        this.alpha = ageRatio;
-
-        // Adjust the particle velocity
-        this.vel.x += this.wind * skew;
-        this.vel.y += this.gravity * skew;
-
-        // If necessary update the rotation of particle in accordance the particle trajectory
-        let angle = this.followTrajectory ? Math.atan2(this.vel.y, this.vel.x) : this.angle;
-
-        this.pos.x += this.vel.x * skew;
-        this.pos.y += this.vel.y * skew;
-
-        // Update particle transform
-        this.currentTransform.setTransform(
-            scale, 0, 0,
-            0, scale, 0,
-            this.pos.x, this.pos.y, 1
-        ).rotate(angle);
-
-        // mark as dirty if the particle is not dead yet
-        this.isDirty = this.inViewport || !this.onlyInViewport;
-
-        return super.update(dt);
-    }
-
-    /**
-     * @ignore
-     */
-    draw(renderer) {
-        let w = this.width, h = this.height;
-        renderer.drawImage(
-            this.image,
-            0, 0,
-            w, h,
-            -w / 2, -h / 2,
-            w, h
-        );
-    }
-}
-

package/src/particles/settings.js

@@ -1,310 +0,0 @@
-/**
- * ParticleEmitterSettings contains the default settings for ParticleEmitter
- * @see ParticleEmitter
- * @namespace ParticleEmitterSettings
- */
-const ParticleEmitterSettings = {
-    /**
-     * Width of the particle spawn area.
-     * @type {number}
-     * @name width
-     * @memberof ParticleEmitterSettings
-     * @default 1
-     */
-    width : 1,
-
-    /**
-     * Height of the particle spawn area
-     * @public
-     * @type {number}
-     * @name height
-     * @memberof ParticleEmitterSettings
-     * @default 1
-     */
-    height : 1,
-
-    /**
-     * image used for particles texture
-     * (by default melonJS will create an white 8x8 texture image)
-     * @public
-     * @type {HTMLCanvasElement}
-     * @name image
-     * @memberof ParticleEmitterSettings
-     * @default undefined
-     * @see ParticleEmitterSettings.textureSize
-     */
-    image : undefined,
-
-    /**
-     * default texture size used for particles if no image is specified
-     * (by default melonJS will create an white 8x8 texture image)
-     * @public
-     * @type {number}
-     * @name textureSize
-     * @memberof ParticleEmitterSettings
-     * @default 8
-     * @see ParticleEmitterSettings.image
-     */
-    textureSize : 8,
-
-    /**
-     * tint to be applied to particles
-     * @public
-     * @type {string}
-     * @name tint
-     * @memberof ParticleEmitterSettings
-     * @default "#fff"
-     */
-    tint : "#fff",
-
-    /**
-     * Total number of particles in the emitter
-     * @public
-     * @type {number}
-     * @name totalParticles
-     * @default 50
-     * @memberof ParticleEmitterSettings
-     */
-    totalParticles : 50,
-
-    /**
-     * Start angle for particle launch in Radians
-     * @public
-     * @type {number}
-     * @name angle
-     * @default Math.PI / 2
-     * @memberof ParticleEmitterSettings
-     */
-    angle : Math.PI / 2,
-
-    /**
-     * letiation in the start angle for particle launch in Radians.
-     * @public
-     * @type {number}
-     * @name angleVariation
-     * @default 0
-     * @memberof ParticleEmitterSettings
-     */
-    angleVariation : 0,
-
-    /**
-     * Minimum time each particle lives once it is emitted in ms.
-     * @public
-     * @type {number}
-     * @name minLife
-     * @default 1000
-     * @memberof ParticleEmitterSettings
-     */
-    minLife : 1000,
-
-    /**
-     * Maximum time each particle lives once it is emitted in ms.
-     * @public
-     * @type {number}
-     * @name maxLife
-     * @default 3000
-     * @memberof ParticleEmitterSettings
-     */
-    maxLife : 3000,
-
-    /**
-     * Start speed of particles.<br>
-     * @public
-     * @type {number}
-     * @name speed
-     * @default 2
-     * @memberof ParticleEmitterSettings
-     */
-    speed : 2,
-
-    /**
-     * letiation in the start speed of particles
-     * @public
-     * @type {number}
-     * @name speedVariation
-     * @default 1
-     * @memberof ParticleEmitterSettings
-     */
-    speedVariation : 1,
-
-    /**
-     * Minimum start rotation for particles sprites in Radians
-     * @public
-     * @type {number}
-     * @name minRotation
-     * @default 0
-     * @memberof ParticleEmitterSettings
-     */
-    minRotation : 0,
-
-    /**
-     * Maximum start rotation for particles sprites in Radians
-     * @public
-     * @type {number}
-     * @name maxRotation
-     * @default 0
-     * @memberof ParticleEmitterSettings
-     */
-    maxRotation : 0,
-
-    /**
-     * Minimum start scale ratio for particles (1 = no scaling)
-     * @public
-     * @type {number}
-     * @name minStartScale
-     * @default 1
-     * @memberof ParticleEmitterSettings
-     */
-    minStartScale : 1,
-
-    /**
-     * Maximum start scale ratio for particles (1 = no scaling)
-     * @public
-     * @type {number}
-     * @name maxStartScale
-     * @default 1
-     * @memberof ParticleEmitterSettings
-     */
-    maxStartScale : 1,
-
-    /**
-     * Minimum end scale ratio for particles
-     * @public
-     * @type {number}
-     * @name minEndScale
-     * @default 0
-     * @memberof ParticleEmitterSettings
-     */
-    minEndScale : 0,
-
-    /**
-     * Maximum end scale ratio for particles
-     * @public
-     * @type {number}
-     * @name maxEndScale
-     * @default 0
-     * @memberof ParticleEmitterSettings
-     */
-    maxEndScale : 0,
-
-    /**
-     * Vertical force (Gravity) for each particle
-     * @public
-     * @type {number}
-     * @name gravity
-     * @default 0
-     * @memberof ParticleEmitterSettings
-     * @see game.world.gravity
-     */
-    gravity : 0,
-
-    /**
-     * Horizontal force (like a Wind) for each particle
-     * @public
-     * @type {number}
-     * @name wind
-     * @default 0
-     * @memberof ParticleEmitterSettings
-     */
-    wind : 0,
-
-    /**
-     * Update the rotation of particle in accordance the particle trajectory.<br>
-     * The particle sprite should aim at zero angle (draw from left to right).<br>
-     * Override the particle minRotation and maxRotation.<br>
-     * @public
-     * @type {boolean}
-     * @name followTrajectory
-     * @default false
-     * @memberof ParticleEmitterSettings
-     */
-    followTrajectory : false,
-
-    /**
-     * Enable the Texture Additive by composite operation ("additive" blendMode)
-     * @public
-     * @type {boolean}
-     * @name textureAdditive
-     * @default false
-     * @memberof ParticleEmitterSettings
-     * @see ParticleEmitterSettings.blendMode
-     */
-    textureAdditive : false,
-
-    /**
-     * the blend mode to be applied when rendering particles.
-     * (note: this will superseed the `textureAdditive` setting if different than "normal")
-     * @public
-     * @type {string}
-     * @name blendMode
-     * @default normal
-     * @memberof ParticleEmitterSettings
-     * @see CanvasRenderer#setBlendMode
-     * @see WebGLRenderer#setBlendMode
-     */
-    blendMode : "normal",
-
-    /**
-     * Update particles only in the viewport, remove it when out of viewport.
-     * @public
-     * @type {boolean}
-     * @name onlyInViewport
-     * @default true
-     * @memberof ParticleEmitterSettings
-     */
-    onlyInViewport : true,
-
-    /**
-     * Render particles in screen space.
-     * @public
-     * @type {boolean}
-     * @name floating
-     * @default false
-     * @memberof ParticleEmitterSettings
-     */
-    floating : false,
-
-    /**
-     * Maximum number of particles launched each time in this emitter (used only if emitter is Stream).
-     * @public
-     * @type {number}
-     * @name maxParticles
-     * @default 10
-     * @memberof ParticleEmitterSettings
-     */
-    maxParticles : 10,
-
-    /**
-     * How often a particle is emitted in ms (used only if emitter is a Stream).
-     * @public
-     * @type {number}
-     * @name frequency
-     * @default 100
-     * @memberof ParticleEmitterSettings
-     */
-    frequency : 100,
-
-    /**
-     * Duration that the emitter releases particles in ms (used only if emitter is Stream).
-     * After this period, the emitter stop the launch of particles.
-     * @public
-     * @type {number}
-     * @name duration
-     * @default Infinity
-     * @memberof ParticleEmitterSettings
-     */
-    duration : Infinity,
-
-    /**
-     * Skip n frames after updating the particle system once.
-     * This can be used to reduce the performance impact of emitters with many particles.
-     * @public
-     * @type {number}
-     * @name framesToSkip
-     * @default 0
-     * @memberof ParticleEmitterSettings
-     */
-    framesToSkip : 0
-};
-
-export default ParticleEmitterSettings;