@onerjs/core 8.53.4 → 8.53.6

package/XR/webXRWebGLRenderTargetTextureProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webXRWebGLRenderTargetTextureProvider.js","sourceRoot":"","sources":["../../../../dev/core/src/XR/webXRWebGLRenderTargetTextureProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,OAAO,EAAE,eAAe,EAAyB,MAAM,uCAAuC,CAAC;AAG/F,OAAO,EAAE,qCAAqC,EAAE,MAAM,oCAAoC,CAAC;AAE3F;;;;GAIG;AACH,MAAM,OAAgB,qCAAsC,SAAQ,qCAAqC;IAC7F,sBAAsB,CAAC,WAA8C,EAAE,OAAqB;QAChG,MAAM,EAAE,GAAI,IAAI,CAAC,OAAsB,CAAC,GAAG,CAAC;QAC5C,IAAI,CAAC,EAAE,EAAE,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,yCAAiC,IAAI,CAAC,CAAC;QAC/F,eAAe,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;QAC1C,eAAe,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;QAC5C,eAAe,CAAC,gBAAgB,GAAG,IAAI,oBAAoB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACzE,eAAe,CAAC,OAAO,GAAG,IAAI,CAAC;QAC/B,OAAO,eAAe,CAAC;IAC3B,CAAC;IAES,0BAA0B,CAChC,KAAa,EACb,MAAc,EACd,WAAuC,EACvC,YAA2B,EAC3B,mBAAkC,EAClC,SAAmB;QAEnB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,WAAW,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAEtC,MAAM,mBAAmB,GAAG,IAAI,CAAC,+BAA+B,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;QAC7F,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,YAAwC,CAAC;QACzF,6FAA6F;QAC7F,6FAA6F;QAC7F,IAAI,WAAW,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/B,mBAAmB,CAAC,YAAY,GAAG,WAAW,CAAC;QACnD,CAAC;QAED,0BAA0B;QAC1B,IAAI,YAAY,EAAE,CAAC;YACf,IAAI,SAAS,EAAE,CAAC;gBACZ,mBAAmB,CAAC,kBAAkB,GAAG,YAAY,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACJ,MAAM,eAAe,GAAG,IAAI,CAAC,sBAAsB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;gBAC/E,mBAAmB,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;gBACnD,mBAAmB,CAAC,QAAQ,GAAG,eAAe,CAAC;YACnD,CAAC;QACL,CAAC;QAED,IAAI,mBAAmB,EAAE,CAAC;YACtB,IAAI,SAAS,EAAE,CAAC;gBACZ,mBAAmB,CAAC,yBAAyB,GAAG,mBAAmB,CAAC;YACxE,CAAC;iBAAM,CAAC;gBACJ,mBAAmB,CAAC,oBAAoB,GAAG,IAAI,CAAC,sBAAsB,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;YAC7G,CAAC;QACL,CAAC;QAED,mBAAmB,CAAC,gBAAgB,EAAE,CAAC;QAEvC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAErD,OAAO,mBAAmB,CAAC;IAC/B,CAAC;CACJ","sourcesContent":["import { type ThinEngine } from \"../Engines/thinEngine\";\nimport { WebGLHardwareTexture } from \"../Engines/WebGL/webGLHardwareTexture\";\nimport { type WebGLRenderTargetWrapper } from \"../Engines/WebGL/webGLRenderTargetWrapper\";\nimport { InternalTexture, InternalTextureSource } from \"../Materials/Textures/internalTexture\";\nimport { type RenderTargetTexture } from \"../Materials/Textures/renderTargetTexture.pure\";\nimport { type Nullable } from \"../types\";\nimport { WebXRLayerRenderTargetTextureProvider } from \"./webXRRenderTargetTextureProvider\";\n\n/**\n * Provides render target textures for WebGL-backed XR layers. Owns all WebGL-specific\n * framebuffer/texture wiring so the base provider can stay graphics-API-agnostic.\n * @internal\n */\nexport abstract class WebXRWebGLRenderTargetTextureProvider extends WebXRLayerRenderTargetTextureProvider {\n    private _createInternalTexture(textureSize: { width: number; height: number }, texture: WebGLTexture): InternalTexture {\n        const gl = (this._engine as ThinEngine)._gl;\n        if (!gl) {\n            throw new Error(\"WebXRWebGLRenderTargetTextureProvider requires a WebGL-capable engine.\");\n        }\n        const internalTexture = new InternalTexture(this._engine, InternalTextureSource.Unknown, true);\n        internalTexture.width = textureSize.width;\n        internalTexture.height = textureSize.height;\n        internalTexture._hardwareTexture = new WebGLHardwareTexture(texture, gl);\n        internalTexture.isReady = true;\n        return internalTexture;\n    }\n\n    protected _createRenderTargetTexture(\n        width: number,\n        height: number,\n        framebuffer: Nullable<WebGLFramebuffer>,\n        colorTexture?: WebGLTexture,\n        depthStencilTexture?: WebGLTexture,\n        multiview?: boolean\n    ): RenderTargetTexture {\n        if (!this._engine) {\n            throw new Error(\"Engine is disposed\");\n        }\n\n        const textureSize = { width, height };\n\n        const renderTargetTexture = this._createRenderTargetTextureShell(width, height, !!multiview);\n        const renderTargetWrapper = renderTargetTexture.renderTarget as WebGLRenderTargetWrapper;\n        // Set the framebuffer, make sure it works in all scenarios - emulator, no layers and layers.\n        // This must happen before binding any texture, since setTexture binds it to the framebuffer.\n        if (framebuffer || !colorTexture) {\n            renderTargetWrapper._framebuffer = framebuffer;\n        }\n\n        // Create internal texture\n        if (colorTexture) {\n            if (multiview) {\n                renderTargetWrapper._colorTextureArray = colorTexture;\n            } else {\n                const internalTexture = this._createInternalTexture(textureSize, colorTexture);\n                renderTargetWrapper.setTexture(internalTexture, 0);\n                renderTargetTexture._texture = internalTexture;\n            }\n        }\n\n        if (depthStencilTexture) {\n            if (multiview) {\n                renderTargetWrapper._depthStencilTextureArray = depthStencilTexture;\n            } else {\n                renderTargetWrapper._depthStencilTexture = this._createInternalTexture(textureSize, depthStencilTexture);\n            }\n        }\n\n        renderTargetTexture.disableRescaling();\n\n        this._renderTargetTextures.push(renderTargetTexture);\n\n        return renderTargetTexture;\n    }\n}\n"]}

package/XR/webXRWebGPURenderTargetTextureProvider.d.ts

@@ -0,0 +1,69 @@
+import { type RenderTargetTexture } from "../Materials/Textures/renderTargetTexture.pure.js";
+import { type Nullable } from "../types.js";
+import { WebXRLayerRenderTargetTexture } from "./webXRLayerRenderTargetTexture.js";
+import { WebXRLayerRenderTargetTextureProvider } from "./webXRRenderTargetTextureProvider.js";
+/**
+ * Provides render target textures for WebGPU-backed XR layers. Owns all WebGPU-specific texture wrapping
+ * (via {@link WebGPUEngine.wrapWebGPUTexture} / {@link WebGPUEngine.updateWrappedWebGPUTexture}) so the base
+ * provider can stay graphics-API-agnostic. Mirrors {@link WebXRWebGLRenderTargetTextureProvider} for the
+ * WebGPU (XRGPUBinding) backend.
+ * @internal
+ */
+export declare abstract class WebXRWebGPURenderTargetTextureProvider extends WebXRLayerRenderTargetTextureProvider {
+    private get _webgpuEngine();
+    private _wrapColorTexture;
+    private _wrapDepthTexture;
+    /**
+     * Builds the render target shell as a {@link WebXRLayerRenderTargetTexture} for the single-view path so
+     * each eye can bind its own array layer of a layered projection-layer texture. Multiview is not yet
+     * supported on this WebGPU path and is delegated to the base implementation.
+     * @param width the width of the render target
+     * @param height the height of the render target
+     * @param multiview whether the render target should be a multiview render target
+     * @returns the created (but not yet registered) render target texture
+     */
+    protected _createRenderTargetTextureShell(width: number, height: number, multiview: boolean): RenderTargetTexture;
+    /**
+     * Wraps the sub-image's color (and optional depth/stencil) GPUTextures and builds a new render target
+     * texture around them. Use this on first creation and whenever the sub-image texture size changes.
+     * @param width the width of the render target
+     * @param height the height of the render target
+     * @param colorTexture the sub-image color GPUTexture
+     * @param depthStencilTexture the sub-image depth/stencil GPUTexture, if any
+     * @param depthStencilFormat the WebGPU depth/stencil format the layer was created with, if depth is provided
+     * @param multiview whether the render target should be a multiview render target
+     * @returns the created render target texture
+     */
+    protected _createRenderTargetTextureFromGPUTextures(width: number, height: number, colorTexture: GPUTexture, depthStencilTexture: Nullable<GPUTexture>, depthStencilFormat: GPUTextureFormat | undefined, multiview: boolean): WebXRLayerRenderTargetTexture;
+    /**
+     * Ensures this render target is cleared every frame, including for the right eye.
+     *
+     * `Scene._clearFrameBuffer` skips clearing the right rig camera's framebuffer (`!camera.isRightCamera`).
+     * That is a valid optimization for WebGL2 stereo, where both eyes render into a single side-by-side
+     * texture and the left eye's full clear already covers the whole texture. WebGPU projection layers give
+     * each eye its OWN render target (a distinct array layer rendered in a separate render pass), so the
+     * right eye's color and — critically — depth would never be cleared, leaving its depth test to reject
+     * every fragment (a black right eye). The scene notifies `onClearObservable` regardless of
+     * `camera.isRightCamera`, so this observer clears both eyes' targets. WebGL providers never attach it,
+     * so the WebGL path is unchanged.
+     *
+     * The observer mirrors the clear semantics of `Scene._clearFrameBuffer` (minus the right-eye skip): it
+     * only clears when the scene has `autoClear` enabled, clears color at most once per frame (guarded by
+     * `RenderTargetTexture._cleared`, which the scene resets per frame in `_checkCameraRenderTarget`), always
+     * clears depth+stencil, and honors `skipInitialClear`. This keeps the "clear once per RTT per frame"
+     * contract instead of clearing color on every notification.
+     * @param renderTargetTexture the per-eye render target to clear each frame
+     */
+    private _attachPerEyeClearObserver;
+    /**
+     * Repoints the wrapped color/depth textures of an existing render target at the current frame's
+     * GPUTextures, preserving the RenderTargetTexture / InternalTexture identity held by the XR camera's
+     * `outputRenderTarget`. The sub-image textures are only valid for the current frame and may rotate from
+     * a compositor pool, so this must run every frame. The new GPUTextures must have the same dimensions as
+     * the wrapped ones (guaranteed by the caller's size-change branch, which rebuilds instead).
+     * @param renderTargetTexture the render target whose wrapped textures should be repointed
+     * @param colorTexture the current frame's color GPUTexture
+     * @param depthStencilTexture the current frame's depth/stencil GPUTexture, if any
+     */
+    protected _updateRenderTargetTextureFromGPUTextures(renderTargetTexture: RenderTargetTexture, colorTexture: GPUTexture, depthStencilTexture: Nullable<GPUTexture>): void;
+}

package/XR/webXRWebGPURenderTargetTextureProvider.js

@@ -0,0 +1,148 @@
+
+import { WebXRLayerRenderTargetTexture } from "./webXRLayerRenderTargetTexture.js";
+import { WebXRLayerRenderTargetTextureProvider } from "./webXRRenderTargetTextureProvider.js";
+/**
+ * Maps a WebGPU depth/stencil {@link GPUTextureFormat} to the matching Babylon `TEXTUREFORMAT_*` constant.
+ *
+ * The engine reads `InternalTexture.format` (a Babylon constant) when it builds the render pass depth
+ * attachment for a render target, so a depth texture wrapped from an external `GPUTexture` must carry the
+ * correct Babylon format or the depth attachment pipeline format will not match the sub-image's texture.
+ * @param format the WebGPU depth/stencil format requested when the layer was created
+ * @returns the matching Babylon texture format constant
+ */
+function GetBabylonDepthFormat(format) {
+    switch (format) {
+        case "depth16unorm":
+            return 15;
+        case "depth24plus":
+            return 16;
+        case "depth24plus-stencil8":
+            return 13;
+        case "depth32float":
+            return 14;
+        case "depth32float-stencil8":
+            return 18;
+        case "stencil8":
+            return 19;
+        default:
+            // Fall back to a combined depth/stencil format, which is the projection layer default.
+            return 13;
+    }
+}
+/**
+ * Provides render target textures for WebGPU-backed XR layers. Owns all WebGPU-specific texture wrapping
+ * (via {@link WebGPUEngine.wrapWebGPUTexture} / {@link WebGPUEngine.updateWrappedWebGPUTexture}) so the base
+ * provider can stay graphics-API-agnostic. Mirrors {@link WebXRWebGLRenderTargetTextureProvider} for the
+ * WebGPU (XRGPUBinding) backend.
+ * @internal
+ */
+export class WebXRWebGPURenderTargetTextureProvider extends WebXRLayerRenderTargetTextureProvider {
+    get _webgpuEngine() {
+        return this._engine;
+    }
+    _wrapColorTexture(texture) {
+        return this._webgpuEngine.wrapWebGPUTexture(texture);
+    }
+    _wrapDepthTexture(texture, depthStencilFormat) {
+        const internalTexture = this._webgpuEngine.wrapWebGPUTexture(texture);
+        // The engine derives the color attachment format automatically from the wrapped hardware texture,
+        // but the depth attachment format is read from the Babylon InternalTexture.format, which
+        // wrapWebGPUTexture does not set. Assign it here from the format the layer was created with.
+        internalTexture.format = GetBabylonDepthFormat(depthStencilFormat);
+        return internalTexture;
+    }
+    /**
+     * Builds the render target shell as a {@link WebXRLayerRenderTargetTexture} for the single-view path so
+     * each eye can bind its own array layer of a layered projection-layer texture. Multiview is not yet
+     * supported on this WebGPU path and is delegated to the base implementation.
+     * @param width the width of the render target
+     * @param height the height of the render target
+     * @param multiview whether the render target should be a multiview render target
+     * @returns the created (but not yet registered) render target texture
+     */
+    _createRenderTargetTextureShell(width, height, multiview) {
+        if (multiview) {
+            return super._createRenderTargetTextureShell(width, height, multiview);
+        }
+        const renderTargetTexture = new WebXRLayerRenderTargetTexture("XR renderTargetTexture", { width, height }, this._scene);
+        renderTargetTexture.renderTarget._samples = renderTargetTexture.samples;
+        return renderTargetTexture;
+    }
+    /**
+     * Wraps the sub-image's color (and optional depth/stencil) GPUTextures and builds a new render target
+     * texture around them. Use this on first creation and whenever the sub-image texture size changes.
+     * @param width the width of the render target
+     * @param height the height of the render target
+     * @param colorTexture the sub-image color GPUTexture
+     * @param depthStencilTexture the sub-image depth/stencil GPUTexture, if any
+     * @param depthStencilFormat the WebGPU depth/stencil format the layer was created with, if depth is provided
+     * @param multiview whether the render target should be a multiview render target
+     * @returns the created render target texture
+     */
+    _createRenderTargetTextureFromGPUTextures(width, height, colorTexture, depthStencilTexture, depthStencilFormat, multiview) {
+        const color = this._wrapColorTexture(colorTexture);
+        const depth = depthStencilTexture && depthStencilFormat ? this._wrapDepthTexture(depthStencilTexture, depthStencilFormat) : null;
+        // Single-view (the only path here) always builds a WebXRLayerRenderTargetTexture via the shell override above.
+        const renderTargetTexture = this._createRenderTargetTextureInternal(width, height, color, depth, multiview);
+        this._attachPerEyeClearObserver(renderTargetTexture);
+        return renderTargetTexture;
+    }
+    /**
+     * Ensures this render target is cleared every frame, including for the right eye.
+     *
+     * `Scene._clearFrameBuffer` skips clearing the right rig camera's framebuffer (`!camera.isRightCamera`).
+     * That is a valid optimization for WebGL2 stereo, where both eyes render into a single side-by-side
+     * texture and the left eye's full clear already covers the whole texture. WebGPU projection layers give
+     * each eye its OWN render target (a distinct array layer rendered in a separate render pass), so the
+     * right eye's color and — critically — depth would never be cleared, leaving its depth test to reject
+     * every fragment (a black right eye). The scene notifies `onClearObservable` regardless of
+     * `camera.isRightCamera`, so this observer clears both eyes' targets. WebGL providers never attach it,
+     * so the WebGL path is unchanged.
+     *
+     * The observer mirrors the clear semantics of `Scene._clearFrameBuffer` (minus the right-eye skip): it
+     * only clears when the scene has `autoClear` enabled, clears color at most once per frame (guarded by
+     * `RenderTargetTexture._cleared`, which the scene resets per frame in `_checkCameraRenderTarget`), always
+     * clears depth+stencil, and honors `skipInitialClear`. This keeps the "clear once per RTT per frame"
+     * contract instead of clearing color on every notification.
+     * @param renderTargetTexture the per-eye render target to clear each frame
+     */
+    _attachPerEyeClearObserver(renderTargetTexture) {
+        renderTargetTexture.onClearObservable.add((engine) => {
+            // Honor skipInitialClear so this observer preserves the default clear semantics it replaces.
+            if (renderTargetTexture.skipInitialClear) {
+                return;
+            }
+            const scene = renderTargetTexture.getScene();
+            // When autoClear is disabled the scene does not clear render targets; match that so this observer
+            // does not force a clear the user opted out of.
+            if (scene && !scene.autoClear) {
+                return;
+            }
+            // Clear color only once per frame (!_cleared), always clear depth+stencil, then mark the target
+            // cleared for this frame so a second notification in the same frame does not re-clear color.
+            engine.clear(renderTargetTexture.clearColor ?? scene?.clearColor ?? null, !renderTargetTexture._cleared, true, true);
+            renderTargetTexture._cleared = true;
+        });
+    }
+    /**
+     * Repoints the wrapped color/depth textures of an existing render target at the current frame's
+     * GPUTextures, preserving the RenderTargetTexture / InternalTexture identity held by the XR camera's
+     * `outputRenderTarget`. The sub-image textures are only valid for the current frame and may rotate from
+     * a compositor pool, so this must run every frame. The new GPUTextures must have the same dimensions as
+     * the wrapped ones (guaranteed by the caller's size-change branch, which rebuilds instead).
+     * @param renderTargetTexture the render target whose wrapped textures should be repointed
+     * @param colorTexture the current frame's color GPUTexture
+     * @param depthStencilTexture the current frame's depth/stencil GPUTexture, if any
+     */
+    _updateRenderTargetTextureFromGPUTextures(renderTargetTexture, colorTexture, depthStencilTexture) {
+        const color = renderTargetTexture._texture;
+        if (color) {
+            this._webgpuEngine.updateWrappedWebGPUTexture(color, colorTexture);
+        }
+        const depth = renderTargetTexture.renderTarget?._depthStencilTexture;
+        if (depth && depthStencilTexture) {
+            this._webgpuEngine.updateWrappedWebGPUTexture(depth, depthStencilTexture);
+        }
+    }
+}
+//# sourceMappingURL=webXRWebGPURenderTargetTextureProvider.js.map

package/XR/webXRWebGPURenderTargetTextureProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webXRWebGPURenderTargetTextureProvider.js","sourceRoot":"","sources":["../../../../dev/core/src/XR/webXRWebGPURenderTargetTextureProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAKjD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,qCAAqC,EAAE,MAAM,oCAAoC,CAAC;AAE3F;;;;;;;;GAQG;AACH,SAAS,qBAAqB,CAAC,MAAwB;IACnD,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,cAAc;YACf,OAAO,SAAS,CAAC,qBAAqB,CAAC;QAC3C,KAAK,aAAa;YACd,OAAO,SAAS,CAAC,qBAAqB,CAAC;QAC3C,KAAK,sBAAsB;YACvB,OAAO,SAAS,CAAC,8BAA8B,CAAC;QACpD,KAAK,cAAc;YACf,OAAO,SAAS,CAAC,2BAA2B,CAAC;QACjD,KAAK,uBAAuB;YACxB,OAAO,SAAS,CAAC,mCAAmC,CAAC;QACzD,KAAK,UAAU;YACX,OAAO,SAAS,CAAC,sBAAsB,CAAC;QAC5C;YACI,uFAAuF;YACvF,OAAO,SAAS,CAAC,8BAA8B,CAAC;IACxD,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAgB,sCAAuC,SAAQ,qCAAqC;IACtG,IAAY,aAAa;QACrB,OAAO,IAAI,CAAC,OAAuB,CAAC;IACxC,CAAC;IAEO,iBAAiB,CAAC,OAAmB;QACzC,OAAO,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IAEO,iBAAiB,CAAC,OAAmB,EAAE,kBAAoC;QAC/E,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACtE,kGAAkG;QAClG,yFAAyF;QACzF,6FAA6F;QAC7F,eAAe,CAAC,MAAM,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;QACnE,OAAO,eAAe,CAAC;IAC3B,CAAC;IAED;;;;;;;;OAQG;IACgB,+BAA+B,CAAC,KAAa,EAAE,MAAc,EAAE,SAAkB;QAChG,IAAI,SAAS,EAAE,CAAC;YACZ,OAAO,KAAK,CAAC,+BAA+B,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,mBAAmB,GAAG,IAAI,6BAA6B,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACxH,mBAAmB,CAAC,YAAa,CAAC,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC;QACzE,OAAO,mBAAmB,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;OAUG;IACO,yCAAyC,CAC/C,KAAa,EACb,MAAc,EACd,YAAwB,EACxB,mBAAyC,EACzC,kBAAgD,EAChD,SAAkB;QAElB,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,mBAAmB,IAAI,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjI,+GAA+G;QAC/G,MAAM,mBAAmB,GAAG,IAAI,CAAC,kCAAkC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,CAAkC,CAAC;QAC7I,IAAI,CAAC,0BAA0B,CAAC,mBAAmB,CAAC,CAAC;QACrD,OAAO,mBAAmB,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACK,0BAA0B,CAAC,mBAAwC;QACvE,mBAAmB,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACjD,6FAA6F;YAC7F,IAAI,mBAAmB,CAAC,gBAAgB,EAAE,CAAC;gBACvC,OAAO;YACX,CAAC;YACD,MAAM,KAAK,GAAG,mBAAmB,CAAC,QAAQ,EAAE,CAAC;YAC7C,kGAAkG;YAClG,gDAAgD;YAChD,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;gBAC5B,OAAO;YACX,CAAC;YACD,gGAAgG;YAChG,6FAA6F;YAC7F,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,UAAU,IAAI,KAAK,EAAE,UAAU,IAAI,IAAI,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YACrH,mBAAmB,CAAC,QAAQ,GAAG,IAAI,CAAC;QACxC,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;OASG;IACO,yCAAyC,CAAC,mBAAwC,EAAE,YAAwB,EAAE,mBAAyC;QAC7J,MAAM,KAAK,GAAG,mBAAmB,CAAC,QAAQ,CAAC;QAC3C,IAAI,KAAK,EAAE,CAAC;YACR,IAAI,CAAC,aAAa,CAAC,0BAA0B,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,KAAK,GAAG,mBAAmB,CAAC,YAAY,EAAE,oBAAoB,CAAC;QACrE,IAAI,KAAK,IAAI,mBAAmB,EAAE,CAAC;YAC/B,IAAI,CAAC,aAAa,CAAC,0BAA0B,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;QAC9E,CAAC;IACL,CAAC;CACJ","sourcesContent":["import { Constants } from \"../Engines/constants\";\nimport { type WebGPUEngine } from \"../Engines/webgpuEngine\";\nimport { type InternalTexture } from \"../Materials/Textures/internalTexture\";\nimport { type RenderTargetTexture } from \"../Materials/Textures/renderTargetTexture.pure\";\nimport { type Nullable } from \"../types\";\nimport { WebXRLayerRenderTargetTexture } from \"./webXRLayerRenderTargetTexture\";\nimport { WebXRLayerRenderTargetTextureProvider } from \"./webXRRenderTargetTextureProvider\";\n\n/**\n * Maps a WebGPU depth/stencil {@link GPUTextureFormat} to the matching Babylon `TEXTUREFORMAT_*` constant.\n *\n * The engine reads `InternalTexture.format` (a Babylon constant) when it builds the render pass depth\n * attachment for a render target, so a depth texture wrapped from an external `GPUTexture` must carry the\n * correct Babylon format or the depth attachment pipeline format will not match the sub-image's texture.\n * @param format the WebGPU depth/stencil format requested when the layer was created\n * @returns the matching Babylon texture format constant\n */\nfunction GetBabylonDepthFormat(format: GPUTextureFormat): number {\n    switch (format) {\n        case \"depth16unorm\":\n            return Constants.TEXTUREFORMAT_DEPTH16;\n        case \"depth24plus\":\n            return Constants.TEXTUREFORMAT_DEPTH24;\n        case \"depth24plus-stencil8\":\n            return Constants.TEXTUREFORMAT_DEPTH24_STENCIL8;\n        case \"depth32float\":\n            return Constants.TEXTUREFORMAT_DEPTH32_FLOAT;\n        case \"depth32float-stencil8\":\n            return Constants.TEXTUREFORMAT_DEPTH32FLOAT_STENCIL8;\n        case \"stencil8\":\n            return Constants.TEXTUREFORMAT_STENCIL8;\n        default:\n            // Fall back to a combined depth/stencil format, which is the projection layer default.\n            return Constants.TEXTUREFORMAT_DEPTH24_STENCIL8;\n    }\n}\n\n/**\n * Provides render target textures for WebGPU-backed XR layers. Owns all WebGPU-specific texture wrapping\n * (via {@link WebGPUEngine.wrapWebGPUTexture} / {@link WebGPUEngine.updateWrappedWebGPUTexture}) so the base\n * provider can stay graphics-API-agnostic. Mirrors {@link WebXRWebGLRenderTargetTextureProvider} for the\n * WebGPU (XRGPUBinding) backend.\n * @internal\n */\nexport abstract class WebXRWebGPURenderTargetTextureProvider extends WebXRLayerRenderTargetTextureProvider {\n    private get _webgpuEngine(): WebGPUEngine {\n        return this._engine as WebGPUEngine;\n    }\n\n    private _wrapColorTexture(texture: GPUTexture): InternalTexture {\n        return this._webgpuEngine.wrapWebGPUTexture(texture);\n    }\n\n    private _wrapDepthTexture(texture: GPUTexture, depthStencilFormat: GPUTextureFormat): InternalTexture {\n        const internalTexture = this._webgpuEngine.wrapWebGPUTexture(texture);\n        // The engine derives the color attachment format automatically from the wrapped hardware texture,\n        // but the depth attachment format is read from the Babylon InternalTexture.format, which\n        // wrapWebGPUTexture does not set. Assign it here from the format the layer was created with.\n        internalTexture.format = GetBabylonDepthFormat(depthStencilFormat);\n        return internalTexture;\n    }\n\n    /**\n     * Builds the render target shell as a {@link WebXRLayerRenderTargetTexture} for the single-view path so\n     * each eye can bind its own array layer of a layered projection-layer texture. Multiview is not yet\n     * supported on this WebGPU path and is delegated to the base implementation.\n     * @param width the width of the render target\n     * @param height the height of the render target\n     * @param multiview whether the render target should be a multiview render target\n     * @returns the created (but not yet registered) render target texture\n     */\n    protected override _createRenderTargetTextureShell(width: number, height: number, multiview: boolean): RenderTargetTexture {\n        if (multiview) {\n            return super._createRenderTargetTextureShell(width, height, multiview);\n        }\n        const renderTargetTexture = new WebXRLayerRenderTargetTexture(\"XR renderTargetTexture\", { width, height }, this._scene);\n        renderTargetTexture.renderTarget!._samples = renderTargetTexture.samples;\n        return renderTargetTexture;\n    }\n\n    /**\n     * Wraps the sub-image's color (and optional depth/stencil) GPUTextures and builds a new render target\n     * texture around them. Use this on first creation and whenever the sub-image texture size changes.\n     * @param width the width of the render target\n     * @param height the height of the render target\n     * @param colorTexture the sub-image color GPUTexture\n     * @param depthStencilTexture the sub-image depth/stencil GPUTexture, if any\n     * @param depthStencilFormat the WebGPU depth/stencil format the layer was created with, if depth is provided\n     * @param multiview whether the render target should be a multiview render target\n     * @returns the created render target texture\n     */\n    protected _createRenderTargetTextureFromGPUTextures(\n        width: number,\n        height: number,\n        colorTexture: GPUTexture,\n        depthStencilTexture: Nullable<GPUTexture>,\n        depthStencilFormat: GPUTextureFormat | undefined,\n        multiview: boolean\n    ): WebXRLayerRenderTargetTexture {\n        const color = this._wrapColorTexture(colorTexture);\n        const depth = depthStencilTexture && depthStencilFormat ? this._wrapDepthTexture(depthStencilTexture, depthStencilFormat) : null;\n        // Single-view (the only path here) always builds a WebXRLayerRenderTargetTexture via the shell override above.\n        const renderTargetTexture = this._createRenderTargetTextureInternal(width, height, color, depth, multiview) as WebXRLayerRenderTargetTexture;\n        this._attachPerEyeClearObserver(renderTargetTexture);\n        return renderTargetTexture;\n    }\n\n    /**\n     * Ensures this render target is cleared every frame, including for the right eye.\n     *\n     * `Scene._clearFrameBuffer` skips clearing the right rig camera's framebuffer (`!camera.isRightCamera`).\n     * That is a valid optimization for WebGL2 stereo, where both eyes render into a single side-by-side\n     * texture and the left eye's full clear already covers the whole texture. WebGPU projection layers give\n     * each eye its OWN render target (a distinct array layer rendered in a separate render pass), so the\n     * right eye's color and — critically — depth would never be cleared, leaving its depth test to reject\n     * every fragment (a black right eye). The scene notifies `onClearObservable` regardless of\n     * `camera.isRightCamera`, so this observer clears both eyes' targets. WebGL providers never attach it,\n     * so the WebGL path is unchanged.\n     *\n     * The observer mirrors the clear semantics of `Scene._clearFrameBuffer` (minus the right-eye skip): it\n     * only clears when the scene has `autoClear` enabled, clears color at most once per frame (guarded by\n     * `RenderTargetTexture._cleared`, which the scene resets per frame in `_checkCameraRenderTarget`), always\n     * clears depth+stencil, and honors `skipInitialClear`. This keeps the \"clear once per RTT per frame\"\n     * contract instead of clearing color on every notification.\n     * @param renderTargetTexture the per-eye render target to clear each frame\n     */\n    private _attachPerEyeClearObserver(renderTargetTexture: RenderTargetTexture): void {\n        renderTargetTexture.onClearObservable.add((engine) => {\n            // Honor skipInitialClear so this observer preserves the default clear semantics it replaces.\n            if (renderTargetTexture.skipInitialClear) {\n                return;\n            }\n            const scene = renderTargetTexture.getScene();\n            // When autoClear is disabled the scene does not clear render targets; match that so this observer\n            // does not force a clear the user opted out of.\n            if (scene && !scene.autoClear) {\n                return;\n            }\n            // Clear color only once per frame (!_cleared), always clear depth+stencil, then mark the target\n            // cleared for this frame so a second notification in the same frame does not re-clear color.\n            engine.clear(renderTargetTexture.clearColor ?? scene?.clearColor ?? null, !renderTargetTexture._cleared, true, true);\n            renderTargetTexture._cleared = true;\n        });\n    }\n\n    /**\n     * Repoints the wrapped color/depth textures of an existing render target at the current frame's\n     * GPUTextures, preserving the RenderTargetTexture / InternalTexture identity held by the XR camera's\n     * `outputRenderTarget`. The sub-image textures are only valid for the current frame and may rotate from\n     * a compositor pool, so this must run every frame. The new GPUTextures must have the same dimensions as\n     * the wrapped ones (guaranteed by the caller's size-change branch, which rebuilds instead).\n     * @param renderTargetTexture the render target whose wrapped textures should be repointed\n     * @param colorTexture the current frame's color GPUTexture\n     * @param depthStencilTexture the current frame's depth/stencil GPUTexture, if any\n     */\n    protected _updateRenderTargetTextureFromGPUTextures(renderTargetTexture: RenderTargetTexture, colorTexture: GPUTexture, depthStencilTexture: Nullable<GPUTexture>): void {\n        const color = renderTargetTexture._texture;\n        if (color) {\n            this._webgpuEngine.updateWrappedWebGPUTexture(color, colorTexture);\n        }\n        const depth = renderTargetTexture.renderTarget?._depthStencilTexture;\n        if (depth && depthStencilTexture) {\n            this._webgpuEngine.updateWrappedWebGPUTexture(depth, depthStencilTexture);\n        }\n    }\n}\n"]}

package/index.d.ts

@@ -1,3 +1,4 @@
+import "./Misc/symbolMetadataPolyfill.js";
 export * from "./Actions/index.js";
 export * from "./Animations/index.js";
 export * from "./assetContainer.js";

package/index.js

@@ -1,4 +1,5 @@
 /* eslint-disable @typescript-eslint/no-restricted-imports */
+import "./Misc/symbolMetadataPolyfill.js";
 export * from "./Actions/index.js";
 export * from "./Animations/index.js";
 export * from "./assetContainer.js";

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../dev/core/src/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,QAAQ,CAAC;AACvB,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAE3B,OAAO,mDAAmD,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/no-restricted-imports */\r\nexport * from \"./Actions/index\";\r\nexport * from \"./Animations/index\";\r\nexport * from \"./assetContainer\";\r\nexport * from \"./Audio/index\";\r\nexport * from \"./AudioV2/index\";\r\nexport * from \"./BakedVertexAnimation/index\";\r\nexport * from \"./Behaviors/index\";\r\nexport * from \"./Bones/index\";\r\nexport * from \"./Buffers/index\";\r\nexport * from \"./Cameras/index\";\r\nexport * from \"./Collisions/index\";\r\nexport * from \"./Compat/index\";\r\nexport * from \"./Compute/index\";\r\nexport * from \"./Culling/index\";\r\nexport * from \"./Debug/index\";\r\nexport * from \"./DeviceInput/index\";\r\nexport * from \"./Engines/index\";\r\nexport * from \"./Events/index\";\r\nexport * from \"./FlowGraph/index\";\r\nexport * from \"./FrameGraph/index\";\r\nexport * from \"./Gamepads/index\";\r\nexport * from \"./Gizmos/index\";\r\nexport * from \"./Helpers/index\";\r\nexport * from \"./Instrumentation/index\";\r\nexport * from \"./Layers/index\";\r\nexport * from \"./LensFlares/index\";\r\nexport * from \"./Lights/index\";\r\nexport * from \"./Loading/index\";\r\nexport * from \"./Materials/index\";\r\nexport * from \"./Maths/pure\";\r\nexport * from \"./Meshes/index\";\r\nexport * from \"./Misc/index\";\r\nexport * from \"./Morph/index\";\r\nexport * from \"./Navigation/index\";\r\nexport * from \"./node\";\r\nexport * from \"./ObjectModel/index\";\r\nexport * from \"./Offline/index\";\r\nexport * from \"./Particles/index\";\r\nexport * from \"./Physics/index\";\r\nexport * from \"./PostProcesses/index\";\r\nexport * from \"./Probes/index\";\r\nexport * from \"./Rendering/index\";\r\nexport * from \"./scene\";\r\nexport * from \"./sceneComponent\";\r\nexport * from \"./SmartAssets/index\";\r\nexport * from \"./Sprites/index\";\r\nexport * from \"./States/index\";\r\nexport * from \"./types\";\r\nexport * from \"./XR/index\";\r\n\r\nimport \"./Shaders/ShadersInclude/sceneFragmentDeclaration\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../dev/core/src/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,OAAO,+BAA+B,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,QAAQ,CAAC;AACvB,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAE3B,OAAO,mDAAmD,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/no-restricted-imports */\r\nimport \"./Misc/symbolMetadataPolyfill\";\r\nexport * from \"./Actions/index\";\r\nexport * from \"./Animations/index\";\r\nexport * from \"./assetContainer\";\r\nexport * from \"./Audio/index\";\r\nexport * from \"./AudioV2/index\";\r\nexport * from \"./BakedVertexAnimation/index\";\r\nexport * from \"./Behaviors/index\";\r\nexport * from \"./Bones/index\";\r\nexport * from \"./Buffers/index\";\r\nexport * from \"./Cameras/index\";\r\nexport * from \"./Collisions/index\";\r\nexport * from \"./Compat/index\";\r\nexport * from \"./Compute/index\";\r\nexport * from \"./Culling/index\";\r\nexport * from \"./Debug/index\";\r\nexport * from \"./DeviceInput/index\";\r\nexport * from \"./Engines/index\";\r\nexport * from \"./Events/index\";\r\nexport * from \"./FlowGraph/index\";\r\nexport * from \"./FrameGraph/index\";\r\nexport * from \"./Gamepads/index\";\r\nexport * from \"./Gizmos/index\";\r\nexport * from \"./Helpers/index\";\r\nexport * from \"./Instrumentation/index\";\r\nexport * from \"./Layers/index\";\r\nexport * from \"./LensFlares/index\";\r\nexport * from \"./Lights/index\";\r\nexport * from \"./Loading/index\";\r\nexport * from \"./Materials/index\";\r\nexport * from \"./Maths/pure\";\r\nexport * from \"./Meshes/index\";\r\nexport * from \"./Misc/index\";\r\nexport * from \"./Morph/index\";\r\nexport * from \"./Navigation/index\";\r\nexport * from \"./node\";\r\nexport * from \"./ObjectModel/index\";\r\nexport * from \"./Offline/index\";\r\nexport * from \"./Particles/index\";\r\nexport * from \"./Physics/index\";\r\nexport * from \"./PostProcesses/index\";\r\nexport * from \"./Probes/index\";\r\nexport * from \"./Rendering/index\";\r\nexport * from \"./scene\";\r\nexport * from \"./sceneComponent\";\r\nexport * from \"./SmartAssets/index\";\r\nexport * from \"./Sprites/index\";\r\nexport * from \"./States/index\";\r\nexport * from \"./types\";\r\nexport * from \"./XR/index\";\r\n\r\nimport \"./Shaders/ShadersInclude/sceneFragmentDeclaration\";\r\n"]}