@babylonjs/core 7.46.0 → 7.47.0

package/Misc/snapshotRenderingHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshotRenderingHelper.js","sourceRoot":"","sources":["../../../../dev/core/src/Misc/snapshotRenderingHelper.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\r\n    AbstractEngine,\r\n    AbstractMesh,\r\n    EffectLayer,\r\n    Mesh,\r\n    Nullable,\r\n    Observer,\r\n    Scene,\r\n    WebGPUDrawContext,\r\n    WebGPUShaderProcessor,\r\n    WebGPUPipelineContext,\r\n    GaussianSplattingMesh,\r\n    // eslint-disable-next-line import/no-internal-modules\r\n} from \"core/index\";\r\n\r\nimport { Constants } from \"core/Engines/constants\";\r\nimport { BindMorphTargetParameters } from \"core/Materials/materialHelper.functions\";\r\nimport { ScenePerformancePriority } from \"core/scene\";\r\n\r\n/**\r\n * Options for the snapshot rendering helper\r\n */\r\nexport interface SnapshotRenderingHelpersOptions {\r\n    /**\r\n     * Maximum number of influences for morph target managers\r\n     * In FAST snapshot mode, the number of influences must be fixed and cannot change from one frame to the next.\r\n     * morphTargetsNumMaxInfluences is the maximum number of non-zero influences allowed in a morph target manager.\r\n     * The final value defined for a morph target manager is: Math.min(morphTargetManager.numTargets, morphTargetsNumMaxInfluences)\r\n     * Default: 20\r\n     */\r\n    morphTargetsNumMaxInfluences?: number;\r\n}\r\n\r\n/**\r\n * A helper class to simplify work with FAST snapshot mode (WebGPU only - can be used in WebGL too, but won't do anything).\r\n */\r\nexport class SnapshotRenderingHelper {\r\n    private readonly _engine: AbstractEngine;\r\n    private readonly _scene: Scene;\r\n    private readonly _options: SnapshotRenderingHelpersOptions;\r\n    private readonly _onBeforeRenderObserver: Nullable<Observer<Scene>>;\r\n    private _onBeforeRenderObserverUpdateLayer: Nullable<Observer<Scene>>;\r\n    private readonly _onResizeObserver: Nullable<Observer<AbstractEngine>>;\r\n    private _disableRenderingRefCount = 0;\r\n    private _currentPerformancePriorityMode = ScenePerformancePriority.BackwardCompatible;\r\n    private _pendingCurrentPerformancePriorityMode?: ScenePerformancePriority;\r\n\r\n    /**\r\n     * Creates a new snapshot rendering helper\r\n     * Note that creating an instance of the helper will set the snapshot rendering mode to SNAPSHOTRENDERING_FAST but will not enable snapshot rendering (engine.snapshotRendering is not updated).\r\n     * Note also that fixMeshes() is called as part of the construction\r\n     * @param scene The scene to use the helper in\r\n     * @param options The options for the helper\r\n     */\r\n    constructor(scene: Scene, options?: SnapshotRenderingHelpersOptions) {\r\n        this._scene = scene;\r\n        this._engine = scene.getEngine();\r\n\r\n        if (!this._engine.isWebGPU) {\r\n            return;\r\n        }\r\n\r\n        this._options = {\r\n            morphTargetsNumMaxInfluences: 20,\r\n            ...options,\r\n        };\r\n\r\n        this._engine.snapshotRenderingMode = Constants.SNAPSHOTRENDERING_FAST;\r\n\r\n        this.fixMeshes();\r\n\r\n        this._onResizeObserver = this._engine.onResizeObservable.add(() => {\r\n            // enableSnapshotRendering() will delay the actual enabling of snapshot rendering by at least a frame, so these two lines are not redundant!\r\n            this.disableSnapshotRendering();\r\n            this.enableSnapshotRendering();\r\n        });\r\n\r\n        this._scene.onBeforeRenderObservable.add(() => {\r\n            if (!this._fastSnapshotRenderingEnabled) {\r\n                return;\r\n            }\r\n\r\n            // Animate skeletons\r\n            scene.skeletons.forEach((skeleton) => skeleton.prepare(true));\r\n\r\n            for (const mesh of scene.meshes) {\r\n                if (mesh.infiniteDistance) {\r\n                    mesh.transferToEffect(mesh.computeWorldMatrix(true));\r\n                }\r\n\r\n                if (mesh.skeleton) {\r\n                    mesh.transferToEffect(mesh.computeWorldMatrix(true));\r\n                }\r\n\r\n                if (mesh.getClassName() === \"GaussianSplattingMesh\") {\r\n                    (mesh as GaussianSplattingMesh)._postToWorker();\r\n                }\r\n\r\n                if (mesh.morphTargetManager && mesh.subMeshes) {\r\n                    // Make sure morph target animations work\r\n                    for (const subMesh of mesh.subMeshes) {\r\n                        const dw = subMesh._drawWrapper;\r\n                        const effect = dw.effect;\r\n                        if (effect) {\r\n                            const dataBuffer = (dw.drawContext as WebGPUDrawContext).buffers[\"LeftOver\" satisfies (typeof WebGPUShaderProcessor)[\"LeftOvertUBOName\"]];\r\n                            const ubLeftOver = (effect._pipelineContext as WebGPUPipelineContext)?.uniformBuffer;\r\n                            if (dataBuffer && ubLeftOver && ubLeftOver.setDataBuffer(dataBuffer)) {\r\n                                mesh.morphTargetManager._bind(effect);\r\n                                BindMorphTargetParameters(mesh, effect);\r\n                                ubLeftOver.update();\r\n                            }\r\n                        }\r\n                    }\r\n                }\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Enable snapshot rendering\r\n     * Use this method instead of engine.snapshotRendering=true, to make sure everything is ready before enabling snapshot rendering.\r\n     * Note that this method is ref-counted and works in pair with disableSnapshotRendering(): you should call enableSnapshotRendering() as many times as you call disableSnapshotRendering().\r\n     */\r\n    public enableSnapshotRendering() {\r\n        if (!this._engine.isWebGPU) {\r\n            return;\r\n        }\r\n\r\n        if (--this._disableRenderingRefCount > 0) {\r\n            return;\r\n        }\r\n\r\n        this._disableRenderingRefCount = 0;\r\n\r\n        this._currentPerformancePriorityMode = this._pendingCurrentPerformancePriorityMode ?? this._scene.performancePriority;\r\n        this._pendingCurrentPerformancePriorityMode = undefined;\r\n        this._scene.performancePriority = ScenePerformancePriority.BackwardCompatible;\r\n\r\n        this._scene.executeWhenReady(() => {\r\n            if (this._disableRenderingRefCount > 0) {\r\n                return;\r\n            }\r\n\r\n            // Make sure a full frame is rendered before enabling snapshot rendering, so use \"+2\" instead of \"+1\"\r\n            this._executeAtFrame(this._engine.frameId + 2, () => {\r\n                this._engine.snapshotRendering = true;\r\n            });\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Disable snapshot rendering\r\n     * Note that this method is ref-counted and works in pair with disableSnapshotRendering(): you should call enableSnapshotRendering() as many times as you call disableSnapshotRendering().\r\n     */\r\n    public disableSnapshotRendering() {\r\n        if (!this._engine.isWebGPU) {\r\n            return;\r\n        }\r\n\r\n        if (this._disableRenderingRefCount === 0) {\r\n            // Snapshot rendering switches from enabled to disabled\r\n            // We reset the performance priority mode to that which it was before enabling snapshot rendering, but first set it to “BackwardCompatible” to allow the system to regenerate resources that may have been optimized for snapshot rendering.\r\n            // We'll then restore the original mode at the next frame.\r\n            this._scene.performancePriority = ScenePerformancePriority.BackwardCompatible;\r\n            if (this._currentPerformancePriorityMode !== ScenePerformancePriority.BackwardCompatible) {\r\n                this._pendingCurrentPerformancePriorityMode = this._currentPerformancePriorityMode;\r\n                this._scene.executeWhenReady(() => {\r\n                    this._executeAtFrame(\r\n                        this._engine.frameId + 2,\r\n                        () => {\r\n                            // if this._disableRenderingRefCount === 0, snapshot rendering has been enabled in the meantime, so do nothing\r\n                            if (this._disableRenderingRefCount > 0 && this._pendingCurrentPerformancePriorityMode !== undefined) {\r\n                                this._scene.performancePriority = this._pendingCurrentPerformancePriorityMode;\r\n                            }\r\n                            this._pendingCurrentPerformancePriorityMode = undefined;\r\n                        },\r\n                        true\r\n                    );\r\n                });\r\n            }\r\n        }\r\n\r\n        this._engine.snapshotRendering = false;\r\n        this._disableRenderingRefCount++;\r\n    }\r\n\r\n    /**\r\n     * Fix meshes for snapshot rendering.\r\n     * This method will make sure that some features are disabled or fixed to make sure snapshot rendering works correctly.\r\n     * @param meshes List of meshes to fix. If not provided, all meshes in the scene will be fixed.\r\n     */\r\n    public fixMeshes(meshes?: AbstractMesh[]) {\r\n        if (!this._engine.isWebGPU) {\r\n            return;\r\n        }\r\n\r\n        meshes = meshes || this._scene.meshes;\r\n\r\n        for (const mesh of meshes) {\r\n            (mesh as Mesh).ignoreCameraMaxZ = false;\r\n            if (mesh.morphTargetManager) {\r\n                mesh.morphTargetManager.numMaxInfluencers = Math.min(mesh.morphTargetManager.numTargets, this._options.morphTargetsNumMaxInfluences!);\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Call this method to update a mesh on the GPU after some properties have changed (position, rotation, scaling, visibility).\r\n     * @param mesh The mesh to update. Can be a single mesh or an array of meshes to update.\r\n     */\r\n    public updateMesh(mesh: AbstractMesh | AbstractMesh[]) {\r\n        if (!this._fastSnapshotRenderingEnabled) {\r\n            return;\r\n        }\r\n\r\n        if (Array.isArray(mesh)) {\r\n            for (const m of mesh) {\r\n                m.transferToEffect(m.computeWorldMatrix(true));\r\n            }\r\n            return;\r\n        }\r\n\r\n        mesh.transferToEffect(mesh.computeWorldMatrix(true));\r\n    }\r\n\r\n    /**\r\n     * Update the meshes used in an effect layer to ensure that snapshot rendering works correctly for these meshes in this layer.\r\n     * @param effectLayer The effect layer\r\n     * @param autoUpdate If true, the helper will automatically update the effect layer meshes with each frame. If false, you'll need to call this method manually when the camera or layer meshes move or rotate.\r\n     */\r\n    public updateMeshesForEffectLayer(effectLayer: EffectLayer, autoUpdate = true) {\r\n        if (!this._engine.isWebGPU) {\r\n            return;\r\n        }\r\n\r\n        const renderPassId = effectLayer.mainTexture.renderPassId;\r\n\r\n        if (autoUpdate) {\r\n            this._onBeforeRenderObserverUpdateLayer = this._scene.onBeforeRenderObservable.add(() => {\r\n                this._updateMeshMatricesForRenderPassId(renderPassId);\r\n            });\r\n        } else {\r\n            this._updateMeshMatricesForRenderPassId(renderPassId);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Dispose the helper\r\n     */\r\n    public dispose() {\r\n        if (!this._engine.isWebGPU) {\r\n            return;\r\n        }\r\n\r\n        this._scene.onBeforeRenderObservable.remove(this._onBeforeRenderObserver);\r\n        this._scene.onBeforeRenderObservable.remove(this._onBeforeRenderObserverUpdateLayer);\r\n        this._engine.onResizeObservable.remove(this._onResizeObserver);\r\n    }\r\n\r\n    private get _fastSnapshotRenderingEnabled() {\r\n        return this._engine.snapshotRendering && this._engine.snapshotRenderingMode === Constants.SNAPSHOTRENDERING_FAST;\r\n    }\r\n\r\n    private _updateMeshMatricesForRenderPassId(renderPassId: number) {\r\n        if (!this._fastSnapshotRenderingEnabled) {\r\n            return;\r\n        }\r\n\r\n        const sceneTransformationMatrix = this._scene.getTransformMatrix();\r\n\r\n        for (let i = 0; i < this._scene.meshes.length; ++i) {\r\n            const mesh = this._scene.meshes[i];\r\n            if (!mesh.subMeshes) {\r\n                continue;\r\n            }\r\n\r\n            for (let j = 0; j < mesh.subMeshes.length; ++j) {\r\n                const dw = mesh.subMeshes[j]._getDrawWrapper(renderPassId);\r\n                const effect = dw?.effect;\r\n                if (effect) {\r\n                    const dataBuffer = (dw.drawContext as WebGPUDrawContext).buffers[\"LeftOver\" satisfies (typeof WebGPUShaderProcessor)[\"LeftOvertUBOName\"]];\r\n                    const ubLeftOver = (effect._pipelineContext as WebGPUPipelineContext)?.uniformBuffer;\r\n                    if (dataBuffer && ubLeftOver && ubLeftOver.setDataBuffer(dataBuffer)) {\r\n                        effect.setMatrix(\"viewProjection\", sceneTransformationMatrix);\r\n                        effect.setMatrix(\"world\", mesh.computeWorldMatrix());\r\n                        ubLeftOver.update();\r\n                    }\r\n                }\r\n            }\r\n        }\r\n    }\r\n\r\n    private _executeAtFrame(frameId: number, func: () => void, executeWhenModeIsDisabled = false) {\r\n        const obs = this._engine.onEndFrameObservable.add(() => {\r\n            if ((this._disableRenderingRefCount > 0 && !executeWhenModeIsDisabled) || (this._disableRenderingRefCount === 0 && executeWhenModeIsDisabled)) {\r\n                this._engine.onEndFrameObservable.remove(obs);\r\n                return;\r\n            }\r\n            if (this._engine.frameId >= frameId) {\r\n                this._engine.onEndFrameObservable.remove(obs);\r\n                func();\r\n            }\r\n        });\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"snapshotRenderingHelper.js","sourceRoot":"","sources":["../../../../dev/core/src/Misc/snapshotRenderingHelper.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\r\n    AbstractEngine,\r\n    AbstractMesh,\r\n    EffectLayer,\r\n    Mesh,\r\n    Nullable,\r\n    Observer,\r\n    Scene,\r\n    WebGPUDrawContext,\r\n    WebGPUShaderProcessor,\r\n    WebGPUPipelineContext,\r\n    GaussianSplattingMesh,\r\n    // eslint-disable-next-line import/no-internal-modules\r\n} from \"core/index\";\r\n\r\nimport { Constants } from \"core/Engines/constants\";\r\nimport { BindMorphTargetParameters } from \"core/Materials/materialHelper.functions\";\r\nimport { ScenePerformancePriority } from \"core/scene\";\r\nimport { Logger } from \"core/Misc/logger\";\r\n\r\n/**\r\n * Options for the snapshot rendering helper\r\n */\r\nexport interface SnapshotRenderingHelpersOptions {\r\n    /**\r\n     * Maximum number of influences for morph target managers\r\n     * In FAST snapshot mode, the number of influences must be fixed and cannot change from one frame to the next.\r\n     * morphTargetsNumMaxInfluences is the maximum number of non-zero influences allowed in a morph target manager.\r\n     * The final value defined for a morph target manager is: Math.min(morphTargetManager.numTargets, morphTargetsNumMaxInfluences)\r\n     * Default: 20\r\n     */\r\n    morphTargetsNumMaxInfluences?: number;\r\n}\r\n\r\n/**\r\n * A helper class to simplify work with FAST snapshot mode (WebGPU only - can be used in WebGL too, but won't do anything).\r\n */\r\nexport class SnapshotRenderingHelper {\r\n    private readonly _engine: AbstractEngine;\r\n    private readonly _scene: Scene;\r\n    private readonly _options: SnapshotRenderingHelpersOptions;\r\n    private readonly _onBeforeRenderObserver: Nullable<Observer<Scene>>;\r\n    private _onBeforeRenderObserverUpdateLayer: Nullable<Observer<Scene>>;\r\n    private readonly _onResizeObserver: Nullable<Observer<AbstractEngine>>;\r\n    private _disableRenderingRefCount = 0;\r\n    private _currentPerformancePriorityMode = ScenePerformancePriority.BackwardCompatible;\r\n    private _pendingCurrentPerformancePriorityMode?: ScenePerformancePriority;\r\n    private _isEnabling = false;\r\n    private _enableCancelFunctions: Map<() => void, () => void> = new Map(); // first function is the callback, second function is the cancel function\r\n    private _disableCancelFunctions: Map<() => void, () => void> = new Map(); // same as above\r\n\r\n    /**\r\n     * Indicates if debug logs should be displayed\r\n     */\r\n    public showDebugLogs = false;\r\n\r\n    /**\r\n     * Creates a new snapshot rendering helper\r\n     * Note that creating an instance of the helper will set the snapshot rendering mode to SNAPSHOTRENDERING_FAST but will not enable snapshot rendering (engine.snapshotRendering is not updated).\r\n     * Note also that fixMeshes() is called as part of the construction\r\n     * @param scene The scene to use the helper in\r\n     * @param options The options for the helper\r\n     */\r\n    constructor(scene: Scene, options?: SnapshotRenderingHelpersOptions) {\r\n        this._scene = scene;\r\n        this._engine = scene.getEngine();\r\n\r\n        if (!this._engine.isWebGPU) {\r\n            return;\r\n        }\r\n\r\n        this._options = {\r\n            morphTargetsNumMaxInfluences: 20,\r\n            ...options,\r\n        };\r\n\r\n        this._engine.snapshotRenderingMode = Constants.SNAPSHOTRENDERING_FAST;\r\n\r\n        this.fixMeshes();\r\n\r\n        this._onResizeObserver = this._engine.onResizeObservable.add(() => {\r\n            this._log(\"onResize\", \"start\");\r\n\r\n            // enableSnapshotRendering() will delay the actual enabling of snapshot rendering by at least a frame, so these two lines are not redundant!\r\n            this.disableSnapshotRendering();\r\n            this.enableSnapshotRendering();\r\n\r\n            this._log(\"onResize\", \"end\");\r\n        });\r\n\r\n        this._scene.onBeforeRenderObservable.add(() => {\r\n            if (!this._fastSnapshotRenderingEnabled) {\r\n                return;\r\n            }\r\n\r\n            // Animate skeletons\r\n            scene.skeletons.forEach((skeleton) => skeleton.prepare(true));\r\n\r\n            for (const mesh of scene.meshes) {\r\n                if (mesh.infiniteDistance) {\r\n                    mesh.transferToEffect(mesh.computeWorldMatrix(true));\r\n                }\r\n\r\n                if (mesh.skeleton) {\r\n                    mesh.transferToEffect(mesh.computeWorldMatrix(true));\r\n                }\r\n\r\n                if (mesh.getClassName() === \"GaussianSplattingMesh\") {\r\n                    (mesh as GaussianSplattingMesh)._postToWorker();\r\n                }\r\n\r\n                if (mesh.morphTargetManager && mesh.subMeshes) {\r\n                    // Make sure morph target animations work\r\n                    for (const subMesh of mesh.subMeshes) {\r\n                        const dw = subMesh._drawWrapper;\r\n                        const effect = dw.effect;\r\n                        if (effect) {\r\n                            const dataBuffer = (dw.drawContext as WebGPUDrawContext).buffers[\"LeftOver\" satisfies (typeof WebGPUShaderProcessor)[\"LeftOvertUBOName\"]];\r\n                            const ubLeftOver = (effect._pipelineContext as WebGPUPipelineContext)?.uniformBuffer;\r\n                            if (dataBuffer && ubLeftOver && ubLeftOver.setDataBuffer(dataBuffer)) {\r\n                                mesh.morphTargetManager._bind(effect);\r\n                                BindMorphTargetParameters(mesh, effect);\r\n                                ubLeftOver.update();\r\n                            }\r\n                        }\r\n                    }\r\n                }\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Gets a value indicating if the helper is in a steady state (not in the process of enabling snapshot rendering).\r\n     */\r\n    public get isReady() {\r\n        return !this._isEnabling;\r\n    }\r\n\r\n    /**\r\n     * Enable snapshot rendering\r\n     * Use this method instead of engine.snapshotRendering=true, to make sure everything is ready before enabling snapshot rendering.\r\n     * Note that this method is ref-counted and works in pair with disableSnapshotRendering(): you should call enableSnapshotRendering() as many times as you call disableSnapshotRendering().\r\n     */\r\n    public enableSnapshotRendering() {\r\n        if (!this._engine.isWebGPU) {\r\n            return;\r\n        }\r\n\r\n        if (--this._disableRenderingRefCount > 0) {\r\n            return;\r\n        }\r\n\r\n        this._log(\"enableSnapshotRendering\", \"called\");\r\n        if (this._disableCancelFunctions.size > 0) {\r\n            this._log(\"enableSnapshotRendering\", `cancelling ${this._disableCancelFunctions.size} \"disable\" callbacks`);\r\n        }\r\n\r\n        this._disableCancelFunctions.forEach((cancel) => cancel());\r\n        this._disableCancelFunctions.clear();\r\n\r\n        this._isEnabling = true;\r\n        this._disableRenderingRefCount = 0;\r\n\r\n        this._currentPerformancePriorityMode = this._pendingCurrentPerformancePriorityMode ?? this._scene.performancePriority;\r\n        this._pendingCurrentPerformancePriorityMode = undefined;\r\n        this._scene.performancePriority = ScenePerformancePriority.BackwardCompatible;\r\n\r\n        const callbackWhenSceneReady = () => {\r\n            this._enableCancelFunctions.delete(callbackWhenSceneReady);\r\n\r\n            // Make sure a full frame is rendered before enabling snapshot rendering, so use \"+2\" instead of \"+1\"\r\n            const targetFrameId = this._engine.frameId + 2;\r\n\r\n            this._log(\"enableSnapshotRendering\", `scene ready, add callbacks for frames ${targetFrameId} and ${targetFrameId + 1}`);\r\n\r\n            this._executeAtFrame(targetFrameId, () => {\r\n                this._log(\"enableSnapshotRendering\", `callback #1, enable snapshot rendering at the engine level`);\r\n                this._engine.snapshotRendering = true;\r\n            });\r\n\r\n            // Render one frame with snapshot rendering enabled to make sure everything is ready\r\n            this._executeAtFrame(targetFrameId + 1, () => {\r\n                this._log(\"enableSnapshotRendering\", `callback #2, signals that snapshot rendering helper is ready`);\r\n                this._isEnabling = false;\r\n            });\r\n        };\r\n\r\n        this._enableCancelFunctions.set(callbackWhenSceneReady, () => this._scene.onReadyObservable.removeCallback(callbackWhenSceneReady));\r\n\r\n        this._scene.executeWhenReady(callbackWhenSceneReady);\r\n    }\r\n\r\n    /**\r\n     * Disable snapshot rendering\r\n     * Note that this method is ref-counted and works in pair with disableSnapshotRendering(): you should call enableSnapshotRendering() as many times as you call disableSnapshotRendering().\r\n     */\r\n    public disableSnapshotRendering() {\r\n        if (!this._engine.isWebGPU) {\r\n            return;\r\n        }\r\n\r\n        this._log(\"disableSnapshotRendering\", \"called\");\r\n\r\n        if (this._disableRenderingRefCount === 0) {\r\n            if (this._enableCancelFunctions.size > 0) {\r\n                this._log(\"disableSnapshotRendering\", `cancelling ${this._enableCancelFunctions.size} \"enable\" callbacks`);\r\n            }\r\n\r\n            this._enableCancelFunctions.forEach((cancel) => cancel());\r\n            this._enableCancelFunctions.clear();\r\n\r\n            this._isEnabling = false;\r\n\r\n            // Snapshot rendering switches from enabled to disabled\r\n            // We reset the performance priority mode to that which it was before enabling snapshot rendering, but first set it to “BackwardCompatible” to allow the system to regenerate resources that may have been optimized for snapshot rendering.\r\n            // We'll then restore the original mode at the next frame.\r\n            this._scene.performancePriority = ScenePerformancePriority.BackwardCompatible;\r\n            if (this._currentPerformancePriorityMode !== ScenePerformancePriority.BackwardCompatible) {\r\n                this._log(\r\n                    \"disableSnapshotRendering\",\r\n                    `makes sure that the scene is rendered once in BackwardCompatible mode (code: ${ScenePerformancePriority.BackwardCompatible}) before switching to mode ${this._currentPerformancePriorityMode}`\r\n                );\r\n\r\n                this._pendingCurrentPerformancePriorityMode = this._currentPerformancePriorityMode;\r\n\r\n                const callbackWhenSceneReady = () => {\r\n                    this._log(\"disableSnapshotRendering\", `scene ready, add callback for frame ${this._engine.frameId + 2}`);\r\n\r\n                    this._executeAtFrame(\r\n                        this._engine.frameId + 2,\r\n                        () => {\r\n                            this._log(\"disableSnapshotRendering\", `switching to performance priority mode ${this._pendingCurrentPerformancePriorityMode}`);\r\n                            this._scene.performancePriority = this._pendingCurrentPerformancePriorityMode!;\r\n                            this._pendingCurrentPerformancePriorityMode = undefined;\r\n                        },\r\n                        \"whenDisabled\"\r\n                    );\r\n                };\r\n\r\n                this._disableCancelFunctions.set(callbackWhenSceneReady, () => this._scene.onReadyObservable.removeCallback(callbackWhenSceneReady));\r\n\r\n                this._scene.executeWhenReady(callbackWhenSceneReady);\r\n            }\r\n        }\r\n\r\n        this._engine.snapshotRendering = false;\r\n        this._disableRenderingRefCount++;\r\n    }\r\n\r\n    /**\r\n     * Fix meshes for snapshot rendering.\r\n     * This method will make sure that some features are disabled or fixed to make sure snapshot rendering works correctly.\r\n     * @param meshes List of meshes to fix. If not provided, all meshes in the scene will be fixed.\r\n     */\r\n    public fixMeshes(meshes?: AbstractMesh[]) {\r\n        if (!this._engine.isWebGPU) {\r\n            return;\r\n        }\r\n\r\n        meshes = meshes || this._scene.meshes;\r\n\r\n        for (const mesh of meshes) {\r\n            (mesh as Mesh).ignoreCameraMaxZ = false;\r\n            if (mesh.morphTargetManager) {\r\n                mesh.morphTargetManager.numMaxInfluencers = Math.min(mesh.morphTargetManager.numTargets, this._options.morphTargetsNumMaxInfluences!);\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Call this method to update a mesh on the GPU after some properties have changed (position, rotation, scaling, visibility).\r\n     * @param mesh The mesh to update. Can be a single mesh or an array of meshes to update.\r\n     */\r\n    public updateMesh(mesh: AbstractMesh | AbstractMesh[]) {\r\n        if (!this._fastSnapshotRenderingEnabled) {\r\n            return;\r\n        }\r\n\r\n        if (Array.isArray(mesh)) {\r\n            for (const m of mesh) {\r\n                m.transferToEffect(m.computeWorldMatrix(true));\r\n            }\r\n            return;\r\n        }\r\n\r\n        mesh.transferToEffect(mesh.computeWorldMatrix(true));\r\n    }\r\n\r\n    /**\r\n     * Update the meshes used in an effect layer to ensure that snapshot rendering works correctly for these meshes in this layer.\r\n     * @param effectLayer The effect layer\r\n     * @param autoUpdate If true, the helper will automatically update the effect layer meshes with each frame. If false, you'll need to call this method manually when the camera or layer meshes move or rotate.\r\n     */\r\n    public updateMeshesForEffectLayer(effectLayer: EffectLayer, autoUpdate = true) {\r\n        if (!this._engine.isWebGPU) {\r\n            return;\r\n        }\r\n\r\n        const renderPassId = effectLayer.mainTexture.renderPassId;\r\n\r\n        if (autoUpdate) {\r\n            this._onBeforeRenderObserverUpdateLayer = this._scene.onBeforeRenderObservable.add(() => {\r\n                this._updateMeshMatricesForRenderPassId(renderPassId);\r\n            });\r\n        } else {\r\n            this._updateMeshMatricesForRenderPassId(renderPassId);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Dispose the helper\r\n     */\r\n    public dispose() {\r\n        if (!this._engine.isWebGPU) {\r\n            return;\r\n        }\r\n\r\n        this._scene.onBeforeRenderObservable.remove(this._onBeforeRenderObserver);\r\n        this._scene.onBeforeRenderObservable.remove(this._onBeforeRenderObserverUpdateLayer);\r\n        this._engine.onResizeObservable.remove(this._onResizeObserver);\r\n    }\r\n\r\n    private get _fastSnapshotRenderingEnabled() {\r\n        return this._engine.snapshotRendering && this._engine.snapshotRenderingMode === Constants.SNAPSHOTRENDERING_FAST;\r\n    }\r\n\r\n    private _updateMeshMatricesForRenderPassId(renderPassId: number) {\r\n        if (!this._fastSnapshotRenderingEnabled) {\r\n            return;\r\n        }\r\n\r\n        const sceneTransformationMatrix = this._scene.getTransformMatrix();\r\n\r\n        for (let i = 0; i < this._scene.meshes.length; ++i) {\r\n            const mesh = this._scene.meshes[i];\r\n            if (!mesh.subMeshes) {\r\n                continue;\r\n            }\r\n\r\n            for (let j = 0; j < mesh.subMeshes.length; ++j) {\r\n                const dw = mesh.subMeshes[j]._getDrawWrapper(renderPassId);\r\n                const effect = dw?.effect;\r\n                if (effect) {\r\n                    const dataBuffer = (dw.drawContext as WebGPUDrawContext).buffers[\"LeftOver\" satisfies (typeof WebGPUShaderProcessor)[\"LeftOvertUBOName\"]];\r\n                    const ubLeftOver = (effect._pipelineContext as WebGPUPipelineContext)?.uniformBuffer;\r\n                    if (dataBuffer && ubLeftOver && ubLeftOver.setDataBuffer(dataBuffer)) {\r\n                        effect.setMatrix(\"viewProjection\", sceneTransformationMatrix);\r\n                        effect.setMatrix(\"world\", mesh.computeWorldMatrix());\r\n                        ubLeftOver.update();\r\n                    }\r\n                }\r\n            }\r\n        }\r\n    }\r\n\r\n    private _executeAtFrame(frameId: number, func: () => void, mode: \"whenEnabled\" | \"whenDisabled\" = \"whenEnabled\") {\r\n        const callback = () => {\r\n            if (this._engine.frameId >= frameId) {\r\n                this._engine.onEndFrameObservable.remove(obs);\r\n                if (mode === \"whenEnabled\") {\r\n                    this._enableCancelFunctions.delete(callback);\r\n                } else {\r\n                    this._disableCancelFunctions.delete(callback);\r\n                }\r\n                func();\r\n            }\r\n        };\r\n\r\n        const obs = this._engine.onEndFrameObservable.add(callback);\r\n        if (mode === \"whenEnabled\") {\r\n            this._enableCancelFunctions.set(callback, () => this._engine.onEndFrameObservable.remove(obs));\r\n        } else {\r\n            this._disableCancelFunctions.set(callback, () => this._engine.onEndFrameObservable.remove(obs));\r\n        }\r\n    }\r\n\r\n    private _log(funcName: string, message: string) {\r\n        if (this.showDebugLogs) {\r\n            Logger.Log(`[Frame: ${this._engine.frameId}] SnapshotRenderingHelper:${funcName} - ${message}`);\r\n        }\r\n    }\r\n}\r\n"]}

package/package.json

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