@onerjs/core 9.0.1 → 9.0.3

package/Materials/Textures/HTML/htmlTexture.js

@@ -6,6 +6,7 @@ import { Observable } from "../../../Misc/observable.pure.js";
 import { Logger } from "../../../Misc/logger.js";
 import { IsWindowObjectExist } from "../../../Misc/domManagement.js";
 import { RegisterEnginesExtensionsEngineDynamicTexture } from "../../../Engines/Extensions/engine.dynamicTexture.pure.js";
+import { _IsHtmlInCanvasPolyfillInstalled } from "./htmlInCanvasPolyfill.js";
 let _HasWarnedAboutMissingApi = false;
 function _WarnMissingApi(apiName) {
     if (_HasWarnedAboutMissingApi) {
@@ -29,7 +30,7 @@ function _WarnUploadFailure(error) {
     }
     _HasWarnedAboutUploadFailure = true;
     const message = error instanceof Error ? error.message : String(error);
-    Logger.Warn(`HTML-in-Canvas: the native upload failed (${message}). The element must be a direct child of the engine's rendering canvas, which must carry the \`layoutsubtree\` attribute, and the upload must run during a paint event.`);
+    Logger.Warn(`HTML-in-Canvas: the native upload failed (${message}). The element must be drawable inside the engine's rendering canvas with content="drawable" (or layoutsubtree on older implementations), and the first upload must wait for a paint event.`);
 }
 /**
  * Detects whether the engine can upload an HTML element through the native (or polyfilled) WICG
@@ -40,10 +41,10 @@ function _WarnUploadFailure(error) {
 export function IsHtmlInCanvasUploadSupported(engine) {
     if (engine.isWebGPU) {
         const queue = engine._device?.queue;
-        return !!queue && typeof queue.copyElementImageToTexture === "function";
+        return !!queue && (typeof queue.drawElementImageToTexture === "function" || typeof queue.copyElementImageToTexture === "function");
     }
     const gl = engine._gl;
-    return !!gl && typeof gl.texElementImage2D === "function";
+    return !!gl && (typeof gl.texElementSubImage2D === "function" || typeof gl.texElementImage2D === "function");
 }
 /**
  * Uploads a live HTML element (or a captured ElementImage) into an existing 2D texture using the WICG
@@ -51,9 +52,9 @@ export function IsHtmlInCanvasUploadSupported(engine) {
  *
  * This is a side-effect-free helper - it is only reachable when {@link HtmlTexture} (or a direct caller)
  * is imported, so it adds nothing to bundles that do not use it. It relies on
- * `WebGLRenderingContext.texElementImage2D` (WebGL) or `GPUQueue.copyElementImageToTexture` (WebGPU),
- * available either natively (behind chrome://flags/#canvas-draw-element) or through the
- * three-html-render polyfill.
+ * `WebGLRenderingContext.texElementSubImage2D` (WebGL) or `GPUQueue.drawElementImageToTexture` (WebGPU),
+ * with support for their older `texElementImage2D` / `copyElementImageToTexture` counterparts, including
+ * the three-html-render polyfill.
  * @param engine defines the engine that owns the texture
  * @param texture defines the internal texture to update
  * @param element defines the source HTML element (or captured ElementImage) to upload
@@ -70,13 +71,9 @@ export function UploadHtmlElementToTexture(engine, texture, element, invertY = t
     }
     return _UploadHtmlElementToWebGLTexture(engine, texture, element, invertY, config);
 }
-// The texElementImage2D signature was changed mid-flight in the WICG proposal (see
-// https://github.com/WICG/html-in-canvas#idl-changes): the current spec form is
-// texElementImage2D(target, internalformat, element, config?), but older Chrome Canary builds (and the
-// three-html-render polyfill) still ship the legacy texImage2D-shaped overload
-// texElementImage2D(target, level, internalformat, format, type, element). We prefer the new form and
-// fall back to the legacy one when the implementation rejects it for the wrong number of arguments. The
-// detected shape is cached so we only pay the failed call once.
+// Before texElementSubImage2D, the proposal used two incompatible texElementImage2D signatures.
+// Prefer the shorter form and fall back to the texImage2D-shaped overload used by older Chrome builds
+// and three-html-render when the implementation rejects the argument count.
 let _UseLegacyTexElementImage2D = false;
 function _CallTexElementImage2D(gl, internalFormat, element, config) {
     if (!_UseLegacyTexElementImage2D) {
@@ -99,45 +96,55 @@ function _CallTexElementImage2D(gl, internalFormat, element, config) {
     gl.texElementImage2D(gl.TEXTURE_2D, 0, internalFormat, gl.RGBA, gl.UNSIGNED_BYTE, element);
 }
 function _UploadHtmlElementToWebGLTexture(engine, texture, element, invertY, config) {
-    // texElementImage2D is provided either natively (behind a flag) or by the three-html-render polyfill.
     // Engines without a WebGL context (e.g. NullEngine) have no _gl and are handled by this guard.
     const gl = engine._gl;
-    if (!gl || typeof gl.texElementImage2D !== "function") {
-        _WarnMissingApi("texElementImage2D");
+    if (!gl || (typeof gl.texElementSubImage2D !== "function" && typeof gl.texElementImage2D !== "function")) {
+        _WarnMissingApi("texElementSubImage2D / texElementImage2D");
         return false;
     }
     // texElementImage2D requires a *sized* internal format (RGBA8, SRGB8_ALPHA8, RGBA16F or RGBA32F);
     // the unsized gl.RGBA returned by _getInternalFormat is rejected.
-    const internalFormat = engine._getRGBABufferInternalSizedFormat(texture.type, texture.format, texture._useSRGBBuffer);
+    const type = texture.type === -1 ? 0 : texture.type;
+    const internalFormat = engine._getRGBABufferInternalSizedFormat(type, texture.format, texture._useSRGBBuffer);
     const wasPreviouslyBound = engine._bindTextureDirectly(gl.TEXTURE_2D, texture, true);
     engine._unpackFlipY(invertY);
     try {
-        _CallTexElementImage2D(gl, internalFormat, element, config);
+        if (typeof gl.texElementSubImage2D === "function" && !(_IsHtmlInCanvasPolyfillInstalled() && typeof gl.texElementImage2D === "function")) {
+            // Unlike texElementImage2D, the current API updates existing storage rather than defining it.
+            if (!texture.isReady) {
+                gl.texImage2D(gl.TEXTURE_2D, 0, internalFormat, texture.width, texture.height, 0, engine._getInternalFormat(texture.format), engine._getWebGLTextureType(type), null);
+            }
+            gl.texElementSubImage2D(gl.TEXTURE_2D, 0, 0, 0, element, config ?? { width: texture.width, height: texture.height });
+        }
+        else {
+            _CallTexElementImage2D(gl, internalFormat, element, config);
+        }
         if (texture.generateMipMaps) {
             gl.generateMipmap(gl.TEXTURE_2D);
         }
-        if (!wasPreviouslyBound) {
-            engine._bindTextureDirectly(gl.TEXTURE_2D, null);
-        }
         texture.invertY = invertY;
         texture.isReady = true;
         return true;
     }
     catch (error) {
         // Reaching here means the snapshot upload failed - usually a real misconfiguration (the element is
-        // not a child of the rendering canvas, or `layoutsubtree` is missing), though a stray call before
+        // not drawable in the rendering canvas), though a stray call before
         // the first paint snapshot can also throw. Either way we must NOT disable the texture, so a later
         // paint-driven update can still succeed; we surface a one-time diagnostic to help debugging.
         _WarnUploadFailure(error);
         return false;
     }
+    finally {
+        if (!wasPreviouslyBound) {
+            engine._bindTextureDirectly(gl.TEXTURE_2D, null);
+        }
+    }
 }
 function _UploadHtmlElementToWebGPUTexture(engine, texture, element, invertY, config) {
-    // copyElementImageToTexture is provided either natively (behind a flag) or by the three-html-render polyfill.
     const device = engine._device;
     const queue = device && device.queue;
-    if (!device || !queue || typeof queue.copyElementImageToTexture !== "function") {
-        _WarnMissingApi("GPUQueue.copyElementImageToTexture");
+    if (!device || !queue || (typeof queue.drawElementImageToTexture !== "function" && typeof queue.copyElementImageToTexture !== "function")) {
+        _WarnMissingApi("GPUQueue.drawElementImageToTexture / GPUQueue.copyElementImageToTexture");
         return false;
     }
     const gpuTexture = texture._hardwareTexture?.underlyingResource;
@@ -145,22 +152,40 @@ function _UploadHtmlElementToWebGPUTexture(engine, texture, element, invertY, co
         return false;
     }
     try {
-        const source = { source: element };
-        if (config) {
-            source.sx = config.sx;
-            source.sy = config.sy;
-            source.swidth = config.swidth;
-            source.sheight = config.sheight;
+        if (_IsHtmlInCanvasPolyfillInstalled() && typeof queue.copyElementImageToTexture === "function") {
+            queue.copyElementImageToTexture(element, config?.width ?? texture.width, config?.height ?? texture.height, { texture: gpuTexture });
+        }
+        else if (typeof queue.drawElementImageToTexture === "function") {
+            const source = { source: element };
+            if (config) {
+                source.sourceX = config.sx;
+                source.sourceY = config.sy;
+                source.sourceWidth = config.swidth;
+                source.sourceHeight = config.sheight;
+            }
+            queue.drawElementImageToTexture(source, {
+                texture: gpuTexture,
+                size: { width: config?.width ?? texture.width, height: config?.height ?? texture.height },
+            });
+        }
+        else {
+            const source = { source: element };
+            if (config) {
+                source.sx = config.sx;
+                source.sy = config.sy;
+                source.swidth = config.swidth;
+                source.sheight = config.sheight;
+            }
+            queue.copyElementImageToTexture(source, {
+                destination: { texture: gpuTexture },
+                width: config?.width ?? texture.width,
+                height: config?.height ?? texture.height,
+            });
         }
-        queue.copyElementImageToTexture(source, {
-            destination: { texture: gpuTexture },
-            width: config?.width ?? texture.width,
-            height: config?.height ?? texture.height,
-        });
         if (texture.generateMipMaps) {
             engine._generateMipmaps(texture);
         }
-        // The WICG copyElementImageToTexture API has no flipY option; the destination orientation is
+        // The WICG element upload APIs have no flipY option; the destination orientation is
         // determined by the source. We record the requested value for downstream sampling conventions.
         texture.invertY = invertY;
         texture.isReady = true;
@@ -168,7 +193,7 @@ function _UploadHtmlElementToWebGPUTexture(engine, texture, element, invertY, co
     }
     catch (error) {
         // Reaching here means the snapshot upload failed - usually a real misconfiguration (the element is
-        // not a child of the rendering canvas, or `layoutsubtree` is missing), though a stray call before
+        // not drawable in the rendering canvas), though a stray call before
         // the first paint snapshot can also throw. Either way we must NOT disable the texture, so a later
         // paint-driven update can still succeed; we surface a one-time diagnostic to help debugging.
         _WarnUploadFailure(error);
@@ -179,11 +204,10 @@ function _UploadHtmlElementToWebGPUTexture(engine, texture, element, invertY, co
  * A texture whose content is rendered from a live HTML element using the WICG HTML-in-Canvas API
  * (https://github.com/WICG/html-in-canvas).
  *
- * The element is hosted as a child of the engine's rendering canvas (which is marked `layoutsubtree`) so
- * the browser can lay it out and snapshot it; the WICG API requires the source element to be a direct
- * child of the canvas whose context performs the upload. Content is uploaded through
- * `WebGLRenderingContext.texElementImage2D` (WebGL) or `GPUQueue.copyElementImageToTexture` (WebGPU),
- * available either natively (behind chrome://flags/#canvas-draw-element) or via the three-html-render
+ * The element is hosted as a drawable child of the engine's rendering canvas (marked `content="drawable"`,
+ * or `layoutsubtree` on older implementations) so the browser can lay it out and snapshot it.
+ * Content is uploaded through `WebGLRenderingContext.texElementSubImage2D` (WebGL) or
+ * `GPUQueue.drawElementImageToTexture` (WebGPU), with support for older browsers and the three-html-render
  * polyfill (https://github.com/repalash/three-html-render). When neither is present, a built-in SVG
  * `<foreignObject>` fallback is used instead (see `useSvgFallback`).
  *
@@ -208,6 +232,8 @@ export class HtmlTexture extends BaseTexture {
         this._originalParent = null;
         this._originalNextSibling = null;
         this._addedInert = false;
+        this._addedDrawable = false;
+        this._updateRequested = false;
         this.element = element;
         this._textureMatrix = Matrix.Identity();
         if (!element || (!options.engine && !options.scene)) {
@@ -232,23 +258,23 @@ export class HtmlTexture extends BaseTexture {
         this.wrapV = 0;
         this.anisotropicFilteringLevel = 1;
         this.host = this._createHost();
-        // The native WICG API has no content until the first paint snapshot is recorded, so the initial
-        // upload must happen from a paint event. The rendering canvas emits `paint`; listen for at least the
-        // first one and, when auto-update is disabled, detach after that first refresh. A non-canvas helper
-        // host never emits `paint`, so this listener is simply never invoked there.
+        // Native uploads need an initial paint snapshot. Keep the listener for explicit requests even when
+        // auto-update is disabled; helper div hosts never emit paint.
         if (this.host) {
+            let hasPainted = false;
             this._paintHandler = (event) => {
                 // A single `paint` event covers every changed child of the shared rendering canvas. When the
                 // browser reports which elements changed, skip the upload unless ours is among them, so that
                 // multiple HTML textures hosted on the same canvas don't all re-upload on every unrelated change.
-                if (event.changedElements && !event.changedElements.some((changed) => this.element === changed || this.element.contains(changed))) {
+                if (!autoUpdate && !this._updateRequested && hasPainted) {
                     return;
                 }
-                this.update();
-                if (!autoUpdate && this._paintHandler && this.host) {
-                    this.host.removeEventListener("paint", this._paintHandler);
-                    this._paintHandler = null;
+                if (!this._updateRequested && event.changedElements && !event.changedElements.some((changed) => this.element === changed || this.element.contains(changed))) {
+                    return;
                 }
+                this._updateRequested = false;
+                hasPainted = true;
+                this.update();
             };
             this.host.addEventListener("paint", this._paintHandler);
         }
@@ -262,15 +288,21 @@ export class HtmlTexture extends BaseTexture {
         // into the host (the element must be a direct child of the host to be captured and laid out).
         this._originalParent = this.element.parentNode;
         this._originalNextSibling = this.element.nextSibling;
-        // Per the WICG spec, the source element must be a *direct child* of the same canvas whose WebGL/WebGPU
-        // context performs the upload, and that canvas must opt its subtree into layout via `layoutsubtree`.
-        // The engine already owns our texture through its rendering canvas, so the element has to live inside
-        // that canvas: it is the only one whose context can snapshot the element via texElementImage2D /
-        // copyElementImageToTexture. A separate canvas would lay the element out but could never be captured
-        // into the engine's texture (this is why nothing rendered on the native path before).
+        // Older WICG implementations require a direct canvas child; current implementations require a
+        // drawable descendant and content="drawable" on the same canvas whose context performs the upload.
+        // A separate canvas cannot supply snapshots to the engine's context.
         const renderingCanvas = this._getEngine()?.getRenderingCanvas() ?? null;
         if (renderingCanvas) {
-            renderingCanvas.layoutSubtree = true;
+            if (typeof renderingCanvas.content === "string" && !_IsHtmlInCanvasPolyfillInstalled()) {
+                renderingCanvas.content = "drawable";
+                this._addedDrawable = !this.element.hasAttribute("drawable");
+                if (this._addedDrawable) {
+                    this.element.setAttribute("drawable", "");
+                }
+            }
+            else {
+                renderingCanvas.layoutSubtree = true;
+            }
             // `layoutsubtree` opts children into hit testing; mark ours inert so it never steals pointer events
             // from the canvas (e.g. camera controls). Synthetic event dispatch still reaches inert elements, so
             // HtmlRaycastInteractionManager keeps working; HtmlInteractionManager clears it to enable native input.
@@ -316,15 +348,16 @@ export class HtmlTexture extends BaseTexture {
         return this._textureMatrix;
     }
     /**
-     * Requests the host canvas to emit a paint event on the next rendering update. When auto-update is
-     * enabled, this triggers a texture refresh in sync with the DOM. Falls back to an immediate update
-     * when the WICG API is not available.
+     * Requests a texture refresh in sync with the host canvas's next paint event, even when auto-update is
+     * disabled. Updates immediately when the engine's WICG upload API is not available.
      */
     requestUpdate() {
-        // `requestPaint` only exists on a WICG-capable rendering canvas; the helper <div> host has no such
-        // method, so fall back to an immediate update there.
+        // A browser can expose requestPaint without an upload API supported by this engine. In that case
+        // do not wait for native paint: update() must still reach the SVG fallback or the missing-API warning.
+        const engine = this._getEngine();
         const canvasHost = this.host;
-        if (canvasHost && typeof canvasHost.requestPaint === "function") {
+        if (engine && IsHtmlInCanvasUploadSupported(engine) && canvasHost && typeof canvasHost.requestPaint === "function") {
+            this._updateRequested = true;
             canvasHost.requestPaint();
         }
         else {
@@ -427,6 +460,14 @@ export class HtmlTexture extends BaseTexture {
                 this.element.removeAttribute("inert");
                 this._addedInert = false;
             }
+            if (this._addedDrawable) {
+                this.element.removeAttribute("drawable");
+                this._addedDrawable = false;
+            }
+            // The polyfill redirects children into a helper host and tracks removals through this API.
+            if (this.element.parentNode === this.host) {
+                this.host.removeChild(this.element);
+            }
             // Restore the element to where the caller had it before we re-parented it into the host, rather
             // than silently deleting their node from the document.
             if (this._originalParent) {

package/Materials/Textures/HTML/htmlTexture.js.map

@@ -1 +1 @@
-{"version":3,"file":"htmlTexture.js","sourceRoot":"","sources":["../../../../../../dev/core/src/Materials/Textures/HTML/htmlTexture.ts"],"names":[],"mappings":"AAAA,8HAA8H;AAG9H,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,6CAA6C,EAAE,MAAM,wDAAwD,CAAC;AASvH,IAAI,yBAAyB,GAAG,KAAK,CAAC;AAEtC,SAAS,eAAe,CAAC,OAAe;IACpC,IAAI,yBAAyB,EAAE,CAAC;QAC5B,OAAO;IACX,CAAC;IACD,yBAAyB,GAAG,IAAI,CAAC;IACjC,MAAM,CAAC,IAAI,CACP,mBAAmB,OAAO,iJAAiJ,CAC9K,CAAC;AACN,CAAC;AAED,IAAI,0BAA0B,GAAG,KAAK,CAAC;AAEvC,SAAS,gBAAgB;IACrB,IAAI,0BAA0B,EAAE,CAAC;QAC7B,OAAO;IACX,CAAC;IACD,0BAA0B,GAAG,IAAI,CAAC;IAClC,MAAM,CAAC,IAAI,CAAC,kKAAkK,CAAC,CAAC;AACpL,CAAC;AAED,IAAI,4BAA4B,GAAG,KAAK,CAAC;AAEzC,SAAS,kBAAkB,CAAC,KAAc;IACtC,IAAI,4BAA4B,EAAE,CAAC;QAC/B,OAAO;IACX,CAAC;IACD,4BAA4B,GAAG,IAAI,CAAC;IACpC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,CAAC,IAAI,CACP,6CAA6C,OAAO,yKAAyK,CAChO,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAAsB;IAChE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,KAAK,GAAI,MAAuB,CAAC,OAAO,EAAE,KAAK,CAAC;QACtD,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,yBAAyB,KAAK,UAAU,CAAC;IAC5E,CAAC;IAED,MAAM,EAAE,GAAI,MAAqB,CAAC,GAAuC,CAAC;IAC1E,OAAO,CAAC,CAAC,EAAE,IAAI,OAAO,EAAE,CAAC,iBAAiB,KAAK,UAAU,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,0BAA0B,CACtC,MAAsB,EACtB,OAAkC,EAClC,OAA+B,EAC/B,UAAmB,IAAI,EACvB,MAAoC;IAEpC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAClB,OAAO,iCAAiC,CAAC,MAAsB,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACxG,CAAC;IAED,OAAO,gCAAgC,CAAC,MAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACrG,CAAC;AAED,mFAAmF;AACnF,gFAAgF;AAChF,uGAAuG;AACvG,+EAA+E;AAC/E,sGAAsG;AACtG,wGAAwG;AACxG,gEAAgE;AAChE,IAAI,2BAA2B,GAAG,KAAK,CAAC;AAExC,SAAS,sBAAsB,CAAC,EAA0B,EAAE,cAAsB,EAAE,OAA+B,EAAE,MAAoC;IACrJ,IAAI,CAAC,2BAA2B,EAAE,CAAC;QAC/B,IAAI,CAAC;YACD,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACrE,OAAO;QACX,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,2FAA2F;YAC3F,2FAA2F;YAC3F,mFAAmF;YACnF,4EAA4E;YAC5E,IAAI,CAAC,CAAC,KAAK,YAAY,SAAS,CAAC,IAAI,CAAC,mCAAmC,CAAC,IAAI,CAAE,KAAe,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvG,MAAM,KAAK,CAAC;YAChB,CAAC;YACD,2BAA2B,GAAG,IAAI,CAAC;QACvC,CAAC;IACL,CAAC;IAED,4FAA4F;IAC5F,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AAC/F,CAAC;AAED,SAAS,gCAAgC,CACrC,MAAkB,EAClB,OAAwB,EACxB,OAA+B,EAC/B,OAAgB,EAChB,MAAoC;IAEpC,sGAAsG;IACtG,+FAA+F;IAC/F,MAAM,EAAE,GAAG,MAAM,CAAC,GAAuC,CAAC;IAC1D,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;QACpD,eAAe,CAAC,mBAAmB,CAAC,CAAC;QACrC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,kGAAkG;IAClG,kEAAkE;IAClE,MAAM,cAAc,GAAG,MAAM,CAAC,iCAAiC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACtH,MAAM,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACrF,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAE7B,IAAI,CAAC;QACD,sBAAsB,CAAC,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE5D,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC1B,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACtB,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;QAC1B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,mGAAmG;QACnG,kGAAkG;QAClG,kGAAkG;QAClG,6FAA6F;QAC7F,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,SAAS,iCAAiC,CACtC,MAAoB,EACpB,OAAwB,EACxB,OAA+B,EAC/B,OAAgB,EAChB,MAAoC;IAEpC,8GAA8G;IAC9G,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC;IACrC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,yBAAyB,KAAK,UAAU,EAAE,CAAC;QAC7E,eAAe,CAAC,oCAAoC,CAAC,CAAC;QACtD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,UAAU,GAAI,OAAO,CAAC,gBAAoD,EAAE,kBAAkB,CAAC;IACrG,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACD,MAAM,MAAM,GAA8B,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC9D,IAAI,MAAM,EAAE,CAAC;YACT,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC9B,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,yBAAyB,CAAC,MAAM,EAAE;YACpC,WAAW,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE;YACpC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK;YACrC,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM;SAC3C,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC1B,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QAED,6FAA6F;QAC7F,+FAA+F;QAC/F,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;QAC1B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,mGAAmG;QACnG,kGAAkG;QAClG,kGAAkG;QAClG,6FAA6F;QAC7F,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AA8BD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAuCxC;;;;;OAKG;IACH,YAAY,IAAY,EAAE,OAAoB,EAAE,OAA4B;QACxE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;QAjC3C;;WAEG;QACI,qBAAgB,GAA4B,IAAI,UAAU,EAAe,CAAC;QAezE,kBAAa,GAA0C,IAAI,CAAC;QAC5D,cAAS,GAAY,KAAK,CAAC;QAC3B,oBAAe,GAAgC,IAAI,CAAC;QACpD,yBAAoB,GAAwB,IAAI,CAAC;QACjD,gBAAW,GAAY,KAAK,CAAC;QAajC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAExC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YAChB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;YACjB,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC;YAClD,IAAI,CAAC,gBAAgB,GAAG,WAAW,CAAC,eAAe,CAAC,eAAe,CAAC;YACpE,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC;YAC9D,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,eAAe,CAAC,cAAc,CAAC;YAClE,OAAO;QACX,CAAC;QAED,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,eAAe,IAAI,WAAW,CAAC,eAAe,CAAC,eAAe,CAAC;QAC/F,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,YAAY,IAAI,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC;QACtF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC;QACpE,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,cAAc,IAAI,WAAW,CAAC,eAAe,CAAC,cAAc,CAAC;QAC5F,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC;QAEhF,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC;QAC1D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,YAAY,IAAI,GAAG,CAAC;QAE7D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,yBAAyB,CAAC;QACjD,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,yBAAyB,CAAC;QACjD,IAAI,CAAC,yBAAyB,GAAG,CAAC,CAAC;QAEnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAE/B,gGAAgG;QAChG,qGAAqG;QACrG,oGAAoG;QACpG,4EAA4E;QAC5E,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,aAAa,GAAG,CAAC,KAAiB,EAAE,EAAE;gBACvC,6FAA6F;gBAC7F,6FAA6F;gBAC7F,kGAAkG;gBAClG,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;oBAChI,OAAO;gBACX,CAAC;gBACD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACd,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACjD,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,aAA8B,CAAC,CAAC;oBAC5E,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;gBAC9B,CAAC;YACL,CAAC,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,aAA8B,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,CAAC,sBAAsB,EAAE,CAAC;IAClC,CAAC;IAEO,WAAW;QACf,IAAI,CAAC,mBAAmB,EAAE,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC5D,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,uGAAuG;QACvG,8FAA8F;QAC9F,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QAC/C,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QAErD,uGAAuG;QACvG,qGAAqG;QACrG,sGAAsG;QACtG,iGAAiG;QACjG,qGAAqG;QACrG,sFAAsF;QACtF,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,kBAAkB,EAAE,IAAI,IAAI,CAAC;QACxE,IAAI,eAAe,EAAE,CAAC;YAClB,eAAe,CAAC,aAAa,GAAG,IAAI,CAAC;YACrC,oGAAoG;YACpG,oGAAoG;YACpG,wGAAwG;YACxG,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YACvD,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACvC,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,OAAO,eAAe,CAAC;QAC3B,CAAC;QAED,sGAAsG;QACtG,wGAAwG;QACxG,yGAAyG;QACzG,kGAAkG;QAClG,4EAA4E;QAC5E,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC;QAClC,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAEzC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,OAAO,IAAI,CAAC;IAChB,CAAC;IAEO,sBAAsB;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,IAAI,MAAM,EAAE,CAAC;YACT,oIAAoI;YACpI,6CAA6C,EAAE,CAAC;YAChD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAClH,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QACxC,CAAC;QAED,mGAAmG;QACnG,gGAAgG;QAChG,yDAAyD;QACzD,IAAI,CAAC,aAAa,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACa,gBAAgB;QAC5B,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACI,aAAa;QAChB,mGAAmG;QACnG,qDAAqD;QACrD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAmC,CAAC;QAC5D,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;YAC9D,UAAU,CAAC,YAAY,EAAE,CAAC;QAC9B,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,MAAM,EAAE,CAAC;QAClB,CAAC;IACL,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,UAAmB,IAAI;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YAC1C,OAAO;QACX,CAAC;QAED,kGAAkG;QAClG,iGAAiG;QACjG,IAAI,IAAI,CAAC,eAAe,IAAI,CAAC,6BAA6B,CAAC,MAAM,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAEhC,0BAA0B,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEzE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9B,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACK,sBAAsB,CAAC,MAAsB,EAAE,OAAgB;QACnE,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,OAAO,KAAK,KAAK,WAAW,IAAI,OAAO,aAAa,KAAK,WAAW,EAAE,CAAC;YAC1G,OAAO;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO;QACX,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;QAC1B,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE;YAChB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;gBACxB,OAAO;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,IAAI,CAAC;gBACD,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACpF,CAAC;YAAC,MAAM,CAAC;gBACL,gBAAgB,EAAE,CAAC;gBACnB,OAAO;YACX,CAAC;YACD,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC9B,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAChD,CAAC;QACL,CAAC,CAAC;QACF,KAAK,CAAC,OAAO,GAAG,GAAG,EAAE;YACjB,gBAAgB,EAAE,CAAC;QACvB,CAAC,CAAC;QACF,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;OAGG;IACK,gBAAgB;QACpB,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAgB,CAAC;YAC1D,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,8BAA8B,CAAC,CAAC;YAC5D,MAAM,UAAU,GAAG,IAAI,aAAa,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAChE,MAAM,GAAG,GACL,kDAAkD,IAAI,CAAC,MAAM,aAAa,IAAI,CAAC,OAAO,IAAI;gBAC1F,yDAAyD,UAAU,kBAAkB;gBACrF,QAAQ,CAAC;YACb,OAAO,oCAAoC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;;OAGG;IACa,YAAY;QACxB,OAAO,aAAa,CAAC;IACzB,CAAC;IAED;;OAEG;IACa,OAAO;QACnB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,aAA8B,CAAC,CAAC;gBAC5E,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC9B,CAAC;YACD,+FAA+F;YAC/F,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACnB,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBACtC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YAC7B,CAAC;YACD,gGAAgG;YAChG,uDAAuD;YACvD,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,oBAAoB,CAAC,UAAU,KAAK,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC;gBAChJ,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,CAAC;YACD,oFAAoF;YACpF,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACjB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,CAAC;QACL,CAAC;QAED,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAC9B,KAAK,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC;;AAnSuB,2BAAe,GAAyH;IAC5J,eAAe,EAAE,KAAK;IACtB,YAAY,EAAE,SAAS,CAAC,6BAA6B;IACrD,MAAM,EAAE,SAAS,CAAC,kBAAkB;IACpC,UAAU,EAAE,IAAI;IAChB,cAAc,EAAE,IAAI;CACvB,AANsC,CAMrC","sourcesContent":["/** This module has no top-level side effects: the engine extension it depends on is registered lazily from the constructor */\n\nimport { type Nullable } from \"../../../types\";\nimport { BaseTexture } from \"../baseTexture.pure\";\nimport { Constants } from \"../../../Engines/constants\";\nimport { Matrix } from \"../../../Maths/math.vector.pure\";\nimport { Observable } from \"../../../Misc/observable.pure\";\nimport { Logger } from \"../../../Misc/logger\";\nimport { IsWindowObjectExist } from \"../../../Misc/domManagement\";\nimport { RegisterEnginesExtensionsEngineDynamicTexture } from \"../../../Engines/Extensions/engine.dynamicTexture.pure\";\n\nimport { type AbstractEngine } from \"../../../Engines/abstractEngine.pure\";\nimport { type ThinEngine } from \"../../../Engines/thinEngine.pure\";\nimport { type WebGPUEngine } from \"../../../Engines/webgpuEngine.pure\";\nimport { type WebGPUHardwareTexture } from \"../../../Engines/WebGPU/webgpuHardwareTexture\";\nimport { type InternalTexture } from \"../internalTexture\";\nimport { type Scene } from \"../../../scene.pure\";\n\nlet _HasWarnedAboutMissingApi = false;\n\nfunction _WarnMissingApi(apiName: string): void {\n    if (_HasWarnedAboutMissingApi) {\n        return;\n    }\n    _HasWarnedAboutMissingApi = true;\n    Logger.Warn(\n        `HTML-in-Canvas: ${apiName} is not available. Enable chrome://flags/#canvas-draw-element, the built-in SVG fallback, or the three-html-render polyfill to use HtmlTexture.`\n    );\n}\n\nlet _HasWarnedAboutSvgFallback = false;\n\nfunction _WarnSvgFallback(): void {\n    if (_HasWarnedAboutSvgFallback) {\n        return;\n    }\n    _HasWarnedAboutSvgFallback = true;\n    Logger.Warn(\"HTML-in-Canvas: the SVG fallback could not rasterize the element. This usually means it references cross-origin or external resources, which taint the snapshot.\");\n}\n\nlet _HasWarnedAboutUploadFailure = false;\n\nfunction _WarnUploadFailure(error: unknown): void {\n    if (_HasWarnedAboutUploadFailure) {\n        return;\n    }\n    _HasWarnedAboutUploadFailure = true;\n    const message = error instanceof Error ? error.message : String(error);\n    Logger.Warn(\n        `HTML-in-Canvas: the native upload failed (${message}). The element must be a direct child of the engine's rendering canvas, which must carry the \\`layoutsubtree\\` attribute, and the upload must run during a paint event.`\n    );\n}\n\n/**\n * Detects whether the engine can upload an HTML element through the native (or polyfilled) WICG\n * HTML-in-Canvas API, without emitting any warning. Used to decide whether the SVG fallback is needed.\n * @param engine defines the engine to test\n * @returns true when the WICG upload API is available for this engine\n */\nexport function IsHtmlInCanvasUploadSupported(engine: AbstractEngine): boolean {\n    if (engine.isWebGPU) {\n        const queue = (engine as WebGPUEngine)._device?.queue;\n        return !!queue && typeof queue.copyElementImageToTexture === \"function\";\n    }\n\n    const gl = (engine as ThinEngine)._gl as Nullable<WebGL2RenderingContext>;\n    return !!gl && typeof gl.texElementImage2D === \"function\";\n}\n\n/**\n * Uploads a live HTML element (or a captured ElementImage) into an existing 2D texture using the WICG\n * HTML-in-Canvas API (https://github.com/WICG/html-in-canvas).\n *\n * This is a side-effect-free helper - it is only reachable when {@link HtmlTexture} (or a direct caller)\n * is imported, so it adds nothing to bundles that do not use it. It relies on\n * `WebGLRenderingContext.texElementImage2D` (WebGL) or `GPUQueue.copyElementImageToTexture` (WebGPU),\n * available either natively (behind chrome://flags/#canvas-draw-element) or through the\n * three-html-render polyfill.\n * @param engine defines the engine that owns the texture\n * @param texture defines the internal texture to update\n * @param element defines the source HTML element (or captured ElementImage) to upload\n * @param invertY defines if data must be stored with Y axis inverted (true by default)\n * @param config defines an optional source rectangle and sizing configuration\n * @returns true if the upload succeeded, false otherwise (e.g. the API is unavailable)\n */\nexport function UploadHtmlElementToTexture(\n    engine: AbstractEngine,\n    texture: Nullable<InternalTexture>,\n    element: Element | ElementImage,\n    invertY: boolean = true,\n    config?: WebGLCopyElementImageConfig\n): boolean {\n    if (!texture || texture._isDisabled) {\n        return false;\n    }\n\n    if (engine.isWebGPU) {\n        return _UploadHtmlElementToWebGPUTexture(engine as WebGPUEngine, texture, element, invertY, config);\n    }\n\n    return _UploadHtmlElementToWebGLTexture(engine as ThinEngine, texture, element, invertY, config);\n}\n\n// The texElementImage2D signature was changed mid-flight in the WICG proposal (see\n// https://github.com/WICG/html-in-canvas#idl-changes): the current spec form is\n// texElementImage2D(target, internalformat, element, config?), but older Chrome Canary builds (and the\n// three-html-render polyfill) still ship the legacy texImage2D-shaped overload\n// texElementImage2D(target, level, internalformat, format, type, element). We prefer the new form and\n// fall back to the legacy one when the implementation rejects it for the wrong number of arguments. The\n// detected shape is cached so we only pay the failed call once.\nlet _UseLegacyTexElementImage2D = false;\n\nfunction _CallTexElementImage2D(gl: WebGL2RenderingContext, internalFormat: number, element: Element | ElementImage, config?: WebGLCopyElementImageConfig): void {\n    if (!_UseLegacyTexElementImage2D) {\n        try {\n            gl.texElementImage2D(gl.TEXTURE_2D, internalFormat, element, config);\n            return;\n        } catch (error) {\n            // Only a wrong-arity TypeError means we are talking to the legacy signature; anything else\n            // (e.g. the element is not a canvas child) is a genuine upload failure and must propagate.\n            // Native rejects the new form with \"N arguments required, but only M present\"; the\n            // three-html-render polyfill rejects it with \"unexpected argument count N\".\n            if (!(error instanceof TypeError) || !/arguments required|argument count/.test((error as Error).message)) {\n                throw error;\n            }\n            _UseLegacyTexElementImage2D = true;\n        }\n    }\n\n    // Legacy overload: texElementImage2D(target, level, internalformat, format, type, element).\n    gl.texElementImage2D(gl.TEXTURE_2D, 0, internalFormat, gl.RGBA, gl.UNSIGNED_BYTE, element);\n}\n\nfunction _UploadHtmlElementToWebGLTexture(\n    engine: ThinEngine,\n    texture: InternalTexture,\n    element: Element | ElementImage,\n    invertY: boolean,\n    config?: WebGLCopyElementImageConfig\n): boolean {\n    // texElementImage2D is provided either natively (behind a flag) or by the three-html-render polyfill.\n    // Engines without a WebGL context (e.g. NullEngine) have no _gl and are handled by this guard.\n    const gl = engine._gl as Nullable<WebGL2RenderingContext>;\n    if (!gl || typeof gl.texElementImage2D !== \"function\") {\n        _WarnMissingApi(\"texElementImage2D\");\n        return false;\n    }\n\n    // texElementImage2D requires a *sized* internal format (RGBA8, SRGB8_ALPHA8, RGBA16F or RGBA32F);\n    // the unsized gl.RGBA returned by _getInternalFormat is rejected.\n    const internalFormat = engine._getRGBABufferInternalSizedFormat(texture.type, texture.format, texture._useSRGBBuffer);\n    const wasPreviouslyBound = engine._bindTextureDirectly(gl.TEXTURE_2D, texture, true);\n    engine._unpackFlipY(invertY);\n\n    try {\n        _CallTexElementImage2D(gl, internalFormat, element, config);\n\n        if (texture.generateMipMaps) {\n            gl.generateMipmap(gl.TEXTURE_2D);\n        }\n\n        if (!wasPreviouslyBound) {\n            engine._bindTextureDirectly(gl.TEXTURE_2D, null);\n        }\n\n        texture.invertY = invertY;\n        texture.isReady = true;\n        return true;\n    } catch (error) {\n        // Reaching here means the snapshot upload failed - usually a real misconfiguration (the element is\n        // not a child of the rendering canvas, or `layoutsubtree` is missing), though a stray call before\n        // the first paint snapshot can also throw. Either way we must NOT disable the texture, so a later\n        // paint-driven update can still succeed; we surface a one-time diagnostic to help debugging.\n        _WarnUploadFailure(error);\n        return false;\n    }\n}\n\nfunction _UploadHtmlElementToWebGPUTexture(\n    engine: WebGPUEngine,\n    texture: InternalTexture,\n    element: Element | ElementImage,\n    invertY: boolean,\n    config?: WebGLCopyElementImageConfig\n): boolean {\n    // copyElementImageToTexture is provided either natively (behind a flag) or by the three-html-render polyfill.\n    const device = engine._device;\n    const queue = device && device.queue;\n    if (!device || !queue || typeof queue.copyElementImageToTexture !== \"function\") {\n        _WarnMissingApi(\"GPUQueue.copyElementImageToTexture\");\n        return false;\n    }\n\n    const gpuTexture = (texture._hardwareTexture as Nullable<WebGPUHardwareTexture>)?.underlyingResource;\n    if (!gpuTexture) {\n        return false;\n    }\n\n    try {\n        const source: GPUCopyElementImageSource = { source: element };\n        if (config) {\n            source.sx = config.sx;\n            source.sy = config.sy;\n            source.swidth = config.swidth;\n            source.sheight = config.sheight;\n        }\n\n        queue.copyElementImageToTexture(source, {\n            destination: { texture: gpuTexture },\n            width: config?.width ?? texture.width,\n            height: config?.height ?? texture.height,\n        });\n\n        if (texture.generateMipMaps) {\n            engine._generateMipmaps(texture);\n        }\n\n        // The WICG copyElementImageToTexture API has no flipY option; the destination orientation is\n        // determined by the source. We record the requested value for downstream sampling conventions.\n        texture.invertY = invertY;\n        texture.isReady = true;\n        return true;\n    } catch (error) {\n        // Reaching here means the snapshot upload failed - usually a real misconfiguration (the element is\n        // not a child of the rendering canvas, or `layoutsubtree` is missing), though a stray call before\n        // the first paint snapshot can also throw. Either way we must NOT disable the texture, so a later\n        // paint-driven update can still succeed; we surface a one-time diagnostic to help debugging.\n        _WarnUploadFailure(error);\n        return false;\n    }\n}\n\n/**\n * Defines the options used to create an {@link HtmlTexture}.\n */\nexport interface IHtmlTextureOptions {\n    /** Defines the width of the texture in pixels (defaults to the element's offset width, then 256). */\n    width?: number;\n    /** Defines the height of the texture in pixels (defaults to the element's offset height, then 256). */\n    height?: number;\n    /** Defines whether mip maps should be created or not (default: false). */\n    generateMipMaps?: boolean;\n    /** Defines the sampling mode of the texture (default: TEXTURE_BILINEAR_SAMPLINGMODE). */\n    samplingMode?: number;\n    /** Defines the associated texture format (default: TEXTUREFORMAT_RGBA). */\n    format?: number;\n    /** Defines whether the texture is automatically updated when the host canvas emits a paint event (default: true). */\n    autoUpdate?: boolean;\n    /**\n     * Defines whether to fall back to an SVG `<foreignObject>` rasterization when the native WICG\n     * HTML-in-Canvas API is unavailable (default: true). The fallback works in any browser but only\n     * captures same-origin, inline-styled content as a static snapshot (see the documentation for caveats).\n     */\n    useSvgFallback?: boolean;\n    /** Defines the engine instance to use the texture with. Not mandatory if a scene is provided. */\n    engine?: Nullable<AbstractEngine>;\n    /** Defines the scene the texture belongs to. Not mandatory if an engine is provided. */\n    scene?: Nullable<Scene>;\n}\n\n/**\n * A texture whose content is rendered from a live HTML element using the WICG HTML-in-Canvas API\n * (https://github.com/WICG/html-in-canvas).\n *\n * The element is hosted as a child of the engine's rendering canvas (which is marked `layoutsubtree`) so\n * the browser can lay it out and snapshot it; the WICG API requires the source element to be a direct\n * child of the canvas whose context performs the upload. Content is uploaded through\n * `WebGLRenderingContext.texElementImage2D` (WebGL) or `GPUQueue.copyElementImageToTexture` (WebGPU),\n * available either natively (behind chrome://flags/#canvas-draw-element) or via the three-html-render\n * polyfill (https://github.com/repalash/three-html-render). When neither is present, a built-in SVG\n * `<foreignObject>` fallback is used instead (see `useSvgFallback`).\n *\n * As with {@link HtmlElementTexture}, updates are not automatic unless `autoUpdate` is enabled; in\n * that case the texture refreshes whenever the host canvas reports a paint change.\n */\nexport class HtmlTexture extends BaseTexture {\n    /**\n     * The HTML element rendered into the texture.\n     */\n    public readonly element: HTMLElement;\n\n    /**\n     * The element that hosts {@link element} in the document. This is the engine's rendering canvas when one\n     * is available (required by the WICG API, which can only capture the element from that canvas), or a\n     * hidden helper `<div>` otherwise - in which case only the SVG fallback can render.\n     */\n    public readonly host: Nullable<HTMLElement>;\n\n    /**\n     * Observable triggered once the texture has been rendered for the first time.\n     */\n    public onLoadObservable: Observable<HtmlTexture> = new Observable<HtmlTexture>();\n\n    private static readonly _DefaultOptions: Required<Pick<IHtmlTextureOptions, \"generateMipMaps\" | \"samplingMode\" | \"format\" | \"autoUpdate\" | \"useSvgFallback\">> = {\n        generateMipMaps: false,\n        samplingMode: Constants.TEXTURE_BILINEAR_SAMPLINGMODE,\n        format: Constants.TEXTUREFORMAT_RGBA,\n        autoUpdate: true,\n        useSvgFallback: true,\n    };\n\n    private readonly _format: number;\n    private readonly _generateMipMaps: boolean;\n    private readonly _samplingMode: number;\n    private readonly _useSvgFallback: boolean;\n    private readonly _textureMatrix: Matrix;\n    private _paintHandler: Nullable<(event: PaintEvent) => void> = null;\n    private _ownsHost: boolean = false;\n    private _originalParent: Nullable<Node & ParentNode> = null;\n    private _originalNextSibling: Nullable<ChildNode> = null;\n    private _addedInert: boolean = false;\n    private _width: number;\n    private _height: number;\n\n    /**\n     * Instantiates an HtmlTexture from an HTML element.\n     * @param name Defines the name of the texture\n     * @param element Defines the HTML element to render into the texture\n     * @param options Defines the texture creation options\n     */\n    constructor(name: string, element: HTMLElement, options: IHtmlTextureOptions) {\n        super(options.scene || options.engine);\n\n        this.element = element;\n        this._textureMatrix = Matrix.Identity();\n\n        if (!element || (!options.engine && !options.scene)) {\n            this.host = null;\n            this._width = 0;\n            this._height = 0;\n            this._format = HtmlTexture._DefaultOptions.format;\n            this._generateMipMaps = HtmlTexture._DefaultOptions.generateMipMaps;\n            this._samplingMode = HtmlTexture._DefaultOptions.samplingMode;\n            this._useSvgFallback = HtmlTexture._DefaultOptions.useSvgFallback;\n            return;\n        }\n\n        this._generateMipMaps = options.generateMipMaps ?? HtmlTexture._DefaultOptions.generateMipMaps;\n        this._samplingMode = options.samplingMode ?? HtmlTexture._DefaultOptions.samplingMode;\n        this._format = options.format ?? HtmlTexture._DefaultOptions.format;\n        this._useSvgFallback = options.useSvgFallback ?? HtmlTexture._DefaultOptions.useSvgFallback;\n        const autoUpdate = options.autoUpdate ?? HtmlTexture._DefaultOptions.autoUpdate;\n\n        this._width = options.width || element.offsetWidth || 256;\n        this._height = options.height || element.offsetHeight || 256;\n\n        this.name = name;\n        this.wrapU = Constants.TEXTURE_CLAMP_ADDRESSMODE;\n        this.wrapV = Constants.TEXTURE_CLAMP_ADDRESSMODE;\n        this.anisotropicFilteringLevel = 1;\n\n        this.host = this._createHost();\n\n        // The native WICG API has no content until the first paint snapshot is recorded, so the initial\n        // upload must happen from a paint event. The rendering canvas emits `paint`; listen for at least the\n        // first one and, when auto-update is disabled, detach after that first refresh. A non-canvas helper\n        // host never emits `paint`, so this listener is simply never invoked there.\n        if (this.host) {\n            this._paintHandler = (event: PaintEvent) => {\n                // A single `paint` event covers every changed child of the shared rendering canvas. When the\n                // browser reports which elements changed, skip the upload unless ours is among them, so that\n                // multiple HTML textures hosted on the same canvas don't all re-upload on every unrelated change.\n                if (event.changedElements && !event.changedElements.some((changed) => this.element === changed || this.element.contains(changed))) {\n                    return;\n                }\n                this.update();\n                if (!autoUpdate && this._paintHandler && this.host) {\n                    this.host.removeEventListener(\"paint\", this._paintHandler as EventListener);\n                    this._paintHandler = null;\n                }\n            };\n            this.host.addEventListener(\"paint\", this._paintHandler as EventListener);\n        }\n\n        this._createInternalTexture();\n    }\n\n    private _createHost(): Nullable<HTMLElement> {\n        if (!IsWindowObjectExist() || typeof document === \"undefined\") {\n            return null;\n        }\n\n        // Remember where the caller had the element so dispose() can put it back: we are about to re-parent it\n        // into the host (the element must be a direct child of the host to be captured and laid out).\n        this._originalParent = this.element.parentNode;\n        this._originalNextSibling = this.element.nextSibling;\n\n        // Per the WICG spec, the source element must be a *direct child* of the same canvas whose WebGL/WebGPU\n        // context performs the upload, and that canvas must opt its subtree into layout via `layoutsubtree`.\n        // The engine already owns our texture through its rendering canvas, so the element has to live inside\n        // that canvas: it is the only one whose context can snapshot the element via texElementImage2D /\n        // copyElementImageToTexture. A separate canvas would lay the element out but could never be captured\n        // into the engine's texture (this is why nothing rendered on the native path before).\n        const renderingCanvas = this._getEngine()?.getRenderingCanvas() ?? null;\n        if (renderingCanvas) {\n            renderingCanvas.layoutSubtree = true;\n            // `layoutsubtree` opts children into hit testing; mark ours inert so it never steals pointer events\n            // from the canvas (e.g. camera controls). Synthetic event dispatch still reaches inert elements, so\n            // HtmlRaycastInteractionManager keeps working; HtmlInteractionManager clears it to enable native input.\n            this._addedInert = !this.element.hasAttribute(\"inert\");\n            this.element.setAttribute(\"inert\", \"\");\n            renderingCanvas.appendChild(this.element);\n            this._ownsHost = false;\n            return renderingCanvas;\n        }\n\n        // No rendering canvas (e.g. NullEngine / offscreen): the native upload paths cannot run, because they\n        // capture from the engine's canvas and there is none. Only the SVG fallback renders here, and it builds\n        // from the element's serialized markup rather than from a canvas - so a host *canvas* would buy nothing.\n        // Host the element in a hidden, off-screen <div> purely so it is laid out in the document (giving\n        // correct measured sizes); there is no canvas to capture into on this path.\n        const host = document.createElement(\"div\");\n        host.style.position = \"absolute\";\n        host.style.left = \"-99999px\";\n        host.style.top = \"0px\";\n        host.style.pointerEvents = \"none\";\n        host.setAttribute(\"aria-hidden\", \"true\");\n\n        host.appendChild(this.element);\n        document.body.appendChild(host);\n        this._ownsHost = true;\n\n        return host;\n    }\n\n    private _createInternalTexture(): void {\n        const engine = this._getEngine();\n        if (engine) {\n            // createDynamicTexture is an engine extension; register it lazily (idempotent) so this module stays free of top-level side effects.\n            RegisterEnginesExtensionsEngineDynamicTexture();\n            this._texture = engine.createDynamicTexture(this._width, this._height, this._generateMipMaps, this._samplingMode);\n            this._texture.format = this._format;\n        }\n\n        // Trigger the initial render. On the native path this requests a paint so the first upload happens\n        // once a snapshot exists (calling the WICG API before the first snapshot throws); otherwise the\n        // SVG fallback (or a direct update) renders immediately.\n        this.requestUpdate();\n    }\n\n    /**\n     * @returns the texture matrix used in most of the material.\n     */\n    public override getTextureMatrix(): Matrix {\n        return this._textureMatrix;\n    }\n\n    /**\n     * Requests the host canvas to emit a paint event on the next rendering update. When auto-update is\n     * enabled, this triggers a texture refresh in sync with the DOM. Falls back to an immediate update\n     * when the WICG API is not available.\n     */\n    public requestUpdate(): void {\n        // `requestPaint` only exists on a WICG-capable rendering canvas; the helper <div> host has no such\n        // method, so fall back to an immediate update there.\n        const canvasHost = this.host as Nullable<HTMLCanvasElement>;\n        if (canvasHost && typeof canvasHost.requestPaint === \"function\") {\n            canvasHost.requestPaint();\n        } else {\n            this.update();\n        }\n    }\n\n    /**\n     * Updates the content of the texture from the current state of the HTML element.\n     * @param invertY Defines whether the texture should be inverted on Y (true by default)\n     */\n    public update(invertY: boolean = true): void {\n        const engine = this._getEngine();\n        if (this._texture == null || engine == null) {\n            return;\n        }\n\n        // When the native WICG upload API is unavailable, render through the SVG <foreignObject> fallback\n        // (unless it was explicitly disabled, in which case the upload helper emits a one-time warning).\n        if (this._useSvgFallback && !IsHtmlInCanvasUploadSupported(engine)) {\n            this._updateFromSvgFallback(engine, invertY);\n            return;\n        }\n\n        const wasReady = this.isReady();\n\n        UploadHtmlElementToTexture(engine, this._texture, this.element, invertY);\n\n        if (!wasReady && this.isReady()) {\n            this.onLoadObservable.notifyObservers(this);\n        }\n    }\n\n    /**\n     * Renders the element through an SVG `<foreignObject>` snapshot and uploads it to the texture. This\n     * fallback works in any browser but only captures same-origin, inline-styled content as a static image.\n     * @param engine defines the engine that owns the texture\n     * @param invertY defines whether the texture should be inverted on Y\n     */\n    private _updateFromSvgFallback(engine: AbstractEngine, invertY: boolean): void {\n        if (typeof document === \"undefined\" || typeof Image === \"undefined\" || typeof XMLSerializer === \"undefined\") {\n            return;\n        }\n\n        const svgUrl = this._buildSvgDataUrl();\n        if (!svgUrl) {\n            return;\n        }\n\n        const image = new Image();\n        image.onload = () => {\n            if (this._texture == null) {\n                return;\n            }\n            const wasReady = this.isReady();\n            try {\n                engine.updateDynamicTexture(this._texture, image, invertY, false, this._format);\n            } catch {\n                _WarnSvgFallback();\n                return;\n            }\n            if (!wasReady && this.isReady()) {\n                this.onLoadObservable.notifyObservers(this);\n            }\n        };\n        image.onerror = () => {\n            _WarnSvgFallback();\n        };\n        image.src = svgUrl;\n    }\n\n    /**\n     * Serializes the element into an SVG `<foreignObject>` data URL sized to the texture.\n     * @returns a data URL, or null if serialization failed\n     */\n    private _buildSvgDataUrl(): Nullable<string> {\n        try {\n            const clone = this.element.cloneNode(true) as HTMLElement;\n            clone.setAttribute(\"xmlns\", \"http://www.w3.org/1999/xhtml\");\n            const serialized = new XMLSerializer().serializeToString(clone);\n            const svg =\n                `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${this._width}\" height=\"${this._height}\">` +\n                `<foreignObject x=\"0\" y=\"0\" width=\"100%\" height=\"100%\">${serialized}</foreignObject>` +\n                `</svg>`;\n            return `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;\n        } catch {\n            return null;\n        }\n    }\n\n    /**\n     * Gets the current class name of the texture useful for serialization or dynamic coding.\n     * @returns \"HtmlTexture\"\n     */\n    public override getClassName(): string {\n        return \"HtmlTexture\";\n    }\n\n    /**\n     * Dispose the texture and release its associated resources.\n     */\n    public override dispose(): void {\n        if (this.host) {\n            if (this._paintHandler) {\n                this.host.removeEventListener(\"paint\", this._paintHandler as EventListener);\n                this._paintHandler = null;\n            }\n            // Remove the `inert` attribute we added so the caller gets the element back as they passed it.\n            if (this._addedInert) {\n                this.element.removeAttribute(\"inert\");\n                this._addedInert = false;\n            }\n            // Restore the element to where the caller had it before we re-parented it into the host, rather\n            // than silently deleting their node from the document.\n            if (this._originalParent) {\n                const reference = this._originalNextSibling && this._originalNextSibling.parentNode === this._originalParent ? this._originalNextSibling : null;\n                this._originalParent.insertBefore(this.element, reference);\n            } else {\n                this.element.remove();\n            }\n            // Remove the helper host we created (never the engine's borrowed rendering canvas).\n            if (this._ownsHost) {\n                this.host.remove();\n            }\n        }\n\n        this.onLoadObservable.clear();\n        super.dispose();\n    }\n}\n"]}
+{"version":3,"file":"htmlTexture.js","sourceRoot":"","sources":["../../../../../../dev/core/src/Materials/Textures/HTML/htmlTexture.ts"],"names":[],"mappings":"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","sourcesContent":["/** This module has no top-level side effects: the engine extension it depends on is registered lazily from the constructor */\n\nimport { type Nullable } from \"../../../types\";\nimport { BaseTexture } from \"../baseTexture.pure\";\nimport { Constants } from \"../../../Engines/constants\";\nimport { Matrix } from \"../../../Maths/math.vector.pure\";\nimport { Observable } from \"../../../Misc/observable.pure\";\nimport { Logger } from \"../../../Misc/logger\";\nimport { IsWindowObjectExist } from \"../../../Misc/domManagement\";\nimport { RegisterEnginesExtensionsEngineDynamicTexture } from \"../../../Engines/Extensions/engine.dynamicTexture.pure\";\nimport { _IsHtmlInCanvasPolyfillInstalled } from \"./htmlInCanvasPolyfill\";\n\nimport { type AbstractEngine } from \"../../../Engines/abstractEngine.pure\";\nimport { type ThinEngine } from \"../../../Engines/thinEngine.pure\";\nimport { type WebGPUEngine } from \"../../../Engines/webgpuEngine.pure\";\nimport { type WebGPUHardwareTexture } from \"../../../Engines/WebGPU/webgpuHardwareTexture\";\nimport { type InternalTexture } from \"../internalTexture\";\nimport { type Scene } from \"../../../scene.pure\";\n\nlet _HasWarnedAboutMissingApi = false;\n\nfunction _WarnMissingApi(apiName: string): void {\n    if (_HasWarnedAboutMissingApi) {\n        return;\n    }\n    _HasWarnedAboutMissingApi = true;\n    Logger.Warn(\n        `HTML-in-Canvas: ${apiName} is not available. Enable chrome://flags/#canvas-draw-element, the built-in SVG fallback, or the three-html-render polyfill to use HtmlTexture.`\n    );\n}\n\nlet _HasWarnedAboutSvgFallback = false;\n\nfunction _WarnSvgFallback(): void {\n    if (_HasWarnedAboutSvgFallback) {\n        return;\n    }\n    _HasWarnedAboutSvgFallback = true;\n    Logger.Warn(\"HTML-in-Canvas: the SVG fallback could not rasterize the element. This usually means it references cross-origin or external resources, which taint the snapshot.\");\n}\n\nlet _HasWarnedAboutUploadFailure = false;\n\nfunction _WarnUploadFailure(error: unknown): void {\n    if (_HasWarnedAboutUploadFailure) {\n        return;\n    }\n    _HasWarnedAboutUploadFailure = true;\n    const message = error instanceof Error ? error.message : String(error);\n    Logger.Warn(\n        `HTML-in-Canvas: the native upload failed (${message}). The element must be drawable inside the engine's rendering canvas with content=\"drawable\" (or layoutsubtree on older implementations), and the first upload must wait for a paint event.`\n    );\n}\n\n/**\n * Detects whether the engine can upload an HTML element through the native (or polyfilled) WICG\n * HTML-in-Canvas API, without emitting any warning. Used to decide whether the SVG fallback is needed.\n * @param engine defines the engine to test\n * @returns true when the WICG upload API is available for this engine\n */\nexport function IsHtmlInCanvasUploadSupported(engine: AbstractEngine): boolean {\n    if (engine.isWebGPU) {\n        const queue = (engine as WebGPUEngine)._device?.queue;\n        return !!queue && (typeof queue.drawElementImageToTexture === \"function\" || typeof queue.copyElementImageToTexture === \"function\");\n    }\n\n    const gl = (engine as ThinEngine)._gl as Nullable<WebGL2RenderingContext>;\n    return !!gl && (typeof gl.texElementSubImage2D === \"function\" || typeof gl.texElementImage2D === \"function\");\n}\n\n/**\n * Uploads a live HTML element (or a captured ElementImage) into an existing 2D texture using the WICG\n * HTML-in-Canvas API (https://github.com/WICG/html-in-canvas).\n *\n * This is a side-effect-free helper - it is only reachable when {@link HtmlTexture} (or a direct caller)\n * is imported, so it adds nothing to bundles that do not use it. It relies on\n * `WebGLRenderingContext.texElementSubImage2D` (WebGL) or `GPUQueue.drawElementImageToTexture` (WebGPU),\n * with support for their older `texElementImage2D` / `copyElementImageToTexture` counterparts, including\n * the three-html-render polyfill.\n * @param engine defines the engine that owns the texture\n * @param texture defines the internal texture to update\n * @param element defines the source HTML element (or captured ElementImage) to upload\n * @param invertY defines if data must be stored with Y axis inverted (true by default)\n * @param config defines an optional source rectangle and sizing configuration\n * @returns true if the upload succeeded, false otherwise (e.g. the API is unavailable)\n */\nexport function UploadHtmlElementToTexture(\n    engine: AbstractEngine,\n    texture: Nullable<InternalTexture>,\n    element: Element | ElementImage,\n    invertY: boolean = true,\n    config?: WebGLCopyElementImageConfig\n): boolean {\n    if (!texture || texture._isDisabled) {\n        return false;\n    }\n\n    if (engine.isWebGPU) {\n        return _UploadHtmlElementToWebGPUTexture(engine as WebGPUEngine, texture, element, invertY, config);\n    }\n\n    return _UploadHtmlElementToWebGLTexture(engine as ThinEngine, texture, element, invertY, config);\n}\n\n// Before texElementSubImage2D, the proposal used two incompatible texElementImage2D signatures.\n// Prefer the shorter form and fall back to the texImage2D-shaped overload used by older Chrome builds\n// and three-html-render when the implementation rejects the argument count.\nlet _UseLegacyTexElementImage2D = false;\n\nfunction _CallTexElementImage2D(gl: WebGL2RenderingContext, internalFormat: number, element: Element | ElementImage, config?: WebGLCopyElementImageConfig): void {\n    if (!_UseLegacyTexElementImage2D) {\n        try {\n            gl.texElementImage2D(gl.TEXTURE_2D, internalFormat, element, config);\n            return;\n        } catch (error) {\n            // Only a wrong-arity TypeError means we are talking to the legacy signature; anything else\n            // (e.g. the element is not a canvas child) is a genuine upload failure and must propagate.\n            // Native rejects the new form with \"N arguments required, but only M present\"; the\n            // three-html-render polyfill rejects it with \"unexpected argument count N\".\n            if (!(error instanceof TypeError) || !/arguments required|argument count/.test((error as Error).message)) {\n                throw error;\n            }\n            _UseLegacyTexElementImage2D = true;\n        }\n    }\n\n    // Legacy overload: texElementImage2D(target, level, internalformat, format, type, element).\n    gl.texElementImage2D(gl.TEXTURE_2D, 0, internalFormat, gl.RGBA, gl.UNSIGNED_BYTE, element);\n}\n\nfunction _UploadHtmlElementToWebGLTexture(\n    engine: ThinEngine,\n    texture: InternalTexture,\n    element: Element | ElementImage,\n    invertY: boolean,\n    config?: WebGLCopyElementImageConfig\n): boolean {\n    // Engines without a WebGL context (e.g. NullEngine) have no _gl and are handled by this guard.\n    const gl = engine._gl as Nullable<WebGL2RenderingContext>;\n    if (!gl || (typeof gl.texElementSubImage2D !== \"function\" && typeof gl.texElementImage2D !== \"function\")) {\n        _WarnMissingApi(\"texElementSubImage2D / texElementImage2D\");\n        return false;\n    }\n\n    // texElementImage2D requires a *sized* internal format (RGBA8, SRGB8_ALPHA8, RGBA16F or RGBA32F);\n    // the unsized gl.RGBA returned by _getInternalFormat is rejected.\n    const type = texture.type === -1 ? Constants.TEXTURETYPE_UNSIGNED_BYTE : texture.type;\n    const internalFormat = engine._getRGBABufferInternalSizedFormat(type, texture.format, texture._useSRGBBuffer);\n    const wasPreviouslyBound = engine._bindTextureDirectly(gl.TEXTURE_2D, texture, true);\n    engine._unpackFlipY(invertY);\n\n    try {\n        if (typeof gl.texElementSubImage2D === \"function\" && !(_IsHtmlInCanvasPolyfillInstalled() && typeof gl.texElementImage2D === \"function\")) {\n            // Unlike texElementImage2D, the current API updates existing storage rather than defining it.\n            if (!texture.isReady) {\n                gl.texImage2D(\n                    gl.TEXTURE_2D,\n                    0,\n                    internalFormat,\n                    texture.width,\n                    texture.height,\n                    0,\n                    engine._getInternalFormat(texture.format),\n                    engine._getWebGLTextureType(type),\n                    null\n                );\n            }\n            gl.texElementSubImage2D(gl.TEXTURE_2D, 0, 0, 0, element, config ?? { width: texture.width, height: texture.height });\n        } else {\n            _CallTexElementImage2D(gl, internalFormat, element, config);\n        }\n\n        if (texture.generateMipMaps) {\n            gl.generateMipmap(gl.TEXTURE_2D);\n        }\n\n        texture.invertY = invertY;\n        texture.isReady = true;\n        return true;\n    } catch (error) {\n        // Reaching here means the snapshot upload failed - usually a real misconfiguration (the element is\n        // not drawable in the rendering canvas), though a stray call before\n        // the first paint snapshot can also throw. Either way we must NOT disable the texture, so a later\n        // paint-driven update can still succeed; we surface a one-time diagnostic to help debugging.\n        _WarnUploadFailure(error);\n        return false;\n    } finally {\n        if (!wasPreviouslyBound) {\n            engine._bindTextureDirectly(gl.TEXTURE_2D, null);\n        }\n    }\n}\n\nfunction _UploadHtmlElementToWebGPUTexture(\n    engine: WebGPUEngine,\n    texture: InternalTexture,\n    element: Element | ElementImage,\n    invertY: boolean,\n    config?: WebGLCopyElementImageConfig\n): boolean {\n    const device = engine._device;\n    const queue = device && device.queue;\n    if (!device || !queue || (typeof queue.drawElementImageToTexture !== \"function\" && typeof queue.copyElementImageToTexture !== \"function\")) {\n        _WarnMissingApi(\"GPUQueue.drawElementImageToTexture / GPUQueue.copyElementImageToTexture\");\n        return false;\n    }\n\n    const gpuTexture = (texture._hardwareTexture as Nullable<WebGPUHardwareTexture>)?.underlyingResource;\n    if (!gpuTexture) {\n        return false;\n    }\n\n    try {\n        if (_IsHtmlInCanvasPolyfillInstalled() && typeof queue.copyElementImageToTexture === \"function\") {\n            queue.copyElementImageToTexture(element, config?.width ?? texture.width, config?.height ?? texture.height, { texture: gpuTexture });\n        } else if (typeof queue.drawElementImageToTexture === \"function\") {\n            const source: GPUDrawElementImageSource = { source: element };\n            if (config) {\n                source.sourceX = config.sx;\n                source.sourceY = config.sy;\n                source.sourceWidth = config.swidth;\n                source.sourceHeight = config.sheight;\n            }\n            queue.drawElementImageToTexture(source, {\n                texture: gpuTexture,\n                size: { width: config?.width ?? texture.width, height: config?.height ?? texture.height },\n            });\n        } else {\n            const source: GPUCopyElementImageSource = { source: element };\n            if (config) {\n                source.sx = config.sx;\n                source.sy = config.sy;\n                source.swidth = config.swidth;\n                source.sheight = config.sheight;\n            }\n            queue.copyElementImageToTexture(source, {\n                destination: { texture: gpuTexture },\n                width: config?.width ?? texture.width,\n                height: config?.height ?? texture.height,\n            });\n        }\n\n        if (texture.generateMipMaps) {\n            engine._generateMipmaps(texture);\n        }\n\n        // The WICG element upload APIs have no flipY option; the destination orientation is\n        // determined by the source. We record the requested value for downstream sampling conventions.\n        texture.invertY = invertY;\n        texture.isReady = true;\n        return true;\n    } catch (error) {\n        // Reaching here means the snapshot upload failed - usually a real misconfiguration (the element is\n        // not drawable in the rendering canvas), though a stray call before\n        // the first paint snapshot can also throw. Either way we must NOT disable the texture, so a later\n        // paint-driven update can still succeed; we surface a one-time diagnostic to help debugging.\n        _WarnUploadFailure(error);\n        return false;\n    }\n}\n\n/**\n * Defines the options used to create an {@link HtmlTexture}.\n */\nexport interface IHtmlTextureOptions {\n    /** Defines the width of the texture in pixels (defaults to the element's offset width, then 256). */\n    width?: number;\n    /** Defines the height of the texture in pixels (defaults to the element's offset height, then 256). */\n    height?: number;\n    /** Defines whether mip maps should be created or not (default: false). */\n    generateMipMaps?: boolean;\n    /** Defines the sampling mode of the texture (default: TEXTURE_BILINEAR_SAMPLINGMODE). */\n    samplingMode?: number;\n    /** Defines the associated texture format (default: TEXTUREFORMAT_RGBA). */\n    format?: number;\n    /** Defines whether the texture is automatically updated when the host canvas emits a paint event (default: true). */\n    autoUpdate?: boolean;\n    /**\n     * Defines whether to fall back to an SVG `<foreignObject>` rasterization when the native WICG\n     * HTML-in-Canvas API is unavailable (default: true). The fallback works in any browser but only\n     * captures same-origin, inline-styled content as a static snapshot (see the documentation for caveats).\n     */\n    useSvgFallback?: boolean;\n    /** Defines the engine instance to use the texture with. Not mandatory if a scene is provided. */\n    engine?: Nullable<AbstractEngine>;\n    /** Defines the scene the texture belongs to. Not mandatory if an engine is provided. */\n    scene?: Nullable<Scene>;\n}\n\n/**\n * A texture whose content is rendered from a live HTML element using the WICG HTML-in-Canvas API\n * (https://github.com/WICG/html-in-canvas).\n *\n * The element is hosted as a drawable child of the engine's rendering canvas (marked `content=\"drawable\"`,\n * or `layoutsubtree` on older implementations) so the browser can lay it out and snapshot it.\n * Content is uploaded through `WebGLRenderingContext.texElementSubImage2D` (WebGL) or\n * `GPUQueue.drawElementImageToTexture` (WebGPU), with support for older browsers and the three-html-render\n * polyfill (https://github.com/repalash/three-html-render). When neither is present, a built-in SVG\n * `<foreignObject>` fallback is used instead (see `useSvgFallback`).\n *\n * As with {@link HtmlElementTexture}, updates are not automatic unless `autoUpdate` is enabled; in\n * that case the texture refreshes whenever the host canvas reports a paint change.\n */\nexport class HtmlTexture extends BaseTexture {\n    /**\n     * The HTML element rendered into the texture.\n     */\n    public readonly element: HTMLElement;\n\n    /**\n     * The element that hosts {@link element} in the document. This is the engine's rendering canvas when one\n     * is available (required by the WICG API, which can only capture the element from that canvas), or a\n     * hidden helper `<div>` otherwise - in which case only the SVG fallback can render.\n     */\n    public readonly host: Nullable<HTMLElement>;\n\n    /**\n     * Observable triggered once the texture has been rendered for the first time.\n     */\n    public onLoadObservable: Observable<HtmlTexture> = new Observable<HtmlTexture>();\n\n    private static readonly _DefaultOptions: Required<Pick<IHtmlTextureOptions, \"generateMipMaps\" | \"samplingMode\" | \"format\" | \"autoUpdate\" | \"useSvgFallback\">> = {\n        generateMipMaps: false,\n        samplingMode: Constants.TEXTURE_BILINEAR_SAMPLINGMODE,\n        format: Constants.TEXTUREFORMAT_RGBA,\n        autoUpdate: true,\n        useSvgFallback: true,\n    };\n\n    private readonly _format: number;\n    private readonly _generateMipMaps: boolean;\n    private readonly _samplingMode: number;\n    private readonly _useSvgFallback: boolean;\n    private readonly _textureMatrix: Matrix;\n    private _paintHandler: Nullable<(event: CanvasPaintEvent) => void> = null;\n    private _ownsHost: boolean = false;\n    private _originalParent: Nullable<Node & ParentNode> = null;\n    private _originalNextSibling: Nullable<ChildNode> = null;\n    private _addedInert: boolean = false;\n    private _addedDrawable: boolean = false;\n    private _updateRequested: boolean = false;\n    private _width: number;\n    private _height: number;\n\n    /**\n     * Instantiates an HtmlTexture from an HTML element.\n     * @param name Defines the name of the texture\n     * @param element Defines the HTML element to render into the texture\n     * @param options Defines the texture creation options\n     */\n    constructor(name: string, element: HTMLElement, options: IHtmlTextureOptions) {\n        super(options.scene || options.engine);\n\n        this.element = element;\n        this._textureMatrix = Matrix.Identity();\n\n        if (!element || (!options.engine && !options.scene)) {\n            this.host = null;\n            this._width = 0;\n            this._height = 0;\n            this._format = HtmlTexture._DefaultOptions.format;\n            this._generateMipMaps = HtmlTexture._DefaultOptions.generateMipMaps;\n            this._samplingMode = HtmlTexture._DefaultOptions.samplingMode;\n            this._useSvgFallback = HtmlTexture._DefaultOptions.useSvgFallback;\n            return;\n        }\n\n        this._generateMipMaps = options.generateMipMaps ?? HtmlTexture._DefaultOptions.generateMipMaps;\n        this._samplingMode = options.samplingMode ?? HtmlTexture._DefaultOptions.samplingMode;\n        this._format = options.format ?? HtmlTexture._DefaultOptions.format;\n        this._useSvgFallback = options.useSvgFallback ?? HtmlTexture._DefaultOptions.useSvgFallback;\n        const autoUpdate = options.autoUpdate ?? HtmlTexture._DefaultOptions.autoUpdate;\n\n        this._width = options.width || element.offsetWidth || 256;\n        this._height = options.height || element.offsetHeight || 256;\n\n        this.name = name;\n        this.wrapU = Constants.TEXTURE_CLAMP_ADDRESSMODE;\n        this.wrapV = Constants.TEXTURE_CLAMP_ADDRESSMODE;\n        this.anisotropicFilteringLevel = 1;\n\n        this.host = this._createHost();\n\n        // Native uploads need an initial paint snapshot. Keep the listener for explicit requests even when\n        // auto-update is disabled; helper div hosts never emit paint.\n        if (this.host) {\n            let hasPainted = false;\n            this._paintHandler = (event: CanvasPaintEvent) => {\n                // A single `paint` event covers every changed child of the shared rendering canvas. When the\n                // browser reports which elements changed, skip the upload unless ours is among them, so that\n                // multiple HTML textures hosted on the same canvas don't all re-upload on every unrelated change.\n                if (!autoUpdate && !this._updateRequested && hasPainted) {\n                    return;\n                }\n                if (!this._updateRequested && event.changedElements && !event.changedElements.some((changed) => this.element === changed || this.element.contains(changed))) {\n                    return;\n                }\n                this._updateRequested = false;\n                hasPainted = true;\n                this.update();\n            };\n            this.host.addEventListener(\"paint\", this._paintHandler as EventListener);\n        }\n\n        this._createInternalTexture();\n    }\n\n    private _createHost(): Nullable<HTMLElement> {\n        if (!IsWindowObjectExist() || typeof document === \"undefined\") {\n            return null;\n        }\n\n        // Remember where the caller had the element so dispose() can put it back: we are about to re-parent it\n        // into the host (the element must be a direct child of the host to be captured and laid out).\n        this._originalParent = this.element.parentNode;\n        this._originalNextSibling = this.element.nextSibling;\n\n        // Older WICG implementations require a direct canvas child; current implementations require a\n        // drawable descendant and content=\"drawable\" on the same canvas whose context performs the upload.\n        // A separate canvas cannot supply snapshots to the engine's context.\n        const renderingCanvas = this._getEngine()?.getRenderingCanvas() ?? null;\n        if (renderingCanvas) {\n            if (typeof renderingCanvas.content === \"string\" && !_IsHtmlInCanvasPolyfillInstalled()) {\n                renderingCanvas.content = \"drawable\";\n                this._addedDrawable = !this.element.hasAttribute(\"drawable\");\n                if (this._addedDrawable) {\n                    this.element.setAttribute(\"drawable\", \"\");\n                }\n            } else {\n                renderingCanvas.layoutSubtree = true;\n            }\n            // `layoutsubtree` opts children into hit testing; mark ours inert so it never steals pointer events\n            // from the canvas (e.g. camera controls). Synthetic event dispatch still reaches inert elements, so\n            // HtmlRaycastInteractionManager keeps working; HtmlInteractionManager clears it to enable native input.\n            this._addedInert = !this.element.hasAttribute(\"inert\");\n            this.element.setAttribute(\"inert\", \"\");\n            renderingCanvas.appendChild(this.element);\n            this._ownsHost = false;\n            return renderingCanvas;\n        }\n\n        // No rendering canvas (e.g. NullEngine / offscreen): the native upload paths cannot run, because they\n        // capture from the engine's canvas and there is none. Only the SVG fallback renders here, and it builds\n        // from the element's serialized markup rather than from a canvas - so a host *canvas* would buy nothing.\n        // Host the element in a hidden, off-screen <div> purely so it is laid out in the document (giving\n        // correct measured sizes); there is no canvas to capture into on this path.\n        const host = document.createElement(\"div\");\n        host.style.position = \"absolute\";\n        host.style.left = \"-99999px\";\n        host.style.top = \"0px\";\n        host.style.pointerEvents = \"none\";\n        host.setAttribute(\"aria-hidden\", \"true\");\n\n        host.appendChild(this.element);\n        document.body.appendChild(host);\n        this._ownsHost = true;\n\n        return host;\n    }\n\n    private _createInternalTexture(): void {\n        const engine = this._getEngine();\n        if (engine) {\n            // createDynamicTexture is an engine extension; register it lazily (idempotent) so this module stays free of top-level side effects.\n            RegisterEnginesExtensionsEngineDynamicTexture();\n            this._texture = engine.createDynamicTexture(this._width, this._height, this._generateMipMaps, this._samplingMode);\n            this._texture.format = this._format;\n        }\n\n        // Trigger the initial render. On the native path this requests a paint so the first upload happens\n        // once a snapshot exists (calling the WICG API before the first snapshot throws); otherwise the\n        // SVG fallback (or a direct update) renders immediately.\n        this.requestUpdate();\n    }\n\n    /**\n     * @returns the texture matrix used in most of the material.\n     */\n    public override getTextureMatrix(): Matrix {\n        return this._textureMatrix;\n    }\n\n    /**\n     * Requests a texture refresh in sync with the host canvas's next paint event, even when auto-update is\n     * disabled. Updates immediately when the engine's WICG upload API is not available.\n     */\n    public requestUpdate(): void {\n        // A browser can expose requestPaint without an upload API supported by this engine. In that case\n        // do not wait for native paint: update() must still reach the SVG fallback or the missing-API warning.\n        const engine = this._getEngine();\n        const canvasHost = this.host as Nullable<HTMLCanvasElement>;\n        if (engine && IsHtmlInCanvasUploadSupported(engine) && canvasHost && typeof canvasHost.requestPaint === \"function\") {\n            this._updateRequested = true;\n            canvasHost.requestPaint();\n        } else {\n            this.update();\n        }\n    }\n\n    /**\n     * Updates the content of the texture from the current state of the HTML element.\n     * @param invertY Defines whether the texture should be inverted on Y (true by default)\n     */\n    public update(invertY: boolean = true): void {\n        const engine = this._getEngine();\n        if (this._texture == null || engine == null) {\n            return;\n        }\n\n        // When the native WICG upload API is unavailable, render through the SVG <foreignObject> fallback\n        // (unless it was explicitly disabled, in which case the upload helper emits a one-time warning).\n        if (this._useSvgFallback && !IsHtmlInCanvasUploadSupported(engine)) {\n            this._updateFromSvgFallback(engine, invertY);\n            return;\n        }\n\n        const wasReady = this.isReady();\n\n        UploadHtmlElementToTexture(engine, this._texture, this.element, invertY);\n\n        if (!wasReady && this.isReady()) {\n            this.onLoadObservable.notifyObservers(this);\n        }\n    }\n\n    /**\n     * Renders the element through an SVG `<foreignObject>` snapshot and uploads it to the texture. This\n     * fallback works in any browser but only captures same-origin, inline-styled content as a static image.\n     * @param engine defines the engine that owns the texture\n     * @param invertY defines whether the texture should be inverted on Y\n     */\n    private _updateFromSvgFallback(engine: AbstractEngine, invertY: boolean): void {\n        if (typeof document === \"undefined\" || typeof Image === \"undefined\" || typeof XMLSerializer === \"undefined\") {\n            return;\n        }\n\n        const svgUrl = this._buildSvgDataUrl();\n        if (!svgUrl) {\n            return;\n        }\n\n        const image = new Image();\n        image.onload = () => {\n            if (this._texture == null) {\n                return;\n            }\n            const wasReady = this.isReady();\n            try {\n                engine.updateDynamicTexture(this._texture, image, invertY, false, this._format);\n            } catch {\n                _WarnSvgFallback();\n                return;\n            }\n            if (!wasReady && this.isReady()) {\n                this.onLoadObservable.notifyObservers(this);\n            }\n        };\n        image.onerror = () => {\n            _WarnSvgFallback();\n        };\n        image.src = svgUrl;\n    }\n\n    /**\n     * Serializes the element into an SVG `<foreignObject>` data URL sized to the texture.\n     * @returns a data URL, or null if serialization failed\n     */\n    private _buildSvgDataUrl(): Nullable<string> {\n        try {\n            const clone = this.element.cloneNode(true) as HTMLElement;\n            clone.setAttribute(\"xmlns\", \"http://www.w3.org/1999/xhtml\");\n            const serialized = new XMLSerializer().serializeToString(clone);\n            const svg =\n                `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"${this._width}\" height=\"${this._height}\">` +\n                `<foreignObject x=\"0\" y=\"0\" width=\"100%\" height=\"100%\">${serialized}</foreignObject>` +\n                `</svg>`;\n            return `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;\n        } catch {\n            return null;\n        }\n    }\n\n    /**\n     * Gets the current class name of the texture useful for serialization or dynamic coding.\n     * @returns \"HtmlTexture\"\n     */\n    public override getClassName(): string {\n        return \"HtmlTexture\";\n    }\n\n    /**\n     * Dispose the texture and release its associated resources.\n     */\n    public override dispose(): void {\n        if (this.host) {\n            if (this._paintHandler) {\n                this.host.removeEventListener(\"paint\", this._paintHandler as EventListener);\n                this._paintHandler = null;\n            }\n            // Remove the `inert` attribute we added so the caller gets the element back as they passed it.\n            if (this._addedInert) {\n                this.element.removeAttribute(\"inert\");\n                this._addedInert = false;\n            }\n            if (this._addedDrawable) {\n                this.element.removeAttribute(\"drawable\");\n                this._addedDrawable = false;\n            }\n            // The polyfill redirects children into a helper host and tracks removals through this API.\n            if (this.element.parentNode === this.host) {\n                this.host.removeChild(this.element);\n            }\n            // Restore the element to where the caller had it before we re-parented it into the host, rather\n            // than silently deleting their node from the document.\n            if (this._originalParent) {\n                const reference = this._originalNextSibling && this._originalNextSibling.parentNode === this._originalParent ? this._originalNextSibling : null;\n                this._originalParent.insertBefore(this.element, reference);\n            } else {\n                this.element.remove();\n            }\n            // Remove the helper host we created (never the engine's borrowed rendering canvas).\n            if (this._ownsHost) {\n                this.host.remove();\n            }\n        }\n\n        this.onLoadObservable.clear();\n        super.dispose();\n    }\n}\n"]}

package/Materials/Textures/Loaders/internalTextureLoader.d.ts

@@ -24,6 +24,7 @@ export interface IInternalTextureLoader {
      * @param texture defines the BabylonJS internal texture
      * @param callback defines the method to call once ready to upload
      * @param options options to be passed to the loader
+     * @param ownsData defines whether nothing else holds data (the engine loaded it from the texture's url, with no offline provider), so its buffer can be transferred
      */
-    loadData(data: ArrayBufferView, texture: InternalTexture, callback: (width: number, height: number, loadMipmap: boolean, isCompressed: boolean, done: () => void, loadFailed?: boolean) => void, options?: any): void;
+    loadData(data: ArrayBufferView, texture: InternalTexture, callback: (width: number, height: number, loadMipmap: boolean, isCompressed: boolean, done: () => void, loadFailed?: boolean) => void, options?: any, ownsData?: boolean): void;
 }

package/Materials/Textures/Loaders/internalTextureLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"internalTextureLoader.js","sourceRoot":"","sources":["../../../../../../dev/core/src/Materials/Textures/Loaders/internalTextureLoader.ts"],"names":[],"mappings":"","sourcesContent":["import { type Nullable } from \"../../../types\";\r\nimport { type InternalTexture } from \"../internalTexture\";\r\n\r\n/**\r\n * This represents the required contract to create a new type of texture loader.\r\n */\r\nexport interface IInternalTextureLoader {\r\n    /**\r\n     * Defines whether the loader supports cascade loading the different faces.\r\n     */\r\n    supportCascades: boolean;\r\n\r\n    /**\r\n     * Uploads the cube texture data to the WebGL texture. It has already been bound.\r\n     * @param data contains the texture data\r\n     * @param texture defines the BabylonJS internal texture\r\n     * @param createPolynomials will be true if polynomials have been requested\r\n     * @param onLoad defines the callback to trigger once the texture is ready\r\n     * @param onError defines the callback to trigger in case of error\r\n     * @param options options to be passed to the loader\r\n     */\r\n    loadCubeData(\r\n        data: ArrayBufferView | ArrayBufferView[],\r\n        texture: InternalTexture,\r\n        createPolynomials: boolean,\r\n        onLoad: Nullable<(data?: any) => void>,\r\n        onError: Nullable<(message?: string, exception?: any) => void>,\r\n        options?: any\r\n    ): void;\r\n\r\n    /**\r\n     * Uploads the 2D texture data to the WebGL texture. It has already been bound once in the callback.\r\n     * @param data contains the texture data\r\n     * @param texture defines the BabylonJS internal texture\r\n     * @param callback defines the method to call once ready to upload\r\n     * @param options options to be passed to the loader\r\n     */\r\n    loadData(\r\n        data: ArrayBufferView,\r\n        texture: InternalTexture,\r\n        callback: (width: number, height: number, loadMipmap: boolean, isCompressed: boolean, done: () => void, loadFailed?: boolean) => void,\r\n        options?: any\r\n    ): void;\r\n}\r\n"]}
+{"version":3,"file":"internalTextureLoader.js","sourceRoot":"","sources":["../../../../../../dev/core/src/Materials/Textures/Loaders/internalTextureLoader.ts"],"names":[],"mappings":"","sourcesContent":["import { type Nullable } from \"../../../types\";\r\nimport { type InternalTexture } from \"../internalTexture\";\r\n\r\n/**\r\n * This represents the required contract to create a new type of texture loader.\r\n */\r\nexport interface IInternalTextureLoader {\r\n    /**\r\n     * Defines whether the loader supports cascade loading the different faces.\r\n     */\r\n    supportCascades: boolean;\r\n\r\n    /**\r\n     * Uploads the cube texture data to the WebGL texture. It has already been bound.\r\n     * @param data contains the texture data\r\n     * @param texture defines the BabylonJS internal texture\r\n     * @param createPolynomials will be true if polynomials have been requested\r\n     * @param onLoad defines the callback to trigger once the texture is ready\r\n     * @param onError defines the callback to trigger in case of error\r\n     * @param options options to be passed to the loader\r\n     */\r\n    loadCubeData(\r\n        data: ArrayBufferView | ArrayBufferView[],\r\n        texture: InternalTexture,\r\n        createPolynomials: boolean,\r\n        onLoad: Nullable<(data?: any) => void>,\r\n        onError: Nullable<(message?: string, exception?: any) => void>,\r\n        options?: any\r\n    ): void;\r\n\r\n    /**\r\n     * Uploads the 2D texture data to the WebGL texture. It has already been bound once in the callback.\r\n     * @param data contains the texture data\r\n     * @param texture defines the BabylonJS internal texture\r\n     * @param callback defines the method to call once ready to upload\r\n     * @param options options to be passed to the loader\r\n     * @param ownsData defines whether nothing else holds data (the engine loaded it from the texture's url, with no offline provider), so its buffer can be transferred\r\n     */\r\n    loadData(\r\n        data: ArrayBufferView,\r\n        texture: InternalTexture,\r\n        callback: (width: number, height: number, loadMipmap: boolean, isCompressed: boolean, done: () => void, loadFailed?: boolean) => void,\r\n        options?: any,\r\n        ownsData?: boolean\r\n    ): void;\r\n}\r\n"]}

package/Materials/Textures/Loaders/ktxTextureLoader.d.ts

@@ -24,6 +24,7 @@ export declare class _KTXTextureLoader implements IInternalTextureLoader {
      * @param texture defines the BabylonJS internal texture
      * @param callback defines the method to call once ready to upload
      * @param options
+     * @param ownsData defines whether nothing else holds data, so its buffer can be transferred
      */
-    loadData(data: ArrayBufferView, texture: InternalTexture, callback: (width: number, height: number, loadMipmap: boolean, isCompressed: boolean, done: () => void, loadFailed: boolean) => void, options?: any): void;
+    loadData(data: ArrayBufferView, texture: InternalTexture, callback: (width: number, height: number, loadMipmap: boolean, isCompressed: boolean, done: () => void, loadFailed: boolean) => void, options?: any, ownsData?: boolean): void;
 }