@gg-web-engine/core 0.0.1 → 0.0.2

package/package.json

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

package/src/2d/entities/gg-2d-entity.ts

@@ -1,86 +0,0 @@
-import { Subject, Subscription } from 'rxjs';
-import { GgPositionable2dEntity } from './gg-positionable-2d-entity';
-import { ITickListener } from '../../base/entities/interfaces/i-tick-listener';
-import { Point2 } from '../../base/models/points';
-import { IGg2dBody, IGg2dObject } from '../interfaces';
-import { Gg2dWorld } from '../gg-2d-world';
-
-export class Gg2dEntity extends GgPositionable2dEntity implements ITickListener {
-  public readonly tick$: Subject<[number, number]> = new Subject<[number, number]>();
-  public readonly tickOrder = 750;
-  private tickSub: Subscription | null = null;
-
-  set position(value: Point2) {
-    if (this.object2D) {
-      this.object2D.position = value;
-    }
-    if (this.objectBody) {
-      this.objectBody.position = value;
-    }
-    super.position = value;
-  }
-
-  set rotation(value: number) {
-    if (this.object2D) {
-      this.object2D.rotation = value;
-    }
-    if (this.objectBody) {
-      this.objectBody.rotation = value;
-    }
-    super.rotation = value;
-  }
-
-  set scale(value: Point2) {
-    if (this.object2D) {
-      this.object2D.scale = value;
-    }
-    if (this.objectBody) {
-      this.objectBody.scale = value;
-    }
-    super.scale = value;
-  }
-
-  constructor(public readonly object2D: IGg2dObject | null, public readonly objectBody: IGg2dBody | null) {
-    super();
-    if (objectBody && object2D) {
-      this.tickSub = this.tick$.subscribe(() => {
-        // bind physics body transform to object transform
-        const pos = objectBody.position;
-        const rot = objectBody.rotation;
-        object2D.position = pos;
-        object2D.rotation = rot;
-        this._position$.next(pos);
-        this._rotation$.next(rot);
-      });
-    } else if (!objectBody && !object2D) {
-      throw new Error('Cannot create entity without a sprite and a body');
-    }
-    if (objectBody) {
-      objectBody.entity = this;
-    }
-  }
-
-  onSpawned(world: Gg2dWorld) {
-    super.onSpawned(world);
-    this.object2D?.addToWorld(world.visualScene);
-    this.objectBody?.addToWorld(world.physicsWorld);
-  }
-
-  onRemoved() {
-    this.object2D?.removeFromWorld(this.world!.visualScene);
-    this.objectBody?.removeFromWorld(this.world!.physicsWorld);
-    super.onRemoved();
-  }
-
-  dispose(): void {
-    super.dispose();
-    this.tickSub?.unsubscribe();
-    this.tickSub = null;
-    if (this.object2D) {
-      this.object2D.dispose();
-    }
-    if (this.objectBody) {
-      this.objectBody.dispose();
-    }
-  }
-}

package/src/2d/entities/gg-2d-trigger.entity.ts

@@ -1,17 +0,0 @@
-import { IGg2dTrigger } from '../interfaces';
-import { Gg2dEntity } from './gg-2d-entity';
-import { Observable } from 'rxjs';
-import { GgPositionable2dEntity } from './gg-positionable-2d-entity';
-
-export class Gg2dTriggerEntity extends Gg2dEntity {
-  get onEntityEntered(): Observable<GgPositionable2dEntity> {
-    return this.objectBody.onEntityEntered;
-  }
-  get onEntityLeft(): Observable<GgPositionable2dEntity | null> {
-    return this.objectBody.onEntityLeft;
-  }
-
-  constructor(public readonly objectBody: IGg2dTrigger) {
-    super(null, objectBody);
-  }
-}

package/src/2d/entities/gg-positionable-2d-entity.ts

@@ -1,16 +0,0 @@
-import { Point2 } from '../../base/models/points';
-import { GgPositionableEntity } from '../../base/entities/gg-positionable-entity';
-
-export abstract class GgPositionable2dEntity extends GgPositionableEntity<Point2, number> {
-  getDefaultPosition(): Point2 {
-    return { x: 0, y: 0 };
-  }
-
-  getDefaultRotation(): number {
-    return 0;
-  }
-
-  getDefaultScale(): Point2 {
-    return { x: 1, y: 1 };
-  }
-}

package/src/2d/factories.ts

@@ -1,20 +0,0 @@
-import { BodyShape2DDescriptor, Shape2DDescriptor } from './models/shapes';
-import { Point2 } from '../base/models/points';
-import { IGg2dBody, IGg2dObject, IGg2dTrigger } from './interfaces';
-
-export abstract class IGg2dObjectFactory<T extends IGg2dObject = IGg2dObject> {
-  abstract createPrimitive(descriptor: Shape2DDescriptor): T;
-
-  // shortcuts
-  createSquare(dimensions: Point2): T {
-    return this.createPrimitive({ shape: 'SQUARE', dimensions });
-  }
-  createCircle(radius: number): T {
-    return this.createPrimitive({ shape: 'CIRCLE', radius });
-  }
-}
-
-export interface IGg2dBodyFactory<T extends IGg2dBody = IGg2dBody, K extends IGg2dTrigger = IGg2dTrigger> {
-  createRigidBody(descriptor: BodyShape2DDescriptor, transform?: { position?: Point2; rotation?: number }): T;
-  createTrigger(descriptor: Shape2DDescriptor, transform?: { position?: Point2; rotation?: number }): K;
-}

package/src/2d/gg-2d-world.ts

@@ -1,32 +0,0 @@
-import { GgWorld } from '../base/gg-world';
-import { Point2 } from '../base/models/points';
-import { IGg2dPhysicsWorld, IGg2dVisualScene } from './interfaces';
-
-export class Gg2dWorld<
-  V extends IGg2dVisualScene = IGg2dVisualScene,
-  P extends IGg2dPhysicsWorld = IGg2dPhysicsWorld,
-> extends GgWorld<Point2, number, V, P> {
-  constructor(
-    public readonly visualScene: V,
-    public readonly physicsWorld: P,
-    protected readonly consoleEnabled: boolean = false,
-  ) {
-    super(visualScene, physicsWorld, consoleEnabled);
-    if (consoleEnabled) {
-      this.registerConsoleCommand(
-        'ph_gravity',
-        async (...args: string[]) => {
-          if (args.length == 1) {
-            args = ['0', args[0]]; // mean Y axis
-          }
-          if (args.length > 0) {
-            this.physicsWorld.gravity = { x: +args[0], y: +args[1] };
-          }
-          return JSON.stringify(this.physicsWorld.gravity);
-        },
-        'args: [float] or [float float]; change 2D world gravity vector. 1 argument means ' +
-          '{x: 0, y: value}, 2 arguments set the whole vector. Default value is "9.82" or "0 9.82"',
-      );
-    }
-  }
-}

package/src/2d/interfaces.ts

@@ -1,31 +0,0 @@
-import { GgBody } from '../base/interfaces/gg-body';
-import { Point2 } from '../base/models/points';
-import { GgObject } from '../base/interfaces/gg-object';
-import { GgPhysicsWorld } from '../base/interfaces/gg-physics-world';
-import { GgVisualScene } from '../base/interfaces/gg-visual-scene';
-import { BaseGgRenderer } from '../base/entities/base-gg-renderer';
-import { GgTrigger } from '../base/interfaces/gg-trigger';
-import { Observable } from 'rxjs';
-import { GgPositionable2dEntity } from './entities/gg-positionable-2d-entity';
-import { IGg2dBodyFactory, IGg2dObjectFactory } from './factories';
-
-// These interfaces have to be implemented for a particular 2D physics engine
-export interface IGg2dPhysicsWorld extends GgPhysicsWorld<Point2, number> {
-  readonly factory: IGg2dBodyFactory;
-}
-
-export abstract class Gg2dRenderer extends BaseGgRenderer {}
-
-export interface IGg2dBody extends GgBody<Point2, number> {}
-
-export interface IGg2dTrigger extends GgTrigger<Point2, number> {
-  get onEntityEntered(): Observable<GgPositionable2dEntity>;
-  get onEntityLeft(): Observable<GgPositionable2dEntity | null>;
-}
-
-// These interfaces have to be implemented for a particular 2D rendering engine
-export interface IGg2dVisualScene extends GgVisualScene<Point2, number> {
-  readonly factory: IGg2dObjectFactory;
-}
-
-export interface IGg2dObject extends GgObject<Point2, number> {}

package/src/2d/models/body-options.ts

@@ -1,3 +0,0 @@
-import { BodyOptions } from '../../base/models/body-options';
-
-export interface Body2DOptions extends BodyOptions {}

package/src/2d/models/shapes.ts

@@ -1,7 +0,0 @@
-import { Point2 } from '../../base/models/points';
-import { Body2DOptions } from './body-options';
-
-export type Shape2DDescriptor = { shape: 'SQUARE'; dimensions: Point2 } | { shape: 'CIRCLE'; radius: number };
-// TODO add more shapes
-
-export type BodyShape2DDescriptor = { shape: Shape2DDescriptor; body: Partial<Body2DOptions> };

package/src/3d/controllers/car-keyboard.controller.ts

@@ -1,128 +0,0 @@
-import { BehaviorSubject, combineLatest, interval, pipe, Subject, takeUntil, filter } from 'rxjs';
-import { distinctUntilChanged, map, pairwise, startWith, switchMap, take, tap } from 'rxjs/operators';
-import { IController } from '../../base/controllers/i-controller';
-import { KeyboardController } from '../../base/controllers/keyboard.controller';
-import { Gg3dRaycastVehicleEntity } from '../entities/gg-3d-raycast-vehicle.entity';
-import { bindDirectionKeys, DirectionKeymap, DirectionOutput } from '../../base/controllers/common';
-
-// TODO pass as settings
-// TODO smooth y?
-const TICKER_INTERVAL = 16;
-const TICKER_MAX_STEPS = 10;
-
-type CarKeyboardControllerOptions = {
-  keymap: DirectionKeymap;
-  gearUpDownKeys: [string, string];
-};
-
-export class CarKeyboardController implements IController {
-  // emits values -1 - 1; -1 = full turn left; 1 = full turn right
-  private readonly x$: BehaviorSubject<number> = new BehaviorSubject<number>(0);
-  // emits values -1 - 1; -1 = full brake; 1 = full acceleration
-  private readonly y$: BehaviorSubject<number> = new BehaviorSubject<number>(0);
-
-  private lastX: number = 0;
-  private readonly stop$: Subject<void> = new Subject<void>();
-
-  protected readonly car$: BehaviorSubject<Gg3dRaycastVehicleEntity> = new BehaviorSubject<Gg3dRaycastVehicleEntity>(
-    null!,
-  );
-
-  pairTickerPipe = pipe(
-    startWith(0),
-    pairwise<number>(),
-    map(([beforeValue, afterValue]) => [this.lastX, afterValue] as [number, number]),
-    switchMap(([beforeValue, afterValue]: [number, number]) =>
-      interval(TICKER_INTERVAL).pipe(
-        take(TICKER_MAX_STEPS),
-        map(count => ++count),
-        map(
-          count =>
-            beforeValue * ((TICKER_MAX_STEPS - count) / TICKER_MAX_STEPS) + afterValue * (count / TICKER_MAX_STEPS),
-        ),
-        tap(x => {
-          this.lastX = x;
-        }),
-      ),
-    ),
-  );
-
-  public set car(value: Gg3dRaycastVehicleEntity) {
-    this.car$.next(value);
-  }
-
-  public get car(): Gg3dRaycastVehicleEntity {
-    return this.car$.getValue();
-  }
-
-  constructor(
-    private readonly keyboardController: KeyboardController,
-    car: Gg3dRaycastVehicleEntity,
-    private readonly options: CarKeyboardControllerOptions = { keymap: 'arrows', gearUpDownKeys: ['KeyA', 'KeyZ'] },
-  ) {
-    this.car$.next(car);
-  }
-
-  async start(): Promise<void> {
-    let moveDirection: DirectionOutput = {};
-    bindDirectionKeys(this.keyboardController, this.options.keymap)
-      .pipe(takeUntil(this.stop$))
-      .subscribe(d => {
-        moveDirection = d;
-      });
-    this.car$
-      .pipe(
-        takeUntil(this.stop$),
-        switchMap(c => c.tick$),
-        takeUntil(this.stop$),
-        map(() => {
-          const direction = [0, 0];
-          if (moveDirection.leftRight !== undefined) direction[0] = moveDirection.leftRight ? -1 : 1;
-          if (moveDirection.upDown !== undefined) direction[1] = moveDirection.upDown ? 1 : -1;
-          return direction;
-        }),
-      )
-      .subscribe(([x, y]) => {
-        this.x$.next(x);
-        this.y$.next(y);
-      });
-    combineLatest([
-      this.x$.pipe(takeUntil(this.stop$), distinctUntilChanged(), this.pairTickerPipe),
-      this.y$.pipe(takeUntil(this.stop$), distinctUntilChanged()),
-    ]).subscribe(([x, y]) => {
-      this.car$.getValue().setXAxisControlValue(x);
-      this.car$.getValue().setYAxisControlValue(y);
-    });
-    this.keyboardController
-      .bind(this.options.gearUpDownKeys[0])
-      .pipe(
-        takeUntil(this.stop$),
-        filter(x => !!x),
-      )
-      .subscribe(() => {
-        if (
-          this.car$.getValue() &&
-          (!this.car$.getValue().carProperties.transmission.isAuto || this.car$.getValue().gear <= 0)
-        ) {
-          this.car$.getValue().gear++;
-        }
-      });
-    this.keyboardController
-      .bind(this.options.gearUpDownKeys[1])
-      .pipe(
-        takeUntil(this.stop$),
-        filter(x => !!x),
-      )
-      .subscribe(() => {
-        if (this.car$.getValue().carProperties.transmission.isAuto && this.car.gear > 1) {
-          this.car$.getValue().gear = 0;
-        } else {
-          this.car$.getValue().gear--;
-        }
-      });
-  }
-
-  async stop(): Promise<void> {
-    this.stop$.next();
-  }
-}

package/src/3d/controllers/free-camera.controller.ts

@@ -1,86 +0,0 @@
-import { IController } from '../../base/controllers/i-controller';
-import { combineLatest, Subject, takeUntil } from 'rxjs';
-import { MouseController, MouseControllerOptions } from '../../base/controllers/mouse.controller';
-import { Pnt3 } from '../../base/math/point3';
-import { Gg3dCameraEntity } from '../entities/gg-3d-camera.entity';
-import { KeyboardController } from '../../base/controllers/keyboard.controller';
-import { Pnt2 } from '../../base/math/point2';
-import { Point2 } from '../../base/models/points';
-import { Qtrn } from '../../base/math/quaternion';
-import { bindDirectionKeys, DirectionKeymap, DirectionOutput } from '../../base/controllers/common';
-
-type FreeCameraControllerOptions = {
-  keymap: DirectionKeymap;
-  movementOptions: {
-    speed: number;
-  };
-  mouseOptions: MouseControllerOptions;
-};
-
-export class FreeCameraController implements IController {
-  private readonly mController: MouseController;
-  private readonly stop$: Subject<void> = new Subject<void>();
-
-  constructor(
-    private readonly keyboardController: KeyboardController,
-    private readonly camera: Gg3dCameraEntity,
-    private readonly options: FreeCameraControllerOptions = {
-      keymap: 'wasd',
-      movementOptions: { speed: 0.5 },
-      mouseOptions: {},
-    },
-  ) {
-    this.mController = new MouseController(options.mouseOptions);
-  }
-
-  async start(): Promise<void> {
-    let controls: { direction: DirectionOutput; rest: boolean[] } = { direction: {}, rest: [] };
-    const keys = ['KeyE', 'KeyQ'];
-    if (this.camera.object3D.supportsFov) {
-      keys.push('KeyZ', 'KeyC');
-    }
-    bindDirectionKeys(this.keyboardController, this.options.keymap)
-      .pipe(takeUntil(this.stop$))
-      .subscribe(d => {
-        controls.direction = d;
-      });
-    combineLatest(keys.map(c => this.keyboardController.bind(c)))
-      .pipe(takeUntil(this.stop$))
-      .subscribe((d: boolean[]) => {
-        controls.rest = d;
-      });
-
-    let rotationDelta: Point2 = { x: 0, y: 0 };
-    this.mController.delta$.pipe(takeUntil(this.stop$)).subscribe(delta => {
-      rotationDelta = Pnt2.add(rotationDelta, delta);
-    });
-
-    this.camera.tick$.pipe(takeUntil(this.stop$)).subscribe(() => {
-      let translateVector = { x: 0, y: 0, z: 0 };
-      const [u, d, zo, zi] = controls.rest;
-      if (controls.direction.upDown !== undefined) translateVector.z = controls.direction.upDown ? -1 : 1;
-      if (controls.direction.leftRight !== undefined) translateVector.x = controls.direction.leftRight ? -1 : 1;
-      if (u != d) translateVector.y = d ? -1 : 1;
-      if (zo != zi) this.camera.object3D.fov += zo ? 1 : -1;
-      this.camera.position = Pnt3.add(
-        this.camera.position,
-        Pnt3.rot(Pnt3.scalarMult(Pnt3.norm(translateVector), this.options.movementOptions.speed), this.camera.rotation),
-      );
-      if (rotationDelta.x != 0 || rotationDelta.y != 0) {
-        this.camera.rotation = Qtrn.combineRotations(
-          Qtrn.fromAngle({ x: 0, y: 0, z: 1 }, -rotationDelta.x / 300),
-          this.camera.rotation,
-          Qtrn.fromAngle({ x: 1, y: 0, z: 0 }, -rotationDelta.y / 300),
-        );
-        rotationDelta = { x: 0, y: 0 };
-      }
-    });
-
-    await this.mController.start();
-  }
-
-  async stop(unlockPointer: boolean = true): Promise<void> {
-    this.stop$.next();
-    await this.mController.stop(unlockPointer);
-  }
-}

package/src/3d/entities/controllers/entity-motion.controller.ts

@@ -1,122 +0,0 @@
-import { GgEntity } from '../../../base/entities/gg-entity';
-import { ITickListener } from '../../../base/entities/interfaces/i-tick-listener';
-import { Subject, Subscription, takeUntil } from 'rxjs';
-import { Gg3dWorld } from '../../gg-3d-world';
-import { GgPositionable3dEntity } from '../gg-positionable-3d-entity';
-import { Point3, Point4 } from '../../../base/models/points';
-import { Pnt3 } from '../../../base/math/point3';
-import { Qtrn } from '../../../base/math/quaternion';
-
-export type MotionControlFuncReturn = { position: Point3; rotation: Point4; customParameters: { [key: string]: any } };
-export type MotionControlFunction = (delta: number) => MotionControlFuncReturn;
-
-export class EntityMotionController extends GgEntity implements ITickListener {
-  get motionControlFunction(): MotionControlFunction {
-    return this._motionControlFunction;
-  }
-
-  set motionControlFunction(value: MotionControlFunction) {
-    if (this.currentTransition) {
-      this.currentTransition.unsubscribe();
-      this.currentTransition = null;
-    }
-    this._motionControlFunction = value;
-  }
-  public readonly tick$: Subject<[number, number]> = new Subject<[number, number]>();
-
-  protected readonly removed$: Subject<void> = new Subject<void>();
-  public readonly tickOrder: number = 750;
-
-  constructor(
-    public target: GgPositionable3dEntity,
-    protected _motionControlFunction: MotionControlFunction,
-    public customParametersHandleFunc: (target: GgPositionable3dEntity, params: any) => void = () => {},
-  ) {
-    super();
-  }
-
-  protected lastValue: MotionControlFuncReturn | undefined;
-  private currentTransition: Subscription | null = null;
-
-  // smoothly set controller function, animate from some determined state
-  transitFromStaticState(
-    state: MotionControlFuncReturn,
-    newFunc: MotionControlFunction,
-    transitionDuration: number,
-    easing: (t: number) => number = x => x,
-    customParametersLerpFunc: (a: any, b: any, t: number) => any = (a, b, t) => b,
-  ) {
-    this.lastValue = state;
-    this._motionControlFunction = () => state;
-    return this.transitControlFunction(newFunc, transitionDuration, easing, customParametersLerpFunc);
-  }
-
-  // smoothly change controller function
-  transitControlFunction(
-    newFunc: MotionControlFunction,
-    transitionDuration: number,
-    easing: (t: number) => number = x => x,
-    customParametersLerpFunc: (a: any, b: any, t: number) => any = (a, b, t) => b,
-  ) {
-    let oldControlFunc: MotionControlFunction;
-    if (this.currentTransition) {
-      this.currentTransition.unsubscribe();
-      this.currentTransition = null;
-      if (this.lastValue) {
-        oldControlFunc = () => this.lastValue!;
-      } else {
-        this._motionControlFunction = newFunc;
-        return;
-      }
-    } else {
-      oldControlFunc = this._motionControlFunction;
-    }
-    let k = 0;
-    this._motionControlFunction = delta => {
-      const oldRes = oldControlFunc(delta);
-      const newRes = newFunc(delta);
-      return {
-        customParameters: customParametersLerpFunc(oldRes.customParameters, newRes.customParameters, k),
-        position: Pnt3.lerp(oldRes.position, newRes.position, k),
-        rotation: Qtrn.slerp(oldRes.rotation, newRes.rotation, k),
-      };
-    };
-    let startTime: number | undefined;
-    this.currentTransition = this.tick$.pipe(takeUntil(this.removed$)).subscribe(([elapsed, _]) => {
-      if (startTime === undefined) {
-        startTime = elapsed;
-      } else {
-        k = (elapsed - startTime) / transitionDuration;
-        if (k >= 1) {
-          k = 1;
-          this.currentTransition!.unsubscribe();
-          this.currentTransition = null;
-          this._motionControlFunction = newFunc;
-        } else {
-          k = easing(k);
-        }
-      }
-    });
-  }
-
-  onSpawned(world: Gg3dWorld) {
-    super.onSpawned(world);
-    this.tick$.pipe(takeUntil(this.removed$)).subscribe(([_, delta]) => {
-      this.lastValue = this._motionControlFunction(delta);
-      this.target.position = this.lastValue.position;
-      this.target.rotation = this.lastValue.rotation;
-      this.customParametersHandleFunc(this.target, this.lastValue.customParameters);
-    });
-  }
-
-  onRemoved() {
-    super.onRemoved();
-    this.removed$.next();
-  }
-
-  dispose(): void {
-    super.dispose();
-    this.tick$.unsubscribe();
-    this.tick$.complete();
-  }
-}

package/src/3d/entities/gg-3d-camera.entity.ts

@@ -1,8 +0,0 @@
-import { IGg3dBody, IGg3dCamera } from '../interfaces';
-import { Gg3dEntity } from './gg-3d-entity';
-
-export class Gg3dCameraEntity<T extends IGg3dCamera = IGg3dCamera> extends Gg3dEntity {
-  constructor(public readonly object3D: T, public readonly objectBody: IGg3dBody | null = null) {
-    super(object3D, objectBody);
-  }
-}