feat(core): implement manual mode in renderer

Author: agviegas

packages/core/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@thatopen/components",
   "description": "Collection of core functionalities to author BIM apps.",
-  "version": "3.2.3",
+  "version": "3.2.4",
   "author": "That Open Company",
   "contributors": [
     "Antonio Gonzalez Viegas (https://github.com/agviegas)",

packages/core/src/core/Worlds/src/simple-renderer.ts

@@ -8,6 +8,14 @@ import {
 } from "../../Types";
 import { Components } from "../../Components";
 
+/**
+ * The mode of the renderer. If MANUAL, the renderer will be updated on command. If AUTO, the renderer will render on every update tick.
+ */
+export enum RendererMode {
+  MANUAL,
+  AUTO,
+}
+
 /**
  * A basic renderer capable of rendering [Objec3Ds](https://threejs.org/docs/#api/en/core/Object3D).
  */
@@ -28,6 +36,16 @@ export class SimpleRenderer extends BaseRenderer {
    */
   three: THREE.WebGLRenderer;
 
+  /**
+   * The mode of the renderer. If MANUAL, the renderer will be updated manually. If AUTO, the renderer will render on every update tick.
+   */
+  mode = RendererMode.AUTO;
+
+  /**
+   * Whether the renderer needs to be updated. If true, the renderer will be updated on the next frame.
+   */
+  needsUpdate = false;
+
   protected _canvas: HTMLCanvasElement;
   protected _parameters?: Partial<THREE.WebGLRendererParameters>;
   protected _resizeObserver: ResizeObserver | null = null;
@@ -75,6 +93,12 @@ export class SimpleRenderer extends BaseRenderer {
   /** {@link Updateable.update} */
   update() {
     if (!this.enabled || !this.currentWorld) return;
+
+    if (this.mode === RendererMode.MANUAL && !this.needsUpdate) {
+      return;
+    }
+    this.needsUpdate = false;
+
     this.onBeforeUpdate.trigger(this);
     const scene = this.currentWorld.scene.three;
     const camera = this.currentWorld.camera.three;