excalibur 0.28.3 → 0.28.4

package/build/dist/Input/Gamepad.js

@@ -0,0 +1,422 @@
+import { GamepadConnectEvent, GamepadDisconnectEvent, GamepadButtonEvent, GamepadAxisEvent } from '../Events';
+import { EventEmitter } from '../EventEmitter';
+export const GamepadEvents = {
+    GamepadConnect: 'connect',
+    GamepadDisconnect: 'disconnect',
+    GamepadButton: 'button',
+    GamepadAxis: 'axis'
+};
+/**
+ * Excalibur leverages the HTML5 Gamepad API [where it is supported](http://caniuse.com/#feat=gamepad)
+ * to provide controller support for your games.
+ */
+export class Gamepads {
+    constructor() {
+        this.events = new EventEmitter();
+        /**
+         * Whether or not to poll for Gamepad input (default: `false`)
+         */
+        this.enabled = false;
+        /**
+         * Whether or not Gamepad API is supported
+         */
+        this.supported = !!navigator.getGamepads;
+        this._gamePadTimeStamps = [0, 0, 0, 0];
+        this._oldPads = [];
+        this._pads = [];
+        this._initSuccess = false;
+        this._navigator = navigator;
+        this._minimumConfiguration = null;
+    }
+    init() {
+        if (!this.supported) {
+            return;
+        }
+        if (this._initSuccess) {
+            return;
+        }
+        // In Chrome, this will return 4 undefined items until a button is pressed
+        // In FF, this will not return any items until a button is pressed
+        this._oldPads = this._clonePads(this._navigator.getGamepads());
+        if (this._oldPads.length && this._oldPads[0]) {
+            this._initSuccess = true;
+        }
+    }
+    /**
+     * Sets the minimum gamepad configuration, for example {axis: 4, buttons: 4} means
+     * this game requires at minimum 4 axis inputs and 4 buttons, this is not restrictive
+     * all other controllers with more axis or buttons are valid as well. If no minimum
+     * configuration is set all pads are valid.
+     */
+    setMinimumGamepadConfiguration(config) {
+        this._enableAndUpdate(); // if config is used, implicitly enable
+        this._minimumConfiguration = config;
+    }
+    /**
+     * When implicitly enabled, set the enabled flag and run an update so information is updated
+     */
+    _enableAndUpdate() {
+        if (!this.enabled) {
+            this.enabled = true;
+            this.update();
+        }
+    }
+    /**
+     * Checks a navigator gamepad against the minimum configuration if present.
+     */
+    _isGamepadValid(pad) {
+        if (!this._minimumConfiguration) {
+            return true;
+        }
+        if (!pad) {
+            return false;
+        }
+        const axesLength = pad.axes.filter((value) => {
+            return typeof value !== undefined;
+        }).length;
+        const buttonLength = pad.buttons.filter((value) => {
+            return typeof value !== undefined;
+        }).length;
+        return axesLength >= this._minimumConfiguration.axis && buttonLength >= this._minimumConfiguration.buttons && pad.connected;
+    }
+    emit(eventName, event) {
+        this.events.emit(eventName, event);
+    }
+    on(eventName, handler) {
+        this._enableAndUpdate(); // implicitly enable
+        return this.events.on(eventName, handler);
+    }
+    once(eventName, handler) {
+        return this.events.once(eventName, handler);
+    }
+    off(eventName, handler) {
+        this._enableAndUpdate(); // implicitly enable
+        this.events.off(eventName, handler);
+    }
+    /**
+     * Updates Gamepad state and publishes Gamepad events
+     */
+    update() {
+        if (!this.enabled || !this.supported) {
+            return;
+        }
+        this.init();
+        const gamepads = this._navigator.getGamepads();
+        for (let i = 0; i < gamepads.length; i++) {
+            if (!gamepads[i]) {
+                const gamepad = this.at(i);
+                // If was connected, but now isn't emit the disconnect event
+                if (gamepad.connected) {
+                    this.events.emit('disconnect', new GamepadDisconnectEvent(i, gamepad));
+                }
+                // Reset connection status
+                gamepad.connected = false;
+                continue;
+            }
+            else {
+                if (!this.at(i).connected && this._isGamepadValid(gamepads[i])) {
+                    this.events.emit('connect', new GamepadConnectEvent(i, this.at(i)));
+                }
+                // Set connection status
+                this.at(i).connected = true;
+            }
+            this.at(i).update();
+            // Only supported in Chrome
+            if (gamepads[i].timestamp && gamepads[i].timestamp === this._gamePadTimeStamps[i]) {
+                continue;
+            }
+            this._gamePadTimeStamps[i] = gamepads[i].timestamp;
+            // Add reference to navigator gamepad
+            this.at(i).navigatorGamepad = gamepads[i];
+            // Buttons
+            let b, bi, a, ai, value;
+            for (b in Buttons) {
+                bi = Buttons[b];
+                if (typeof bi === 'number') {
+                    if (gamepads[i].buttons[bi]) {
+                        value = gamepads[i].buttons[bi].value;
+                        if (value !== this._oldPads[i].getButton(bi)) {
+                            if (gamepads[i].buttons[bi].pressed) {
+                                this.at(i).updateButton(bi, value);
+                                this.at(i).events.emit('button', new GamepadButtonEvent(bi, value, this.at(i)));
+                            }
+                            else {
+                                this.at(i).updateButton(bi, 0);
+                            }
+                        }
+                    }
+                }
+            }
+            // Axes
+            for (a in Axes) {
+                ai = Axes[a];
+                if (typeof ai === 'number') {
+                    value = gamepads[i].axes[ai];
+                    if (value !== this._oldPads[i].getAxes(ai)) {
+                        this.at(i).updateAxes(ai, value);
+                        this.at(i).events.emit('axis', new GamepadAxisEvent(ai, value, this.at(i)));
+                    }
+                }
+            }
+            this._oldPads[i] = this._clonePad(gamepads[i]);
+        }
+    }
+    /**
+     * Safely retrieves a Gamepad at a specific index and creates one if it doesn't yet exist
+     */
+    at(index) {
+        this._enableAndUpdate(); // implicitly enable gamepads when at() is called
+        if (index >= this._pads.length) {
+            // Ensure there is a pad to retrieve
+            for (let i = this._pads.length - 1, max = index; i < max; i++) {
+                this._pads.push(new Gamepad());
+                this._oldPads.push(new Gamepad());
+            }
+        }
+        return this._pads[index];
+    }
+    /**
+     * Returns a list of all valid gamepads that meet the minimum configuration requirement.
+     */
+    getValidGamepads() {
+        this._enableAndUpdate();
+        const result = [];
+        for (let i = 0; i < this._pads.length; i++) {
+            if (this._isGamepadValid(this.at(i).navigatorGamepad) && this.at(i).connected) {
+                result.push(this.at(i));
+            }
+        }
+        return result;
+    }
+    /**
+     * Gets the number of connected gamepads
+     */
+    count() {
+        return this._pads.filter((p) => p.connected).length;
+    }
+    _clonePads(pads) {
+        const arr = [];
+        for (let i = 0, len = pads.length; i < len; i++) {
+            arr.push(this._clonePad(pads[i]));
+        }
+        return arr;
+    }
+    /**
+     * Fastest way to clone a known object is to do it yourself
+     */
+    _clonePad(pad) {
+        let i, len;
+        const clonedPad = new Gamepad();
+        if (!pad) {
+            return clonedPad;
+        }
+        for (i = 0, len = pad.buttons.length; i < len; i++) {
+            if (pad.buttons[i]) {
+                clonedPad.updateButton(i, pad.buttons[i].value);
+            }
+        }
+        for (i = 0, len = pad.axes.length; i < len; i++) {
+            clonedPad.updateAxes(i, pad.axes[i]);
+        }
+        return clonedPad;
+    }
+}
+/**
+ * The minimum value an axis has to move before considering it a change
+ */
+Gamepads.MinAxisMoveThreshold = 0.05;
+/**
+ * Gamepad holds state information for a connected controller. See [[Gamepads]]
+ * for more information on handling controller input.
+ */
+export class Gamepad {
+    constructor() {
+        this.events = new EventEmitter();
+        this.connected = false;
+        this._axes = new Array(4);
+        this._buttons = new Array(16);
+        this._buttonsUp = new Array(16);
+        this._buttonsDown = new Array(16);
+        for (let i = 0; i < this._buttons.length; i++) {
+            this._buttons[i] = 0;
+        }
+        for (let i = 0; i < this._axes.length; i++) {
+            this._axes[i] = 0;
+        }
+    }
+    update() {
+        // Reset buttonsDown and buttonsUp after update is complete
+        this._buttonsDown = new Array(16);
+        this._buttonsUp = new Array(16);
+    }
+    /**
+     * Whether or not the given button is pressed
+     * @deprecated will be removed in v0.28.0. Use isButtonHeld instead
+     * @param button     The button to query
+     * @param threshold  The threshold over which the button is considered to be pressed
+     */
+    isButtonPressed(button, threshold = 1) {
+        return this._buttons[button] >= threshold;
+    }
+    /**
+     * Tests if a certain button is held down. This is persisted between frames.
+     * @param button     The button to query
+     * @param threshold  The threshold over which the button is considered to be pressed
+     */
+    isButtonHeld(button, threshold = 1) {
+        return this._buttons[button] >= threshold;
+    }
+    /**
+     * Tests if a certain button was just pressed this frame. This is cleared at the end of the update frame.
+     * @param button Test whether a button was just pressed
+     * @param threshold  The threshold over which the button is considered to be pressed
+     */
+    wasButtonPressed(button, threshold = 1) {
+        return this._buttonsDown[button] >= threshold;
+    }
+    /**
+     * Tests if a certain button was just released this frame. This is cleared at the end of the update frame.
+     * @param button  Test whether a button was just released
+     */
+    wasButtonReleased(button) {
+        return Boolean(this._buttonsUp[button]);
+    }
+    /**
+     * Gets the given button value between 0 and 1
+     */
+    getButton(button) {
+        return this._buttons[button];
+    }
+    /**
+     * Gets the given axis value between -1 and 1. Values below
+     * [[MinAxisMoveThreshold]] are considered 0.
+     */
+    getAxes(axes) {
+        const value = this._axes[axes];
+        if (Math.abs(value) < Gamepads.MinAxisMoveThreshold) {
+            return 0;
+        }
+        else {
+            return value;
+        }
+    }
+    updateButton(buttonIndex, value) {
+        // button was just released
+        if (value === 0 && this._buttons[buttonIndex]) {
+            this._buttonsUp[buttonIndex] = 1;
+            // button was just pressed
+        }
+        else {
+            this._buttonsDown[buttonIndex] = value;
+        }
+        this._buttons[buttonIndex] = value;
+    }
+    updateAxes(axesIndex, value) {
+        this._axes[axesIndex] = value;
+    }
+    emit(eventName, event) {
+        this.events.emit(eventName, event);
+    }
+    on(eventName, handler) {
+        return this.events.on(eventName, handler);
+    }
+    once(eventName, handler) {
+        return this.events.once(eventName, handler);
+    }
+    off(eventName, handler) {
+        this.events.off(eventName, handler);
+    }
+}
+/**
+ * Gamepad Buttons enumeration
+ */
+export var Buttons;
+(function (Buttons) {
+    /**
+     * Face 1 button (e.g. A)
+     */
+    Buttons[Buttons["Face1"] = 0] = "Face1";
+    /**
+     * Face 2 button (e.g. B)
+     */
+    Buttons[Buttons["Face2"] = 1] = "Face2";
+    /**
+     * Face 3 button (e.g. X)
+     */
+    Buttons[Buttons["Face3"] = 2] = "Face3";
+    /**
+     * Face 4 button (e.g. Y)
+     */
+    Buttons[Buttons["Face4"] = 3] = "Face4";
+    /**
+     * Left bumper button
+     */
+    Buttons[Buttons["LeftBumper"] = 4] = "LeftBumper";
+    /**
+     * Right bumper button
+     */
+    Buttons[Buttons["RightBumper"] = 5] = "RightBumper";
+    /**
+     * Left trigger button
+     */
+    Buttons[Buttons["LeftTrigger"] = 6] = "LeftTrigger";
+    /**
+     * Right trigger button
+     */
+    Buttons[Buttons["RightTrigger"] = 7] = "RightTrigger";
+    /**
+     * Select button
+     */
+    Buttons[Buttons["Select"] = 8] = "Select";
+    /**
+     * Start button
+     */
+    Buttons[Buttons["Start"] = 9] = "Start";
+    /**
+     * Left analog stick press (e.g. L3)
+     */
+    Buttons[Buttons["LeftStick"] = 10] = "LeftStick";
+    /**
+     * Right analog stick press (e.g. R3)
+     */
+    Buttons[Buttons["RightStick"] = 11] = "RightStick";
+    /**
+     * D-pad up
+     */
+    Buttons[Buttons["DpadUp"] = 12] = "DpadUp";
+    /**
+     * D-pad down
+     */
+    Buttons[Buttons["DpadDown"] = 13] = "DpadDown";
+    /**
+     * D-pad left
+     */
+    Buttons[Buttons["DpadLeft"] = 14] = "DpadLeft";
+    /**
+     * D-pad right
+     */
+    Buttons[Buttons["DpadRight"] = 15] = "DpadRight";
+})(Buttons || (Buttons = {}));
+/**
+ * Gamepad Axes enumeration
+ */
+export var Axes;
+(function (Axes) {
+    /**
+     * Left analogue stick X direction
+     */
+    Axes[Axes["LeftStickX"] = 0] = "LeftStickX";
+    /**
+     * Left analogue stick Y direction
+     */
+    Axes[Axes["LeftStickY"] = 1] = "LeftStickY";
+    /**
+     * Right analogue stick X direction
+     */
+    Axes[Axes["RightStickX"] = 2] = "RightStickX";
+    /**
+     * Right analogue stick Y direction
+     */
+    Axes[Axes["RightStickY"] = 3] = "RightStickY";
+})(Axes || (Axes = {}));
+//# sourceMappingURL=Gamepad.js.map

package/build/dist/Input/Gamepad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Gamepad.js","sourceRoot":"","sources":["../../../src/engine/Input/Gamepad.ts"],"names":[],"mappings":"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"}

package/build/dist/Input/Index.js

@@ -0,0 +1,88 @@
+// This import site is deprecated
+// TODO remove deprecated exports in v0.29.0
+/**
+ * @module
+ * Provides support for mice, keyboards, and controllers.
+ */
+export { 
+/**
+ * @deprecated ex.Input.WheelEvent import site will be removed in v0.29.0, use ex.WheelEvent
+ */
+WheelEvent } from './WheelEvent';
+export { 
+/**
+ * @deprecated ex.Input.PointerEvent import site will be removed in v0.29.0, use ex.PointerEvent
+ */
+PointerEvent } from './PointerEvent';
+export { 
+/**
+ * @deprecated ex.Input.WheelDeltaMode import site will be removed in v0.29.0, use ex.WheelDeltaMode
+ */
+WheelDeltaMode } from './WheelDeltaMode';
+export { 
+/**
+ * @deprecated ex.Input.PointerButton import site will be removed in v0.29.0, use ex.PointerButton
+ */
+PointerButton } from './PointerButton';
+export { 
+/**
+ * @deprecated ex.Input.NativePointerButton import site will be removed in v0.29.0, use ex.NativePointerButton
+ */
+NativePointerButton } from './NativePointerButton';
+export { 
+/**
+ * @deprecated ex.Input.PointerEventReceiver import site will be removed in v0.29.0, use ex.PointerEventReceiver
+ */
+PointerEventReceiver } from './PointerEventReceiver';
+export { 
+/**
+ * @deprecated ex.Input.PointerComponent import site will be removed in v0.29.0, use ex.PointerComponent
+ */
+PointerComponent } from './PointerComponent';
+export { 
+/**
+ * @deprecated ex.Input.PointerSystem import site will be removed in v0.29.0, use ex.PointerSystem
+ */
+PointerSystem } from './PointerSystem';
+export { 
+/**
+ * @deprecated ex.Input.PointerType import site will be removed in v0.29.0, use ex.PointerType
+ */
+PointerType } from './PointerType';
+export { 
+/**
+ * @deprecated ex.Input.PointerScope import site will be removed in v0.29.0, use ex.PointerScope
+ */
+PointerScope } from './PointerScope';
+export { 
+/**
+ * @deprecated ex.Input.Keys import site will be removed in v0.29.0, use ex.Keys
+ */
+Keys, 
+/**
+ * @deprecated ex.Input.KeyEvent import site will be removed in v0.29.0, use ex.KeyEvent
+ */
+KeyEvent, 
+/**
+ * @deprecated ex.Input.Keyboard import site will be removed in v0.29.0, use ex.Keyboard
+ */
+Keyboard } from './Keyboard';
+// Re-export hack to deprecate import site gently
+export { 
+/**
+ * @deprecated ex.Input.Gamepads import site will be removed in v0.29.0, use ex.Gamepads
+ */
+Gamepads, 
+/**
+ * @deprecated ex.Input.Gamepad import site will be removed in v0.29.0, use ex.Gamepad
+ */
+Gamepad, 
+/**
+ * @deprecated ex.Input.Buttons import site will be removed in v0.29.0, use ex.Buttons
+ */
+Buttons, 
+/**
+ * @deprecated ex.Input.Axes import site will be removed in v0.29.0, use ex.Axes
+ */
+Axes } from './Gamepad';
+//# sourceMappingURL=Index.js.map

package/build/dist/Input/Index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Index.js","sourceRoot":"","sources":["../../../src/engine/Input/Index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,4CAA4C;AAE5C;;;GAGG;AAEH,OAAO;AACL;;GAEG;AACH,UAAU,EACX,MAAM,cAAc,CAAC;AAEtB,OAAO;AACL;;GAEG;AACH,YAAY,EACb,MAAM,gBAAgB,CAAC;AAExB,OAAO;AACL;;GAEG;AACH,cAAc,EACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO;AACL;;GAEG;AACH,aAAa,EACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO;AACL;;GAEG;AACH,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAgB/B,OAAO;AAqBL;;GAEG;AACH,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO;AACL;;GAEG;AACH,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO;AACL;;GAEG;AACH,aAAa,EACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO;AACL;;GAEG;AACH,WAAW,EACZ,MAAM,eAAe,CAAC;AAEvB,OAAO;AACL;;GAEG;AACH,YAAY,EACb,MAAM,gBAAgB,CAAC;AAExB,OAAO;AACL;;GAEG;AACH,IAAI;AACJ;;GAEG;AACH,QAAQ;AAKR;;GAEG;AACH,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,iDAAiD;AACjD,OAAO;AACL;;GAEG;AACH,QAAQ;AACR;;GAEG;AACH,OAAO;AACP;;GAEG;AACH,OAAO;AACP;;GAEG;AACH,IAAI,EAqBL,MAAM,WAAW,CAAC"}

package/build/dist/Input/InputMapper.js

@@ -0,0 +1,45 @@
+/**
+ * This allows you to map multiple inputs to specific commands! This is especially useful when
+ * you need to allow multiple input sources to control a specific action.
+ */
+export class InputMapper {
+    constructor(inputs) {
+        this.inputs = inputs;
+        this._handlers = new Map();
+    }
+    /**
+     * Executes the input map, called internally by Excalibur
+     */
+    execute() {
+        for (const [input, command] of this._handlers.entries()) {
+            const results = input(this.inputs);
+            if (results) {
+                command(results);
+            }
+        }
+    }
+    /**
+     * This allows you to map multiple inputs to specific commands! This is useful
+     *
+     * The inputHandler should return a truthy value if you wish the commandHandler to fire.
+     *
+     * Example:
+     * ```typescript
+     * const moveRight = (amount: number) => { actor.vel.x = 100 * amount }
+     * const moveLeft = (amount: number) => { actor.vel.x = -100 * amount }
+     * const moveUp = (amount: number) => { actor.vel.y = -100 * amount }
+     * const moveDown = (amount: number) => { actor.vel.y = 100 * amount }
+     *
+     * engine.inputMapper.on(({keyboard}) => keyboard.isHeld(ex.Keys.ArrowRight) ? 1 : 0, moveRight);
+     * engine.inputMapper.on(({gamepads}) => gamepads.at(0).isButtonPressed(ex.Buttons.DpadRight) ? 1 : 0, moveRight);
+     * engine.inputMapper.on(({gamepads}) => gamepads.at(0).getAxes(ex.Axes.LeftStickX) > 0 ?
+     *  gamepads.at(0).getAxes(ex.Axes.LeftStickX) : 0, moveRight);
+     * ```
+     * @param inputHandler
+     * @param commandHandler
+     */
+    on(inputHandler, commandHandler) {
+        this._handlers.set(inputHandler, commandHandler);
+    }
+}
+//# sourceMappingURL=InputMapper.js.map

package/build/dist/Input/InputMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputMapper.js","sourceRoot":"","sources":["../../../src/engine/Input/InputMapper.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,OAAO,WAAW;IAGtB,YAAmB,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;QADhC,cAAS,GAAG,IAAI,GAAG,EAAY,CAAC;IACG,CAAC;IAE5C;;OAEG;IACH,OAAO;QACL,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YACxD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnC,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,OAAO,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,EAAE,CACA,YAAkE,EAClE,cAAgD;QAChD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IACnD,CAAC;CACF"}