@gg-web-engine/core 0.0.3 → 0.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/dist/2d/entities/controllers/entity-2d-positioning.animator.js +1 -1
  2. package/dist/2d/entities/gg-2d-entity.d.ts +3 -5
  3. package/dist/2d/entities/gg-2d-entity.js +2 -3
  4. package/dist/3d/entities/controllers/animators/camera-3d.animator.d.ts +17 -0
  5. package/dist/3d/entities/controllers/animators/camera-3d.animator.js +32 -0
  6. package/dist/3d/entities/controllers/animators/entity-3d-positioning.animator.d.ts +16 -0
  7. package/dist/3d/entities/controllers/animators/entity-3d-positioning.animator.js +26 -0
  8. package/dist/3d/entities/controllers/input/car-keyboard-handling.controller.d.ts +25 -0
  9. package/dist/3d/entities/controllers/input/car-keyboard-handling.controller.js +105 -0
  10. package/dist/3d/entities/controllers/input/free-camera.controller.d.ts +54 -0
  11. package/dist/3d/entities/controllers/input/free-camera.controller.js +102 -0
  12. package/dist/3d/entities/gg-3d-entity.d.ts +3 -5
  13. package/dist/3d/entities/gg-3d-entity.js +2 -3
  14. package/dist/3d/entities/gg-3d-map-graph.entity.d.ts +3 -5
  15. package/dist/3d/entities/gg-3d-map-graph.entity.js +1 -2
  16. package/dist/3d/inputs/car-keyboard.input.d.ts +25 -0
  17. package/dist/3d/inputs/car-keyboard.input.js +100 -0
  18. package/dist/3d/inputs/free-camera.input.d.ts +22 -0
  19. package/dist/3d/inputs/free-camera.input.js +80 -0
  20. package/dist/base/clock/global-clock.d.ts +4 -3
  21. package/dist/base/clock/global-clock.js +2 -2
  22. package/dist/base/clock/i-clock.d.ts +7 -0
  23. package/dist/base/clock/i-clock.js +2 -0
  24. package/dist/base/clock/pausable-clock.d.ts +25 -0
  25. package/dist/base/clock/pausable-clock.js +79 -0
  26. package/dist/base/entities/base-gg-renderer.d.ts +3 -15
  27. package/dist/base/entities/base-gg-renderer.js +2 -30
  28. package/dist/base/entities/controllers/animation-mixer.d.ts +1 -8
  29. package/dist/base/entities/controllers/animation-mixer.js +2 -11
  30. package/dist/base/entities/gg-entity.d.ts +29 -0
  31. package/dist/base/entities/gg-entity.js +35 -1
  32. package/dist/base/entities/inline-controller.js +1 -6
  33. package/dist/base/entities/interfaces/i-tick-listener.d.ts +25 -1
  34. package/dist/base/entities/interfaces/i-tick-listener.js +17 -1
  35. package/dist/base/gg-world.d.ts +9 -6
  36. package/dist/base/gg-world.js +47 -29
  37. package/dist/base/inputs/direction.keyboard-input.d.ts +41 -0
  38. package/dist/base/inputs/direction.keyboard-input.js +85 -0
  39. package/dist/base/inputs/input.d.ts +50 -0
  40. package/dist/base/inputs/input.js +80 -0
  41. package/dist/base/inputs/keyboard.input.d.ts +45 -0
  42. package/dist/base/inputs/keyboard.input.js +130 -0
  43. package/dist/base/inputs/mouse.input.d.ts +57 -0
  44. package/dist/base/inputs/mouse.input.js +81 -0
  45. package/dist/index.d.ts +10 -10
  46. package/dist/index.js +10 -10
  47. package/package.json +1 -1
@@ -0,0 +1,22 @@
1
+ import { Input } from '../../base/inputs/input';
2
+ import { MouseControllerOptions, MouseInput } from '../../base/inputs/mouse.input';
3
+ import { Gg3dCameraEntity } from '../entities/gg-3d-camera.entity';
4
+ import { KeyboardInput } from '../../base/inputs/keyboard.input';
5
+ import { DirectionKeyboardInput, DirectionKeyboardKeymap } from '../../base/inputs/direction.keyboard-input';
6
+ export declare type FreeCameraControllerOptions = {
7
+ keymap: DirectionKeyboardKeymap;
8
+ movementOptions: {
9
+ speed: number;
10
+ };
11
+ mouseOptions: MouseControllerOptions;
12
+ };
13
+ export declare class FreeCameraInput extends Input<[], [unlockPointer?: boolean]> {
14
+ protected readonly keyboard: KeyboardInput;
15
+ protected readonly camera: Gg3dCameraEntity;
16
+ protected readonly options: FreeCameraControllerOptions;
17
+ protected readonly mouseInput: MouseInput;
18
+ protected readonly directionsInput: DirectionKeyboardInput;
19
+ constructor(keyboard: KeyboardInput, camera: Gg3dCameraEntity, options?: FreeCameraControllerOptions);
20
+ protected startInternal(): Promise<void>;
21
+ protected stopInternal(unlockPointer?: boolean): Promise<void>;
22
+ }
@@ -0,0 +1,80 @@
1
+ "use strict";
2
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
+ return new (P || (P = Promise))(function (resolve, reject) {
5
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
9
+ });
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.FreeCameraInput = void 0;
13
+ const input_1 = require("../../base/inputs/input");
14
+ const rxjs_1 = require("rxjs");
15
+ const mouse_input_1 = require("../../base/inputs/mouse.input");
16
+ const point3_1 = require("../../base/math/point3");
17
+ const point2_1 = require("../../base/math/point2");
18
+ const quaternion_1 = require("../../base/math/quaternion");
19
+ const direction_keyboard_input_1 = require("../../base/inputs/direction.keyboard-input");
20
+ class FreeCameraInput extends input_1.Input {
21
+ constructor(keyboard, camera, options = {
22
+ keymap: 'wasd',
23
+ movementOptions: { speed: 0.5 },
24
+ mouseOptions: {},
25
+ }) {
26
+ super();
27
+ this.keyboard = keyboard;
28
+ this.camera = camera;
29
+ this.options = options;
30
+ this.mouseInput = new mouse_input_1.MouseInput(options.mouseOptions);
31
+ this.directionsInput = new direction_keyboard_input_1.DirectionKeyboardInput(keyboard, options.keymap);
32
+ }
33
+ startInternal() {
34
+ return __awaiter(this, void 0, void 0, function* () {
35
+ let controls = { direction: {}, rest: [] };
36
+ const keys = ['KeyE', 'KeyQ'];
37
+ if (this.camera.object3D.supportsFov) {
38
+ keys.push('KeyZ', 'KeyC');
39
+ }
40
+ this.directionsInput.output$.pipe((0, rxjs_1.takeUntil)(this.stop$)).subscribe(d => {
41
+ controls.direction = d;
42
+ });
43
+ (0, rxjs_1.combineLatest)(keys.map(c => this.keyboard.bind(c)))
44
+ .pipe((0, rxjs_1.takeUntil)(this.stop$))
45
+ .subscribe((d) => {
46
+ controls.rest = d;
47
+ });
48
+ let rotationDelta = { x: 0, y: 0 };
49
+ this.mouseInput.delta$.pipe((0, rxjs_1.takeUntil)(this.stop$)).subscribe(delta => {
50
+ rotationDelta = point2_1.Pnt2.add(rotationDelta, delta);
51
+ });
52
+ this.camera.tick$.pipe((0, rxjs_1.takeUntil)(this.stop$)).subscribe(() => {
53
+ let translateVector = { x: 0, y: 0, z: 0 };
54
+ const [u, d, zo, zi] = controls.rest;
55
+ if (controls.direction.upDown !== undefined)
56
+ translateVector.z = controls.direction.upDown ? -1 : 1;
57
+ if (controls.direction.leftRight !== undefined)
58
+ translateVector.x = controls.direction.leftRight ? -1 : 1;
59
+ if (u != d)
60
+ translateVector.y = d ? -1 : 1;
61
+ if (zo != zi)
62
+ this.camera.object3D.fov += zo ? 1 : -1;
63
+ this.camera.position = point3_1.Pnt3.add(this.camera.position, point3_1.Pnt3.rot(point3_1.Pnt3.scalarMult(point3_1.Pnt3.norm(translateVector), this.options.movementOptions.speed), this.camera.rotation));
64
+ if (rotationDelta.x != 0 || rotationDelta.y != 0) {
65
+ this.camera.rotation = quaternion_1.Qtrn.combineRotations(quaternion_1.Qtrn.fromAngle({ x: 0, y: 0, z: 1 }, -rotationDelta.x / 300), this.camera.rotation, quaternion_1.Qtrn.fromAngle({ x: 1, y: 0, z: 0 }, -rotationDelta.y / 300));
66
+ rotationDelta = { x: 0, y: 0 };
67
+ }
68
+ });
69
+ yield this.mouseInput.start();
70
+ yield this.directionsInput.start();
71
+ });
72
+ }
73
+ stopInternal(unlockPointer = true) {
74
+ return __awaiter(this, void 0, void 0, function* () {
75
+ yield this.mouseInput.stop(unlockPointer);
76
+ yield this.directionsInput.stop();
77
+ });
78
+ }
79
+ }
80
+ exports.FreeCameraInput = FreeCameraInput;
@@ -1,15 +1,16 @@
1
1
  import { Observable } from 'rxjs';
2
- import { Clock } from './clock';
2
+ import { PausableClock } from './pausable-clock';
3
+ import { IClock } from './i-clock';
3
4
  /**
4
5
  * A singleton class, providing ability to track time, fire ticks, provide time elapsed + tick delta.
5
6
  * Starts as soon as accessed and counts time from 01/01/1970
6
7
  */
7
- export declare class GgGlobalClock {
8
+ export declare class GgGlobalClock implements IClock {
8
9
  private static _instance;
9
10
  static get instance(): GgGlobalClock;
10
11
  private readonly _tick$;
11
12
  get tick$(): Observable<[number, number]>;
12
13
  get elapsedTime(): number;
13
- createChildClock(autoStart: boolean): Clock;
14
+ createChildClock(autoStart: boolean): PausableClock;
14
15
  private constructor();
15
16
  }
@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.GgGlobalClock = void 0;
4
4
  const rxjs_1 = require("rxjs");
5
5
  const operators_1 = require("rxjs/operators");
6
- const clock_1 = require("./clock");
6
+ const pausable_clock_1 = require("./pausable-clock");
7
7
  /**
8
8
  * A singleton class, providing ability to track time, fire ticks, provide time elapsed + tick delta.
9
9
  * Starts as soon as accessed and counts time from 01/01/1970
@@ -30,7 +30,7 @@ class GgGlobalClock {
30
30
  return (typeof performance === 'undefined' ? Date : performance).now();
31
31
  }
32
32
  createChildClock(autoStart) {
33
- return new clock_1.Clock(autoStart, this);
33
+ return new pausable_clock_1.PausableClock(autoStart, this);
34
34
  }
35
35
  }
36
36
  exports.GgGlobalClock = GgGlobalClock;
@@ -0,0 +1,7 @@
1
+ import { Observable } from 'rxjs';
2
+ import { PausableClock } from './pausable-clock';
3
+ export interface IClock {
4
+ get tick$(): Observable<[number, number]>;
5
+ get elapsedTime(): number;
6
+ createChildClock(autoStart: boolean): PausableClock;
7
+ }
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,25 @@
1
+ import { Observable } from 'rxjs';
2
+ import { IClock } from './i-clock';
3
+ /**
4
+ * A class, providing ability to track time, fire ticks, provide time elapsed + tick delta with ability to suspend/resume it.
5
+ */
6
+ export declare class PausableClock implements IClock {
7
+ protected readonly parentClock: IClock;
8
+ private tickSub;
9
+ private readonly _tick$;
10
+ get tick$(): Observable<[number, number]>;
11
+ get isRunning(): boolean;
12
+ get isPaused(): boolean;
13
+ get elapsedTime(): number;
14
+ private startedAt;
15
+ private oldRelativeTime;
16
+ private pausedAt;
17
+ constructor(autoStart?: boolean, parentClock?: IClock);
18
+ createChildClock(autoStart: boolean): PausableClock;
19
+ start(): void;
20
+ stop(): void;
21
+ pause(): void;
22
+ resume(): void;
23
+ protected startListeningTicks(): void;
24
+ protected stopListeningTicks(): void;
25
+ }
@@ -0,0 +1,79 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.PausableClock = void 0;
4
+ const rxjs_1 = require("rxjs");
5
+ const operators_1 = require("rxjs/operators");
6
+ const global_clock_1 = require("./global-clock");
7
+ /**
8
+ * A class, providing ability to track time, fire ticks, provide time elapsed + tick delta with ability to suspend/resume it.
9
+ */
10
+ class PausableClock {
11
+ constructor(autoStart = false, parentClock = global_clock_1.GgGlobalClock.instance) {
12
+ this.parentClock = parentClock;
13
+ this.tickSub = null;
14
+ this._tick$ = new rxjs_1.Subject();
15
+ // state
16
+ this.startedAt = -1;
17
+ this.oldRelativeTime = 0; // "elapsed", emitted on last tick
18
+ this.pausedAt = -1;
19
+ if (autoStart) {
20
+ this.start();
21
+ }
22
+ }
23
+ get tick$() {
24
+ return this._tick$.pipe((0, operators_1.map)(([oldTime, newTime]) => [newTime, newTime - oldTime]));
25
+ }
26
+ get isRunning() {
27
+ return !!this.tickSub;
28
+ }
29
+ get isPaused() {
30
+ return this.pausedAt !== -1;
31
+ }
32
+ get elapsedTime() {
33
+ if (this.isPaused) {
34
+ return this.pausedAt - this.startedAt;
35
+ }
36
+ return this.parentClock.elapsedTime - this.startedAt;
37
+ }
38
+ createChildClock(autoStart) {
39
+ return new PausableClock(autoStart, this);
40
+ }
41
+ start() {
42
+ if (this.isRunning) {
43
+ return;
44
+ }
45
+ this.oldRelativeTime = 0;
46
+ this.startedAt = this.parentClock.elapsedTime;
47
+ this.startListeningTicks();
48
+ }
49
+ stop() {
50
+ this.stopListeningTicks();
51
+ this.startedAt = this.pausedAt = -1;
52
+ }
53
+ pause() {
54
+ this.stopListeningTicks();
55
+ this.pausedAt = this.parentClock.elapsedTime;
56
+ }
57
+ resume() {
58
+ if (this.isRunning || this.pausedAt == -1) {
59
+ return;
60
+ }
61
+ this.startedAt += this.parentClock.elapsedTime - this.pausedAt;
62
+ this.pausedAt = -1;
63
+ this.startListeningTicks();
64
+ }
65
+ startListeningTicks() {
66
+ if (this.tickSub) {
67
+ throw new Error('Clock is already ticking!');
68
+ }
69
+ this.tickSub = this.parentClock.tick$
70
+ .pipe((0, operators_1.map)(([parentElapsed, _]) => [this.oldRelativeTime, parentElapsed - this.startedAt]), (0, operators_1.tap)(([_, cur]) => (this.oldRelativeTime = cur)))
71
+ .subscribe(this._tick$);
72
+ }
73
+ stopListeningTicks() {
74
+ var _a;
75
+ (_a = this.tickSub) === null || _a === void 0 ? void 0 : _a.unsubscribe();
76
+ this.tickSub = null;
77
+ }
78
+ }
79
+ exports.PausableClock = PausableClock;
@@ -1,6 +1,4 @@
1
- import { ITickListener } from './interfaces/i-tick-listener';
2
- import { Subject, Subscription } from 'rxjs';
3
- import { GgEntity } from './gg-entity';
1
+ import { GgEntity, GGTickOrder } from './gg-entity';
4
2
  import { Point2 } from '../models/points';
5
3
  export declare type RendererOptions = {
6
4
  transparent: boolean;
@@ -9,20 +7,10 @@ export declare type RendererOptions = {
9
7
  forceResolution?: number;
10
8
  antialias: boolean;
11
9
  };
12
- export declare abstract class BaseGgRenderer extends GgEntity implements ITickListener {
13
- protected _permanentRenderMethods: Map<number, Function>;
14
- protected _singularRenderMethods: Map<number, Function>;
15
- private initialized;
16
- readonly tick$: Subject<[number, number]>;
17
- readonly tickOrder = 1000;
18
- protected tickListener: Subscription | null;
10
+ export declare abstract class BaseGgRenderer extends GgEntity {
11
+ readonly tickOrder = GGTickOrder.RENDERING;
19
12
  readonly rendererOptions: RendererOptions;
20
13
  protected constructor(canvas?: HTMLCanvasElement, options?: Partial<RendererOptions>);
21
- get isActive(): boolean;
22
- activate(): void;
23
- deactivate(): void;
24
- init(): void;
25
14
  abstract render(): void;
26
15
  abstract resize(newSize: Point2): void;
27
- abstract dispose(): void;
28
16
  }
@@ -1,49 +1,21 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.BaseGgRenderer = void 0;
4
- const rxjs_1 = require("rxjs");
5
4
  const gg_entity_1 = require("./gg-entity");
6
5
  const gg_viewport_manager_1 = require("../gg-viewport-manager");
7
6
  class BaseGgRenderer extends gg_entity_1.GgEntity {
8
7
  constructor(canvas, options = {}) {
9
8
  super();
10
- this.initialized = false;
11
- this.tickOrder = 1000;
12
- this.tickListener = null;
9
+ this.tickOrder = gg_entity_1.GGTickOrder.RENDERING;
13
10
  this.rendererOptions = Object.assign({ transparent: false, background: 0x000000, antialias: true }, (options || {}));
14
- this._permanentRenderMethods = new Map();
15
- this._singularRenderMethods = new Map();
16
- this.tick$ = new rxjs_1.Subject();
17
11
  if (canvas) {
18
12
  setTimeout(() => {
19
13
  gg_viewport_manager_1.GgViewportManager.instance.assignRendererToCanvas(this, canvas).then();
20
14
  }, 0);
21
15
  }
22
- }
23
- get isActive() {
24
- return !!this.tickListener;
25
- }
26
- activate() {
27
- if (this.isActive) {
28
- return;
29
- }
30
- if (!this.initialized) {
31
- this.init();
32
- }
33
- this.tickListener = this.tick$.subscribe(() => {
16
+ this.tick$.subscribe(() => {
34
17
  this.render();
35
18
  });
36
19
  }
37
- deactivate() {
38
- var _a;
39
- if (!this.isActive) {
40
- return;
41
- }
42
- (_a = this.tickListener) === null || _a === void 0 ? void 0 : _a.unsubscribe();
43
- this.tickListener = null;
44
- }
45
- init() {
46
- this.initialized = true;
47
- }
48
20
  }
49
21
  exports.BaseGgRenderer = BaseGgRenderer;
@@ -1,5 +1,4 @@
1
1
  import { GgEntity } from '../gg-entity';
2
- import { ITickListener } from '../interfaces/i-tick-listener';
3
2
  import { Observable, Subject } from 'rxjs';
4
3
  import { GgWorld } from '../../gg-world';
5
4
  export declare type AnimationFunction<T> = (elapsed: number, delta: number) => T;
@@ -9,19 +8,14 @@ export declare type AnimationFunction<T> = (elapsed: number, delta: number) => T
9
8
  * The current value of the animation can be subscribed to using the `subscribeToValue` property.
10
9
  * The animation function can be changed with `transitAnimationFunction` or `transitFromStaticState`.
11
10
  */
12
- export declare class AnimationMixer<T> extends GgEntity implements ITickListener {
11
+ export declare class AnimationMixer<T> extends GgEntity {
13
12
  protected _animationFunction: AnimationFunction<T>;
14
13
  protected _lerp: (a: T, b: T, t: number) => T;
15
- readonly tick$: Subject<[number, number]>;
16
14
  readonly tickOrder: number;
17
15
  /**
18
16
  * A subject that emits the current value of the animation on every tick.
19
17
  */
20
18
  protected readonly _value$: Subject<T>;
21
- /**
22
- * A subject that emits when the animator has been removed from the world.
23
- */
24
- protected readonly removed$: Subject<void>;
25
19
  /**
26
20
  * The current transition time reference `[elapsed, delta]` that interpolates between the old and new functions.
27
21
  */
@@ -78,6 +72,5 @@ export declare class AnimationMixer<T> extends GgEntity implements ITickListener
78
72
  */
79
73
  transitAnimationFunction(newFunc: AnimationFunction<T>, transitionDuration: number, easing?: (t: number) => number): void;
80
74
  onSpawned(world: GgWorld<any, any>): void;
81
- onRemoved(): void;
82
75
  dispose(): void;
83
76
  }
@@ -20,16 +20,11 @@ class AnimationMixer extends gg_entity_1.GgEntity {
20
20
  super();
21
21
  this._animationFunction = _animationFunction;
22
22
  this._lerp = _lerp;
23
- this.tick$ = new rxjs_1.Subject();
24
- this.tickOrder = 850;
23
+ this.tickOrder = gg_entity_1.GGTickOrder.ANIMATION_MIXERS;
25
24
  /**
26
25
  * A subject that emits the current value of the animation on every tick.
27
26
  */
28
27
  this._value$ = new rxjs_1.Subject();
29
- /**
30
- * A subject that emits when the animator has been removed from the world.
31
- */
32
- this.removed$ = new rxjs_1.Subject();
33
28
  /**
34
29
  * The current transition time reference `[elapsed, delta]` that interpolates between the old and new functions.
35
30
  */
@@ -136,13 +131,9 @@ class AnimationMixer extends gg_entity_1.GgEntity {
136
131
  onSpawned(world) {
137
132
  super.onSpawned(world);
138
133
  this.tick$
139
- .pipe((0, rxjs_1.takeUntil)(this.removed$), (0, operators_1.tap)(([elapsed, delta]) => this.currentTransition && this.currentTransition([elapsed, delta])), (0, operators_1.map)(([elapsed, delta]) => this._animationFunction(elapsed, delta)))
134
+ .pipe((0, rxjs_1.takeUntil)(this._onRemoved$), (0, operators_1.tap)(([elapsed, delta]) => this.currentTransition && this.currentTransition([elapsed, delta])), (0, operators_1.map)(([elapsed, delta]) => this._animationFunction(elapsed, delta)))
140
135
  .subscribe(value => this._value$.next(value));
141
136
  }
142
- onRemoved() {
143
- super.onRemoved();
144
- this.removed$.next();
145
- }
146
137
  dispose() {
147
138
  super.dispose();
148
139
  this.tick$.complete();
@@ -1,11 +1,40 @@
1
1
  import { GgWorld } from '../gg-world';
2
2
  import { Subject } from 'rxjs';
3
+ /**
4
+ * Engine's default tick orders: the less value, the earlier tick will be run.
5
+ */
6
+ export declare enum GGTickOrder {
7
+ INPUT_CONTROLLERS = 0,
8
+ PHYSICS_SIMULATION = 200,
9
+ OBJECTS_BINDING = 400,
10
+ ANIMATION_MIXERS = 600,
11
+ CONTROLLERS = 800,
12
+ RENDERING = 1000,
13
+ POST_RENDERING = 1200
14
+ }
3
15
  export declare abstract class GgEntity {
16
+ /**
17
+ * will receive [elapsed time, delta] of each world clock tick
18
+ */
19
+ readonly tick$: Subject<[number, number]>;
20
+ /**
21
+ * the priority of ticker: the less value, the earlier tick will be run.
22
+ */
23
+ abstract readonly tickOrder: GGTickOrder | number;
24
+ /**
25
+ * a world reference, where this entity was added to
26
+ */
4
27
  protected _world: GgWorld<any, any> | null;
5
28
  get world(): GgWorld<any, any> | null;
6
29
  protected _name: string;
7
30
  get name(): string;
8
31
  set name(value: string);
32
+ /**
33
+ * The flag whether entity should listen to ticks. If set to false, ticks will not be propagated to this entity
34
+ * */
35
+ protected _active: boolean;
36
+ get active(): boolean;
37
+ set active(value: boolean);
9
38
  protected _children: GgEntity[];
10
39
  addChildren(...entities: GgEntity[]): void;
11
40
  removeChildren(entities: GgEntity[], dispose?: boolean): void;
@@ -1,11 +1,35 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.GgEntity = void 0;
3
+ exports.GgEntity = exports.GGTickOrder = void 0;
4
4
  const rxjs_1 = require("rxjs");
5
+ /**
6
+ * Engine's default tick orders: the less value, the earlier tick will be run.
7
+ */
8
+ var GGTickOrder;
9
+ (function (GGTickOrder) {
10
+ GGTickOrder[GGTickOrder["INPUT_CONTROLLERS"] = 0] = "INPUT_CONTROLLERS";
11
+ GGTickOrder[GGTickOrder["PHYSICS_SIMULATION"] = 200] = "PHYSICS_SIMULATION";
12
+ GGTickOrder[GGTickOrder["OBJECTS_BINDING"] = 400] = "OBJECTS_BINDING";
13
+ GGTickOrder[GGTickOrder["ANIMATION_MIXERS"] = 600] = "ANIMATION_MIXERS";
14
+ GGTickOrder[GGTickOrder["CONTROLLERS"] = 800] = "CONTROLLERS";
15
+ GGTickOrder[GGTickOrder["RENDERING"] = 1000] = "RENDERING";
16
+ GGTickOrder[GGTickOrder["POST_RENDERING"] = 1200] = "POST_RENDERING";
17
+ })(GGTickOrder = exports.GGTickOrder || (exports.GGTickOrder = {}));
5
18
  class GgEntity {
6
19
  constructor() {
20
+ /**
21
+ * will receive [elapsed time, delta] of each world clock tick
22
+ */
23
+ this.tick$ = new rxjs_1.Subject();
24
+ /**
25
+ * a world reference, where this entity was added to
26
+ */
7
27
  this._world = null;
8
28
  this._name = '';
29
+ /**
30
+ * The flag whether entity should listen to ticks. If set to false, ticks will not be propagated to this entity
31
+ * */
32
+ this._active = true;
9
33
  this._children = [];
10
34
  this._onSpawned$ = new rxjs_1.Subject();
11
35
  this._onRemoved$ = new rxjs_1.Subject();
@@ -19,6 +43,12 @@ class GgEntity {
19
43
  set name(value) {
20
44
  this._name = value;
21
45
  }
46
+ get active() {
47
+ return this._active;
48
+ }
49
+ set active(value) {
50
+ this._active = value;
51
+ }
22
52
  addChildren(...entities) {
23
53
  this._children.push(...entities);
24
54
  if (this._world) {
@@ -52,8 +82,12 @@ class GgEntity {
52
82
  }
53
83
  // TODO add some flag to entity that it is disposed, and throw a normal error when trying to add such entity to world again
54
84
  dispose() {
85
+ if (this.world) {
86
+ this.world.removeEntity(this);
87
+ }
55
88
  this._onSpawned$.complete();
56
89
  this._onRemoved$.complete();
90
+ this.tick$.complete();
57
91
  for (const c of this._children) {
58
92
  c.dispose();
59
93
  }
@@ -7,14 +7,9 @@ class InlineTickController extends gg_entity_1.GgEntity {
7
7
  constructor(tickOrder) {
8
8
  super();
9
9
  this.tickOrder = tickOrder;
10
- this.tick$ = new rxjs_1.Subject();
11
- }
12
- dispose() {
13
- super.dispose();
14
- this.tick$.complete();
15
10
  }
16
11
  }
17
- function createInlineTickController(world, tickOrder = 750) {
12
+ function createInlineTickController(world, tickOrder = gg_entity_1.GGTickOrder.CONTROLLERS) {
18
13
  const controller = new InlineTickController(tickOrder);
19
14
  world.addEntity(controller);
20
15
  return controller.tick$.pipe((0, rxjs_1.finalize)(() => {
@@ -1,7 +1,31 @@
1
1
  import { Subject } from 'rxjs';
2
2
  import { GgEntity } from '../gg-entity';
3
+ /**
4
+ * Engine's default tick orders: the less value, the earlier tick will be run.
5
+ */
6
+ export declare enum GGTickOrder {
7
+ INPUT_CONTROLLERS = 0,
8
+ PHYSICS_SIMULATION = 200,
9
+ OBJECTS_BINDING = 400,
10
+ ANIMATION_MIXERS = 600,
11
+ CONTROLLERS = 800,
12
+ RENDERING = 1000,
13
+ POST_RENDERING = 1200
14
+ }
15
+ /**
16
+ * An interface for world entities, which need to do some routine on each world clock tick
17
+ */
3
18
  export interface ITickListener {
19
+ /**
20
+ * will receive [elapsed time, delta] of each world clock tick
21
+ */
4
22
  tick$: Subject<[number, number]>;
5
- readonly tickOrder: number;
23
+ /**
24
+ * the priority of ticker: the less value, the earlier tick will be run.
25
+ */
26
+ readonly tickOrder: GGTickOrder | number;
6
27
  }
28
+ /**
29
+ * A function which determines whether entity implements ITickListener interface
30
+ */
7
31
  export declare const isITickListener: (entity: GgEntity) => boolean;
@@ -1,6 +1,22 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.isITickListener = void 0;
3
+ exports.isITickListener = exports.GGTickOrder = void 0;
4
4
  const rxjs_1 = require("rxjs");
5
+ /**
6
+ * Engine's default tick orders: the less value, the earlier tick will be run.
7
+ */
8
+ var GGTickOrder;
9
+ (function (GGTickOrder) {
10
+ GGTickOrder[GGTickOrder["INPUT_CONTROLLERS"] = 0] = "INPUT_CONTROLLERS";
11
+ GGTickOrder[GGTickOrder["PHYSICS_SIMULATION"] = 200] = "PHYSICS_SIMULATION";
12
+ GGTickOrder[GGTickOrder["OBJECTS_BINDING"] = 400] = "OBJECTS_BINDING";
13
+ GGTickOrder[GGTickOrder["ANIMATION_MIXERS"] = 600] = "ANIMATION_MIXERS";
14
+ GGTickOrder[GGTickOrder["CONTROLLERS"] = 800] = "CONTROLLERS";
15
+ GGTickOrder[GGTickOrder["RENDERING"] = 1000] = "RENDERING";
16
+ GGTickOrder[GGTickOrder["POST_RENDERING"] = 1200] = "POST_RENDERING";
17
+ })(GGTickOrder = exports.GGTickOrder || (exports.GGTickOrder = {}));
18
+ /**
19
+ * A function which determines whether entity implements ITickListener interface
20
+ */
5
21
  const isITickListener = entity => (entity === null || entity === void 0 ? void 0 : entity.tick$) instanceof rxjs_1.Subject;
6
22
  exports.isITickListener = isITickListener;
@@ -1,23 +1,26 @@
1
+ import { PausableClock } from './clock/pausable-clock';
1
2
  import { GgEntity } from './entities/gg-entity';
2
- import { ITickListener } from './entities/interfaces/i-tick-listener';
3
3
  import { GgPhysicsWorld } from './interfaces/gg-physics-world';
4
4
  import { GgVisualScene } from './interfaces/gg-visual-scene';
5
- import { KeyboardController } from './controllers/keyboard.controller';
5
+ import { KeyboardInput } from './inputs/keyboard.input';
6
6
  import { GgPositionableEntity } from './entities/gg-positionable-entity';
7
7
  export declare abstract class GgWorld<D, R, V extends GgVisualScene<D, R> = GgVisualScene<D, R>, P extends GgPhysicsWorld<D, R> = GgPhysicsWorld<D, R>> {
8
8
  readonly visualScene: V;
9
9
  readonly physicsWorld: P;
10
10
  protected readonly consoleEnabled: boolean;
11
- private readonly worldClock;
12
- readonly keyboardController: KeyboardController;
13
- get worldTime(): number;
11
+ readonly worldClock: PausableClock;
12
+ readonly keyboardInput: KeyboardInput;
14
13
  readonly children: GgEntity[];
15
- protected readonly tickListeners: ITickListener[];
14
+ protected readonly tickListeners: GgEntity[];
16
15
  constructor(visualScene: V, physicsWorld: P, consoleEnabled?: boolean);
17
16
  init(): Promise<void>;
18
17
  start(): void;
19
18
  pauseWorld(): void;
20
19
  resumeWorld(): void;
20
+ get isRunning(): boolean;
21
+ get isPaused(): boolean;
22
+ get worldTime(): number;
23
+ createClock(autoStart: boolean): PausableClock;
21
24
  dispose(): void;
22
25
  abstract addPrimitiveRigidBody(descr: any, position?: D, rotation?: R): GgPositionableEntity<D, R>;
23
26
  addEntity(entity: GgEntity): void;