melonjs 10.9.0 → 10.12.0

package/src/math/vector2.js

@@ -37,7 +37,6 @@ class Vector2d {
      * set the Vector x and y properties to the given values<br>
      * @name set
      * @memberof Vector2d
-     * @function
      * @param {number} x
      * @param {number} y
      * @returns {Vector2d} Reference to this object for method chaining
@@ -52,7 +51,7 @@ class Vector2d {
         /**
          * x value of the vector
          * @public
-         * @type {number}
+         * @member {number}
          * @name x
          * @memberof Vector2d
          */
@@ -61,7 +60,7 @@ class Vector2d {
         /**
          * y value of the vector
          * @public
-         * @type {number}
+         * @member {number}
          * @name y
          * @memberof Vector2d
          */
@@ -74,7 +73,6 @@ class Vector2d {
      * set the Vector x and y properties to 0
      * @name setZero
      * @memberof Vector2d
-     * @function
      * @returns {Vector2d} Reference to this object for method chaining
      */
     setZero() {
@@ -85,7 +83,6 @@ class Vector2d {
      * set the Vector x and y properties using the passed vector
      * @name setV
      * @memberof Vector2d
-     * @function
      * @param {Vector2d} v
      * @returns {Vector2d} Reference to this object for method chaining
      */
@@ -97,7 +94,6 @@ class Vector2d {
      * Add the passed vector to this vector
      * @name add
      * @memberof Vector2d
-     * @function
      * @param {Vector2d} v
      * @returns {Vector2d} Reference to this object for method chaining
      */
@@ -109,7 +105,6 @@ class Vector2d {
      * Substract the passed vector to this vector
      * @name sub
      * @memberof Vector2d
-     * @function
      * @param {Vector2d} v
      * @returns {Vector2d} Reference to this object for method chaining
      */
@@ -121,7 +116,6 @@ class Vector2d {
      * Multiply this vector values by the given scalar
      * @name scale
      * @memberof Vector2d
-     * @function
      * @param {number} x
      * @param {number} [y=x]
      * @returns {Vector2d} Reference to this object for method chaining
@@ -134,7 +128,6 @@ class Vector2d {
      * Convert this vector into isometric coordinate space
      * @name toIso
      * @memberof Vector2d
-     * @function
      * @returns {Vector2d} Reference to this object for method chaining
      */
     toIso() {
@@ -145,7 +138,6 @@ class Vector2d {
      * Convert this vector into 2d coordinate space
      * @name to2d
      * @memberof Vector2d
-     * @function
      * @returns {Vector2d} Reference to this object for method chaining
      */
     to2d() {
@@ -156,7 +148,6 @@ class Vector2d {
      * Multiply this vector values by the passed vector
      * @name scaleV
      * @memberof Vector2d
-     * @function
      * @param {Vector2d} v
      * @returns {Vector2d} Reference to this object for method chaining
      */
@@ -168,7 +159,6 @@ class Vector2d {
      * Divide this vector values by the passed value
      * @name div
      * @memberof Vector2d
-     * @function
      * @param {number} n the value to divide the vector by
      * @returns {Vector2d} Reference to this object for method chaining
      */
@@ -180,7 +170,6 @@ class Vector2d {
      * Update this vector values to absolute values
      * @name abs
      * @memberof Vector2d
-     * @function
      * @returns {Vector2d} Reference to this object for method chaining
      */
     abs() {
@@ -191,7 +180,6 @@ class Vector2d {
      * Clamp the vector value within the specified value range
      * @name clamp
      * @memberof Vector2d
-     * @function
      * @param {number} low
      * @param {number} high
      * @returns {Vector2d} new me.Vector2d
@@ -204,7 +192,6 @@ class Vector2d {
      * Clamp this vector value within the specified value range
      * @name clampSelf
      * @memberof Vector2d
-     * @function
      * @param {number} low
      * @param {number} high
      * @returns {Vector2d} Reference to this object for method chaining
@@ -217,7 +204,6 @@ class Vector2d {
      * Update this vector with the minimum value between this and the passed vector
      * @name minV
      * @memberof Vector2d
-     * @function
      * @param {Vector2d} v
      * @returns {Vector2d} Reference to this object for method chaining
      */
@@ -229,7 +215,6 @@ class Vector2d {
      * Update this vector with the maximum value between this and the passed vector
      * @name maxV
      * @memberof Vector2d
-     * @function
      * @param {Vector2d} v
      * @returns {Vector2d} Reference to this object for method chaining
      */
@@ -241,7 +226,6 @@ class Vector2d {
      * Floor the vector values
      * @name floor
      * @memberof Vector2d
-     * @function
      * @returns {Vector2d} new me.Vector2d
      */
     floor() {
@@ -252,7 +236,6 @@ class Vector2d {
      * Floor this vector values
      * @name floorSelf
      * @memberof Vector2d
-     * @function
      * @returns {Vector2d} Reference to this object for method chaining
      */
     floorSelf() {
@@ -263,7 +246,6 @@ class Vector2d {
      * Ceil the vector values
      * @name ceil
      * @memberof Vector2d
-     * @function
      * @returns {Vector2d} new me.Vector2d
      */
     ceil() {
@@ -274,7 +256,6 @@ class Vector2d {
      * Ceil this vector values
      * @name ceilSelf
      * @memberof Vector2d
-     * @function
      * @returns {Vector2d} Reference to this object for method chaining
      */
     ceilSelf() {
@@ -285,7 +266,6 @@ class Vector2d {
      * Negate the vector values
      * @name negate
      * @memberof Vector2d
-     * @function
      * @returns {Vector2d} new me.Vector2d
      */
     negate() {
@@ -296,7 +276,6 @@ class Vector2d {
      * Negate this vector values
      * @name negateSelf
      * @memberof Vector2d
-     * @function
      * @returns {Vector2d} Reference to this object for method chaining
      */
     negateSelf() {
@@ -307,7 +286,6 @@ class Vector2d {
      * Copy the x,y values of the passed vector to this one
      * @name copy
      * @memberof Vector2d
-     * @function
      * @param {Vector2d} v
      * @returns {Vector2d} Reference to this object for method chaining
      */
@@ -319,7 +297,7 @@ class Vector2d {
      * return true if the two vectors are the same
      * @name equals
      * @memberof Vector2d
-     * @function
+     * @method
      * @param {Vector2d} v
      * @returns {boolean}
      */
@@ -327,7 +305,6 @@ class Vector2d {
      * return true if this vector is equal to the given values
      * @name equals
      * @memberof Vector2d
-     * @function
      * @param {number} x
      * @param {number} y
      * @returns {boolean}
@@ -350,7 +327,6 @@ class Vector2d {
      * normalize this vector (scale the vector so that its magnitude is 1)
      * @name normalize
      * @memberof Vector2d
-     * @function
      * @returns {Vector2d} Reference to this object for method chaining
      */
     normalize() {
@@ -362,7 +338,6 @@ class Vector2d {
      * (Effectively rotates it 90 degrees in a clockwise direction)
      * @name perp
      * @memberof Vector2d
-     * @function
      * @returns {Vector2d} Reference to this object for method chaining
      */
     perp() {
@@ -373,7 +348,6 @@ class Vector2d {
      * Rotate this vector (counter-clockwise) by the specified angle (in radians).
      * @name rotate
      * @memberof Vector2d
-     * @function
      * @param {number} angle The angle to rotate (in radians)
      * @param {Vector2d|ObservableVector2d} [v] an optional point to rotate around
      * @returns {Vector2d} Reference to this object for method chaining
@@ -400,7 +374,6 @@ class Vector2d {
      * return the dot product of this vector and the passed one
      * @name dot
      * @memberof Vector2d
-     * @function
      * @param {Vector2d} v
      * @returns {number} The dot product.
      */
@@ -412,7 +385,6 @@ class Vector2d {
      * return the cross product of this vector and the passed one
      * @name cross
      * @memberof Vector2d
-     * @function
      * @param {Vector2d} v
      * @returns {number} The cross product.
      */
@@ -424,7 +396,6 @@ class Vector2d {
     * return the square length of this vector
     * @name length2
     * @memberof Vector2d
-    * @function
     * @returns {number} The length^2 of this vector.
     */
     length2() {
@@ -435,7 +406,6 @@ class Vector2d {
      * return the length (magnitude) of this vector
      * @name length
      * @memberof Vector2d
-     * @function
      * @returns {number} the length of this vector
      */
     length() {
@@ -446,7 +416,6 @@ class Vector2d {
      * Linearly interpolate between this vector and the given one.
      * @name lerp
      * @memberof Vector2d
-     * @function
      * @param {Vector2d} v
      * @param {number} alpha distance along the line (alpha = 0 will be this vector, and alpha = 1 will be the given one).
      * @returns {Vector2d} Reference to this object for method chaining
@@ -461,7 +430,6 @@ class Vector2d {
      * return the distance between this vector and the passed one
      * @name distance
      * @memberof Vector2d
-     * @function
      * @param {Vector2d} v
      * @returns {number}
      */
@@ -474,7 +442,6 @@ class Vector2d {
      * return the angle between this vector and the passed one
      * @name angle
      * @memberof Vector2d
-     * @function
      * @param {Vector2d} v
      * @returns {number} angle in radians
      */
@@ -486,7 +453,6 @@ class Vector2d {
      * project this vector on to another vector.
      * @name project
      * @memberof Vector2d
-     * @function
      * @param {Vector2d} v The vector to project onto.
      * @returns {Vector2d} Reference to this object for method chaining
      */
@@ -499,7 +465,6 @@ class Vector2d {
      * This is slightly more efficient than `project` when dealing with unit vectors.
      * @name projectN
      * @memberof Vector2d
-     * @function
      * @param {Vector2d} v The unit vector to project onto.
      * @returns {Vector2d} Reference to this object for method chaining
      */
@@ -511,7 +476,6 @@ class Vector2d {
      * return a clone copy of this vector
      * @name clone
      * @memberof Vector2d
-     * @function
      * @returns {Vector2d} new me.Vector2d
      */
     clone() {
@@ -522,7 +486,6 @@ class Vector2d {
      * convert the object to a string representation
      * @name toString
      * @memberof Vector2d
-     * @function
      * @returns {string}
      */
     toString() {

package/src/math/vector3.js

@@ -40,7 +40,6 @@ class Vector3d {
      * set the Vector x and y properties to the given values<br>
      * @name set
      * @memberof Vector3d
-     * @function
      * @param {number} x
      * @param {number} y
      * @param {number} [z=0]
@@ -56,7 +55,7 @@ class Vector3d {
         /**
          * x value of the vector
          * @public
-         * @type {number}
+         * @member {number}
          * @name x
          * @memberof Vector3d
          */
@@ -65,7 +64,7 @@ class Vector3d {
         /**
          * y value of the vector
          * @public
-         * @type {number}
+         * @member {number}
          * @name y
          * @memberof Vector3d
          */
@@ -74,7 +73,7 @@ class Vector3d {
         /**
          * z value of the vector
          * @public
-         * @type {number}
+         * @member {number}
          * @name z
          * @memberof Vector3d
          */
@@ -87,7 +86,6 @@ class Vector3d {
      * set the Vector x and y properties to 0
      * @name setZero
      * @memberof Vector3d
-     * @function
      * @returns {Vector3d} Reference to this object for method chaining
      */
     setZero() {
@@ -98,7 +96,6 @@ class Vector3d {
      * set the Vector x and y properties using the passed vector
      * @name setV
      * @memberof Vector3d
-     * @function
      * @param {Vector2d|Vector3d} v
      * @returns {Vector3d} Reference to this object for method chaining
      */
@@ -110,7 +107,6 @@ class Vector3d {
      * Add the passed vector to this vector
      * @name add
      * @memberof Vector3d
-     * @function
      * @param {Vector2d|Vector3d} v
      * @returns {Vector3d} Reference to this object for method chaining
      */
@@ -122,7 +118,6 @@ class Vector3d {
      * Substract the passed vector to this vector
      * @name sub
      * @memberof Vector3d
-     * @function
      * @param {Vector2d|Vector3d} v
      * @returns {Vector3d} Reference to this object for method chaining
      */
@@ -134,7 +129,6 @@ class Vector3d {
      * Multiply this vector values by the given scalar
      * @name scale
      * @memberof Vector3d
-     * @function
      * @param {number} x
      * @param {number} [y=x]
      * @param {number} [z=1]
@@ -149,7 +143,6 @@ class Vector3d {
      * Multiply this vector values by the passed vector
      * @name scaleV
      * @memberof Vector3d
-     * @function
      * @param {Vector2d|Vector3d} v
      * @returns {Vector3d} Reference to this object for method chaining
      */
@@ -161,7 +154,6 @@ class Vector3d {
      * Convert this vector into isometric coordinate space
      * @name toIso
      * @memberof Vector3d
-     * @function
      * @returns {Vector3d} Reference to this object for method chaining
      */
     toIso() {
@@ -172,7 +164,6 @@ class Vector3d {
      * Convert this vector into 2d coordinate space
      * @name to2d
      * @memberof Vector3d
-     * @function
      * @returns {Vector3d} Reference to this object for method chaining
      */
     to2d() {
@@ -183,7 +174,6 @@ class Vector3d {
      * Divide this vector values by the passed value
      * @name div
      * @memberof Vector3d
-     * @function
      * @param {number} n the value to divide the vector by
      * @returns {Vector3d} Reference to this object for method chaining
      */
@@ -195,7 +185,6 @@ class Vector3d {
      * Update this vector values to absolute values
      * @name abs
      * @memberof Vector3d
-     * @function
      * @returns {Vector3d} Reference to this object for method chaining
      */
     abs() {
@@ -206,7 +195,6 @@ class Vector3d {
      * Clamp the vector value within the specified value range
      * @name clamp
      * @memberof Vector3d
-     * @function
      * @param {number} low
      * @param {number} high
      * @returns {Vector3d} new me.Vector3d
@@ -219,7 +207,6 @@ class Vector3d {
      * Clamp this vector value within the specified value range
      * @name clampSelf
      * @memberof Vector3d
-     * @function
      * @param {number} low
      * @param {number} high
      * @returns {Vector3d} Reference to this object for method chaining
@@ -232,7 +219,6 @@ class Vector3d {
      * Update this vector with the minimum value between this and the passed vector
      * @name minV
      * @memberof Vector3d
-     * @function
      * @param {Vector2d|Vector3d} v
      * @returns {Vector3d} Reference to this object for method chaining
      */
@@ -245,7 +231,6 @@ class Vector3d {
      * Update this vector with the maximum value between this and the passed vector
      * @name maxV
      * @memberof Vector3d
-     * @function
      * @param {Vector2d|Vector3d} v
      * @returns {Vector3d} Reference to this object for method chaining
      */
@@ -258,7 +243,6 @@ class Vector3d {
      * Floor the vector values
      * @name floor
      * @memberof Vector3d
-     * @function
      * @returns {Vector3d} new me.Vector3d
      */
     floor() {
@@ -269,7 +253,6 @@ class Vector3d {
      * Floor this vector values
      * @name floorSelf
      * @memberof Vector3d
-     * @function
      * @returns {Vector3d} Reference to this object for method chaining
      */
     floorSelf() {
@@ -280,7 +263,6 @@ class Vector3d {
      * Ceil the vector values
      * @name ceil
      * @memberof Vector3d
-     * @function
      * @returns {Vector3d} new me.Vector3d
      */
     ceil() {
@@ -291,7 +273,6 @@ class Vector3d {
      * Ceil this vector values
      * @name ceilSelf
      * @memberof Vector3d
-     * @function
      * @returns {Vector3d} Reference to this object for method chaining
      */
     ceilSelf() {
@@ -302,7 +283,6 @@ class Vector3d {
      * Negate the vector values
      * @name negate
      * @memberof Vector3d
-     * @function
      * @returns {Vector3d} new me.Vector3d
      */
     negate() {
@@ -313,7 +293,6 @@ class Vector3d {
      * Negate this vector values
      * @name negateSelf
      * @memberof Vector3d
-     * @function
      * @returns {Vector3d} Reference to this object for method chaining
      */
     negateSelf() {
@@ -324,7 +303,6 @@ class Vector3d {
      * Copy the components of the given vector into this one
      * @name copy
      * @memberof Vector3d
-     * @function
      * @param {Vector2d|Vector3d} v
      * @returns {Vector3d} Reference to this object for method chaining
      */
@@ -336,7 +314,7 @@ class Vector3d {
      * return true if the two vectors are the same
      * @name equals
      * @memberof Vector3d
-     * @function
+     * @method
      * @param {Vector2d|Vector3d} v
      * @returns {boolean}
      */
@@ -344,7 +322,6 @@ class Vector3d {
      * return true if this vector is equal to the given values
      * @name equals
      * @memberof Vector3d
-     * @function
      * @param {number} x
      * @param {number} y
      * @param {number} [z]
@@ -375,7 +352,6 @@ class Vector3d {
      * normalize this vector (scale the vector so that its magnitude is 1)
      * @name normalize
      * @memberof Vector3d
-     * @function
      * @returns {Vector3d} Reference to this object for method chaining
      */
     normalize() {
@@ -387,7 +363,6 @@ class Vector3d {
      * (Effectively rotates it 90 degrees in a clockwise direction around the z axis)
      * @name perp
      * @memberof Vector3d
-     * @function
      * @returns {Vector3d} Reference to this object for method chaining
      */
     perp() {
@@ -398,7 +373,6 @@ class Vector3d {
      * Rotate this vector (counter-clockwise) by the specified angle (in radians) around the z axis
      * @name rotate
      * @memberof Vector3d
-     * @function
      * @param {number} angle The angle to rotate (in radians)
      * @param {Vector2d|ObservableVector2d} [v] an optional point to rotate around (on the same z axis)
      * @returns {Vector3d} Reference to this object for method chaining
@@ -426,7 +400,6 @@ class Vector3d {
      * return the dot product of this vector and the passed one
      * @name dot
      * @memberof Vector3d
-     * @function
      * @param {Vector2d|Vector3d} v
      * @returns {number} The dot product.
      */
@@ -438,7 +411,6 @@ class Vector3d {
      * calculate the cross product of this vector and the passed one
      * @name cross
      * @memberof Vector3d
-     * @function
      * @param {Vector3d} v
      * @returns {Vector3d} Reference to this object for method chaining
      */
@@ -457,7 +429,6 @@ class Vector3d {
     * return the square length of this vector
     * @name length2
     * @memberof Vector3d
-    * @function
     * @returns {number} The length^2 of this vector.
     */
     length2() {
@@ -468,7 +439,6 @@ class Vector3d {
      * return the length (magnitude) of this vector
      * @name length
      * @memberof Vector3d
-     * @function
      * @returns {number} the length of this vector
      */
     length() {
@@ -479,7 +449,6 @@ class Vector3d {
      * Linearly interpolate between this vector and the given one.
      * @name lerp
      * @memberof Vector3d
-     * @function
      * @param {Vector3d} v
      * @param {number} alpha distance along the line (alpha = 0 will be this vector, and alpha = 1 will be the given one).
      * @returns {Vector3d} Reference to this object for method chaining
@@ -495,7 +464,6 @@ class Vector3d {
      * return the distance between this vector and the passed one
      * @name distance
      * @memberof Vector3d
-     * @function
      * @param {Vector2d|Vector3d} v
      * @returns {number}
      */
@@ -510,7 +478,6 @@ class Vector3d {
      * return the angle between this vector and the passed one
      * @name angle
      * @memberof Vector3d
-     * @function
      * @param {Vector2d|Vector3d} v
      * @returns {number} angle in radians
      */
@@ -522,7 +489,6 @@ class Vector3d {
      * project this vector on to another vector.
      * @name project
      * @memberof Vector3d
-     * @function
      * @param {Vector2d|Vector3d} v The vector to project onto.
      * @returns {Vector3d} Reference to this object for method chaining
      */
@@ -536,7 +502,6 @@ class Vector3d {
      * This is slightly more efficient than `project` when dealing with unit vectors.
      * @name projectN
      * @memberof Vector3d
-     * @function
      * @param {Vector2d|Vector3d} v The unit vector to project onto.
      * @returns {Vector3d} Reference to this object for method chaining
      */
@@ -549,7 +514,6 @@ class Vector3d {
      * return a clone copy of this vector
      * @name clone
      * @memberof Vector3d
-     * @function
      * @returns {Vector3d} new me.Vector3d
      */
     clone() {
@@ -560,7 +524,6 @@ class Vector3d {
      * convert the object to a string representation
      * @name toString
      * @memberof Vector3d
-     * @function
      * @returns {string}
      */
     toString() {

package/src/particles/emitter.js

@@ -1,23 +1,18 @@
-import { createCanvas } from "./../video/video.js";
 import pool from "./../system/pooling.js";
 import ParticleEmitterSettings from "./settings.js";
 import { randomFloat } from "./../math/math.js";
 import Container from "./../renderable/container.js";
 
 
-// default texture used when no sprite is defined
-let defaultParticleTexture;
-
 /**
  * @ignore
  */
 function createDefaultParticleTexture(w = 8, h = 8) {
-    if (typeof defaultParticleTexture === "undefined") {
-        defaultParticleTexture = createCanvas(w, h, true);
-        var context = defaultParticleTexture.getContext("2d");
-        context.fillStyle = "#fff";
-        context.fillRect(0, 0, w, h);
-    }
+    var defaultParticleTexture = pool.pull("CanvasTexture", w, h, { offscreenCanvas: true });
+
+    defaultParticleTexture.context.fillStyle = "#fff";
+    defaultParticleTexture.context.fillRect(0, 0, w, h);
+
     return defaultParticleTexture;
 };
 
@@ -120,9 +115,9 @@ class ParticleEmitter extends Container {
     reset(settings = {}) {
         Object.assign(this.settings, ParticleEmitterSettings, settings);
 
-        // Cache the image reference
         if (typeof this.settings.image === "undefined") {
-            this.settings.image = createDefaultParticleTexture(settings.textureSize, settings.textureSize);
+            this._defaultParticle = createDefaultParticleTexture(settings.textureSize, settings.textureSize);
+            this.settings.image = this._defaultParticle.canvas;
         }
 
         this.floating = this.settings.floating;
@@ -252,6 +247,10 @@ class ParticleEmitter extends Container {
         // call the parent destroy method
         super.destroy(arguments);
         // clean emitter specific Properties
+        if (typeof this._defaultParticle !== "undefined") {
+            pool.push(this._defaultParticle);
+            this._defaultParticle = undefined;
+        }
         this.settings.image = undefined;
         this.settings = undefined;
     }