melonjs 15.2.1 → 15.4.0

package/src/particles/emitter.js

@@ -21,7 +21,7 @@ function createDefaultParticleTexture(w = 8, h = 8) {
  * Particle Emitter Object.
  * @augments Container
  */
- export default class ParticleEmitter extends Container {
+export default class ParticleEmitter extends Container {
     /**
      * @param {number} x - x position of the particle emitter
      * @param {number} y - y position of the particle emitter

package/src/particles/particle.js

@@ -8,7 +8,7 @@ import Renderable from "./../renderable/renderable.js";
  * Single Particle Object.
  * @augments Renderable
  */
- export default class Particle extends Renderable {
+export default class Particle extends Renderable {
     /**
      * @param {ParticleEmitter} emitter - the particle emitter
      */

package/src/physics/body.js

@@ -14,7 +14,7 @@ import Point from "../geometries/point.js";
  * a Generic Physic Body Object with some physic properties and behavior functionality, to as a member of a Renderable.
  * @see Renderable.body
  */
- export default class Body {
+export default class Body {
     /**
      * @param {Renderable|Container|Entity|Sprite|NineSliceSprite} ancestor - the parent object this body is attached to
      * @param {Rect|Rect[]|Polygon|Polygon[]|Line|Line[]|Ellipse|Ellipse[]|Point|Point[]|Bounds|Bounds[]|object} [shapes] - a initial shape, list of shapes, or JSON object defining the body
@@ -516,32 +516,34 @@ import Point from "../geometries/point.js";
 
     /**
      * Returns true if the any of the shape composing the body contains the given point.
-     * @method Body#contains
-     * @param {Vector2d} point
-     * @returns {boolean} true if contains
-     */
-    /**
-     * Returns true if the any of the shape composing the body contains the given point.
-     * @param  {number} x -  x coordinate
-     * @param  {number} y -  y coordinate
+     * @param {number|Vector2d} x -  x coordinate or a vector point to check
+     * @param {number} [y] -  y coordinate
      * @returns {boolean} true if contains
+     * @example
+     * if (mySprite.body.contains(10, 10)) {
+     *   // do something
+     * }
+     * // or
+     * if (mySprite.body.contains(myVector2d)) {
+     *   // do something
+     * }
      */
     contains() {
         let _x, _y;
 
         if (arguments.length === 2) {
-          // x, y
-          _x = arguments[0];
-          _y = arguments[1];
+            // x, y
+            _x = arguments[0];
+            _y = arguments[1];
         } else {
-          // vector
-          _x = arguments[0].x;
-          _y = arguments[0].y;
+            // vector
+            _x = arguments[0].x;
+            _y = arguments[0].y;
         }
 
         if (this.getBounds().contains(_x, _y)) {
-             // cannot use forEach here as cannot break out with a return
-             for (let i = this.shapes.length, shape; i--, (shape = this.shapes[i]);) {
+            // cannot use forEach here as cannot break out with a return
+            for (let i = this.shapes.length, shape; i--, (shape = this.shapes[i]);) {
                 if (shape.contains(_x, _y)) {
                     return true;
                 }
@@ -633,7 +635,7 @@ import Point from "../geometries/point.js";
 
             this.vel.x = (
                 (nx < 0) ? nx :
-                ( x > 0) ? x  : 0
+                    ( x > 0) ? x  : 0
             );
         }
         if (this.friction.y > 0) {
@@ -643,7 +645,7 @@ import Point from "../geometries/point.js";
 
             this.vel.y = (
                 (ny < 0) ? ny :
-                ( y > 0) ? y  : 0
+                    ( y > 0) ? y  : 0
             );
         }
 

package/src/physics/bounds.js

@@ -5,7 +5,7 @@ import Vector2d from "./../math/vector2.js";
  * @classdesc
  * a bound object contains methods for creating and manipulating axis-aligned bounding boxes (AABB).
  */
- export default class Bounds {
+export default class Bounds {
     /**
      * @param {Vector2d[]|Point[]} [vertices] - an array of Vector2d or Point
      */
@@ -254,17 +254,17 @@ import Vector2d from "./../math/vector2.js";
 
     /**
      * Returns true if the bounds contains the given point.
-     * @name contains
-     * @memberof Bounds
-     * @method
-     * @param {Vector2d} point
-     * @returns {boolean} True if the bounds contain the point, otherwise false
-     */
-    /**
-     * Returns true if the bounds contains the given point.
-     * @param {number} x
-     * @param {number} y
+     * @param {number|Vector2d} x -  x coordinate or a vector point to check
+     * @param {number} [y] - y coordinate
      * @returns {boolean} True if the bounds contain the point, otherwise false
+     * @example
+     * if (bounds.contains(10, 10)) {
+     *   // do something
+     * }
+     * // or
+     * if (bounds.contains(myVector2d)) {
+     *   // do something
+     * }
      */
     contains() {
         let arg0 = arguments[0];
@@ -274,8 +274,8 @@ import Vector2d from "./../math/vector2.js";
             _x1 = _x2 = arg0;
             _y1 = _y2 = arguments[1];
         } else {
-            if (arg0 instanceof Bounds) {
-                // bounds
+            if (typeof arg0.max !== "undefined") {
+                // only bounds define min and max properties
                 _x1 = arg0.min.x;
                 _x2 = arg0.max.x;
                 _y1 = arg0.min.y;
@@ -310,16 +310,13 @@ import Vector2d from "./../math/vector2.js";
     }
 
     /**
-     * Translates the bounds by the given vector.
-     * @name translate
-     * @memberof Bounds
-     * @method
-     * @param {Vector2d} vector
-     */
-    /**
-     * Translates the bounds by x on the x axis, and y on the y axis
-     * @param {number} x
-     * @param {number} y
+     * Translates the bounds by the given point
+     * @param {number|Vector2d} x -  x coordinate or a vector point to translate by
+     * @param {number} [y]
+     * @example
+     * bounds.translate(10, 10);
+     * // or
+     * bounds.translate(myVector2d);
      */
     translate() {
         let _x, _y;
@@ -338,17 +335,14 @@ import Vector2d from "./../math/vector2.js";
         this.max.y += _y;
     }
 
-    /**
-     * Shifts the bounds to the given position vector.
-     * @name shift
-     * @memberof Bounds
-     * @method
-     * @param {Vector2d} position
-     */
     /**
      * Shifts the bounds to the given x, y position.
-     * @param {number} x
-     * @param {number} y
+     * @param {number|Vector2d} x -  x coordinate or a vector point to shift to
+     * @param {number} [y]
+     * @example
+     * bounds.shift(10, 10);
+     * // or
+     * bounds.shift(myVector2d);
      */
     shift() {
         let _x, _y;

package/src/physics/collision.js

@@ -8,7 +8,7 @@ import { game } from "../index.js";
 
 let collision = {
 
-     /**
+    /**
       * The maximum number of children that a quadtree node can contain before it is split into sub-nodes.
       * @name maxChildren
       * @memberof collision
@@ -17,9 +17,9 @@ let collision = {
       * @default 8
       * @see game.world.broadphase
       */
-     maxChildren : 8,
+    maxChildren : 8,
 
-     /**
+    /**
       * The maximum number of levels that the quadtree will create.
       * @name maxDepth
       * @memberof collision
@@ -28,7 +28,7 @@ let collision = {
       * @default 4
       * @see game.world.broadphase
       */
-     maxDepth : 4,
+    maxDepth : 4,
 
     /**
      * Enum for collision type values.

package/src/physics/detector.js

@@ -62,7 +62,7 @@ export default class Detector {
      * detect collision between two bodies.
      * @param {Body} bodyA - a reference to body A.
      * @param {Body} bodyB - a reference to body B.
-     * @returns {Boolean} true if colliding
+     * @returns {boolean} true if colliding
      */
     collides(bodyA, bodyB, response = this.response) {
         // for each shape in body A
@@ -71,13 +71,13 @@ export default class Detector {
             for (let indexB = bodyB.shapes.length, shapeB; indexB--, (shapeB = bodyB.shapes[indexB]);) {
                 // full SAT collision check
                 if (SAT["test" + shapeA.shapeType + shapeB.shapeType].call(
-                        this,
-                        bodyA.ancestor, // a reference to the object A
-                        shapeA,
-                        bodyB.ancestor,  // a reference to the object B
-                        shapeB,
-                        // clear response object before reusing
-                        response.clear()) === true
+                    this,
+                    bodyA.ancestor, // a reference to the object A
+                    shapeA,
+                    bodyB.ancestor,  // a reference to the object B
+                    shapeB,
+                    // clear response object before reusing
+                    response.clear()) === true
                 ) {
 
                     // set the shape index
@@ -190,7 +190,7 @@ export default class Detector {
                             shapeA,
                             objB,  // a reference to the object B
                             shapeB
-                    )) {
+                        )) {
                         // we touched something !
                         result[collisionCounter] = objB;
                         collisionCounter++;

package/src/physics/quadtree.js

@@ -51,7 +51,7 @@ let QT_VECTOR = new Vector2d();
  * a QuadTree implementation in JavaScript, a 2d spatial subdivision algorithm.
  * @see game.world.broadphase
  */
- export default class QuadTree {
+export default class QuadTree {
     /**
      * @param {World} world - the physic world this QuadTree belongs to
      * @param {Bounds} bounds - bounds of the node
@@ -83,7 +83,7 @@ let QT_VECTOR = new Vector2d();
             left = this.bounds.left,
             top = this.bounds.top;
 
-         //top right node
+        //top right node
         this.nodes[0] = QT_ARRAY_POP(
             this.world,
             {
@@ -279,7 +279,7 @@ let QT_VECTOR = new Vector2d();
             if (index !== -1) {
                 returnObjects = returnObjects.concat(this.nodes[index].retrieve(item));
             } else {
-                 //if rect does not fit into a subnode, check it against all subnodes
+                //if rect does not fit into a subnode, check it against all subnodes
                 for (let i = 0; i < this.nodes.length; i = i + 1) {
                     returnObjects = returnObjects.concat(this.nodes[i].retrieve(item));
                 }
@@ -301,7 +301,7 @@ let QT_VECTOR = new Vector2d();
      * @param {object} item - object to be removed
      * @returns {boolean} true if the item was found and removed.
      */
-     remove(item) {
+    remove(item) {
         let found = false;
 
         if (typeof (item.getBounds) === "undefined") {

package/src/physics/sat.js

@@ -205,10 +205,9 @@ export function testPolygonPolygon(a, polyA, b, polyB, response) {
     // aboslute shape position
     let posA = T_VECTORS.pop().copy(a.pos).add(a.ancestor.getAbsolutePosition()).add(polyA.pos);
     let posB = T_VECTORS.pop().copy(b.pos).add(b.ancestor.getAbsolutePosition()).add(polyB.pos);
-    let i;
 
     // If any of the edge normals of A is a separating axis, no intersection.
-    for (i = 0; i < aLen; i++) {
+    for (let i = 0; i < aLen; i++) {
         if (isSeparatingAxis(posA, posB, aPoints, bPoints, aNormals[i], response)) {
             T_VECTORS.push(posA);
             T_VECTORS.push(posB);
@@ -217,7 +216,7 @@ export function testPolygonPolygon(a, polyA, b, polyB, response) {
     }
 
     // If any of the edge normals of B is a separating axis, no intersection.
-    for (i = 0; i < bLen; i++) {
+    for (let i = 0; i < bLen; i++) {
         if (isSeparatingAxis(posA, posB, aPoints, bPoints, bNormals[i], response)) {
             T_VECTORS.push(posA);
             T_VECTORS.push(posB);

package/src/physics/world.js

@@ -11,7 +11,7 @@ import state from "./../state/state.js";
  * an object representing the physic world, and responsible for managing and updating all childs and physics
  * @augments Container
  */
- export default class World extends Container {
+export default class World extends Container {
     /**
      * @param {number} [x=0] - position of the container (accessible via the inherited pos.x property)
      * @param {number} [y=0] - position of the container (accessible via the inherited pos.y property)
@@ -50,13 +50,10 @@ import state from "./../state/state.js";
         this.gravity = new Vector2d(0, 0.98);
 
         /**
-         * Specify the rendering method for tile layers. <br>
-         * if false visible part of the layers are rendered dynamically,<br>
-         * if true the entire layers are first rendered into an offscreen canvas.<br>
-         * the "best" rendering method depends of your game
-         * (amount of layer, layer size, amount of tiles per layer, etc.)<br>
-         * note : rendering method is also configurable per layer by adding this
-         * property to your layer (in Tiled).
+         * Enabled pre-rendering for all tile layers. <br>
+         * If false layers are rendered dynamically, if true layers are first fully rendered into an offscreen canvas.<br>
+         * the "best" rendering method depends of your game (amount of layer, layer size, amount of tiles per layer, etc.)<br>
+         * Note : rendering method is also configurable per layer by adding a boolean "preRender" property to your layer in Tiled ({@link https://doc.mapeditor.org/en/stable/manual/custom-properties/#adding-properties}).
          * @type {boolean}
          * @default false
          */