melonjs 10.3.0 → 10.4.0

package/src/geometries/poly.js

@@ -10,31 +10,31 @@ import pool from "./../system/pooling.js";
  * (which means that all angles are less than 180 degrees), as described here below : <br>
  * <center><img src="images/convex_polygon.png"/></center><br>
  * A polygon's `winding` is clockwise iff its vertices (points) are declared turning to the right. The image above shows COUNTERCLOCKWISE winding.
- * @class Polygon
- * @memberof me
- * @param {number} x origin point of the Polygon
- * @param {number} y origin point of the Polygon
- * @param {me.Vector2d[]} points array of vector defining the Polygon
  */
 
 class Polygon {
 
+    /**
+     * @param {number} x origin point of the Polygon
+     * @param {number} y origin point of the Polygon
+     * @param {Vector2d[]} points array of vector defining the Polygon
+     */
     constructor(x, y, points) {
         /**
          * origin point of the Polygon
          * @public
-         * @type {me.Vector2d}
+         * @type {Vector2d}
          * @name pos
-         * @memberof me.Polygon#
+         * @memberof Polygon#
          */
         this.pos = new Vector2d();
 
         /**
          * The bounding rectangle for this shape
          * @ignore
-         * @type {me.Bounds}
+         * @type {Bounds}
          * @name _bounds
-         * @memberof me.Polygon#
+         * @memberof Polygon#
          */
         this._bounds;
 
@@ -42,9 +42,9 @@ class Polygon {
          * Array of points defining the Polygon <br>
          * Note: If you manually change `points`, you **must** call `recalc`afterwards so that the changes get applied correctly.
          * @public
-         * @type {me.Vector2d[]}
+         * @type {Vector2d[]}
          * @name points
-         * @memberof me.Polygon#
+         * @memberof Polygon#
          */
         this.points = [];
 
@@ -83,12 +83,12 @@ class Polygon {
     /**
      * set new value to the Polygon
      * @name setShape
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
      * @param {number} x position of the Polygon
      * @param {number} y position of the Polygon
-     * @param {me.Vector2d[]|number[]} points array of vector or vertice defining the Polygon
-     * @returns {me.Polygon} this instance for objecf chaining
+     * @param {Vector2d[]|number[]} points array of vector or vertice defining the Polygon
+     * @returns {Polygon} this instance for objecf chaining
      */
     setShape(x, y, points) {
         this.pos.set(x, y);
@@ -99,10 +99,10 @@ class Polygon {
     /**
      * set the vertices defining this Polygon
      * @name setVertices
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
-     * @param {me.Vector2d[]} vertices array of vector or vertice defining the Polygon
-     * @returns {me.Polygon} this instance for objecf chaining
+     * @param {Vector2d[]} vertices array of vector or vertice defining the Polygon
+     * @returns {Polygon} this instance for objecf chaining
      */
     setVertices(vertices) {
 
@@ -139,10 +139,10 @@ class Polygon {
     /**
      * apply the given transformation matrix to this Polygon
      * @name transform
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
-     * @param {me.Matrix2d} m the transformation matrix
-     * @returns {me.Polygon} Reference to this object for method chaining
+     * @param {Matrix2d} m the transformation matrix
+     * @returns {Polygon} Reference to this object for method chaining
      */
     transform(m) {
         var points = this.points;
@@ -158,9 +158,9 @@ class Polygon {
     /**
      * apply an isometric projection to this shape
      * @name toIso
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
-     * @returns {me.Polygon} Reference to this object for method chaining
+     * @returns {Polygon} Reference to this object for method chaining
      */
     toIso() {
         return this.rotate(Math.PI / 4).scale(Math.SQRT2, Math.SQRT1_2);
@@ -169,9 +169,9 @@ class Polygon {
     /**
      * apply a 2d projection to this shape
      * @name to2d
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
-     * @returns {me.Polygon} Reference to this object for method chaining
+     * @returns {Polygon} Reference to this object for method chaining
      */
     to2d() {
         return this.scale(Math.SQRT1_2, Math.SQRT2).rotate(-Math.PI / 4);
@@ -180,11 +180,11 @@ class Polygon {
     /**
      * Rotate this Polygon (counter-clockwise) by the specified angle (in radians).
      * @name rotate
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
      * @param {number} angle The angle to rotate (in radians)
-     * @param {me.Vector2d|me.ObservableVector2d} [v] an optional point to rotate around
-     * @returns {me.Polygon} Reference to this object for method chaining
+     * @param {Vector2d|ObservableVector2d} [v] an optional point to rotate around
+     * @returns {Polygon} Reference to this object for method chaining
      */
     rotate(angle, v) {
         if (angle !== 0) {
@@ -202,11 +202,11 @@ class Polygon {
     /**
      * Scale this Polygon by the given scalar.
      * @name scale
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
      * @param {number} x
      * @param {number} [y=x]
-     * @returns {me.Polygon} Reference to this object for method chaining
+     * @returns {Polygon} Reference to this object for method chaining
      */
     scale(x, y) {
         y = typeof (y) !== "undefined" ? y : x;
@@ -224,10 +224,10 @@ class Polygon {
     /**
      * Scale this Polygon by the given vector
      * @name scaleV
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
-     * @param {me.Vector2d} v
-     * @returns {me.Polygon} Reference to this object for method chaining
+     * @param {Vector2d} v
+     * @returns {Polygon} Reference to this object for method chaining
      */
     scaleV(v) {
         return this.scale(v.x, v.y);
@@ -237,9 +237,9 @@ class Polygon {
      * Computes the calculated collision polygon.
      * This **must** be called if the `points` array, `angle`, or `offset` is modified manually.
      * @name recalc
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
-     * @returns {me.Polygon} Reference to this object for method chaining
+     * @returns {Polygon} Reference to this object for method chaining
      */
     recalc() {
         var i;
@@ -281,7 +281,7 @@ class Polygon {
     /**
      * returns a list of indices for all triangles defined in this polygon
      * @name getIndices
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
      * @returns {Array} an array of vertex indices for all triangles forming this polygon.
      */
@@ -295,7 +295,7 @@ class Polygon {
     /**
      * Returns true if the vertices composing this polygon form a convex shape (vertices must be in clockwise order).
      * @name isConvex
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
      * @returns {boolean} true if the vertices are convex, false if not, null if not computable
      */
@@ -342,19 +342,19 @@ class Polygon {
     /**
      * translate the Polygon by the specified offset
      * @name translate
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
      * @param {number} x x offset
      * @param {number} y y offset
-     * @returns {me.Polygon} this Polygon
+     * @returns {Polygon} this Polygon
      */
     /**
      * translate the Polygon by the specified vector
      * @name translate
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
-     * @param {me.Vector2d} v vector offset
-     * @returns {me.Polygon} Reference to this object for method chaining
+     * @param {Vector2d} v vector offset
+     * @returns {Polygon} Reference to this object for method chaining
      */
     translate() {
         var _x, _y;
@@ -379,14 +379,14 @@ class Polygon {
     /**
      * Shifts the Polygon to the given position vector.
      * @name shift
-     * @memberof me.Polygon
+     * @memberof Polygon
      * @function
-     * @param {me.Vector2d} position
+     * @param {Vector2d} position
      */
     /**
      * Shifts the Polygon to the given x, y position.
      * @name shift
-     * @memberof me.Polygon
+     * @memberof Polygon
      * @function
      * @param {number} x
      * @param {number} y
@@ -412,9 +412,9 @@ class Polygon {
      * (Note: it is highly recommended to first do a hit test on the corresponding <br>
      *  bounding rect, as the function can be highly consuming with complex shapes)
      * @name contains
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
-     * @param  {me.Vector2d} point
+     * @param {Vector2d} point
      * @returns {boolean} true if contains
      */
 
@@ -423,7 +423,7 @@ class Polygon {
      * (Note: it is highly recommended to first do a hit test on the corresponding <br>
      *  bounding rect, as the function can be highly consuming with complex shapes)
      * @name contains
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
      * @param  {number} x x coordinate
      * @param  {number} y y coordinate
@@ -461,9 +461,9 @@ class Polygon {
     /**
      * returns the bounding box for this shape, the smallest Rectangle object completely containing this shape.
      * @name getBounds
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
-     * @returns {me.Bounds} this shape bounding box Rectangle object
+     * @returns {Bounds} this shape bounding box Rectangle object
      */
     getBounds() {
         if (typeof this._bounds === "undefined") {
@@ -476,9 +476,9 @@ class Polygon {
      * update the bounding box for this shape.
      * @ignore
      * @name updateBounds
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
-     * @returns {me.Bounds} this shape bounding box Rectangle object
+     * @returns {Bounds} this shape bounding box Rectangle object
      */
     updateBounds() {
         var bounds = this.getBounds();
@@ -492,9 +492,9 @@ class Polygon {
     /**
      * clone this Polygon
      * @name clone
-     * @memberof me.Polygon.prototype
+     * @memberof Polygon.prototype
      * @function
-     * @returns {me.Polygon} new Polygon
+     * @returns {Polygon} new Polygon
      */
     clone() {
         var copy = [];

package/src/geometries/rectangle.js

@@ -4,17 +4,15 @@ import Polygon from "./poly.js";
 /**
  * @classdesc
  * a rectangle Object
- * @class Rect
- * @augments me.Polygon
- * @memberof me
- * @param {number} x position of the Rectangle
- * @param {number} y position of the Rectangle
- * @param {number} w width of the rectangle
- * @param {number} h height of the rectangle
+ * @augments Polygon
  */
-
 class Rect extends Polygon {
-
+    /**
+     * @param {number} x position of the Rectangle
+     * @param {number} y position of the Rectangle
+     * @param {number} w width of the rectangle
+     * @param {number} h height of the rectangle
+     */
     constructor(x, y, w, h) {
         // parent constructor
         super(x, y, [
@@ -34,13 +32,13 @@ class Rect extends Polygon {
     /**
      * set new value to the rectangle shape
      * @name setShape
-     * @memberof me.Rect.prototype
+     * @memberof Rect.prototype
      * @function
      * @param {number} x position of the Rectangle
      * @param {number} y position of the Rectangle
-     * @param {number|me.Vector2d[]} w width of the rectangle, or an array of vector defining the rectangle
+     * @param {number|Vector2d[]} w width of the rectangle, or an array of vector defining the rectangle
      * @param {number} [h] height of the rectangle, if a numeral width parameter is specified
-     * @returns {me.Rect} this rectangle
+     * @returns {Rect} this rectangle
      */
     setShape(x, y, w, h) {
         var points = w; // assume w is an array by default
@@ -65,7 +63,7 @@ class Rect extends Polygon {
      * @public
      * @type {number}
      * @name left
-     * @memberof me.Rect
+     * @memberof Rect
      */
     get left() {
         return this.pos.x;
@@ -76,7 +74,7 @@ class Rect extends Polygon {
      * @public
      * @type {number}
      * @name right
-     * @memberof me.Rect
+     * @memberof Rect
      */
     get right() {
         var w = this.width;
@@ -88,7 +86,7 @@ class Rect extends Polygon {
      * @public
      * @type {number}
      * @name top
-     * @memberof me.Rect
+     * @memberof Rect
      */
     get top() {
         return this.pos.y;
@@ -99,7 +97,7 @@ class Rect extends Polygon {
      * @public
      * @type {number}
      * @name bottom
-     * @memberof me.Rect
+     * @memberof Rect
      */
     get bottom() {
         var h = this.height;
@@ -111,7 +109,7 @@ class Rect extends Polygon {
      * @public
      * @type {number}
      * @name width
-     * @memberof me.Rect
+     * @memberof Rect
      */
     get width() {
         return this.points[2].x;
@@ -127,7 +125,7 @@ class Rect extends Polygon {
      * @public
      * @type {number}
      * @name height
-     * @memberof me.Rect
+     * @memberof Rect
      */
     get height() {
         return this.points[2].y;
@@ -143,7 +141,7 @@ class Rect extends Polygon {
      * @public
      * @type {number}
      * @name centerX
-     * @memberof me.Rect
+     * @memberof Rect
      */
     get centerX() {
         if (isFinite(this.width)) {
@@ -161,7 +159,7 @@ class Rect extends Polygon {
      * @public
      * @type {number}
      * @name centerY
-     * @memberof me.Rect
+     * @memberof Rect
      */
     get centerY() {
         if (isFinite(this.height)) {
@@ -177,11 +175,11 @@ class Rect extends Polygon {
     /**
      * resize the rectangle
      * @name resize
-     * @memberof me.Rect.prototype
+     * @memberof Rect.prototype
      * @function
      * @param {number} w new width of the rectangle
      * @param {number} h new height of the rectangle
-     * @returns {me.Rect} this rectangle
+     * @returns {Rect} this rectangle
      */
     resize(w, h) {
         this.width = w;
@@ -192,11 +190,11 @@ class Rect extends Polygon {
     /**
      * scale the rectangle
      * @name scale
-     * @memberof me.Rect.prototype
+     * @memberof Rect.prototype
      * @function
      * @param {number} x a number representing the abscissa of the scaling vector.
      * @param {number} [y=x] a number representing the ordinate of the scaling vector.
-     * @returns {me.Rect} this rectangle
+     * @returns {Rect} this rectangle
      */
     scale(x, y = x) {
         this.width *= x;
@@ -207,9 +205,9 @@ class Rect extends Polygon {
     /**
      * clone this rectangle
      * @name clone
-     * @memberof me.Rect.prototype
+     * @memberof Rect.prototype
      * @function
-     * @returns {me.Rect} new rectangle
+     * @returns {Rect} new rectangle
      */
     clone() {
         return new Rect(this.pos.x, this.pos.y, this.width, this.height);
@@ -218,10 +216,10 @@ class Rect extends Polygon {
     /**
      * copy the position and size of the given rectangle into this one
      * @name copy
-     * @memberof me.Rect.prototype
+     * @memberof Rect.prototype
      * @function
-     * @param {me.Rect} rect Source rectangle
-     * @returns {me.Rect} new rectangle
+     * @param {Rect} rect Source rectangle
+     * @returns {Rect} new rectangle
      */
     copy(rect) {
         return this.setShape(rect.pos.x, rect.pos.y, rect.width, rect.height);
@@ -230,10 +228,10 @@ class Rect extends Polygon {
     /**
      * merge this rectangle with another one
      * @name union
-     * @memberof me.Rect.prototype
+     * @memberof Rect.prototype
      * @function
-     * @param {me.Rect} rect other rectangle to union with
-     * @returns {me.Rect} the union(ed) rectangle
+     * @param {Rect} rect other rectangle to union with
+     * @returns {Rect} the union(ed) rectangle
      */
     union(rect) {
         var x1 = Math.min(this.left, rect.left);
@@ -252,9 +250,9 @@ class Rect extends Polygon {
     /**
      * check if this rectangle is intersecting with the specified one
      * @name overlaps
-     * @memberof me.Rect.prototype
+     * @memberof Rect.prototype
      * @function
-     * @param  {me.Rect} rect
+     * @param {Rect} rect
      * @returns {boolean} true if overlaps
      */
     overlaps(rect) {
@@ -269,16 +267,16 @@ class Rect extends Polygon {
     /**
      * Returns true if the rectangle contains the given rectangle
      * @name contains
-     * @memberof me.Rect.prototype
+     * @memberof Rect.prototype
      * @function
-     * @param {me.Rect} rect
+     * @param {Rect} rect
      * @returns {boolean} true if contains
      */
 
     /**
      * Returns true if the rectangle contains the given point
      * @name contains
-     * @memberof me.Rect.prototype
+     * @memberof Rect.prototype
      * @function
      * @param  {number} x x coordinate
      * @param  {number} y y coordinate
@@ -288,9 +286,9 @@ class Rect extends Polygon {
     /**
      * Returns true if the rectangle contains the given point
      * @name contains
-     * @memberof me.Rect
+     * @memberof Rect
      * @function
-     * @param {me.Vector2d} point
+     * @param {Vector2d} point
      * @returns {boolean} true if contains
      */
     contains() {
@@ -324,9 +322,9 @@ class Rect extends Polygon {
     /**
      * check if this rectangle is identical to the specified one
      * @name equals
-     * @memberof me.Rect.prototype
+     * @memberof Rect.prototype
      * @function
-     * @param  {me.Rect} rect
+     * @param {Rect} rect
      * @returns {boolean} true if equals
      */
     equals(rect) {
@@ -341,7 +339,7 @@ class Rect extends Polygon {
     /**
      * determines whether all coordinates of this rectangle are finite numbers.
      * @name isFinite
-     * @memberof me.Rect.prototype
+     * @memberof Rect.prototype
      * @function
      * @returns {boolean} false if all coordinates are positive or negative Infinity or NaN; otherwise, true.
      */
@@ -352,9 +350,9 @@ class Rect extends Polygon {
     /**
      * Returns a polygon whose edges are the same as this box.
      * @name toPolygon
-     * @memberof me.Rect.prototype
+     * @memberof Rect.prototype
      * @function
-     * @returns {me.Polygon} a new Polygon that represents this rectangle.
+     * @returns {Polygon} a new Polygon that represents this rectangle.
      */
     toPolygon() {
         return new Polygon(

package/src/index.js

@@ -41,6 +41,7 @@ import WebGLCompositor from "./video/webgl/webgl_compositor.js";
 import Renderer from "./video/renderer.js";
 import WebGLRenderer from "./video/webgl/webgl_renderer.js";
 import CanvasRenderer from "./video/canvas/canvas_renderer.js";
+import { TextureAtlas } from "./video/texture.js";
 import Renderable from "./renderable/renderable.js";
 import Text from "./text/text.js";
 import BitmapText from "./text/bitmaptext.js";
@@ -78,24 +79,15 @@ import DroptargetEntity from "./entity/droptarget.js";
 // alias and wrapper for deprecated API
 import * as deprecated from "./lang/deprecated.js";
 
-/**
- * (<b>m</b>)elonJS (<b>e</b>)ngine : All melonJS functions are defined inside this namespace.
- * You generally should not add new properties to this namespace as it may be overwritten in future versions.
- * @namespace me
- */
-
 /**
  * current melonJS version
  * @static
  * @constant
- * @memberof me
  * @name version
  * @type {string}
  */
 export const version = "__VERSION__";
 
-// namespace "me" will be created by rollup automatically
-
 // export all utility function
 export {
     audio,
@@ -137,6 +129,7 @@ export {
     Renderer,
     WebGLRenderer,
     CanvasRenderer,
+    TextureAtlas,
     Renderable,
     Body,
     Bounds,
@@ -184,7 +177,6 @@ export {
  * @type {boolean}
  * @default false
  * @readonly
- * @memberof me
  */
 export var initialized = false;
 
@@ -192,8 +184,7 @@ export var initialized = false;
  * disable melonJS auto-initialization
  * @type {boolean}
  * @default false
- * @see me.boot
- * @memberof me
+ * @see boot
  */
 export var skipAutoInit = false;
 
@@ -202,8 +193,7 @@ export var skipAutoInit = false;
  * this is automatically called unless me.skipAutoInit is set to true,
  * to allow asynchronous loaders to work.
  * @name boot
- * @memberof me
- * @see me.skipAutoInit
+ * @see skipAutoInit
  * @public
  * @function
  */

package/src/input/gamepad.js

@@ -1,6 +1,7 @@
 import {getBindingKey, triggerKeyEvent} from "./keyboard.js";
 import * as event from "./../system/event.js";
 
+
 // Analog deadzone
 var deadzone = 0.1;
 
@@ -284,7 +285,7 @@ window.addEventListener("gamepaddisconnected", function (e) {
  * Namespace for standard gamepad mapping constants
  * @public
  * @namespace GAMEPAD
- * @memberof me.input
+ * @memberof input
  */
 export var GAMEPAD = {
     /**
@@ -297,7 +298,7 @@ export var GAMEPAD = {
      * @public
      * @name AXES
      * @enum {number}
-     * @memberof me.input.GAMEPAD
+     * @memberof input.GAMEPAD
      * @see https://w3c.github.io/gamepad/#remapping
      */
     "AXES" : {
@@ -324,7 +325,7 @@ export var GAMEPAD = {
      * @public
      * @name BUTTONS
      * @enum {number}
-     * @memberof me.input.GAMEPAD
+     * @memberof input.GAMEPAD
      * @see https://w3c.github.io/gamepad/#remapping
      */
     "BUTTONS" : {
@@ -357,15 +358,15 @@ export var GAMEPAD = {
 /**
  * Associate a gamepad event to a keycode
  * @name bindGamepad
- * @memberof me.input
+ * @memberof input
  * @public
  * @function
  * @param {number} index Gamepad index
  * @param {object} button Button/Axis definition
  * @param {string} button.type "buttons" or "axes"
- * @param {me.input.GAMEPAD.BUTTONS|me.input.GAMEPAD.AXES} button.code button or axis code id
+ * @param {number} button.code button or axis code id (See {@link input.GAMEPAD.BUTTONS}, {@link input.GAMEPAD.AXES})
  * @param {number} [button.threshold=1] value indicating when the axis should trigger the keycode (e.g. -0.5 or 0.5)
- * @param {me.input.KEY} keyCode
+ * @param {number} keyCode (See {@link input.KEY})
  * @example
  * // enable the keyboard
  * me.input.bindKey(me.input.KEY.X, "shoot");
@@ -432,11 +433,11 @@ export function bindGamepad(index, button, keyCode) {
 /**
  * unbind the defined keycode
  * @name unbindGamepad
- * @memberof me.input
+ * @memberof input
  * @public
  * @function
  * @param {number} index Gamepad index
- * @param {me.input.GAMEPAD.BUTTONS} button
+ * @param {number} button (See {@link input.GAMEPAD.BUTTONS})
  * @example
  * me.input.unbindGamepad(0, me.input.GAMEPAD.BUTTONS.FACE_1);
  */
@@ -451,7 +452,7 @@ export function unbindGamepad(index, button) {
  * Set deadzone for analog gamepad inputs<br>
  * The default deadzone is 0.1 (10%) Analog values less than this will be ignored
  * @name setGamepadDeadzone
- * @memberof me.input
+ * @memberof input
  * @public
  * @function
  * @param {number} value Deadzone value
@@ -465,7 +466,7 @@ export function setGamepadDeadzone(value) {
  * see below for the default mapping : <br>
  * <center><img src="images/gamepad_diagram.png"/></center><br>
  * @name setGamepadMapping
- * @memberof me.input
+ * @memberof input
  * @public
  * @function
  * @param {string} id Gamepad id string