melonjs 9.0.1 → 9.1.2

package/README.md

@@ -45,9 +45,9 @@ and currently features :
     - Uncompressed Plain, Base64, CSV and JSON encoded XML tilemap loading
     - Orthogonal, Isometric and Hexagonal maps (both normal and staggered)
     - Multiple layers (multiple background/foreground, collision and Image layers)
-    - Multiple Tileset support
-    - Tileset Transparency settings
-    - Layers Alpha settings
+    - Animated and multiple Tileset support
+    - Tileset transparency settings
+    - Layers alpha and tinting settings
     - Rectangle, Ellipse, Polygon and Polyline objects support
     - Tiled Objects
     - Flipped & rotated Tiles
@@ -68,7 +68,7 @@ Using melonJS
 Basic Example
 
 ```JavaScript
-import * as me from "melonjs-module.js"
+import * as me from "melonjs.module.js";
 
 me.device.onReady(function () {
     // initialize the display canvas once the device/browser is ready
@@ -118,7 +118,7 @@ Since version 9.0.0 melonJS provides different build options :
 | ------------------- | ----------- |
 | `melonjs.js`        | a legacy ES5 UMD Bundle (directly transpiled from the ES6 version) including full API backward compatibility with previous versions |
 | `melonjs.min.js`    | a minified version of the ES5 UMD bundle version |
-| `melonjs-module.js` | a ES6 Module Bundle, for those living on the edge, and with no backward compatibility (note: this will break your game when upgrading!) |
+| `melonjs.module.js` | a ES6 Module Bundle, for those living on the edge, and with no backward compatibility (note: this will break your game when upgrading!) |
 
 > Note: current version of both the tutorials and the debugPanel are not compatible with the ES6 version.
 
@@ -126,9 +126,9 @@ Alternatively, the latest version of melonJS can be installed through [NPM](http
 
     $ npm install melonjs
 
-If you need to import the ES6 module of melonjs :
+If you need to import the ES6 module of melonjs (for Webpack):
 
-    $ import * as me from "melonjs-module.js";
+    $ import * as me from 'melonjs/dist/melonjs.module.js';
 
 > Note: when using the es6 module, deprecated methods need to be manually applied, see [here](http://melonjs.github.io/melonJS/docs/me.deprecated.html#.apply)
 
@@ -138,7 +138,7 @@ Or can simply be added to your html, through a content delivery network (CDN) UR
 <!-- load the ES5 UMD bundle of melonJS v9.0.0 -->
 <script src="https://cdn.jsdelivr.net/npm/melonjs@9.0.0/dist/melonjs.js"></script>
 <!-- load the ES6 module bundle of melonJS v9.0.0 -->
-<script src="https://cdn.jsdelivr.net/npm/melonjs@9.0.0/dist/melonjs-module.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/melonjs@9.0.0/dist/melonjs.module.js"></script>
 <!-- omit the version completely to get the latest one -->
 <!-- you should NOT use this in production -->
 <script src="https://cdn.jsdelivr.net/npm/melonjs/dist/melonjs.js"></script>
@@ -176,7 +176,7 @@ Then build the melonJS source by running:
 The generated library will be available under the `build` directory :
 - `melonjs.js` : plain ES5 UMD bundle
 - `melonjs.min.js` : minified ES5 UMD bundle
-- `melonjs-module.js` : plain ES6 module
+- `melonjs.module.js` : plain ES6 module
 
 To run the melonJS test suite simply use the following:
 

package/dist/melonjs.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v9.0.1
+ * melonJS Game Engine - v9.1.2
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -9,7 +9,7 @@
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
     typeof define === 'function' && define.amd ? define(['exports'], factory) :
     (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.me = {}));
-}(this, (function (exports) { 'use strict';
+})(this, (function (exports) { 'use strict';
 
     /* eslint-disable no-global-assign, no-native-reassign */
     if (typeof console === "undefined") {
@@ -72,7 +72,7 @@
         return str.replace(/\s+$/, "");
     }
     /**
-     * returns true if the given string contains a numeric (integer) value
+     * returns true if the given string contains a numeric integer or float value
      * @public
      * @function
      * @memberOf me.utils.string
@@ -84,7 +84,7 @@
         if (typeof str === "string") {
             str = str.trim();
         }
-        return !isNaN(str) && /^\d+$/.test(str);
+        return !isNaN(str) && /[+-]?([0-9]*[.])?[0-9]+/.test(str);
     }
     /**
      * returns true if the given string contains a true or false
@@ -10681,6 +10681,37 @@
             return this;
         },
 
+        /**
+         * Shifts the Polygon to the given position vector.
+         * @name shift
+         * @memberOf me.Polygon
+         * @function
+         * @param {me.Vector2d} position
+         */
+        /**
+         * Shifts the Polygon to the given x, y position.
+         * @name shift
+         * @memberOf me.Polygon
+         * @function
+         * @param {Number} x
+         * @param {Number} y
+         */
+        shift: function shift() {
+            var _x, _y;
+            if (arguments.length === 2) {
+                // x, y
+                _x = arguments[0];
+                _y = arguments[1];
+            } else {
+                // vector
+                _x = arguments[0].x;
+                _y = arguments[0].y;
+            }
+            this.pos.x = _x;
+            this.pos.y = _y;
+            this.updateBounds();
+        },
+
         /**
          * Returns true if the polygon contains the given point.
          * (Note: it is highly recommended to first do a hit test on the corresponding <br>
@@ -10892,67 +10923,6 @@
             return this.setShape(rect.pos.x, rect.pos.y, rect.width, rect.height);
         },
 
-        /**
-         * translate the rect by the specified offset
-         * @name translate
-         * @memberOf me.Rect.prototype
-         * @function
-         * @param {Number} x x offset
-         * @param {Number} y y offset
-         * @return {me.Rect} this rectangle
-         */
-        /**
-         * translate the rect by the specified vector
-         * @name translate
-         * @memberOf me.Rect.prototype
-         * @function
-         * @param {me.Vector2d} v vector offset
-         * @return {me.Rect} this rectangle
-         */
-        translate : function () {
-            var _x, _y;
-
-            if (arguments.length === 2) {
-                // x, y
-                _x = arguments[0];
-                _y = arguments[1];
-            } else {
-                // vector
-                _x = arguments[0].x;
-                _y = arguments[0].y;
-            }
-
-            this.pos.x += _x;
-            this.pos.y += _y;
-
-            return this;
-        },
-
-        /**
-         * Shifts the rect to the given position vector.
-         * @name shift
-         * @memberOf me.Rect
-         * @function
-         * @param {me.Vector2d} position
-         */
-        /**
-         * Shifts the rect to the given x, y position.
-         * @name shift
-         * @memberOf me.Rect
-         * @function
-         * @param {Number} x
-         * @param {Number} y
-         */
-        shift : function () {
-            if (arguments.length === 2) {
-                // x, y
-                this.pos.set(arguments[0], arguments[1]);
-            } else {
-                // vector
-                this.pos.setV(arguments[0]);
-            }
-        },
-
         /**
          * merge this rectangle with another one
          * @name union
@@ -13533,7 +13503,8 @@
              * <img src="images/anchor_point.png"/><br>
              * a Renderable's anchor point defaults to (0.5,0.5), which corresponds to the center position.<br>
              * <br>
-             * <i><b>Note:</b> Object created through Tiled will have their anchorPoint set to (0, 0) to match Tiled Level editor implementation</i>
+             * <i><b>Note:</b> Object created through Tiled will have their anchorPoint set to (0, 0) to match Tiled Level editor implementation.
+             * To specify a value through Tiled, use a json expression like `json:{"x":0.5,"y":0.5}`. </i>
              * @public
              * @type me.ObservableVector2d
              * @default <0.5,0.5>
@@ -21153,6 +21124,10 @@
             } else {
                 // HTMLImageElement/Canvas or String
                 this.image = (typeof settings.image === "object") ? settings.image : loader$1.getImage(settings.image);
+                // throw an error if image ends up being null/undefined
+                if (!this.image) {
+                    throw new Error("me.Sprite: '" + settings.image + "' image/texture not found!");
+                }
                 // update the default "current" frame size
                 this.current.width = settings.framewidth = settings.framewidth || this.image.width;
                 this.current.height = settings.frameheight = settings.frameheight || this.image.height;
@@ -21198,6 +21173,10 @@
                 this.name = settings.name;
             }
 
+            // displaying order
+            if (typeof settings.z !== "undefined") {
+                this.pos.z = settings.z;
+            }
             // for sprite, addAnimation will return !=0
             if (this.addAnimation("default", null) !== 0) {
                 // set as default
@@ -25943,10 +25922,14 @@
             Object.assign({
                 name: data.name,
                 image: data.image,
+                ratio : pool.pull("Vector2d", +data.parallaxx || 1.0, +data.parallaxy || 1.0),
+                // convert to melonJS color format (note: this should be done earlier when parsing data)
+                tint : typeof (data.tintcolor) !== "undefined" ? (pool.pull("Color")).parseHex(data.tintcolor, true) : undefined,
                 z: z
             }, data.properties)
         );
 
+
         // set some additional flags
         var visible = typeof(data.visible) !== "undefined" ? data.visible : true;
         imageLayer.setOpacity(visible ? +data.opacity : 0);
@@ -28391,16 +28374,16 @@
             }
 
             // set pause/stop action on losing focus
-            window.addEventListener("blur", function () {
+            window.addEventListener("blur", (function () {
                 if (this.stopOnBlur) {
                     state$1.stop(true);
                 }
                 if (this.pauseOnBlur) {
                     state$1.pause(true);
                 }
-            }, false);
+            }).bind(this), false);
             // set restart/resume action on gaining focus
-            window.addEventListener("focus", function () {
+            window.addEventListener("focus", (function () {
                 if (this.stopOnBlur) {
                     state$1.restart(true);
                 }
@@ -28411,7 +28394,7 @@
                 if (this.autoFocus) {
                     this.focus();
                 }
-            }, false);
+            }).bind(this), false);
 
 
             // Set the name of the hidden property and the change event for visibility
@@ -28435,7 +28418,7 @@
             if (typeof (visibilityChange) === "string") {
                 // add the corresponding event listener
                 document.addEventListener(visibilityChange,
-                    function () {
+                    (function () {
                         if (document[hidden]) {
                             if (this.stopOnBlur) {
                                 state$1.stop(true);
@@ -28451,7 +28434,7 @@
                                 state$1.resume(true);
                             }
                         }
-                    }, false
+                    }).bind(this), false
                 );
             }
         },
@@ -32506,10 +32489,10 @@
                  * this can be overridden by the plugin
                  * @public
                  * @type String
-                 * @default "9.0.1"
+                 * @default "9.1.2"
                  * @name me.plugin.Base#version
                  */
-                this.version = "9.0.1";
+                this.version = "9.1.2";
             }
         }),
 
@@ -34706,41 +34689,19 @@
      *     repeat :"repeat-x"
      * }), 1);
      */
-    var ImageLayer = Renderable.extend({
+    var ImageLayer = Sprite.extend({
         /**
          * @ignore
          */
         init: function (x, y, settings) {
             // call the constructor
-            this._super(Renderable, "init", [x, y, Infinity, Infinity]);
-
-            // get the corresponding image
-            this.image = (typeof settings.image === "object") ? settings.image : loader$1.getImage(settings.image);
-
-            // throw an error if image is null/undefined
-            if (!this.image) {
-                throw new Error((
-                    (typeof(settings.image) === "string") ?
-                    "'" + settings.image + "'" :
-                    "Image"
-                ) + " file for Image Layer '" + this.name + "' not found!");
-            }
-
-            this.imagewidth = this.image.width;
-            this.imageheight = this.image.height;
-
-            // set the sprite name if specified
-            if (typeof (settings.name) === "string") {
-                this.name = settings.name;
-            }
+            this._super(Sprite, "init", [x, y, settings]);
 
             // render in screen coordinates
             this.floating = true;
 
-            // displaying order
-            this.pos.z = settings.z || 0;
-
-            this.offset = pool.pull("Vector2d", x, y);
+            // image drawing offset
+            this.offset.set(x, y);
 
             /**
              * Define the image scrolling ratio<br>
@@ -34758,8 +34719,8 @@
 
             if (typeof(settings.ratio) !== "undefined") {
                 // little hack for backward compatiblity
-                if (typeof(settings.ratio) === "number") {
-                    this.ratio.set(settings.ratio, settings.ratio);
+                if (utils$1.string.isNumeric(settings.ratio)) {
+                    this.ratio.set(settings.ratio, +settings.ratio);
                 } else /* vector */ {
                     this.ratio.setV(settings.ratio);
                 }
@@ -34875,7 +34836,7 @@
          * @param {Number} h new height
         */
         resize : function (w, h) {
-            this._super(Renderable, "resize", [
+            this._super(Sprite, "resize", [
                 this.repeatX ? Infinity : w,
                 this.repeatY ? Infinity : h
             ]);
@@ -34905,8 +34866,8 @@
             }
 
             var viewport = game$1.viewport,
-                width = this.imagewidth,
-                height = this.imageheight,
+                width = this.width,
+                height = this.height,
                 bw = viewport.bounds.width,
                 bh = viewport.bounds.height,
                 ax = this.anchorPoint.x,
@@ -34949,6 +34910,9 @@
             renderer.save();
             // apply the defined alpha value
             renderer.setGlobalAlpha(renderer.globalAlpha() * this.getOpacity());
+
+            // apply the defined tint, if any
+            renderer.setTint(this.tint);
         },
 
         /**
@@ -34957,8 +34921,8 @@
          */
         draw : function (renderer) {
             var viewport = game$1.viewport,
-                width = this.imagewidth,
-                height = this.imageheight,
+                width = this.width,
+                height = this.height,
                 bw = viewport.bounds.width,
                 bh = viewport.bounds.height,
                 ax = this.anchorPoint.x,
@@ -34995,11 +34959,9 @@
          * @ignore
          */
         destroy : function () {
-            pool.push(this.offset);
-            this.offset = undefined;
             pool.push(this.ratio);
             this.ratio = undefined;
-            this._super(Renderable, "destroy");
+            this._super(Sprite, "destroy");
         }
     });
 
@@ -36781,7 +36743,7 @@
      * @name version
      * @type {string}
      */
-    var version = "9.0.1";
+    var version = "9.1.2";
 
 
     /**
@@ -36976,5 +36938,5 @@
 
     Object.defineProperty(exports, '__esModule', { value: true });
 
-})));
+}));
 me.deprecated.apply();