melonjs 10.10.0 → 10.11.0

package/src/level/tiled/TMXTileMap.js

@@ -16,7 +16,7 @@ import Renderable from "./../../renderable/renderable.js";
 import Container from "./../../renderable/container.js";
 
 // constant to identify the collision object layer
-var COLLISION_GROUP = "collision";
+const COLLISION_GROUP = "collision";
 
 /**
  * set a compatible renderer object
@@ -256,7 +256,6 @@ class TMXTileMap {
      * @name getRenderer
      * @memberof TMXTileMap
      * @public
-     * @function
      * @returns {TMXRenderer} a TMX renderer
      */
     getRenderer() {
@@ -270,7 +269,6 @@ class TMXTileMap {
      * return the map bounding rect
      * @name TMXRenderer#getBounds
      * @public
-     * @function
      * @returns {Bounds}
      */
     getBounds() {
@@ -353,7 +351,6 @@ class TMXTileMap {
      * note : this will not automatically update the camera viewport
      * @name TMXTileMap#addTo
      * @public
-     * @function
      * @param {Container} container target container
      * @param {boolean} [flatten=true] if true, flatten all objects into the given container, else a `me.Container` object will be created for each corresponding groups
      * @param {boolean} [setViewportBounds=false] if true, set the viewport bounds to the map size, this should be set to true especially if adding a level to the game world container.
@@ -430,7 +427,6 @@ class TMXTileMap {
      * return an Array of instantiated objects, based on the map object definition
      * @name TMXTileMap#getObjects
      * @public
-     * @function
      * @param {boolean} [flatten=true] if true, flatten all objects into the returned array.
      * when false, a `me.Container` object will be created for each corresponding groups
      * @returns {Renderable[]} Array of Objects
@@ -601,7 +597,6 @@ class TMXTileMap {
      * return all the existing layers
      * @name TMXTileMap#getLayers
      * @public
-     * @function
      * @returns {TMXLayer[]} Array of Layers
      */
     getLayers() {
@@ -614,7 +609,6 @@ class TMXTileMap {
      * destroy function, clean all allocated objects
      * @name TMXTileMap#destroy
      * @public
-     * @function
      */
     destroy() {
         this.tilesets = undefined;

package/src/level/tiled/TMXTileset.js

@@ -166,7 +166,6 @@ class TMXTileset {
      * return the tile image from a "Collection of Image" tileset
      * @name TMXTileset#getTileImage
      * @public
-     * @function
      * @param {number} gid
      * @returns {Image} corresponding image or undefined
      */
@@ -178,7 +177,6 @@ class TMXTileset {
     /**
      * set the tile properties
      * @ignore
-     * @function
      */
     setTileProperty(gid, prop) {
         // set the given tile id
@@ -189,7 +187,6 @@ class TMXTileset {
      * return true if the gid belongs to the tileset
      * @name TMXTileset#contains
      * @public
-     * @function
      * @param {number} gid
      * @returns {boolean}
      */
@@ -201,7 +198,6 @@ class TMXTileset {
      * Get the view (local) tile ID from a GID, with animations applied
      * @name TMXTileset#getViewTileId
      * @public
-     * @function
      * @param {number} gid Global tile ID
      * @returns {number} View tile ID
      */
@@ -220,7 +216,6 @@ class TMXTileset {
      * return the properties of the specified tile
      * @name TMXTileset#getTileProperties
      * @public
-     * @function
      * @param {number} tileId
      * @returns {object}
      */

package/src/level/tiled/TMXTilesetGroup.js

@@ -1,6 +1,6 @@
 
 // bitmask constants to check for flipped & rotated tiles
-var TMX_CLEAR_BIT_MASK = ~(0x80000000 | 0x40000000 | 0x20000000);
+const TMX_CLEAR_BIT_MASK = ~(0x80000000 | 0x40000000 | 0x20000000);
 
 /**
  * @classdesc
@@ -17,7 +17,6 @@ class TMXTilesetGroup {
      * add a tileset to the tileset group
      * @name TMXTilesetGroup#add
      * @public
-     * @function
      * @param {TMXTileset} tileset
      */
     add(tileset) {
@@ -29,7 +28,6 @@ class TMXTilesetGroup {
      * return the tileset at the specified index
      * @name TMXTilesetGroup#getTilesetByIndex
      * @public
-     * @function
      * @param {number} i
      * @returns {TMXTileset} corresponding tileset
      */
@@ -42,7 +40,6 @@ class TMXTilesetGroup {
      * will throw an exception if no matching tileset is found
      * @name TMXTilesetGroup#getTilesetByGid
      * @public
-     * @function
      * @param {number} gid
      * @returns {TMXTileset} corresponding tileset
      */

package/src/level/tiled/TMXUtils.js

@@ -98,7 +98,6 @@ function parseAttributes(obj, elt) {
 /**
  * decompress zlib/gzip data (NOT IMPLEMENTED)
  * @ignore
- * @function
  * @name decompress
  * @param  {number[]} data Array of bytes
  * @param  {string} format compressed data format ("gzip","zlib")
@@ -110,7 +109,6 @@ export function decompress() {
 /**
  * Decode a CSV encoded array into a binary array
  * @ignore
- * @function
  * @name decodeCSV
  * @param  {string} input CSV formatted data (only numbers, everything else will be converted to NaN)
  * @returns {number[]} Decoded data
@@ -128,7 +126,6 @@ export function decodeCSV(input) {
 /**
  * Decode a base64 encoded string into a byte array
  * @ignore
- * @function
  * @name decodeBase64AsArray
  * @param {string} input Base64 encoded data
  * @param {number} [bytes] number of bytes per array entry

package/src/level/tiled/renderer/TMXHexagonalRenderer.js

@@ -6,13 +6,13 @@ import TMXLayer from "./../TMXLayer.js";
 
 
 // scope global var & constants
-var offsetsStaggerX = [
+const offsetsStaggerX = [
     {x:   0, y:   0},
     {x: + 1, y: - 1},
     {x: + 1, y:   0},
     {x: + 2, y:   0}
 ];
-var offsetsStaggerY = [
+const offsetsStaggerY = [
     {x:   0, y:   0},
     {x: - 1, y: + 1},
     {x:   0, y: + 1},
@@ -81,7 +81,6 @@ class TMXHexagonalRenderer extends TMXRenderer {
      * return the bounding rect for this map renderer
      * @name TMXHexagonalRenderer#getBounds
      * @public
-     * @function
      * @param {TMXLayer} [layer] calculate the bounding rect for a specific layer (will return a new bounds object)
      * @returns {Bounds}
      */

package/src/level/tiled/renderer/TMXIsometricRenderer.js

@@ -41,7 +41,6 @@ class TMXIsometricRenderer extends TMXRenderer {
      * return the bounding rect for this map renderer
      * @name TMXIsometricRenderer#getBounds
      * @public
-     * @function
      * @param {TMXLayer} [layer] calculate the bounding rect for a specific layer (will return a new bounds object)
      * @returns {Bounds}
      */

package/src/level/tiled/renderer/TMXRenderer.js

@@ -2,7 +2,7 @@
 
 import pool from "./../../../system/pooling.js";
 import TMXLayer from "./../TMXLayer.js";
-import Bounds from "./../../../physics/Bounds.js";
+import Bounds from "./../../../physics/bounds.js";
 
 /**
  * @classdesc
@@ -27,7 +27,6 @@ class TMXRenderer {
      * return true if the renderer can render the specified map or layer
      * @name TMXRenderer#canRender
      * @public
-     * @function
      * @param {TMXTileMap|TMXLayer} component TMX Map or Layer
      * @returns {boolean}
      */
@@ -48,7 +47,6 @@ class TMXRenderer {
      * return the bounding rect for this map renderer
      * @name TMXRenderer#getBounds
      * @public
-     * @function
      * @param {TMXLayer} [layer] calculate the bounding rect for a specific layer (will return a new bounds object)
      * @returns {Bounds}
      */
@@ -66,7 +64,6 @@ class TMXRenderer {
      * return the tile position corresponding to the specified pixel
      * @name TMXRenderer#pixelToTileCoords
      * @public
-     * @function
      * @param {number} x X coordinate
      * @param {number} y Y coordinate
      * @param {Vector2d} [v] an optional vector object where to put the return values
@@ -80,7 +77,6 @@ class TMXRenderer {
      * return the pixel position corresponding of the specified tile
      * @name TMXRenderer#tileToPixelCoords
      * @public
-     * @function
      * @param {number} col tile horizontal position
      * @param {number} row tile vertical position
      * @param {Vector2d} [v] an optional vector object where to put the return values
@@ -94,7 +90,6 @@ class TMXRenderer {
      * draw the given tile at the specified layer
      * @name TMXRenderer#drawTile
      * @public
-     * @function
      * @param {CanvasRenderer|WebGLRenderer} renderer a renderer object
      * @param {number} x X coordinate where to draw the tile
      * @param {number} y Y coordinate where to draw the tile
@@ -107,7 +102,6 @@ class TMXRenderer {
      * draw the given TMX Layer for the given area
      * @name TMXRenderer#drawTileLayer
      * @public
-     * @function
      * @param {CanvasRenderer|WebGLRenderer} renderer a renderer object
      * @param {TMXLayer} layer a TMX Layer object
      * @param {Rect} rect the area of the layer to draw

package/src/loader/loader.js

@@ -310,7 +310,6 @@ var loader = {
     /**
      * onload callback
      * @public
-     * @function
      * @name onload
      * @memberof loader
      * @example
@@ -324,7 +323,6 @@ var loader = {
      * each time a resource is loaded, the loader will fire the specified function,
      * giving the actual progress [0 ... 1], as argument, and an object describing the resource loaded
      * @public
-     * @function
      * @name onProgress
      * @memberof loader
      * @example
@@ -412,7 +410,6 @@ var loader = {
      * @name setBaseURL
      * @memberof loader
      * @public
-     * @function
      * @param {string} type  "*", "audio", binary", "image", "json", "js", "tmx", "tsx"
      * @param {string} [url="./"] default base URL
      * @example
@@ -443,7 +440,6 @@ var loader = {
      * @name preload
      * @memberof loader
      * @public
-     * @function
      * @param {object[]} res
      * @param {string} res.name internal name of the resource
      * @param {string} res.type  "audio", binary", "image", "json","js", "tmx", "tsx", "fontface"
@@ -508,7 +504,6 @@ var loader = {
      * @name load
      * @memberof loader
      * @public
-     * @function
      * @param {object} res
      * @param {string} res.name internal name of the resource
      * @param {string} res.type  "audio", binary", "image", "json", "tmx", "tsx"
@@ -578,7 +573,6 @@ var loader = {
      * @name unload
      * @memberof loader
      * @public
-     * @function
      * @param {object} res
      * @param {string} res.name internal name of the resource
      * @param {string} res.type  "audio", binary", "image", "json", "tmx", "tsx"
@@ -640,7 +634,6 @@ var loader = {
      * @name unloadAll
      * @memberof loader
      * @public
-     * @function
      * @example me.loader.unloadAll();
      */
     unloadAll() {
@@ -695,7 +688,6 @@ var loader = {
      * @name getTMX
      * @memberof loader
      * @public
-     * @function
      * @param {string} elt name of the tmx/tsx element ("map1");
      * @returns {object} requested element or null if not found
      */
@@ -713,7 +705,6 @@ var loader = {
      * @name getBinary
      * @memberof loader
      * @public
-     * @function
      * @param {string} elt name of the binary object ("ymTrack");
      * @returns {object} requested element or null if not found
      */
@@ -731,7 +722,6 @@ var loader = {
      * @name getImage
      * @memberof loader
      * @public
-     * @function
      * @param {string} image name of the Image element ("tileset-platformer");
      * @returns {HTMLImageElement} requested element or null if not found
      */
@@ -750,7 +740,6 @@ var loader = {
      * @name getJSON
      * @memberof loader
      * @public
-     * @function
      * @param {string} elt name of the json file to load
      * @returns {object}
      */

package/src/loader/loadingscreen.js

@@ -72,7 +72,7 @@ class IconLogo extends Renderable {
         this.iconTexture = pool.pull("CanvasTexture",
             renderer.WebGLVersion > 1 ? this.width : nextPowerOfTwo(this.width),
             renderer.WebGLVersion > 1 ? this.height : nextPowerOfTwo(this.height),
-            true
+            { offscreenCanvas: true }
         );
 
         var context = this.iconTexture.context;

package/src/math/color.js

@@ -6,11 +6,11 @@ var toHex = function (component) {
     return "0123456789ABCDEF".charAt((component - (component % 16)) >> 4) + "0123456789ABCDEF".charAt(component % 16);
 };
 
-var rgbaRx = /^rgba?\((\d+), ?(\d+), ?(\d+)(, ?([\d\.]+))?\)$/;
-var hex3Rx = /^#([\da-fA-F])([\da-fA-F])([\da-fA-F])$/;
-var hex4Rx = /^#([\da-fA-F])([\da-fA-F])([\da-fA-F])([\da-fA-F])$/;
-var hex6Rx = /^#([\da-fA-F]{2})([\da-fA-F]{2})([\da-fA-F]{2})$/;
-var hex8Rx = /^#([\da-fA-F]{2})([\da-fA-F]{2})([\da-fA-F]{2})([\da-fA-F]{2})$/;
+const rgbaRx = /^rgba?\((\d+), ?(\d+), ?(\d+)(, ?([\d\.]+))?\)$/;
+const hex3Rx = /^#([\da-fA-F])([\da-fA-F])([\da-fA-F])$/;
+const hex4Rx = /^#([\da-fA-F])([\da-fA-F])([\da-fA-F])([\da-fA-F])$/;
+const hex6Rx = /^#([\da-fA-F]{2})([\da-fA-F]{2})([\da-fA-F]{2})$/;
+const hex8Rx = /^#([\da-fA-F]{2})([\da-fA-F]{2})([\da-fA-F]{2})([\da-fA-F]{2})$/;
 
 var cssToRGB = new Map();
 
@@ -188,9 +188,6 @@ class Color {
      * @ignore
      */
     onResetEvent(r = 0, g = 0, b = 0, alpha = 1.0) {
-        /**
-         * @ignore
-         */
         if (typeof (this.glArray) === "undefined") {
             // Color components in a Float32Array suitable for WebGL
             this.glArray = new Float32Array([ 0.0, 0.0, 0.0, 1.0 ]);
@@ -257,7 +254,6 @@ class Color {
      * Set this color to the specified value.
      * @name setColor
      * @memberof Color
-     * @function
      * @param {number} r red component [0 .. 255]
      * @param {number} g green component [0 .. 255]
      * @param {number} b blue component [0 .. 255]
@@ -276,7 +272,6 @@ class Color {
      * Create a new copy of this color object.
      * @name clone
      * @memberof Color
-     * @function
      * @returns {Color} Reference to the newly cloned object
      */
     clone() {
@@ -287,7 +282,6 @@ class Color {
      * Copy a color object or CSS color into this one.
      * @name copy
      * @memberof Color
-     * @function
      * @param {Color|string} color
      * @returns {Color} Reference to this object for method chaining
      */
@@ -304,7 +298,6 @@ class Color {
      * Blend this color with the given one using addition.
      * @name add
      * @memberof Color
-     * @function
      * @param {Color} color
      * @returns {Color} Reference to this object for method chaining
      */
@@ -321,7 +314,6 @@ class Color {
      * Darken this color value by 0..1
      * @name darken
      * @memberof Color
-     * @function
      * @param {number} scale
      * @returns {Color} Reference to this object for method chaining
      */
@@ -338,7 +330,6 @@ class Color {
      * Linearly interpolate between this color and the given one.
      * @name lerp
      * @memberof Color
-     * @function
      * @param {Color} color
      * @param {number} alpha with alpha = 0 being this color, and alpha = 1 being the given one.
      * @returns {Color} Reference to this object for method chaining
@@ -356,7 +347,6 @@ class Color {
      * Lighten this color value by 0..1
      * @name lighten
      * @memberof Color
-     * @function
      * @param {number} scale
      * @returns {Color} Reference to this object for method chaining
      */
@@ -373,7 +363,6 @@ class Color {
      * Generate random r,g,b values for this color object
      * @name random
      * @memberof Color
-     * @function
      * @param {number} [min=0] minimum value for the random range
      * @param {number} [max=255] maxmium value for the random range
      * @returns {Color} Reference to this object for method chaining
@@ -399,7 +388,6 @@ class Color {
      * given one.
      * @name equals
      * @memberof Color
-     * @function
      * @param {Color} color
      * @returns {boolean}
      */
@@ -417,7 +405,6 @@ class Color {
      * r,g,b values
      * @name parseCSS
      * @memberof Color
-     * @function
      * @param {string} cssColor
      * @returns {Color} Reference to this object for method chaining
      */
@@ -435,7 +422,6 @@ class Color {
      * Parse an RGB or RGBA CSS color string
      * @name parseRGB
      * @memberof Color
-     * @function
      * @param {string} rgbColor
      * @returns {Color} Reference to this object for method chaining
      */
@@ -455,7 +441,6 @@ class Color {
      * the corresponding r,g,b,a values
      * @name parseHex
      * @memberof Color
-     * @function
      * @param {string} hexColor
      * @param {boolean} [argb = false] true if format is #ARGB, or #AARRGGBB (as opposed to #RGBA or #RGGBBAA)
      * @returns {Color} Reference to this object for method chaining
@@ -515,7 +500,6 @@ class Color {
      * Pack this color into a Uint32 ARGB representation
      * @name toUint32
      * @memberof Color
-     * @function
      * @param {number} [alpha=1.0] alpha value [0.0 .. 1.0]
      * @returns {number}
      */
@@ -532,7 +516,6 @@ class Color {
      * return an array representation of this object
      * @name toArray
      * @memberof Color
-     * @function
      * @returns {Float32Array}
      */
     toArray() {
@@ -544,7 +527,6 @@ class Color {
      * Get the color in "#RRGGBB" format
      * @name toHex
      * @memberof Color
-     * @function
      * @returns {string}
      */
     toHex() {
@@ -558,7 +540,6 @@ class Color {
      * Get the color in "#RRGGBBAA" format
      * @name toHex8
      * @memberof Color
-     * @function
      * @returns {string}
      */
     toHex8(alpha = this.alpha) {
@@ -572,7 +553,6 @@ class Color {
      * Get the color in "rgb(R,G,B)" format
      * @name toRGB
      * @memberof Color
-     * @function
      * @returns {string}
      */
     toRGB() {
@@ -590,7 +570,6 @@ class Color {
      * Get the color in "rgba(R,G,B,A)" format
      * @name toRGBA
      * @memberof Color
-     * @function
      * @param {number} [alpha=1.0] alpha value [0.0 .. 1.0]
      * @returns {string}
      */

package/src/math/math.js

@@ -51,7 +51,6 @@ export const EPSILON = 0.000001;
 /**
  * returns true if the given value is a power of two
  * @public
- * @function
  * @memberof Math
  * @name isPowerOfTwo
  * @param {number} val
@@ -64,7 +63,6 @@ export function isPowerOfTwo(val) {
 /**
  * returns the next power of two for the given value
  * @public
- * @function
  * @memberof Math
  * @name nextPowerOfTwo
  * @param {number} val
@@ -84,7 +82,6 @@ export function nextPowerOfTwo(val) {
 /**
  * Converts an angle in degrees to an angle in radians
  * @public
- * @function
  * @memberof Math
  * @name degToRad
  * @param {number} angle angle in degrees
@@ -100,7 +97,6 @@ export function degToRad(angle) {
 /**
  * Converts an angle in radians to an angle in degrees.
  * @public
- * @function
  * @memberof Math
  * @name radToDeg
  * @param {number} radians angle in radians
@@ -116,7 +112,6 @@ export function radToDeg(radians) {
 /**
  * clamp the given value
  * @public
- * @function
  * @memberof Math
  * @name clamp
  * @param {number} val the value to clamp
@@ -131,7 +126,6 @@ export function clamp(val, low, high) {
 /**
  * return a random integer between min (included) and max (excluded)
  * @public
- * @function
  * @memberof Math
  * @name random
  * @param {number} min minimum value.
@@ -148,7 +142,6 @@ export function random(min, max) {
 /**
  * return a random float between min, max (exclusive)
  * @public
- * @function
  * @memberof Math
  * @name randomFloat
  * @param {number} min minimum value.
@@ -165,7 +158,6 @@ export function randomFloat(min, max) {
 /**
  * return a weighted random between min, max (exclusive)
  * @public
- * @function
  * @memberof Math
  * @name weightedRandom
  * @param {number} min minimum value.
@@ -182,7 +174,6 @@ export function weightedRandom(min, max) {
 /**
  * round a value to the specified number of digit
  * @public
- * @function
  * @memberof Math
  * @name round
  * @param {number} num value to be rounded.
@@ -201,7 +192,6 @@ export function round(num, dec = 0) {
 /**
  * check if the given value is close to the expected one
  * @public
- * @function
  * @memberof Math
  * @name toBeCloseTo
  * @param {number} expected value to be compared with.