@babylonjs/core 7.27.1 → 7.27.2

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@babylonjs/core",
-    "version": "7.27.1",
+    "version": "7.27.2",
     "main": "index.js",
     "module": "index.js",
     "types": "index.d.ts",

package/scene.d.ts

@@ -2016,6 +2016,10 @@ export declare class Scene implements IAnimatable, IClipPlanesHolder, IAssetCont
      * @param passId If provided, releases only the draw wrapper corresponding to this render pass id
      */
     resetDrawCache(passId?: number): void;
+    /**
+     * If this function is defined it will take precedence over the standard render() function.
+     */
+    customRenderFunction?: () => void;
     /**
      * Render the scene
      * @param updateCameras defines a boolean indicating if cameras must update according to their inputs (true by default)

package/scene.js

@@ -3825,59 +3825,67 @@ export class Scene {
         }
         // Before render
         this.onBeforeRenderObservable.notifyObservers(this);
-        const engine = this.getEngine();
-        // Customs render targets
-        this.onBeforeRenderTargetsRenderObservable.notifyObservers(this);
-        const currentActiveCamera = this.activeCameras?.length ? this.activeCameras[0] : this.activeCamera;
-        if (this.renderTargetsEnabled) {
-            Tools.StartPerformanceCounter("Custom render targets", this.customRenderTargets.length > 0);
-            this._intermediateRendering = true;
-            for (let customIndex = 0; customIndex < this.customRenderTargets.length; customIndex++) {
-                const renderTarget = this.customRenderTargets[customIndex];
-                if (renderTarget._shouldRender()) {
-                    this._renderId++;
-                    this.activeCamera = renderTarget.activeCamera || this.activeCamera;
-                    if (!this.activeCamera) {
-                        throw new Error("Active camera not set");
+        // Custom render function?
+        if (this.customRenderFunction) {
+            this._renderId++;
+            this._engine.currentRenderPassId = 0;
+            this.customRenderFunction();
+        }
+        else {
+            const engine = this.getEngine();
+            // Customs render targets
+            this.onBeforeRenderTargetsRenderObservable.notifyObservers(this);
+            const currentActiveCamera = this.activeCameras?.length ? this.activeCameras[0] : this.activeCamera;
+            if (this.renderTargetsEnabled) {
+                Tools.StartPerformanceCounter("Custom render targets", this.customRenderTargets.length > 0);
+                this._intermediateRendering = true;
+                for (let customIndex = 0; customIndex < this.customRenderTargets.length; customIndex++) {
+                    const renderTarget = this.customRenderTargets[customIndex];
+                    if (renderTarget._shouldRender()) {
+                        this._renderId++;
+                        this.activeCamera = renderTarget.activeCamera || this.activeCamera;
+                        if (!this.activeCamera) {
+                            throw new Error("Active camera not set");
+                        }
+                        // Viewport
+                        engine.setViewport(this.activeCamera.viewport);
+                        // Camera
+                        this.updateTransformMatrix();
+                        renderTarget.render(currentActiveCamera !== this.activeCamera, this.dumpNextRenderTargets);
                     }
-                    // Viewport
-                    engine.setViewport(this.activeCamera.viewport);
-                    // Camera
-                    this.updateTransformMatrix();
-                    renderTarget.render(currentActiveCamera !== this.activeCamera, this.dumpNextRenderTargets);
                 }
+                Tools.EndPerformanceCounter("Custom render targets", this.customRenderTargets.length > 0);
+                this._intermediateRendering = false;
+                this._renderId++;
             }
-            Tools.EndPerformanceCounter("Custom render targets", this.customRenderTargets.length > 0);
-            this._intermediateRendering = false;
-            this._renderId++;
-        }
-        this._engine.currentRenderPassId = currentActiveCamera?.renderPassId ?? 0;
-        // Restore back buffer
-        this.activeCamera = currentActiveCamera;
-        if (this._activeCamera && this._activeCamera.cameraRigMode !== 22 && !this.prePass) {
-            this._bindFrameBuffer(this._activeCamera, false);
-        }
-        this.onAfterRenderTargetsRenderObservable.notifyObservers(this);
-        for (const step of this._beforeClearStage) {
-            step.action();
-        }
-        // Clear
-        this._clearFrameBuffer(this.activeCamera);
-        // Collects render targets from external components.
-        for (const step of this._gatherRenderTargetsStage) {
-            step.action(this._renderTargets);
-        }
-        // Multi-cameras?
-        if (this.activeCameras && this.activeCameras.length > 0) {
-            for (let cameraIndex = 0; cameraIndex < this.activeCameras.length; cameraIndex++) {
-                this._processSubCameras(this.activeCameras[cameraIndex], cameraIndex > 0);
+            this._engine.currentRenderPassId = currentActiveCamera?.renderPassId ?? 0;
+            // Restore back buffer
+            this.activeCamera = currentActiveCamera;
+            if (this._activeCamera && this._activeCamera.cameraRigMode !== 22 && !this.prePass) {
+                this._bindFrameBuffer(this._activeCamera, false);
             }
-        }
-        else {
-            if (!this.activeCamera) {
-                throw new Error("No camera defined");
+            this.onAfterRenderTargetsRenderObservable.notifyObservers(this);
+            for (const step of this._beforeClearStage) {
+                step.action();
+            }
+            // Clear
+            this._clearFrameBuffer(this.activeCamera);
+            // Collects render targets from external components.
+            for (const step of this._gatherRenderTargetsStage) {
+                step.action(this._renderTargets);
+            }
+            // Multi-cameras?
+            if (this.activeCameras && this.activeCameras.length > 0) {
+                for (let cameraIndex = 0; cameraIndex < this.activeCameras.length; cameraIndex++) {
+                    this._processSubCameras(this.activeCameras[cameraIndex], cameraIndex > 0);
+                }
+            }
+            else {
+                if (!this.activeCamera) {
+                    throw new Error("No camera defined");
+                }
+                this._processSubCameras(this.activeCamera, !!this.activeCamera.outputRenderTarget);
             }
-            this._processSubCameras(this.activeCamera, !!this.activeCamera.outputRenderTarget);
         }
         // Intersection checks
         this._checkIntersections();