melonjs 14.3.0 → 14.4.0

package/dist/melonjs.mjs/level/tiled/TMXGroup.js

@@ -1,9 +1,9 @@
 /*!
- * melonJS Game Engine - v14.3.0
+ * melonJS Game Engine - v14.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
- * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
  */
 import { applyTMXProperties } from './TMXUtils.js';
 import TMXObject from './TMXObject.js';
@@ -22,66 +22,45 @@ class TMXGroup {
 
         /**
          * group name
-         * @public
          * @type {string}
-         * @name name
-         * @memberof TMXGroup
          */
         this.name = data.name;
 
         /**
          * group width
-         * @public
          * @type {number}
-         * @name width
-         * @memberof TMXGroup
          */
         this.width = data.width || 0;
 
         /**
          * group height
-         * @public
          * @type {number}
-         * @name height
-         * @memberof TMXGroup
          */
         this.height = data.height || 0;
 
         /**
          * tint color
-         * @public
          * @type {string}
-         * @name tintcolor
-         * @memberof TMXGroup
          */
         this.tintcolor = data.tintcolor;
 
 
         /**
          * the group class
-         * @public
          * @type {string}
-         * @name class
-         * @memberof TMXGroup
          */
         this.class = data.class;
 
         /**
          * group z order
-         * @public
          * @type {number}
-         * @name z
-         * @memberof TMXGroup
          */
         this.z = z;
 
         /**
          * group objects list definition
          * @see TMXObject
-         * @public
          * @type {object[]}
-         * @name name
-         * @memberof TMXGroup
          */
         this.objects = [];
 

package/dist/melonjs.mjs/level/tiled/TMXLayer.js

@@ -1,9 +1,9 @@
 /*!
- * melonJS Game Engine - v14.3.0
+ * melonJS Game Engine - v14.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
- * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
  */
 import { createCanvas } from '../../video/video.js';
 import pool from '../../system/pooling.js';
@@ -17,34 +17,43 @@ import { game } from '../../index.js';
  * Create required arrays for the given layer object
  * @ignore
  */
-function initArray(layer) {
+function initArray(rows, cols) {
     // initialize the array
-    layer.layerData = new Array(layer.cols);
-    for (var x = 0; x < layer.cols; x++) {
-        layer.layerData[x] = new Array(layer.rows);
-        for (var y = 0; y < layer.rows; y++) {
-            layer.layerData[x][y] = null;
+    var array = new Array(cols);
+    for (var col = 0; col < cols; col++) {
+        array[col] = new Array(rows);
+        for (var row = 0; row < rows; row++) {
+            array[col][row] = null;
         }
     }
+    return array;
 }
 
 /**
  * Set a tiled layer Data
  * @ignore
  */
-function setLayerData(layer, data) {
+function setLayerData(layer, bounds, data) {
     var idx = 0;
-    // initialize the data array
-    initArray(layer);
+    var width, height;
+
+    // layer provide rows and cols, chunk width and height
+    if (typeof bounds.rows === "undefined") {
+        width = bounds.width;
+        height = bounds.height;
+    } else {
+        width = bounds.cols;
+        height = bounds.rows;
+    }
     // set everything
-    for (var y = 0; y < layer.rows; y++) {
-        for (var x = 0; x < layer.cols; x++) {
+    for (var y = 0; y < height; y++) {
+        for (var x = 0; x < width; x++) {
             // get the value of the gid
             var gid = data[idx++];
             // fill the array
             if (gid !== 0) {
                 // add a new tile to the layer
-                layer.layerData[x][y] = layer.getTileById(gid, x, y);
+                layer.layerData[x + bounds.x][y + bounds.y] = layer.getTileById(gid, x + bounds.x, y + bounds.y);
             }
         }
     }
@@ -96,11 +105,23 @@ function preRenderLayer(layer, renderer) {
         // layer orientation
         this.orientation = orientation;
 
+        /**
+         * Horizontal layer offset in tiles
+         * @default 0
+         * @type {number}
+         */
+        this.x = 0;
+
+        /**
+         * Vertical layer offset in tiles
+         * @default 0
+         * @type {number}
+         */
+        this.y = 0;
+
         /**
          * The Layer corresponding Tilesets
-         * @public
          * @type {TMXTilesetGroup}
-         * @name TMXLayer#tilesets
          */
         this.tilesets = tilesets;
 
@@ -121,36 +142,27 @@ function preRenderLayer(layer, renderer) {
 
         /**
          * All animated tilesets in this layer
-         * @ignore
          * @type {TMXTileset[]}
-         * @name TMXLayer#animatedTilesets
          */
         this.animatedTilesets = [];
 
         /**
          * Layer contains tileset animations
-         * @public
          * @type {boolean}
-         * @name TMXLayer#isAnimated
          */
         this.isAnimated = false;
 
         /**
          * the order in which tiles on orthogonal tile layers are rendered.
          * (valid values are "left-down", "left-up", "right-down", "right-up")
-         * @public
          * @type {string}
          * @default "right-down"
-         * @name TMXLayer#renderorder
          */
         this.renderorder = data.renderorder || "right-down";
 
         /**
          * the layer class
-         * @public
          * @type {string}
-         * @name class
-         * @name TMXLayer#class
          */
         this.class = data.class;
 
@@ -196,14 +208,36 @@ function preRenderLayer(layer, renderer) {
         this.setRenderer(map.getRenderer());
 
 
-        // initialize and set the layer data
-        setLayerData(this,
-            decode(
-                data.data,
-                data.encoding,
-                data.compression
-            )
-        );
+        // initialize the data array
+        this.layerData = initArray(this.rows, this.cols);
+
+        if (map.infinite === 0) {
+            // initialize and set the layer data
+            setLayerData(
+                this,
+                this,
+                decode(
+                    data.data,
+                    data.encoding,
+                    data.compression
+                )
+            );
+        } else if (map.infinite === 1) {
+            // infinite map, initialize per chunk
+            data.chunks.forEach((chunk) => {
+                // initialize and set the layer data
+                setLayerData(
+                    this,
+                    chunk,
+                    decode(
+                        chunk.data,
+                        data.encoding,
+                        data.compression
+                    )
+                );
+            });
+        }
+
     }
 
 
@@ -255,9 +289,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * Set the TMX renderer for this layer object
-     * @name setRenderer
-     * @memberof TMXLayer
-     * @public
      * @param {TMXRenderer} renderer
      * @example
      * // use the parent map default renderer
@@ -270,9 +301,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * Return the layer current renderer object
-     * @name getRenderer
-     * @memberof TMXLayer
-     * @public
      * @returns {TMXRenderer} renderer
      */
     getRenderer() {
@@ -282,9 +310,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * Return the TileId of the Tile at the specified position
-     * @name getTileId
-     * @memberof TMXLayer
-     * @public
      * @param {number} x - X coordinate (in world/pixels coordinates)
      * @param {number} y - Y coordinate (in world/pixels coordinates)
      * @returns {number} TileId or null if there is no Tile at the given position
@@ -296,9 +321,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * Return the Tile object at the specified position
-     * @name getTile
-     * @memberof TMXLayer
-     * @public
      * @param {number} x - X coordinate (in world/pixels coordinates)
      * @param {number} y - Y coordinate (in world/pixels coordinates)
      * @returns {Tile} corresponding tile or null if there is no defined tile at the coordinate or if outside of the layer bounds
@@ -321,9 +343,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * assign the given Tile object to the specified position
-     * @name getTile
-     * @memberof TMXLayer
-     * @public
      * @param {Tile} tile - the tile object to be assigned
      * @param {number} x - x coordinate (in world/pixels coordinates)
      * @param {number} y - y coordinate (in world/pixels coordinates)
@@ -336,9 +355,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * return a new the Tile object corresponding to the given tile id
-     * @name setTile
-     * @memberof TMXLayer
-     * @public
      * @param {number} tileId - tileId
      * @param {number} x - X coordinate (in world/pixels coordinates)
      * @param {number} y - Y coordinate (in world/pixels coordinates)
@@ -354,9 +370,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * Return the Tile object at the specified tile coordinates
-     * @name cellAt
-     * @memberof TMXLayer
-     * @public
      * @param {number} x - x position of the tile (in Tile unit)
      * @param {number} y - x position of the tile (in Tile unit)
      * @param {number} [boundsCheck=true] - check first if within the layer bounds
@@ -380,9 +393,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * clear the tile at the specified position
-     * @name clearTile
-     * @memberof TMXLayer
-     * @public
      * @param {number} x - X coordinate (in map coordinates: row/column)
      * @param {number} y - Y coordinate (in map coordinates: row/column)
      * @example

package/dist/melonjs.mjs/level/tiled/TMXObject.js

@@ -1,9 +1,9 @@
 /*!
- * melonJS Game Engine - v14.3.0
+ * melonJS Game Engine - v14.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
- * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
  */
 import pool from '../../system/pooling.js';
 import { applyTMXProperties } from './TMXUtils.js';
@@ -22,185 +22,125 @@ class TMXObject {
 
         /**
          * point list in JSON format
-         * @public
          * @type {object[]}
-         * @name points
-         * @memberof TMXObject
          */
         this.points = undefined;
 
         /**
          * object name
-         * @public
          * @type {string}
-         * @name name
-         * @memberof TMXObject
          */
         this.name = settings.name;
 
         /**
          * object x position
-         * @public
          * @type {number}
-         * @name x
-         * @memberof TMXObject
          */
         this.x = +settings.x;
 
         /**
          * object y position
-         * @public
          * @type {number}
-         * @name y
-         * @memberof TMXObject
          */
         this.y = +settings.y;
 
         /**
          * object z order
-         * @public
          * @type {number}
-         * @name z
-         * @memberof TMXObject
          */
         this.z = +z;
 
         /**
          * object width
-         * @public
          * @type {number}
-         * @name width
-         * @memberof TMXObject
          */
         this.width = +settings.width || 0;
 
         /**
          * object height
-         * @public
          * @type {number}
-         * @name height
-         * @memberof TMXObject
          */
         this.height = +settings.height || 0;
 
         /**
          * object gid value
          * when defined the object is a tiled object
-         * @public
          * @type {number}
-         * @name gid
-         * @memberof TMXObject
          */
         this.gid = +settings.gid || null;
 
         /**
          * tint color
-         * @public
          * @type {string}
-         * @name tintcolor
-         * @memberof TMXObject
          */
         this.tintcolor = settings.tintcolor;
 
         /**
          * object type
-         * @public
          * @type {string}
          * @deprecated since Tiled 1.9
          * @see https://docs.mapeditor.org/en/stable/reference/tmx-changelog/#tiled-1-9
-         * @name type
-         * @memberof TMXObject
          */
         this.type = settings.type;
 
         /**
          * the object class
-         * @public
          * @type {string}
-         * @name class
-         * @memberof TMXObject
          */
         this.class = typeof settings.class !== "undefined" ? settings.class : settings.type;
 
         /**
          * object text
-         * @public
          * @type {object}
          * @see http://docs.mapeditor.org/en/stable/reference/tmx-map-format/#text
-         * @name text
-         * @memberof TMXObject
          */
         this.text = undefined;
 
         /**
          * The rotation of the object in radians clockwise (defaults to 0)
-         * @public
          * @type {number}
-         * @name rotation
-         * @memberof TMXObject
          */
         this.rotation = degToRad(+settings.rotation || 0);
 
         /**
          * object unique identifier per level (Tiled 0.11.x+)
-         * @public
          * @type {number}
-         * @name id
-         * @memberof TMXObject
          */
         this.id = +settings.id || undefined;
 
         /**
          * object orientation (orthogonal or isometric)
-         * @public
          * @type {string}
-         * @name orientation
-         * @memberof TMXObject
          */
         this.orientation = map.orientation;
 
         /**
          * the collision shapes defined for this object
-         * @public
          * @type {object[]}
-         * @name shapes
-         * @memberof TMXObject
          */
         this.shapes = undefined;
 
         /**
          * if true, the object is an Ellipse
-         * @public
          * @type {boolean}
-         * @name isEllipse
-         * @memberof TMXObject
          */
         this.isEllipse = false;
 
         /**
          * if true, the object is a Point
-         * @public
          * @type {boolean}
-         * @name isPoint
-         * @memberof TMXObject
          */
         this.isPoint = false;
 
         /**
          * if true, the object is a Polygon
-         * @public
          * @type {boolean}
-         * @name isPolygon
-         * @memberof TMXObject
          */
         this.isPolygon = false;
 
         /**
          * if true, the object is a PolyLine
-         * @public
          * @type {boolean}
-         * @name isPolyLine
-         * @memberof TMXObject
          */
         this.isPolyLine = false;
 
@@ -272,8 +212,6 @@ class TMXObject {
 
     /**
      * parses the TMX shape definition and returns a corresponding array of me.Shape object
-     * @name parseTMXShapes
-     * @memberof TMXObject
      * @private
      * @returns {Polygon[]|Line[]|Ellipse[]} an array of shape objects
      */

package/dist/melonjs.mjs/level/tiled/TMXTile.js

@@ -1,19 +1,14 @@
 /*!
- * melonJS Game Engine - v14.3.0
+ * melonJS Game Engine - v14.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
- * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
  */
 import Matrix2d from '../../math/matrix2.js';
 import Sprite from '../../renderable/sprite.js';
 import Bounds from '../../physics/bounds.js';
-
-// bitmask constants to check for flipped & rotated tiles
-const TMX_FLIP_H          = 0x80000000,
-      TMX_FLIP_V          = 0x40000000,
-      TMX_FLIP_AD         = 0x20000000,
-      TMX_CLEAR_BIT_MASK  = ~(0x80000000 | 0x40000000 | 0x20000000);
+import { TMX_CLEAR_BIT_MASK, TMX_FLIP_H, TMX_FLIP_V, TMX_FLIP_AD } from './constants.js';
 
 /**
  * @classdesc
@@ -47,9 +42,7 @@ const TMX_FLIP_H          = 0x80000000,
 
         /**
          * tileset
-         * @public
          * @type {TMXTileset}
-         * @name Tile#tileset
          */
         this.tileset = tileset;
 
@@ -65,38 +58,31 @@ const TMX_FLIP_H          = 0x80000000,
 
         /**
          * tileId
-         * @public
          * @type {number}
-         * @name Tile#tileId
          */
         this.tileId = gid;
+
         /**
-         * True if the tile is flipped horizontally<br>
-         * @public
+         * True if the tile is flipped horizontally
          * @type {boolean}
-         * @name Tile#flipX
          */
         this.flippedX  = (this.tileId & TMX_FLIP_H) !== 0;
+
         /**
-         * True if the tile is flipped vertically<br>
-         * @public
+         * True if the tile is flipped vertically
          * @type {boolean}
-         * @name Tile#flippedY
          */
         this.flippedY  = (this.tileId & TMX_FLIP_V) !== 0;
+
         /**
-         * True if the tile is flipped anti-diagonally<br>
-         * @public
+         * True if the tile is flipped anti-diagonally
          * @type {boolean}
-         * @name Tile#flippedAD
          */
         this.flippedAD = (this.tileId & TMX_FLIP_AD) !== 0;
 
         /**
-         * Global flag that indicates if the tile is flipped<br>
-         * @public
+         * Global flag that indicates if the tile is flipped
          * @type {boolean}
-         * @name Tile#flipped
          */
         this.flipped = this.flippedX || this.flippedY || this.flippedAD;
 
@@ -137,8 +123,6 @@ const TMX_FLIP_H          = 0x80000000,
 
     /**
      * return a renderable object for this Tile object
-     * @name Tile#getRenderable
-     * @public
      * @param {object} [settings] - see {@link Sprite}
      * @returns {Renderable} a me.Sprite object
      */