@onerjs/core 8.51.6 → 8.51.8

package/Engines/webgpuEngine.pure.d.ts

@@ -778,11 +778,32 @@ export declare class WebGPUEngine extends ThinWebGPUEngine {
      * @returns the babylon internal texture
      */
     wrapWebGPUTexture(texture: GPUTexture): InternalTexture;
+    /**
+     * Replaces the underlying GPUTexture of a texture previously created via {@link wrapWebGPUTexture}, preserving the
+     * InternalTexture identity.
+     *
+     * Intended for the device-loss / device-restored flow: when the host recreates its external resource on the new
+     * GPU device, it calls this method to repoint Babylon's wrapper at the new handle without losing references held
+     * by materials, render-target wrappers, particle systems, etc.
+     *
+     * The new GPUTexture must have the same dimensions as the original. To change dimensions, dispose the wrapped
+     * texture and call {@link wrapWebGPUTexture} again.
+     *
+     * Throws if the target was not produced by {@link wrapWebGPUTexture}, or if the new GPUTexture's dimensions don't
+     * match.
+     * @param internalTexture defines the wrapped InternalTexture to repoint
+     * @param texture defines the new GPUTexture to wrap
+     */
+    updateWrappedWebGPUTexture(internalTexture: InternalTexture, texture: GPUTexture): void;
     /**
      * Wraps an external web gl texture in a Babylon texture.
      * @returns the babylon internal texture
      */
     wrapWebGLTexture(): InternalTexture;
+    /**
+     * Throws because the engine is WebGPU. Use {@link updateWrappedWebGPUTexture} instead.
+     */
+    updateWrappedWebGLTexture(): void;
     /**
      * @internal
      */

package/Engines/webgpuEngine.pure.js

@@ -1885,11 +1885,50 @@ export class WebGPUEngine extends ThinWebGPUEngine {
      */
     wrapWebGPUTexture(texture) {
         const hardwareTexture = new WebGPUHardwareTexture(this, texture);
-        const internalTexture = new InternalTexture(this, 0 /* InternalTextureSource.Unknown */, true);
+        const internalTexture = new InternalTexture(this, 15 /* InternalTextureSource.External */, true);
         internalTexture._hardwareTexture = hardwareTexture;
+        internalTexture.baseWidth = texture.width;
+        internalTexture.baseHeight = texture.height;
+        internalTexture.width = texture.width;
+        internalTexture.height = texture.height;
         internalTexture.isReady = true;
         return internalTexture;
     }
+    /**
+     * Replaces the underlying GPUTexture of a texture previously created via {@link wrapWebGPUTexture}, preserving the
+     * InternalTexture identity.
+     *
+     * Intended for the device-loss / device-restored flow: when the host recreates its external resource on the new
+     * GPU device, it calls this method to repoint Babylon's wrapper at the new handle without losing references held
+     * by materials, render-target wrappers, particle systems, etc.
+     *
+     * The new GPUTexture must have the same dimensions as the original. To change dimensions, dispose the wrapped
+     * texture and call {@link wrapWebGPUTexture} again.
+     *
+     * Throws if the target was not produced by {@link wrapWebGPUTexture}, or if the new GPUTexture's dimensions don't
+     * match.
+     * @param internalTexture defines the wrapped InternalTexture to repoint
+     * @param texture defines the new GPUTexture to wrap
+     */
+    updateWrappedWebGPUTexture(internalTexture, texture) {
+        if (internalTexture.source !== 15 /* InternalTextureSource.External */) {
+            throw new Error("updateWrappedWebGPUTexture: target InternalTexture was not produced by wrapWebGPUTexture.");
+        }
+        if (texture.width !== internalTexture.baseWidth || texture.height !== internalTexture.baseHeight) {
+            throw new Error(`updateWrappedWebGPUTexture: new GPUTexture dimensions (${texture.width}x${texture.height}) must match the wrapped texture's dimensions (${internalTexture.baseWidth}x${internalTexture.baseHeight}).`);
+        }
+        // Reuse the existing WebGPUHardwareTexture rather than replacing it. The wrapper carries `textureUsages`,
+        // `format`, and the `view` / `viewForWriting` set up the first time the texture was bound; the views point
+        // at the old (now-destroyed) GPUTexture, so we swap the underlying resource and re-issue views via setUsage,
+        // which uses the InternalTexture's flags + dimensions to pick the right view dimension and recreate the views.
+        const hardwareTexture = internalTexture._hardwareTexture;
+        hardwareTexture.set(texture);
+        hardwareTexture.setUsage(15 /* InternalTextureSource.External */, internalTexture.generateMipMaps, internalTexture.is2DArray, internalTexture.isCube, internalTexture.is3D, texture.width, texture.height, internalTexture.depth);
+        internalTexture.isReady = true;
+        // WebGPUMaterialContext and WebGPUCacheBindGroups key on InternalTexture.uniqueId; bump it so caches detect
+        // the new resource and re-resolve bind groups against the new GPUTexture / GPUTextureView.
+        internalTexture._setUniqueId(InternalTexture._Counter++);
+    }
     // eslint-disable-next-line jsdoc/require-returns-check
     /**
      * Wraps an external web gl texture in a Babylon texture.
@@ -1898,6 +1937,12 @@ export class WebGPUEngine extends ThinWebGPUEngine {
     wrapWebGLTexture() {
         throw new Error("wrapWebGLTexture is not supported, use wrapWebGPUTexture instead.");
     }
+    /**
+     * Throws because the engine is WebGPU. Use {@link updateWrappedWebGPUTexture} instead.
+     */
+    updateWrappedWebGLTexture() {
+        throw new Error("updateWrappedWebGLTexture is not supported, use updateWrappedWebGPUTexture instead.");
+    }
     /**
      * @internal
      */