@onerjs/core 8.55.8 → 8.56.1

package/XR/webXRWebGPURenderTargetTextureProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"webXRWebGPURenderTargetTextureProvider.js","sourceRoot":"","sources":["../../../../dev/core/src/XR/webXRWebGPURenderTargetTextureProvider.ts"],"names":[],"mappings":"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","sourcesContent":["import { Constants } from \"../Engines/constants\";\nimport { type WebGPUEngine } from \"../Engines/webgpuEngine\";\nimport { type WebGPURenderTargetWrapper } from \"../Engines/WebGPU/webgpuRenderTargetWrapper\";\nimport { type InternalTexture } from \"../Materials/Textures/internalTexture\";\nimport { type RenderTargetTexture } from \"../Materials/Textures/renderTargetTexture.pure\";\nimport { Color4 } from \"../Maths/math.color.pure\";\nimport { type Nullable } from \"../types\";\nimport { WebXRLayerRenderTargetTexture } from \"./webXRLayerRenderTargetTexture\";\nimport { type WebXRLayerWrapper } from \"./webXRLayerWrapper\";\nimport { WebXRLayerRenderTargetTextureProvider } from \"./webXRRenderTargetTextureProvider\";\nimport { type WebXRSessionManager } from \"./webXRSessionManager\";\n\n/**\n * Maps a WebGPU depth/stencil {@link GPUTextureFormat} to the matching Babylon `TEXTUREFORMAT_*` constant.\n *\n * The engine reads `InternalTexture.format` (a Babylon constant) when it builds the render pass depth\n * attachment for a render target, so a depth texture wrapped from an external `GPUTexture` must carry the\n * correct Babylon format or the depth attachment pipeline format will not match the sub-image's texture.\n * @param format the WebGPU depth/stencil format requested when the layer was created\n * @returns the matching Babylon texture format constant\n */\nfunction GetBabylonDepthFormat(format: GPUTextureFormat): number {\n    switch (format) {\n        case \"depth16unorm\":\n            return Constants.TEXTUREFORMAT_DEPTH16;\n        case \"depth24plus\":\n            return Constants.TEXTUREFORMAT_DEPTH24;\n        case \"depth24plus-stencil8\":\n            return Constants.TEXTUREFORMAT_DEPTH24_STENCIL8;\n        case \"depth32float\":\n            return Constants.TEXTUREFORMAT_DEPTH32_FLOAT;\n        case \"depth32float-stencil8\":\n            return Constants.TEXTUREFORMAT_DEPTH32FLOAT_STENCIL8;\n        case \"stencil8\":\n            return Constants.TEXTUREFORMAT_STENCIL8;\n        default:\n            // Fall back to a combined depth/stencil format, which is the projection layer default.\n            return Constants.TEXTUREFORMAT_DEPTH24_STENCIL8;\n    }\n}\n\n/**\n * Provides render target textures for WebGPU-backed XR layers. Owns all WebGPU-specific texture wrapping\n * (via {@link WebGPUEngine.wrapWebGPUTexture} / {@link WebGPUEngine.updateWrappedWebGPUTexture}) so the base\n * provider can stay graphics-API-agnostic. Mirrors {@link WebXRWebGLRenderTargetTextureProvider} for the\n * WebGPU (XRGPUBinding) backend.\n * @internal\n */\nexport abstract class WebXRWebGPURenderTargetTextureProvider extends WebXRLayerRenderTargetTextureProvider {\n    private readonly _transparentClearColor = new Color4(0, 0, 0, 0);\n\n    constructor(\n        protected readonly _xrSessionManager: WebXRSessionManager,\n        layerWrapper: WebXRLayerWrapper\n    ) {\n        super(_xrSessionManager.scene, layerWrapper);\n    }\n\n    private get _webgpuEngine(): WebGPUEngine {\n        return this._engine as WebGPUEngine;\n    }\n\n    private _wrapColorTexture(texture: GPUTexture): InternalTexture {\n        return this._webgpuEngine.wrapWebGPUTexture(texture);\n    }\n\n    private _wrapDepthTexture(texture: GPUTexture, depthStencilFormat: GPUTextureFormat): InternalTexture {\n        const internalTexture = this._webgpuEngine.wrapWebGPUTexture(texture);\n        // The engine derives the color attachment format automatically from the wrapped hardware texture,\n        // but the depth attachment format is read from the Babylon InternalTexture.format, which\n        // wrapWebGPUTexture does not set. Assign it here from the format the layer was created with.\n        internalTexture.format = GetBabylonDepthFormat(depthStencilFormat);\n        return internalTexture;\n    }\n\n    /**\n     * Builds the render target shell as a {@link WebXRLayerRenderTargetTexture} for the single-view path so\n     * each eye can bind its own array layer of a layered projection-layer texture. Multiview is not yet\n     * supported on this WebGPU path and is delegated to the base implementation.\n     * @param width the width of the render target\n     * @param height the height of the render target\n     * @param multiview whether the render target should be a multiview render target\n     * @returns the created (but not yet registered) render target texture\n     */\n    protected override _createRenderTargetTextureShell(width: number, height: number, multiview: boolean): RenderTargetTexture {\n        if (multiview) {\n            return super._createRenderTargetTextureShell(width, height, multiview);\n        }\n        const renderTargetTexture = new WebXRLayerRenderTargetTexture(\"XR renderTargetTexture\", { width, height }, this._scene);\n        renderTargetTexture.renderTarget!._samples = renderTargetTexture.samples;\n        // The projection-layer texture is presented directly by the XR compositor (top-left origin, never\n        // re-sampled by Babylon), so opt this target out of the engine's render-target Y-flip / winding\n        // compensation and render it upright, matching the WebXR/WebGPU spec's plain render pass.\n        (renderTargetTexture.renderTarget as WebGPURenderTargetWrapper)._disableEngineYFlip = true;\n        return renderTargetTexture;\n    }\n\n    /**\n     * Wraps the sub-image's color (and optional depth/stencil) GPUTextures and builds a new render target\n     * texture around them. Use this on first creation and whenever the sub-image texture size changes.\n     * @param width the width of the render target\n     * @param height the height of the render target\n     * @param colorTexture the sub-image color GPUTexture\n     * @param depthStencilTexture the sub-image depth/stencil GPUTexture, if any\n     * @param depthStencilFormat the WebGPU depth/stencil format the layer was created with, if depth is provided\n     * @param multiview whether the render target should be a multiview render target\n     * @returns the created render target texture\n     */\n    protected _createRenderTargetTextureFromGPUTextures(\n        width: number,\n        height: number,\n        colorTexture: GPUTexture,\n        depthStencilTexture: Nullable<GPUTexture>,\n        depthStencilFormat: GPUTextureFormat | undefined,\n        multiview: boolean\n    ): WebXRLayerRenderTargetTexture {\n        const color = this._wrapColorTexture(colorTexture);\n        const depth = depthStencilTexture && depthStencilFormat ? this._wrapDepthTexture(depthStencilTexture, depthStencilFormat) : null;\n        // Single-view (the only path here) always builds a WebXRLayerRenderTargetTexture via the shell override above.\n        const renderTargetTexture = this._createRenderTargetTextureInternal(width, height, color, depth, multiview) as WebXRLayerRenderTargetTexture;\n        this._attachPerEyeClearObserver(renderTargetTexture);\n        return renderTargetTexture;\n    }\n\n    /**\n     * Ensures this render target is cleared every frame, including for the right eye.\n     *\n     * `Scene._clearFrameBuffer` skips clearing the right rig camera's framebuffer (`!camera.isRightCamera`).\n     * That is a valid optimization for WebGL2 stereo, where both eyes render into a single side-by-side\n     * texture and the left eye's full clear already covers the whole texture. WebGPU projection layers give\n     * each eye its OWN render target (a distinct array layer rendered in a separate render pass), so the\n     * right eye's color and — critically — depth would never be cleared, leaving its depth test to reject\n     * every fragment (a black right eye). The scene notifies `onClearObservable` regardless of\n     * `camera.isRightCamera`, so this observer clears both eyes' targets. WebGL providers never attach it,\n     * so the WebGL path is unchanged.\n     *\n     * Color is cleared at most once per ENGINE FRAME, not once per `Scene.render`. The distinction matters:\n     * more than one scene can render the same XR camera within a single XR frame. `UtilityLayerRenderer`\n     * (used by controller pointer selection and near interaction) renders a second scene through the same\n     * rig cameras, and every `Scene.render` resets `RenderTargetTexture._cleared` for those cameras' targets\n     * (`Scene._checkCameraRenderTarget`), so a `_cleared`-based guard is defeated and each eye is re-cleared\n     * after it was drawn — presenting a clear-colored frame with the geometry gone. `AbstractEngine.frameId`\n     * only advances in `endFrame`, once per XR frame, so unlike `_cleared` it cannot be reset by another\n     * scene rendering the same camera.\n     *\n     * In immersive AR, color is cleared to transparent when `WebXRExperienceHelper` disables\n     * `Scene.autoClear`. WebGL XR framebuffers are cleared to transparent by the user agent, but WebGPU render\n     * passes require the application to request that clear explicitly. Skipping it leaves pixels from prior\n     * frames in passthrough regions, producing trails behind moving objects.\n     *\n     * Depth and stencil are still cleared on every notification, matching the previous behavior and the\n     * expectations of overlay scenes that draw on top of the main scene.\n     * @param renderTargetTexture the per-eye render target to clear each frame\n     */\n    private _attachPerEyeClearObserver(renderTargetTexture: RenderTargetTexture): void {\n        let lastColorClearedFrameId = -1;\n        renderTargetTexture.onClearObservable.add((engine) => {\n            // Honor skipInitialClear so this observer preserves the default clear semantics it replaces.\n            if (renderTargetTexture.skipInitialClear) {\n                return;\n            }\n            const scene = renderTargetTexture.getScene();\n            const isImmersiveAR = this._xrSessionManager.sessionMode === \"immersive-ar\";\n            // When autoClear is disabled the scene does not clear render targets; match that so this observer\n            // does not force a clear the user opted out of. Immersive AR is the exception: the experience\n            // helper disables autoClear because WebGL XR is cleared by the user agent, while WebGPU is not.\n            if (scene && !scene.autoClear && !isImmersiveAR) {\n                return;\n            }\n            const clearColor = engine.frameId !== lastColorClearedFrameId;\n            const color = isImmersiveAR && scene && !scene.autoClear ? this._transparentClearColor : (renderTargetTexture.clearColor ?? scene?.clearColor ?? null);\n            engine.clear(color, clearColor, true, true);\n            if (clearColor) {\n                lastColorClearedFrameId = engine.frameId;\n            }\n            // Kept in sync so anything else reading the flag still sees this target as cleared this frame.\n            renderTargetTexture._cleared = true;\n        });\n    }\n\n    /**\n     * Repoints the wrapped color/depth textures of an existing render target at the current frame's\n     * GPUTextures, preserving the RenderTargetTexture / InternalTexture identity held by the XR camera's\n     * `outputRenderTarget`. The sub-image textures are only valid for the current frame and may rotate from\n     * a compositor pool, so this must run every frame. The new GPUTextures must have the same dimensions as\n     * the wrapped ones (guaranteed by the caller's size-change branch, which rebuilds instead).\n     * @param renderTargetTexture the render target whose wrapped textures should be repointed\n     * @param colorTexture the current frame's color GPUTexture\n     * @param depthStencilTexture the current frame's depth/stencil GPUTexture, if any\n     */\n    protected _updateRenderTargetTextureFromGPUTextures(renderTargetTexture: RenderTargetTexture, colorTexture: GPUTexture, depthStencilTexture: Nullable<GPUTexture>): void {\n        const color = renderTargetTexture._texture;\n        if (color) {\n            this._webgpuEngine.updateWrappedWebGPUTexture(color, colorTexture);\n        }\n        const depth = renderTargetTexture.renderTarget?._depthStencilTexture;\n        if (depth && depthStencilTexture) {\n            this._webgpuEngine.updateWrappedWebGPUTexture(depth, depthStencilTexture);\n        }\n    }\n}\n"]}
+{"version":3,"file":"webXRWebGPURenderTargetTextureProvider.js","sourceRoot":"","sources":["../../../../dev/core/src/XR/webXRWebGPURenderTargetTextureProvider.ts"],"names":[],"mappings":"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","sourcesContent":["import { Constants } from \"../Engines/constants\";\nimport { type WebGPUEngine } from \"../Engines/webgpuEngine\";\nimport { type WebGPURenderTargetWrapper } from \"../Engines/WebGPU/webgpuRenderTargetWrapper\";\nimport { type InternalTexture } from \"../Materials/Textures/internalTexture\";\nimport { type RenderTargetTexture } from \"../Materials/Textures/renderTargetTexture.pure\";\nimport { Color4 } from \"../Maths/math.color.pure\";\nimport { type Nullable } from \"../types\";\nimport { WebXRLayerRenderTargetTexture } from \"./webXRLayerRenderTargetTexture\";\nimport { type WebXRLayerType, type WebXRLayerWrapper, type WebXRSupportedLayerType } from \"./webXRLayerWrapper\";\nimport { WebXRLayerRenderTargetTextureProvider } from \"./webXRRenderTargetTextureProvider\";\nimport { type WebXRSessionManager } from \"./webXRSessionManager\";\n\n/**\n * Maps a WebGPU depth/stencil {@link GPUTextureFormat} to the matching Babylon `TEXTUREFORMAT_*` constant.\n *\n * The engine reads `InternalTexture.format` (a Babylon constant) when it builds the render pass depth\n * attachment for a render target, so a depth texture wrapped from an external `GPUTexture` must carry the\n * correct Babylon format or the depth attachment pipeline format will not match the sub-image's texture.\n * @param format the WebGPU depth/stencil format requested when the layer was created\n * @returns the matching Babylon texture format constant\n */\nfunction GetBabylonDepthFormat(format: GPUTextureFormat): number {\n    switch (format) {\n        case \"depth16unorm\":\n            return Constants.TEXTUREFORMAT_DEPTH16;\n        case \"depth24plus\":\n            return Constants.TEXTUREFORMAT_DEPTH24;\n        case \"depth24plus-stencil8\":\n            return Constants.TEXTUREFORMAT_DEPTH24_STENCIL8;\n        case \"depth32float\":\n            return Constants.TEXTUREFORMAT_DEPTH32_FLOAT;\n        case \"depth32float-stencil8\":\n            return Constants.TEXTUREFORMAT_DEPTH32FLOAT_STENCIL8;\n        case \"stencil8\":\n            return Constants.TEXTUREFORMAT_STENCIL8;\n        default:\n            // Fall back to a combined depth/stencil format, which is the projection layer default.\n            return Constants.TEXTUREFORMAT_DEPTH24_STENCIL8;\n    }\n}\n\n/**\n * Provides render target textures for WebGPU-backed XR layers. Owns all WebGPU-specific texture wrapping\n * (via {@link WebGPUEngine.wrapWebGPUTexture} / {@link WebGPUEngine.updateWrappedWebGPUTexture}) so the base\n * provider can stay graphics-API-agnostic. Mirrors {@link WebXRWebGLRenderTargetTextureProvider} for the\n * WebGPU (XRGPUBinding) backend.\n * @internal\n */\nexport abstract class WebXRWebGPURenderTargetTextureProvider<\n    LayerTypeT extends WebXRSupportedLayerType = WebXRLayerType,\n> extends WebXRLayerRenderTargetTextureProvider<LayerTypeT> {\n    private readonly _transparentClearColor = new Color4(0, 0, 0, 0);\n\n    constructor(\n        protected readonly _xrSessionManager: WebXRSessionManager,\n        layerWrapper: WebXRLayerWrapper<LayerTypeT>\n    ) {\n        super(_xrSessionManager.scene, layerWrapper);\n    }\n\n    private get _webgpuEngine(): WebGPUEngine {\n        return this._engine as WebGPUEngine;\n    }\n\n    private _wrapColorTexture(texture: GPUTexture): InternalTexture {\n        return this._webgpuEngine.wrapWebGPUTexture(texture);\n    }\n\n    private _wrapDepthTexture(texture: GPUTexture, depthStencilFormat: GPUTextureFormat): InternalTexture {\n        const internalTexture = this._webgpuEngine.wrapWebGPUTexture(texture);\n        // The engine derives the color attachment format automatically from the wrapped hardware texture,\n        // but the depth attachment format is read from the Babylon InternalTexture.format, which\n        // wrapWebGPUTexture does not set. Assign it here from the format the layer was created with.\n        internalTexture.format = GetBabylonDepthFormat(depthStencilFormat);\n        return internalTexture;\n    }\n\n    /**\n     * Builds the render target shell as a {@link WebXRLayerRenderTargetTexture} for the single-view path so\n     * each eye can bind its own array layer of a layered projection-layer texture. Multiview is not yet\n     * supported on this WebGPU path and is delegated to the base implementation.\n     * @param width the width of the render target\n     * @param height the height of the render target\n     * @param multiview whether the render target should be a multiview render target\n     * @returns the created (but not yet registered) render target texture\n     */\n    protected override _createRenderTargetTextureShell(width: number, height: number, multiview: boolean): RenderTargetTexture {\n        if (multiview) {\n            return super._createRenderTargetTextureShell(width, height, multiview);\n        }\n        const renderTargetTexture = new WebXRLayerRenderTargetTexture(\"XR renderTargetTexture\", { width, height }, this._scene);\n        renderTargetTexture.renderTarget!._samples = renderTargetTexture.samples;\n        // The projection-layer texture is presented directly by the XR compositor (top-left origin, never\n        // re-sampled by Babylon), so opt this target out of the engine's render-target Y-flip / winding\n        // compensation and render it upright, matching the WebXR/WebGPU spec's plain render pass.\n        (renderTargetTexture.renderTarget as WebGPURenderTargetWrapper)._disableEngineYFlip = true;\n        return renderTargetTexture;\n    }\n\n    /**\n     * Wraps the sub-image's color (and optional depth/stencil) GPUTextures and builds a new render target\n     * texture around them. Use this on first creation and whenever the sub-image texture size changes.\n     * @param width the width of the render target\n     * @param height the height of the render target\n     * @param colorTexture the sub-image color GPUTexture\n     * @param depthStencilTexture the sub-image depth/stencil GPUTexture, if any\n     * @param depthStencilFormat the WebGPU depth/stencil format the layer was created with, if depth is provided\n     * @param multiview whether the render target should be a multiview render target\n     * @returns the created render target texture\n     */\n    protected _createRenderTargetTextureFromGPUTextures(\n        width: number,\n        height: number,\n        colorTexture: GPUTexture,\n        depthStencilTexture: Nullable<GPUTexture>,\n        depthStencilFormat: GPUTextureFormat | undefined,\n        multiview: boolean\n    ): WebXRLayerRenderTargetTexture {\n        const color = this._wrapColorTexture(colorTexture);\n        const depth = depthStencilTexture && depthStencilFormat ? this._wrapDepthTexture(depthStencilTexture, depthStencilFormat) : null;\n        // Single-view (the only path here) always builds a WebXRLayerRenderTargetTexture via the shell override above.\n        const renderTargetTexture = this._createRenderTargetTextureInternal(width, height, color, depth, multiview) as WebXRLayerRenderTargetTexture;\n        this._attachPerEyeClearObserver(renderTargetTexture);\n        return renderTargetTexture;\n    }\n\n    /**\n     * Ensures this render target is cleared every frame, including for the right eye.\n     *\n     * `Scene._clearFrameBuffer` skips clearing the right rig camera's framebuffer (`!camera.isRightCamera`).\n     * That is a valid optimization for WebGL2 stereo, where both eyes render into a single side-by-side\n     * texture and the left eye's full clear already covers the whole texture. WebGPU projection layers give\n     * each eye its OWN render target (a distinct array layer rendered in a separate render pass), so the\n     * right eye's color and — critically — depth would never be cleared, leaving its depth test to reject\n     * every fragment (a black right eye). The scene notifies `onClearObservable` regardless of\n     * `camera.isRightCamera`, so this observer clears both eyes' targets. WebGL providers never attach it,\n     * so the WebGL path is unchanged.\n     *\n     * Color is cleared at most once per ENGINE FRAME, not once per `Scene.render`. The distinction matters:\n     * more than one scene can render the same XR camera within a single XR frame. `UtilityLayerRenderer`\n     * (used by controller pointer selection and near interaction) renders a second scene through the same\n     * rig cameras, and every `Scene.render` resets `RenderTargetTexture._cleared` for those cameras' targets\n     * (`Scene._checkCameraRenderTarget`), so a `_cleared`-based guard is defeated and each eye is re-cleared\n     * after it was drawn — presenting a clear-colored frame with the geometry gone. `AbstractEngine.frameId`\n     * only advances in `endFrame`, once per XR frame, so unlike `_cleared` it cannot be reset by another\n     * scene rendering the same camera.\n     *\n     * In immersive AR, color is cleared to transparent when `WebXRExperienceHelper` disables\n     * `Scene.autoClear`. WebGL XR framebuffers are cleared to transparent by the user agent, but WebGPU render\n     * passes require the application to request that clear explicitly. Skipping it leaves pixels from prior\n     * frames in passthrough regions, producing trails behind moving objects.\n     *\n     * Depth and stencil are still cleared on every notification, matching the previous behavior and the\n     * expectations of overlay scenes that draw on top of the main scene.\n     * @param renderTargetTexture the per-eye render target to clear each frame\n     */\n    private _attachPerEyeClearObserver(renderTargetTexture: RenderTargetTexture): void {\n        let lastColorClearedFrameId = -1;\n        renderTargetTexture.onClearObservable.add((engine) => {\n            // Honor skipInitialClear so this observer preserves the default clear semantics it replaces.\n            if (renderTargetTexture.skipInitialClear) {\n                return;\n            }\n            const scene = renderTargetTexture.getScene();\n            const isImmersiveAR = this._xrSessionManager.sessionMode === \"immersive-ar\";\n            // When autoClear is disabled the scene does not clear render targets; match that so this observer\n            // does not force a clear the user opted out of. Immersive AR is the exception: the experience\n            // helper disables autoClear because WebGL XR is cleared by the user agent, while WebGPU is not.\n            if (scene && !scene.autoClear && !isImmersiveAR) {\n                return;\n            }\n            const clearColor = engine.frameId !== lastColorClearedFrameId;\n            const color = isImmersiveAR && scene && !scene.autoClear ? this._transparentClearColor : (renderTargetTexture.clearColor ?? scene?.clearColor ?? null);\n            engine.clear(color, clearColor, true, true);\n            if (clearColor) {\n                lastColorClearedFrameId = engine.frameId;\n            }\n            // Kept in sync so anything else reading the flag still sees this target as cleared this frame.\n            renderTargetTexture._cleared = true;\n        });\n    }\n\n    /**\n     * Repoints the wrapped color/depth textures of an existing render target at the current frame's\n     * GPUTextures, preserving the RenderTargetTexture / InternalTexture identity held by the XR camera's\n     * `outputRenderTarget`. The sub-image textures are only valid for the current frame and may rotate from\n     * a compositor pool, so this must run every frame. The new GPUTextures must have the same dimensions as\n     * the wrapped ones (guaranteed by the caller's size-change branch, which rebuilds instead).\n     * @param renderTargetTexture the render target whose wrapped textures should be repointed\n     * @param colorTexture the current frame's color GPUTexture\n     * @param depthStencilTexture the current frame's depth/stencil GPUTexture, if any\n     */\n    protected _updateRenderTargetTextureFromGPUTextures(renderTargetTexture: RenderTargetTexture, colorTexture: GPUTexture, depthStencilTexture: Nullable<GPUTexture>): void {\n        const color = renderTargetTexture._texture;\n        if (color) {\n            this._webgpuEngine.updateWrappedWebGPUTexture(color, colorTexture);\n        }\n        const depth = renderTargetTexture.renderTarget?._depthStencilTexture;\n        if (depth && depthStencilTexture) {\n            this._webgpuEngine.updateWrappedWebGPUTexture(depth, depthStencilTexture);\n        }\n    }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@onerjs/core",
-    "version": "8.55.8",
+    "version": "8.56.1",
     "main": "index.js",
     "module": "index.js",
     "types": "index.d.ts",

package/scene.pure.d.ts

@@ -1105,6 +1105,7 @@ export declare class Scene implements IAnimatable, IClipPlanesHolder, IAssetCont
     _cachedVisibility: Nullable<number>;
     private _renderId;
     private _frameId;
+    private _renderingMeshEvaluationDepth;
     private _executeWhenReadyTimeoutId;
     /** @internal */
     _intermediateRendering: boolean;
@@ -2245,6 +2246,8 @@ export declare class Scene implements IAnimatable, IClipPlanesHolder, IAssetCont
     freeRenderingGroups(): void;
     /** @internal */
     _isInIntermediateRendering(): boolean;
+    /** @internal */
+    _isInRenderingMeshEvaluation(): boolean;
     /**
      * Lambda returning the list of potentially active meshes.
      */
@@ -2329,6 +2332,7 @@ export declare class Scene implements IAnimatable, IClipPlanesHolder, IAssetCont
      */
     customRenderFunction?: (updateCameras: boolean, ignoreAnimations: boolean) => void;
     private _renderWithFrameGraph;
+    private _renderWithFrameGraphAfterBeforeRender;
     /**
      * @internal
      */
@@ -2340,6 +2344,7 @@ export declare class Scene implements IAnimatable, IClipPlanesHolder, IAssetCont
      * @param ignoreAnimations defines a boolean indicating if animations should not be executed (false by default)
      */
     render(updateCameras?: boolean, ignoreAnimations?: boolean): void;
+    private _renderFrame;
     /**
      * Freeze all materials
      * A frozen material will not be updatable but should be faster to render

package/scene.pure.js

@@ -1308,6 +1308,7 @@ export class Scene {
         this.animationTimeScale = 1;
         this._renderId = 0;
         this._frameId = 0;
+        this._renderingMeshEvaluationDepth = 0;
         this._executeWhenReadyTimeoutId = null;
         /** @internal */
         this._intermediateRendering = false;
@@ -3697,6 +3698,10 @@ export class Scene {
     _isInIntermediateRendering() {
         return this._intermediateRendering;
     }
+    /** @internal */
+    _isInRenderingMeshEvaluation() {
+        return this._renderingMeshEvaluationDepth > 0;
+    }
     /**
      * Use this function to stop evaluating active meshes. The current list will be keep alive between frames
      * @param skipEvaluateActiveMeshes defines an optional boolean indicating that the evaluate active meshes step must be completely skipped
@@ -4362,6 +4367,15 @@ export class Scene {
             }
         }
         this.onBeforeRenderObservable.notifyObservers(this);
+        this._renderingMeshEvaluationDepth++;
+        try {
+            this._renderWithFrameGraphAfterBeforeRender(forceUpdateWorldMatrix);
+        }
+        finally {
+            this._renderingMeshEvaluationDepth--;
+        }
+    }
+    _renderWithFrameGraphAfterBeforeRender(forceUpdateWorldMatrix) {
         // Customs render targets
         this.onBeforeRenderTargetsRenderObservable.notifyObservers(this);
         this._renderTargets.reset();
@@ -4478,6 +4492,15 @@ export class Scene {
         if (this.isDisposed) {
             return;
         }
+        const renderingMeshEvaluationDepth = this._renderingMeshEvaluationDepth;
+        try {
+            this._renderFrame(updateCameras, ignoreAnimations);
+        }
+        finally {
+            this._renderingMeshEvaluationDepth = renderingMeshEvaluationDepth;
+        }
+    }
+    _renderFrame(updateCameras, ignoreAnimations) {
         if (this.onReadyObservable.hasObservers() && this._executeWhenReadyTimeoutId === null) {
             this._checkIsReady();
         }
@@ -4540,11 +4563,13 @@ export class Scene {
         if (this.customRenderFunction) {
             this._renderId++;
             this._engine.currentRenderPassId = 0;
+            this._renderingMeshEvaluationDepth++;
             this.customRenderFunction(updateCameras, ignoreAnimations);
         }
         else {
             // Before render
             this.onBeforeRenderObservable.notifyObservers(this);
+            this._renderingMeshEvaluationDepth++;
             // Customs render targets
             this.onBeforeRenderTargetsRenderObservable.notifyObservers(this);
             const currentActiveCamera = this.activeCameras?.length ? this.activeCameras[0] : this.activeCamera;