@gg-web-engine/core 0.0.3 → 0.0.5

package/dist/base/inputs/keyboard.input.js

@@ -0,0 +1,130 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyboardInput = void 0;
+const input_1 = require("./input");
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+/**
+ * A main keyboard input: it does not have own key bindings, but provides an API to bind keys.
+ * It is responsible for listening key up/down events (when running!) and emit the events to subscribers.
+ * Every World entity has its own dedicated instance of Keyboard input, which is running only when the world is running
+ */
+class KeyboardInput extends input_1.Input {
+    /**
+     * Creates a new instance of the `KeyboardInput` class.
+     */
+    constructor() {
+        super();
+        this.bindings = {};
+        this.handleKeys = this.handleKeys.bind(this);
+    }
+    startInternal() {
+        return __awaiter(this, void 0, void 0, function* () {
+            window.addEventListener('keydown', this.handleKeys);
+            window.addEventListener('keyup', this.handleKeys);
+        });
+    }
+    stopInternal() {
+        return __awaiter(this, void 0, void 0, function* () {
+            window.removeEventListener('keydown', this.handleKeys);
+            window.removeEventListener('keyup', this.handleKeys);
+        });
+    }
+    /**
+     * Creates an observable that emits a boolean whenever a key with the given code is pressed or released
+     * @param code The key code to bind the observable to
+     * @returns An observable that emits true when the key is pressed and false when it's released
+     */
+    bind(code) {
+        if (!this.bindings[code]) {
+            this.bindings[code] = [];
+        }
+        const subj = new rxjs_1.BehaviorSubject(false);
+        this.bindings[code].push(subj);
+        return subj.pipe((0, rxjs_1.finalize)(() => {
+            this.bindings[code].splice(this.bindings[code].indexOf(subj), 1);
+            subj.complete();
+        }));
+    }
+    /**
+     * Creates an observable that emits a boolean indicating whether any of the keys with the given codes are pressed or released.
+     * Should be used when you have more than one keys, responsible for the same action.
+     * @param codes The key codes to bind the observable to
+     * @returns An observable that emits true when any of the keys are pressed and false when they're all released
+     */
+    bindMany(...codes) {
+        if (codes.length == 0) {
+            console.warn('[KeyboardController] bindMany called without any key code');
+            return rxjs_1.NEVER;
+        }
+        if (codes.length == 1) {
+            return this.bind(codes[0]);
+        }
+        const subjects = [];
+        for (const code of codes) {
+            if (!this.bindings[code]) {
+                this.bindings[code] = [];
+            }
+            const subj = new rxjs_1.BehaviorSubject(false);
+            this.bindings[code].push(subj);
+            subjects.push(subj);
+        }
+        return (0, rxjs_1.combineLatest)(subjects).pipe((0, rxjs_1.finalize)(() => {
+            for (let i = 0; i < codes.length; i++) {
+                this.bindings[codes[i]].splice(this.bindings[codes[i]].indexOf(subjects[i]), 1);
+                subjects[i].complete();
+            }
+        }), (0, operators_1.map)(values => values.includes(true)));
+    }
+    /**
+     * Emulates a key down event for the given key code
+     * @param code The key code to emulate
+     */
+    emulateKeyDown(code) {
+        if (!this.running) {
+            return;
+        }
+        for (const subj of this.bindings[code] || []) {
+            subj.next(true);
+        }
+    }
+    /**
+     * Emulates a key up event for the given key code
+     * @param code The key code to emulate
+     */
+    emulateKeyUp(code) {
+        if (!this.running) {
+            return;
+        }
+        for (const subj of this.bindings[code] || []) {
+            subj.next(false);
+        }
+    }
+    /**
+     * Emulates a key press event (down and up) for the given key code
+     * @param code The key code to emulate
+     */
+    emulateKeyPress(code) {
+        this.emulateKeyDown(code);
+        this.emulateKeyUp(code);
+    }
+    handleKeys(e) {
+        if (e.type != 'keydown' && e.type != 'keyup') {
+            return;
+        }
+        const pressed = e.type == 'keydown';
+        for (const subj of this.bindings[e.code] || []) {
+            subj.next(pressed);
+        }
+    }
+}
+exports.KeyboardInput = KeyboardInput;

package/dist/base/inputs/mouse.input.d.ts

@@ -0,0 +1,57 @@
+import { Input } from './input';
+import { Observable } from 'rxjs';
+import { Point2 } from '../models/points';
+/**
+ * Options for pointer lock in a MouseInput.
+ *
+ * ignoreMovementWhenNotLocked: Whether to ignore mouse movement when pointer lock is not active.
+ *
+ * canvas: The canvas element to request pointer lock on.
+ */
+export declare type MouseInputPointLockOptions = {
+    ignoreMovementWhenNotLocked: boolean;
+    canvas: HTMLCanvasElement;
+};
+/**
+ * Options for a MouseInput.
+ *
+ * pointerLock: The options for pointer lock. Do not provide it to disable pointer lock functionality
+ */
+export declare type MouseInputOptions = {
+    pointerLock?: MouseInputPointLockOptions;
+};
+/**
+ * A class representing mouse input.
+ */
+export declare class MouseInput extends Input<[], [unlockPointer?: boolean]> {
+    private readonly options;
+    /**
+     * An observable of the change in the x position of the mouse.
+     */
+    get deltaX$(): Observable<number>;
+    /**
+     * An observable of the change in the y position of the mouse.
+     */
+    get deltaY$(): Observable<number>;
+    /**
+     An observable of the change in the position of the mouse.
+     */
+    get delta$(): Observable<Point2>;
+    private _delta$;
+    private stopped$;
+    /**
+     Creates an instance of MouseInput.
+     @param {MouseInputOptions} options - The options for the MouseInput.
+     */
+    constructor(options?: MouseInputOptions);
+    protected startInternal(): Promise<void>;
+    /**
+     Stop listening for mouse movement events.
+     @param {boolean} [unlockPointer=true] - Whether to exit pointer lock.
+     */
+    protected stopInternal(unlockPointer?: boolean): Promise<void>;
+    /**
+     Request pointer lock on the canvas element.
+     */
+    private canvasClickListener;
+}

package/dist/base/inputs/mouse.input.js

@@ -0,0 +1,81 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MouseInput = void 0;
+const input_1 = require("./input");
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+/**
+ * A class representing mouse input.
+ */
+class MouseInput extends input_1.Input {
+    /**
+     Creates an instance of MouseInput.
+     @param {MouseInputOptions} options - The options for the MouseInput.
+     */
+    constructor(options = {}) {
+        super();
+        this.options = options;
+        this._delta$ = new rxjs_1.Subject();
+        this.stopped$ = new rxjs_1.Subject();
+        this.canvasClickListener = this.canvasClickListener.bind(this);
+    }
+    /**
+     * An observable of the change in the x position of the mouse.
+     */
+    get deltaX$() {
+        return this._delta$.pipe((0, operators_1.map)(d => d.x));
+    }
+    /**
+     * An observable of the change in the y position of the mouse.
+     */
+    get deltaY$() {
+        return this._delta$.pipe((0, operators_1.map)(d => d.y));
+    }
+    /**
+     An observable of the change in the position of the mouse.
+     */
+    get delta$() {
+        return this._delta$.asObservable();
+    }
+    startInternal() {
+        return __awaiter(this, void 0, void 0, function* () {
+            (0, rxjs_1.fromEvent)(window, 'mousemove')
+                .pipe((0, rxjs_1.takeUntil)(this.stopped$), (0, rxjs_1.filter)(() => !this.options.pointerLock ||
+                !this.options.pointerLock.ignoreMovementWhenNotLocked ||
+                !!document.pointerLockElement), (0, operators_1.map)((e) => ({ x: e.movementX, y: e.movementY })))
+                .subscribe(v => this._delta$.next(v));
+            if (!!this.options.pointerLock) {
+                this.options.pointerLock.canvas.addEventListener('click', this.canvasClickListener);
+            }
+        });
+    }
+    /**
+     Stop listening for mouse movement events.
+     @param {boolean} [unlockPointer=true] - Whether to exit pointer lock.
+     */
+    stopInternal(unlockPointer = true) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.stopped$.next();
+            if (unlockPointer && !!this.options.pointerLock) {
+                this.options.pointerLock.canvas.removeEventListener('click', this.canvasClickListener);
+                document.exitPointerLock();
+            }
+        });
+    }
+    /**
+     Request pointer lock on the canvas element.
+     */
+    canvasClickListener() {
+        this.options.pointerLock.canvas.requestPointerLock();
+    }
+}
+exports.MouseInput = MouseInput;

package/dist/base/math/point2.d.ts

@@ -12,4 +12,6 @@ export declare class Pnt2 {
     static scalarMult(p: Point2, m: number): Point2;
     /** linear interpolation */
     static lerp(a: Point2, b: Point2, t: number): Point2;
+    /** angle between vectors in radians */
+    static angle(a: Point2, b: Point2): number;
 }

package/dist/base/math/point2.js

@@ -36,5 +36,11 @@ class Pnt2 {
             y: a.y + t * (b.y - a.y),
         };
     }
+    /** angle between vectors in radians */
+    static angle(a, b) {
+        const dotProduct = a.x * b.x + a.y * b.y;
+        const magnitudeProduct = Math.sqrt(a.x ** 2 + a.y ** 2) * Math.sqrt(b.x ** 2 + b.y ** 2);
+        return Math.acos(dotProduct / magnitudeProduct);
+    }
 }
 exports.Pnt2 = Pnt2;

package/dist/base/math/point3.d.ts

@@ -18,6 +18,8 @@ export declare class Pnt3 {
     static scalarMult(p: Point3, m: number): Point3;
     /** linear interpolation */
     static lerp(a: Point3, b: Point3, t: number): Point3;
+    /** angle between vectors in radians */
+    static angle(a: Point3, b: Point3): number;
     /** rotate point a with quaternion q */
     static rot(p: Point3, q: Point4): Point3;
     /** rotate point around axis a (normalized vector) */

package/dist/base/math/point3.js

@@ -61,6 +61,12 @@ class Pnt3 {
             z: a.z + t * (b.z - a.z),
         };
     }
+    /** angle between vectors in radians */
+    static angle(a, b) {
+        const dotProduct = a.x * b.x + a.y * b.y + a.z * b.z;
+        const magnitudeProduct = Math.sqrt(a.x ** 2 + a.y ** 2 + a.z ** 2) * Math.sqrt(b.x ** 2 + b.y ** 2 + b.z ** 2);
+        return Math.acos(dotProduct / magnitudeProduct);
+    }
     /** rotate point a with quaternion q */
     static rot(p, q) {
         // faster version of:

package/dist/index.d.ts

@@ -1,12 +1,16 @@
-export * from './base/clock/clock';
+export * from './base/clock/i-clock';
+export * from './base/clock/pausable-clock';
 export * from './base/clock/global-clock';
 export * from './base/gg-viewport';
 export * from './base/gg-viewport-manager';
 export * from './base/entities/controllers/animation-mixer';
-export * from './base/entities/interfaces/i-tick-listener';
 export * from './base/entities/gg-entity';
 export * from './base/entities/base-gg-renderer';
 export * from './base/entities/inline-controller';
+export * from './base/inputs/direction.keyboard-input';
+export * from './base/inputs/input';
+export * from './base/inputs/keyboard.input';
+export * from './base/inputs/mouse.input';
 export * from './base/interfaces/gg-body';
 export * from './base/interfaces/gg-debug-physics-drawer';
 export * from './base/interfaces/gg-object';
@@ -23,10 +27,6 @@ export * from './base/math/point3';
 export * from './base/math/quaternion';
 export * from './base/math/numbers';
 export * from './base/math/matrix4';
-export * from './base/controllers/common';
-export * from './base/controllers/i-controller';
-export * from './base/controllers/keyboard.controller';
-export * from './base/controllers/mouse.controller';
 export * from './2d/entities/controllers/entity-2d-positioning.animator';
 export * from './2d/entities/gg-2d-entity';
 export * from './2d/entities/gg-positionable-2d-entity';
@@ -36,16 +36,16 @@ export * from './2d/models/shapes';
 export * from './2d/interfaces';
 export * from './2d/factories';
 export * from './2d/gg-2d-world';
-export * from './3d/controllers/car-keyboard.controller';
-export * from './3d/controllers/free-camera.controller';
-export * from './3d/entities/controllers/camera-3d.animator';
-export * from './3d/entities/controllers/entity-3d-positioning.animator';
+export * from './3d/entities/controllers/animators/camera-3d.animator';
+export * from './3d/entities/controllers/animators/entity-3d-positioning.animator';
 export * from './3d/entities/gg-3d-entity';
 export * from './3d/entities/gg-positionable-3d-entity';
 export * from './3d/entities/gg-3d-camera.entity';
 export * from './3d/entities/gg-3d-map-graph.entity';
 export * from './3d/entities/gg-3d-raycast-vehicle.entity';
 export * from './3d/entities/gg-3d-trigger.entity';
+export * from './3d/entities/controllers/input/car-keyboard-handling.controller';
+export * from './3d/entities/controllers/input/free-camera.controller';
 export * from './3d/models/body-options';
 export * from './3d/models/gg-meta';
 export * from './3d/models/shapes';

package/dist/index.js

@@ -14,15 +14,19 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./base/clock/clock"), exports);
+__exportStar(require("./base/clock/i-clock"), exports);
+__exportStar(require("./base/clock/pausable-clock"), exports);
 __exportStar(require("./base/clock/global-clock"), exports);
 __exportStar(require("./base/gg-viewport"), exports);
 __exportStar(require("./base/gg-viewport-manager"), exports);
 __exportStar(require("./base/entities/controllers/animation-mixer"), exports);
-__exportStar(require("./base/entities/interfaces/i-tick-listener"), exports);
 __exportStar(require("./base/entities/gg-entity"), exports);
 __exportStar(require("./base/entities/base-gg-renderer"), exports);
 __exportStar(require("./base/entities/inline-controller"), exports);
+__exportStar(require("./base/inputs/direction.keyboard-input"), exports);
+__exportStar(require("./base/inputs/input"), exports);
+__exportStar(require("./base/inputs/keyboard.input"), exports);
+__exportStar(require("./base/inputs/mouse.input"), exports);
 __exportStar(require("./base/interfaces/gg-body"), exports);
 __exportStar(require("./base/interfaces/gg-debug-physics-drawer"), exports);
 __exportStar(require("./base/interfaces/gg-object"), exports);
@@ -39,10 +43,6 @@ __exportStar(require("./base/math/point3"), exports);
 __exportStar(require("./base/math/quaternion"), exports);
 __exportStar(require("./base/math/numbers"), exports);
 __exportStar(require("./base/math/matrix4"), exports);
-__exportStar(require("./base/controllers/common"), exports);
-__exportStar(require("./base/controllers/i-controller"), exports);
-__exportStar(require("./base/controllers/keyboard.controller"), exports);
-__exportStar(require("./base/controllers/mouse.controller"), exports);
 __exportStar(require("./2d/entities/controllers/entity-2d-positioning.animator"), exports);
 __exportStar(require("./2d/entities/gg-2d-entity"), exports);
 __exportStar(require("./2d/entities/gg-positionable-2d-entity"), exports);
@@ -52,16 +52,16 @@ __exportStar(require("./2d/models/shapes"), exports);
 __exportStar(require("./2d/interfaces"), exports);
 __exportStar(require("./2d/factories"), exports);
 __exportStar(require("./2d/gg-2d-world"), exports);
-__exportStar(require("./3d/controllers/car-keyboard.controller"), exports);
-__exportStar(require("./3d/controllers/free-camera.controller"), exports);
-__exportStar(require("./3d/entities/controllers/camera-3d.animator"), exports);
-__exportStar(require("./3d/entities/controllers/entity-3d-positioning.animator"), exports);
+__exportStar(require("./3d/entities/controllers/animators/camera-3d.animator"), exports);
+__exportStar(require("./3d/entities/controllers/animators/entity-3d-positioning.animator"), exports);
 __exportStar(require("./3d/entities/gg-3d-entity"), exports);
 __exportStar(require("./3d/entities/gg-positionable-3d-entity"), exports);
 __exportStar(require("./3d/entities/gg-3d-camera.entity"), exports);
 __exportStar(require("./3d/entities/gg-3d-map-graph.entity"), exports);
 __exportStar(require("./3d/entities/gg-3d-raycast-vehicle.entity"), exports);
 __exportStar(require("./3d/entities/gg-3d-trigger.entity"), exports);
+__exportStar(require("./3d/entities/controllers/input/car-keyboard-handling.controller"), exports);
+__exportStar(require("./3d/entities/controllers/input/free-camera.controller"), exports);
 __exportStar(require("./3d/models/body-options"), exports);
 __exportStar(require("./3d/models/gg-meta"), exports);
 __exportStar(require("./3d/models/shapes"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gg-web-engine/core",
-  "version": "0.0.03",
+  "version": "0.0.05",
   "description": "An attempt to create open source game engine for browser",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",