melonjs 10.2.2 → 10.4.0

package/src/index.js

@@ -28,10 +28,10 @@ import ObservableVector2d from "./math/observable_vector2.js";
 import ObservableVector3d from "./math/observable_vector3.js";
 import Matrix2d from "./math/matrix2.js";
 import Matrix3d from "./math/matrix3.js";
-import Polygon from "./shapes/poly.js";
-import Line from "./shapes/line.js";
-import Ellipse from "./shapes/ellipse.js";
-import Rect from "./shapes/rectangle.js";
+import Polygon from "./geometries/poly.js";
+import Line from "./geometries/line.js";
+import Ellipse from "./geometries/ellipse.js";
+import Rect from "./geometries/rectangle.js";
 import QuadTree from "./physics/quadtree.js";
 import Body from "./physics/body.js";
 import Bounds from "./physics/bounds.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,
@@ -173,8 +166,7 @@ export {
     DroptargetEntity
 };
 
-// Backward compatibility for deprecated method or properties are
-// automatically applied when generating the UMD module through rollup
+// Backward compatibility for deprecated method or properties
 export {
     deprecated
 };
@@ -185,7 +177,6 @@ export {
  * @type {boolean}
  * @default false
  * @readonly
- * @memberOf me
  */
 export var initialized = false;
 
@@ -193,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;
 
@@ -203,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

package/src/input/input.js

@@ -1,6 +1,5 @@
 /**
- * @namespace me.input
- * @memberOf me
+ * @namespace input
  */
 
 /**
@@ -9,7 +8,7 @@
  * @type {boolean}
  * @default true
  * @name preventDefault
- * @memberOf me.input
+ * @memberof input
  */
 export var preventDefault = true;
 

package/src/input/keyboard.js

@@ -100,7 +100,7 @@ var keyUpEvent = function (e, keyCode, mouseButton) {
   * @public
   * @type {EventTarget}
   * @name keyBoardEventTarget
-  * @memberOf me.input
+  * @memberof input
   */
  export var keyBoardEventTarget = null;
 
@@ -109,206 +109,206 @@ var keyUpEvent = function (e, keyCode, mouseButton) {
  * @public
  * @enum {number}
  * @namespace KEY
- * @memberOf me.input
+ * @memberof input
  */
 export var KEY = {
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "BACKSPACE" : 8,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "TAB" : 9,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "ENTER" : 13,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "SHIFT" : 16,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "CTRL" : 17,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "ALT" : 18,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "PAUSE" : 19,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "CAPS_LOCK" : 20,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "ESC" : 27,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "SPACE" : 32,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "PAGE_UP" : 33,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "PAGE_DOWN" : 34,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "END" : 35,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "HOME" : 36,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "LEFT" : 37,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "UP" : 38,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "RIGHT" : 39,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "DOWN" : 40,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "PRINT_SCREEN" : 42,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "INSERT" : 45,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "DELETE" : 46,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUM0" : 48,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUM1" : 49,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUM2" : 50,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUM3" : 51,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUM4" : 52,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUM5" : 53,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUM6" : 54,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUM7" : 55,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUM8" : 56,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUM9" : 57,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "A" : 65,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "B" : 66,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "C" : 67,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "D" : 68,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "E" : 69,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "F" : 70,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "G" : 71,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "H" : 72,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "I" : 73,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "J" : 74,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "K" : 75,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "L" : 76,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "M" : 77,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "N" : 78,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "O" : 79,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "P" : 80,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "Q" : 81,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "R" : 82,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "S" : 83,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "T" : 84,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "U" : 85,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "V" : 86,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "W" : 87,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "X" : 88,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "Y" : 89,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "Z" : 90,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "WINDOW_KEY" : 91,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUMPAD0" : 96,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUMPAD1" : 97,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUMPAD2" : 98,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUMPAD3" : 99,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUMPAD4" : 100,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUMPAD5" : 101,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUMPAD6" : 102,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUMPAD7" : 103,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUMPAD8" : 104,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUMPAD9" : 105,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "MULTIPLY" : 106,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "ADD" : 107,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "SUBSTRACT" : 109,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "DECIMAL" : 110,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "DIVIDE" : 111,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "F1" : 112,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "F2" : 113,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "F3" : 114,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "F4" : 115,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "F5" : 116,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "F6" : 117,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "F7" : 118,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "F8" : 119,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "F9" : 120,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "F10" : 121,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "F11" : 122,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "F12" : 123,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "TILDE" : 126,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "NUM_LOCK" : 144,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "SCROLL_LOCK" : 145,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "SEMICOLON" : 186,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "PLUS" : 187,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "COMMA" : 188,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "MINUS" : 189,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "PERIOD" : 190,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "FORWAND_SLASH" : 191,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "GRAVE_ACCENT" : 192,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "OPEN_BRACKET" : 219,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "BACK_SLASH" : 220,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "CLOSE_BRACKET" : 221,
-    /** @memberOf me.input.KEY */
+    /** @memberof input.KEY */
     "SINGLE_QUOTE" : 222
 };
 
@@ -328,7 +328,7 @@ export function initKeyboardEvent() {
 /**
  * return the key press status of the specified action
  * @name isKeyPressed
- * @memberOf me.input
+ * @memberof input
  * @public
  * @function
  * @param {string} action user defined corresponding action
@@ -354,7 +354,7 @@ export function isKeyPressed(action) {
 /**
  * return the key status of the specified action
  * @name keyStatus
- * @memberOf me.input
+ * @memberof input
  * @public
  * @function
  * @param {string} action user defined corresponding action
@@ -368,10 +368,10 @@ export function keyStatus(action) {
 /**
  * trigger the specified key (simulated) event <br>
  * @name triggerKeyEvent
- * @memberOf me.input
+ * @memberof input
  * @public
  * @function
- * @param {me.input.KEY} keycode
+ * @param {number} keycode (See {@link input.KEY})
  * @param {boolean} [status=false] true to trigger a key down event, or false for key up event
  * @param {number} [mouseButton] the mouse button to trigger
  * @example
@@ -391,13 +391,13 @@ export function triggerKeyEvent(keycode, status, mouseButton) {
 /**
  * associate a user defined action to a keycode
  * @name bindKey
- * @memberOf me.input
+ * @memberof input
  * @public
  * @function
- * @param {me.input.KEY} keycode
+ * @param {number} keycode (See {@link input.KEY})
  * @param {string} action user defined corresponding action
  * @param {boolean} [lock=false] cancel the keypress event once read
- * @param {boolean} [preventDefault=me.input.preventDefault] prevent default browser action
+ * @param {boolean} [preventDefault=input.preventDefault] prevent default browser action
  * @example
  * // enable the keyboard
  * me.input.bindKey(me.input.KEY.LEFT,  "left");
@@ -418,10 +418,10 @@ export function bindKey(keycode, action, lock, preventDefault = preventDefaultAc
 /**
  * return the action associated with the given keycode
  * @name getBindingKey
- * @memberOf me.input
+ * @memberof input
  * @public
  * @function
- * @param {me.input.KEY} keycode
+ * @param {number} keycode (See {@link input.KEY})
  * @returns {string} user defined associated action
  */
 export function getBindingKey(keycode) {
@@ -431,7 +431,7 @@ export function getBindingKey(keycode) {
 /**
  * unlock a key manually
  * @name unlockKey
- * @memberOf me.input
+ * @memberof input
  * @public
  * @function
  * @param {string} action user defined corresponding action
@@ -448,10 +448,10 @@ export function unlockKey(action) {
 /**
  * unbind the defined keycode
  * @name unbindKey
- * @memberOf me.input
+ * @memberof input
  * @public
  * @function
- * @param {me.input.KEY} keycode
+ * @param {number} keycode (See {@link input.KEY})
  * @example
  * me.input.unbindKey(me.input.KEY.LEFT);
  */