@onerjs/core 8.54.4 → 8.54.5

package/XR/features/Layers/WebXRWebGPUCompositionLayer.d.ts

@@ -2,23 +2,18 @@ import { type RenderTargetTexture } from "../../../Materials/Textures/renderTarg
 import { type Viewport } from "../../../Maths/math.viewport.js";
 import { Observable } from "../../../Misc/observable.js";
 import { type WebXRLayerRenderTargetTexture } from "../../webXRLayerRenderTargetTexture.js";
-import { type WebXRLayerType, WebXRLayerWrapper } from "../../webXRLayerWrapper.js";
+import { type WebXRLayerType } from "../../webXRLayerWrapper.js";
 import { type WebXRLayerRenderTargetTextureProvider } from "../../webXRRenderTargetTextureProvider.js";
 import { WebXRWebGPURenderTargetTextureProvider } from "../../webXRWebGPURenderTargetTextureProvider.js";
 import { type WebXRSessionManager } from "../../webXRSessionManager.js";
 import { type Nullable } from "../../../types.js";
+import { WebXRCompositionLayerWrapper } from "./WebXRCompositionLayer.js";
 /**
  * Wraps xr composition layers for the WebGPU (XRGPUBinding) backend.
  * Mirrors {@link WebXRCompositionLayerWrapper} for WebGPU.
  * @internal
  */
-export declare class WebXRWebGPUCompositionLayerWrapper extends WebXRLayerWrapper {
-    getWidth: () => number;
-    getHeight: () => number;
-    readonly layer: XRCompositionLayer;
-    readonly layerType: WebXRLayerType;
-    readonly isMultiview: boolean;
-    createRTTProvider: (xrSessionManager: WebXRSessionManager) => WebXRLayerRenderTargetTextureProvider;
+export declare class WebXRWebGPUCompositionLayerWrapper extends WebXRCompositionLayerWrapper {
     constructor(getWidth: () => number, getHeight: () => number, layer: XRCompositionLayer, layerType: WebXRLayerType, isMultiview: boolean, createRTTProvider: (xrSessionManager: WebXRSessionManager) => WebXRLayerRenderTargetTextureProvider);
 }
 /**
@@ -28,7 +23,6 @@ export declare class WebXRWebGPUCompositionLayerWrapper extends WebXRLayerWrappe
  * @internal
  */
 export declare class WebXRWebGPUCompositionLayerRenderTargetTextureProvider extends WebXRWebGPURenderTargetTextureProvider {
-    protected readonly _xrSessionManager: WebXRSessionManager;
     protected readonly _xrGPUBinding: XRGPUBinding;
     readonly layerWrapper: WebXRWebGPUCompositionLayerWrapper;
     protected readonly _depthStencilFormat?: GPUTextureFormat | undefined;

package/XR/features/Layers/WebXRWebGPUCompositionLayer.js

@@ -1,20 +1,14 @@
 import { Observable } from "../../../Misc/observable.js";
-import { WebXRLayerWrapper } from "../../webXRLayerWrapper.js";
 import { WebXRWebGPURenderTargetTextureProvider } from "../../webXRWebGPURenderTargetTextureProvider.js";
+import { WebXRCompositionLayerWrapper } from "./WebXRCompositionLayer.js";
 /**
  * Wraps xr composition layers for the WebGPU (XRGPUBinding) backend.
  * Mirrors {@link WebXRCompositionLayerWrapper} for WebGPU.
  * @internal
  */
-export class WebXRWebGPUCompositionLayerWrapper extends WebXRLayerWrapper {
+export class WebXRWebGPUCompositionLayerWrapper extends WebXRCompositionLayerWrapper {
     constructor(getWidth, getHeight, layer, layerType, isMultiview, createRTTProvider) {
-        super(getWidth, getHeight, layer, layerType, createRTTProvider);
-        this.getWidth = getWidth;
-        this.getHeight = getHeight;
-        this.layer = layer;
-        this.layerType = layerType;
-        this.isMultiview = isMultiview;
-        this.createRTTProvider = createRTTProvider;
+        super(getWidth, getHeight, layer, layerType, isMultiview, createRTTProvider);
     }
 }
 /**
@@ -25,8 +19,7 @@ export class WebXRWebGPUCompositionLayerWrapper extends WebXRLayerWrapper {
  */
 export class WebXRWebGPUCompositionLayerRenderTargetTextureProvider extends WebXRWebGPURenderTargetTextureProvider {
     constructor(_xrSessionManager, _xrGPUBinding, layerWrapper, _depthStencilFormat) {
-        super(_xrSessionManager.scene, layerWrapper);
-        this._xrSessionManager = _xrSessionManager;
+        super(_xrSessionManager, layerWrapper);
         this._xrGPUBinding = _xrGPUBinding;
         this.layerWrapper = layerWrapper;
         this._depthStencilFormat = _depthStencilFormat;

package/XR/features/Layers/WebXRWebGPUCompositionLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebXRWebGPUCompositionLayer.js","sourceRoot":"","sources":["../../../../../../dev/core/src/XR/features/Layers/WebXRWebGPUCompositionLayer.ts"],"names":[],"mappings":"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","sourcesContent":["import { type RenderTargetTexture } from \"core/Materials/Textures/renderTargetTexture\";\nimport { type Viewport } from \"core/Maths/math.viewport\";\nimport { Observable } from \"core/Misc/observable\";\nimport { type WebXRLayerRenderTargetTexture } from \"core/XR/webXRLayerRenderTargetTexture\";\nimport { type WebXRLayerType, WebXRLayerWrapper } from \"core/XR/webXRLayerWrapper\";\nimport { type WebXRLayerRenderTargetTextureProvider } from \"core/XR/webXRRenderTargetTextureProvider\";\nimport { WebXRWebGPURenderTargetTextureProvider } from \"core/XR/webXRWebGPURenderTargetTextureProvider\";\nimport { type WebXRSessionManager } from \"core/XR/webXRSessionManager\";\nimport { type Nullable } from \"core/types\";\n\n/**\n * Wraps xr composition layers for the WebGPU (XRGPUBinding) backend.\n * Mirrors {@link WebXRCompositionLayerWrapper} for WebGPU.\n * @internal\n */\nexport class WebXRWebGPUCompositionLayerWrapper extends WebXRLayerWrapper {\n    constructor(\n        public override getWidth: () => number,\n        public override getHeight: () => number,\n        public override readonly layer: XRCompositionLayer,\n        public override readonly layerType: WebXRLayerType,\n        public readonly isMultiview: boolean,\n        public createRTTProvider: (xrSessionManager: WebXRSessionManager) => WebXRLayerRenderTargetTextureProvider\n    ) {\n        super(getWidth, getHeight, layer, layerType, createRTTProvider);\n    }\n}\n\n/**\n * Provides render target textures and other important rendering information for a given XRCompositionLayer\n * on the WebGPU backend. Mirrors {@link WebXRCompositionLayerRenderTargetTextureProvider}, but wraps\n * {@link XRGPUSubImage} GPUTextures instead of WebGL textures.\n * @internal\n */\nexport class WebXRWebGPUCompositionLayerRenderTargetTextureProvider extends WebXRWebGPURenderTargetTextureProvider {\n    protected _lastSubImages = new Map<XREye, XRGPUSubImage>();\n    /**\n     * Per-eye render targets, indexed by eye (0 = left/none, 1 = right). Kept separate from the base\n     * `_renderTargetTextures` registry: that array is an append-only owned list (each entry is disposed once\n     * on provider dispose), whereas this map is a mutable per-eye slot. Reusing `_renderTargetTextures` as\n     * both would let a rebuilt eye target both stay in the registry (leaking / double-disposing the old one)\n     * and grow the registry unboundedly on repeated size changes.\n     */\n    protected _renderTargetTexturesByEye: WebXRLayerRenderTargetTexture[] = [];\n    private _compositionLayer: XRCompositionLayer;\n    /**\n     * Fires every time a new render target texture is created (either for eye, for view, or for the entire frame)\n     */\n    public onRenderTargetTextureCreatedObservable = new Observable<{ texture: RenderTargetTexture; eye?: XREye }>();\n\n    constructor(\n        protected readonly _xrSessionManager: WebXRSessionManager,\n        protected readonly _xrGPUBinding: XRGPUBinding,\n        public override readonly layerWrapper: WebXRWebGPUCompositionLayerWrapper,\n        protected readonly _depthStencilFormat?: GPUTextureFormat\n    ) {\n        super(_xrSessionManager.scene, layerWrapper);\n        this._compositionLayer = layerWrapper.layer;\n    }\n\n    protected _getRenderTargetForSubImage(subImage: XRGPUSubImage, eye: XREye = \"none\") {\n        const lastSubImage = this._lastSubImages.get(eye);\n        const eyeIndex = eye == \"right\" ? 1 : 0;\n\n        const colorTexture = subImage.colorTexture;\n        const colorTextureWidth = colorTexture.width;\n        const colorTextureHeight = colorTexture.height;\n\n        const depthStencilTexture = subImage.depthStencilTexture ?? null;\n\n        const existingRenderTarget = this._renderTargetTexturesByEye[eyeIndex];\n        const sizeChanged = !existingRenderTarget || lastSubImage?.colorTexture.width !== colorTextureWidth || lastSubImage?.colorTexture.height !== colorTextureHeight;\n\n        if (sizeChanged) {\n            if (existingRenderTarget) {\n                // A previous target for this eye exists (the sub-image size changed, e.g. a scale-factor or\n                // display-config change). Dispose it and remove it from the owned registry before creating the\n                // replacement so the registry does not accumulate stale entries or double-dispose on teardown.\n                this._destroyRenderTargetTexture(existingRenderTarget);\n            }\n            this._renderTargetTexturesByEye[eyeIndex] = this._createRenderTargetTextureFromGPUTextures(\n                colorTextureWidth,\n                colorTextureHeight,\n                colorTexture,\n                depthStencilTexture,\n                this._depthStencilFormat,\n                this.layerWrapper.isMultiview\n            );\n\n            this._framebufferDimensions = {\n                framebufferWidth: colorTextureWidth,\n                framebufferHeight: colorTextureHeight,\n            };\n            this.onRenderTargetTextureCreatedObservable.notifyObservers({ texture: this._renderTargetTexturesByEye[eyeIndex], eye });\n        } else {\n            // Same size: repoint the wrapped textures at this frame's GPUTextures, preserving the\n            // RenderTargetTexture / InternalTexture identity held by the XR camera's outputRenderTarget.\n            this._updateRenderTargetTextureFromGPUTextures(existingRenderTarget, colorTexture, depthStencilTexture);\n        }\n\n        this._lastSubImages.set(eye, subImage);\n\n        // The projection-layer color/depth textures may be a texture ARRAY with one layer per eye\n        // (depthOrArrayLayers > 1). The sub-image's view descriptor carries the authoritative array-layer\n        // index for this eye, so route it into the render target's bind so each eye renders into its own\n        // layer. For non-layered textures this is 0 (unchanged behavior).\n        const renderTargetTexture = this._renderTargetTexturesByEye[eyeIndex];\n        renderTargetTexture.layerIndex = subImage.getViewDescriptor().baseArrayLayer ?? 0;\n\n        return renderTargetTexture;\n    }\n\n    private _getSubImageForEye(eye?: XREye): Nullable<XRGPUSubImage> {\n        const currentFrame = this._xrSessionManager.currentFrame;\n        if (currentFrame) {\n            return this._xrGPUBinding.getSubImage(this._compositionLayer, currentFrame, eye);\n        }\n        return null;\n    }\n\n    public getRenderTargetTextureForEye(eye?: XREye): Nullable<RenderTargetTexture> {\n        const subImage = this._getSubImageForEye(eye);\n        if (subImage) {\n            return this._getRenderTargetForSubImage(subImage, eye);\n        }\n        return null;\n    }\n\n    public getRenderTargetTextureForView(view?: XRView): Nullable<RenderTargetTexture> {\n        return this.getRenderTargetTextureForEye(view?.eye);\n    }\n\n    protected _setViewportForSubImage(viewport: Viewport, subImage: XRGPUSubImage) {\n        const textureWidth = subImage.colorTexture.width;\n        const textureHeight = subImage.colorTexture.height;\n        const xrViewport = subImage.viewport;\n        viewport.x = xrViewport.x / textureWidth;\n        viewport.y = xrViewport.y / textureHeight;\n        viewport.width = xrViewport.width / textureWidth;\n        viewport.height = xrViewport.height / textureHeight;\n    }\n\n    public trySetViewportForView(viewport: Viewport, view: XRView): boolean {\n        const subImage = this._lastSubImages.get(view.eye) || this._getSubImageForEye(view.eye);\n        if (subImage) {\n            this._setViewportForSubImage(viewport, subImage);\n            return true;\n        }\n        return false;\n    }\n}\n"]}
+{"version":3,"file":"WebXRWebGPUCompositionLayer.js","sourceRoot":"","sources":["../../../../../../dev/core/src/XR/features/Layers/WebXRWebGPUCompositionLayer.ts"],"names":[],"mappings":"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","sourcesContent":["import { type RenderTargetTexture } from \"core/Materials/Textures/renderTargetTexture\";\nimport { type Viewport } from \"core/Maths/math.viewport\";\nimport { Observable } from \"core/Misc/observable\";\nimport { type WebXRLayerRenderTargetTexture } from \"core/XR/webXRLayerRenderTargetTexture\";\nimport { type WebXRLayerType } from \"core/XR/webXRLayerWrapper\";\nimport { type WebXRLayerRenderTargetTextureProvider } from \"core/XR/webXRRenderTargetTextureProvider\";\nimport { WebXRWebGPURenderTargetTextureProvider } from \"core/XR/webXRWebGPURenderTargetTextureProvider\";\nimport { type WebXRSessionManager } from \"core/XR/webXRSessionManager\";\nimport { type Nullable } from \"core/types\";\nimport { WebXRCompositionLayerWrapper } from \"./WebXRCompositionLayer\";\n\n/**\n * Wraps xr composition layers for the WebGPU (XRGPUBinding) backend.\n * Mirrors {@link WebXRCompositionLayerWrapper} for WebGPU.\n * @internal\n */\nexport class WebXRWebGPUCompositionLayerWrapper extends WebXRCompositionLayerWrapper {\n    constructor(\n        getWidth: () => number,\n        getHeight: () => number,\n        layer: XRCompositionLayer,\n        layerType: WebXRLayerType,\n        isMultiview: boolean,\n        createRTTProvider: (xrSessionManager: WebXRSessionManager) => WebXRLayerRenderTargetTextureProvider\n    ) {\n        super(getWidth, getHeight, layer, layerType, isMultiview, createRTTProvider);\n    }\n}\n\n/**\n * Provides render target textures and other important rendering information for a given XRCompositionLayer\n * on the WebGPU backend. Mirrors {@link WebXRCompositionLayerRenderTargetTextureProvider}, but wraps\n * {@link XRGPUSubImage} GPUTextures instead of WebGL textures.\n * @internal\n */\nexport class WebXRWebGPUCompositionLayerRenderTargetTextureProvider extends WebXRWebGPURenderTargetTextureProvider {\n    protected _lastSubImages = new Map<XREye, XRGPUSubImage>();\n    /**\n     * Per-eye render targets, indexed by eye (0 = left/none, 1 = right). Kept separate from the base\n     * `_renderTargetTextures` registry: that array is an append-only owned list (each entry is disposed once\n     * on provider dispose), whereas this map is a mutable per-eye slot. Reusing `_renderTargetTextures` as\n     * both would let a rebuilt eye target both stay in the registry (leaking / double-disposing the old one)\n     * and grow the registry unboundedly on repeated size changes.\n     */\n    protected _renderTargetTexturesByEye: WebXRLayerRenderTargetTexture[] = [];\n    private _compositionLayer: XRCompositionLayer;\n    /**\n     * Fires every time a new render target texture is created (either for eye, for view, or for the entire frame)\n     */\n    public onRenderTargetTextureCreatedObservable = new Observable<{ texture: RenderTargetTexture; eye?: XREye }>();\n\n    constructor(\n        _xrSessionManager: WebXRSessionManager,\n        protected readonly _xrGPUBinding: XRGPUBinding,\n        public override readonly layerWrapper: WebXRWebGPUCompositionLayerWrapper,\n        protected readonly _depthStencilFormat?: GPUTextureFormat\n    ) {\n        super(_xrSessionManager, layerWrapper);\n        this._compositionLayer = layerWrapper.layer;\n    }\n\n    protected _getRenderTargetForSubImage(subImage: XRGPUSubImage, eye: XREye = \"none\") {\n        const lastSubImage = this._lastSubImages.get(eye);\n        const eyeIndex = eye == \"right\" ? 1 : 0;\n\n        const colorTexture = subImage.colorTexture;\n        const colorTextureWidth = colorTexture.width;\n        const colorTextureHeight = colorTexture.height;\n\n        const depthStencilTexture = subImage.depthStencilTexture ?? null;\n\n        const existingRenderTarget = this._renderTargetTexturesByEye[eyeIndex];\n        const sizeChanged = !existingRenderTarget || lastSubImage?.colorTexture.width !== colorTextureWidth || lastSubImage?.colorTexture.height !== colorTextureHeight;\n\n        if (sizeChanged) {\n            if (existingRenderTarget) {\n                // A previous target for this eye exists (the sub-image size changed, e.g. a scale-factor or\n                // display-config change). Dispose it and remove it from the owned registry before creating the\n                // replacement so the registry does not accumulate stale entries or double-dispose on teardown.\n                this._destroyRenderTargetTexture(existingRenderTarget);\n            }\n            this._renderTargetTexturesByEye[eyeIndex] = this._createRenderTargetTextureFromGPUTextures(\n                colorTextureWidth,\n                colorTextureHeight,\n                colorTexture,\n                depthStencilTexture,\n                this._depthStencilFormat,\n                this.layerWrapper.isMultiview\n            );\n\n            this._framebufferDimensions = {\n                framebufferWidth: colorTextureWidth,\n                framebufferHeight: colorTextureHeight,\n            };\n            this.onRenderTargetTextureCreatedObservable.notifyObservers({ texture: this._renderTargetTexturesByEye[eyeIndex], eye });\n        } else {\n            // Same size: repoint the wrapped textures at this frame's GPUTextures, preserving the\n            // RenderTargetTexture / InternalTexture identity held by the XR camera's outputRenderTarget.\n            this._updateRenderTargetTextureFromGPUTextures(existingRenderTarget, colorTexture, depthStencilTexture);\n        }\n\n        this._lastSubImages.set(eye, subImage);\n\n        // The projection-layer color/depth textures may be a texture ARRAY with one layer per eye\n        // (depthOrArrayLayers > 1). The sub-image's view descriptor carries the authoritative array-layer\n        // index for this eye, so route it into the render target's bind so each eye renders into its own\n        // layer. For non-layered textures this is 0 (unchanged behavior).\n        const renderTargetTexture = this._renderTargetTexturesByEye[eyeIndex];\n        renderTargetTexture.layerIndex = subImage.getViewDescriptor().baseArrayLayer ?? 0;\n\n        return renderTargetTexture;\n    }\n\n    private _getSubImageForEye(eye?: XREye): Nullable<XRGPUSubImage> {\n        const currentFrame = this._xrSessionManager.currentFrame;\n        if (currentFrame) {\n            return this._xrGPUBinding.getSubImage(this._compositionLayer, currentFrame, eye);\n        }\n        return null;\n    }\n\n    public getRenderTargetTextureForEye(eye?: XREye): Nullable<RenderTargetTexture> {\n        const subImage = this._getSubImageForEye(eye);\n        if (subImage) {\n            return this._getRenderTargetForSubImage(subImage, eye);\n        }\n        return null;\n    }\n\n    public getRenderTargetTextureForView(view?: XRView): Nullable<RenderTargetTexture> {\n        return this.getRenderTargetTextureForEye(view?.eye);\n    }\n\n    protected _setViewportForSubImage(viewport: Viewport, subImage: XRGPUSubImage) {\n        const textureWidth = subImage.colorTexture.width;\n        const textureHeight = subImage.colorTexture.height;\n        const xrViewport = subImage.viewport;\n        viewport.x = xrViewport.x / textureWidth;\n        viewport.y = xrViewport.y / textureHeight;\n        viewport.width = xrViewport.width / textureWidth;\n        viewport.height = xrViewport.height / textureHeight;\n    }\n\n    public trySetViewportForView(viewport: Viewport, view: XRView): boolean {\n        const subImage = this._lastSubImages.get(view.eye) || this._getSubImageForEye(view.eye);\n        if (subImage) {\n            this._setViewportForSubImage(viewport, subImage);\n            return true;\n        }\n        return false;\n    }\n}\n"]}

package/XR/features/WebXRAbstractFeature.d.ts

@@ -9,6 +9,7 @@ import { type WebXRSessionManager } from "../webXRSessionManager.js";
 export declare abstract class WebXRAbstractFeature implements IWebXRFeature {
     protected _xrSessionManager: WebXRSessionManager;
     private _attached;
+    private _disableAutoAttachWarningEmitted;
     private _removeOnDetach;
     /**
      * Is this feature disposed?
@@ -18,6 +19,8 @@ export declare abstract class WebXRAbstractFeature implements IWebXRFeature {
      * Should auto-attach be disabled?
      */
     disableAutoAttach: boolean;
+    /** @internal */
+    _autoAttachPolicyBeforeAttach?: boolean;
     protected _xrNativeFeatureName: string;
     /**
      * The name of the native xr feature name (like anchor, hit-test, or hand-tracking)
@@ -69,6 +72,12 @@ export declare abstract class WebXRAbstractFeature implements IWebXRFeature {
      * @returns whether or not the feature is compatible in this environment
      */
     isCompatible(): boolean;
+    /**
+     * Disables future automatic attachment when a runtime capability required by the feature is unavailable.
+     * @param warning the specific warning explaining why the feature was disabled
+     * @returns false so feature attach implementations can return the result directly
+     */
+    protected _disableAutoAttach(warning: string): false;
     /**
      * This is used to register callbacks that will automatically be removed when detach is called.
      * @param observable the observable to which the observer will be attached

package/XR/features/WebXRAbstractFeature.js

@@ -1,3 +1,4 @@
+import { _MarkWebXRFeatureWithSpecificDisableWarning } from "../webXRFeatureWarningRegistry.js";
 import { Observable } from "../../Misc/observable.js";
 import { Logger } from "../../Misc/logger.js";
 /**
@@ -26,6 +27,7 @@ export class WebXRAbstractFeature {
     constructor(_xrSessionManager) {
         this._xrSessionManager = _xrSessionManager;
         this._attached = false;
+        this._disableAutoAttachWarningEmitted = false;
         this._removeOnDetach = [];
         /**
          * Is this feature disposed?
@@ -122,6 +124,20 @@ export class WebXRAbstractFeature {
     isCompatible() {
         return true;
     }
+    /**
+     * Disables future automatic attachment when a runtime capability required by the feature is unavailable.
+     * @param warning the specific warning explaining why the feature was disabled
+     * @returns false so feature attach implementations can return the result directly
+     */
+    _disableAutoAttach(warning) {
+        if (!this._disableAutoAttachWarningEmitted) {
+            Logger.Warn(warning);
+            this._disableAutoAttachWarningEmitted = true;
+        }
+        _MarkWebXRFeatureWithSpecificDisableWarning(this);
+        this.disableAutoAttach = true;
+        return false;
+    }
     /**
      * This is used to register callbacks that will automatically be removed when detach is called.
      * @param observable the observable to which the observer will be attached

package/XR/features/WebXRAbstractFeature.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebXRAbstractFeature.js","sourceRoot":"","sources":["../../../../../dev/core/src/XR/features/WebXRAbstractFeature.ts"],"names":[],"mappings":"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","sourcesContent":["import { type IWebXRFeature } from \"../webXRFeaturesManager\";\r\nimport { type Observer, type EventState, Observable } from \"../../Misc/observable\";\r\nimport { type Nullable } from \"../../types\";\r\nimport { type WebXRSessionManager } from \"../webXRSessionManager\";\r\nimport { Logger } from \"core/Misc/logger\";\r\n\r\n/**\r\n * This is the base class for all WebXR features.\r\n * Since most features require almost the same resources and callbacks, this class can be used to simplify the development\r\n * Note that since the features manager is using the `IWebXRFeature` you are in no way obligated to use this class\r\n */\r\nexport abstract class WebXRAbstractFeature implements IWebXRFeature {\r\n    private _attached: boolean = false;\r\n    private _removeOnDetach: {\r\n        observer: Nullable<Observer<any>>;\r\n        observable: Observable<any>;\r\n    }[] = [];\r\n\r\n    /**\r\n     * Is this feature disposed?\r\n     */\r\n    public isDisposed: boolean = false;\r\n\r\n    /**\r\n     * Should auto-attach be disabled?\r\n     */\r\n    public disableAutoAttach: boolean = false;\r\n\r\n    protected _xrNativeFeatureName: string = \"\";\r\n\r\n    /**\r\n     * The name of the native xr feature name (like anchor, hit-test, or hand-tracking)\r\n     */\r\n    public get xrNativeFeatureName() {\r\n        return this._xrNativeFeatureName;\r\n    }\r\n\r\n    public set xrNativeFeatureName(name: string) {\r\n        // check if feature was initialized while in session but needs to be initialized before the session starts\r\n        if (!this._xrSessionManager.isNative && name && this._xrSessionManager.inXRSession && this._xrSessionManager.enabledFeatures?.indexOf(name) === -1) {\r\n            Logger.Warn(`The feature ${name} needs to be enabled before starting the XR session. Note - It is still possible it is not supported.`);\r\n        }\r\n        this._xrNativeFeatureName = name;\r\n    }\r\n\r\n    /**\r\n     * Observers registered here will be executed when the feature is attached\r\n     */\r\n    public onFeatureAttachObservable: Observable<IWebXRFeature> = new Observable();\r\n    /**\r\n     * Observers registered here will be executed when the feature is detached\r\n     */\r\n    public onFeatureDetachObservable: Observable<IWebXRFeature> = new Observable();\r\n\r\n    /**\r\n     * The dependencies of this feature, if any\r\n     */\r\n    public dependsOn?: string[];\r\n\r\n    /**\r\n     * Construct a new (abstract) WebXR feature\r\n     * @param _xrSessionManager the xr session manager for this feature\r\n     */\r\n    constructor(protected _xrSessionManager: WebXRSessionManager) {}\r\n\r\n    /**\r\n     * Is this feature attached\r\n     */\r\n    public get attached() {\r\n        return this._attached;\r\n    }\r\n\r\n    /**\r\n     * attach this feature\r\n     *\r\n     * @param force should attachment be forced (even when already attached)\r\n     * @returns true if successful, false is failed or already attached\r\n     */\r\n    public attach(force?: boolean): boolean {\r\n        // do not attach a disposed feature\r\n        if (this.isDisposed) {\r\n            return false;\r\n        }\r\n        if (!force) {\r\n            if (this.attached) {\r\n                return false;\r\n            }\r\n        } else {\r\n            if (this.attached) {\r\n                // detach first, to be sure\r\n                this.detach();\r\n            }\r\n        }\r\n\r\n        // if this is a native WebXR feature, check if it is enabled on the session\r\n        // For now only check if not using babylon native\r\n        // vision OS doesn't support the enabledFeatures array, so just warn instead of failing\r\n        if (!this._xrSessionManager.enabledFeatures) {\r\n            Logger.Warn(\"session.enabledFeatures is not available on this device. It is possible that this feature is not supported.\");\r\n        } else if (!this._xrSessionManager.isNative && this.xrNativeFeatureName && this._xrSessionManager.enabledFeatures.indexOf(this.xrNativeFeatureName) === -1) {\r\n            return false;\r\n        }\r\n\r\n        this._attached = true;\r\n        this._addNewAttachObserver(this._xrSessionManager.onXRFrameObservable, (frame) => this._onXRFrame(frame));\r\n        this.onFeatureAttachObservable.notifyObservers(this);\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     * detach this feature.\r\n     *\r\n     * @returns true if successful, false if failed or already detached\r\n     */\r\n    public detach(): boolean {\r\n        if (!this._attached) {\r\n            this.disableAutoAttach = true;\r\n            return false;\r\n        }\r\n        this._attached = false;\r\n        for (const toRemove of this._removeOnDetach) {\r\n            toRemove.observable.remove(toRemove.observer);\r\n        }\r\n        this.onFeatureDetachObservable.notifyObservers(this);\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     * Dispose this feature and all of the resources attached\r\n     */\r\n    public dispose(): void {\r\n        this.detach();\r\n        this.isDisposed = true;\r\n        this.onFeatureAttachObservable.clear();\r\n        this.onFeatureDetachObservable.clear();\r\n    }\r\n\r\n    /**\r\n     * This function will be executed during before enabling the feature and can be used to not-allow enabling it.\r\n     * Note that at this point the session has NOT started, so this is purely checking if the browser supports it\r\n     *\r\n     * @returns whether or not the feature is compatible in this environment\r\n     */\r\n    public isCompatible(): boolean {\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     * This is used to register callbacks that will automatically be removed when detach is called.\r\n     * @param observable the observable to which the observer will be attached\r\n     * @param callback the callback to register\r\n     * @param insertFirst should the callback be executed as soon as it is registered\r\n     */\r\n    protected _addNewAttachObserver<T>(observable: Observable<T>, callback: (eventData: T, eventState: EventState) => void, insertFirst?: boolean) {\r\n        this._removeOnDetach.push({\r\n            observable,\r\n            observer: observable.add(callback, undefined, insertFirst),\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Code in this function will be executed on each xrFrame received from the browser.\r\n     * This function will not execute after the feature is detached.\r\n     * @param _xrFrame the current frame\r\n     */\r\n    protected abstract _onXRFrame(_xrFrame: XRFrame): void;\r\n}\r\n"]}
+{"version":3,"file":"WebXRAbstractFeature.js","sourceRoot":"","sources":["../../../../../dev/core/src/XR/features/WebXRAbstractFeature.ts"],"names":[],"mappings":"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","sourcesContent":["import { type IWebXRFeature } from \"../webXRFeaturesManager\";\r\nimport { _MarkWebXRFeatureWithSpecificDisableWarning } from \"../webXRFeatureWarningRegistry\";\r\nimport { type Observer, type EventState, Observable } from \"../../Misc/observable\";\r\nimport { type Nullable } from \"../../types\";\r\nimport { type WebXRSessionManager } from \"../webXRSessionManager\";\r\nimport { Logger } from \"core/Misc/logger\";\r\n\r\n/**\r\n * This is the base class for all WebXR features.\r\n * Since most features require almost the same resources and callbacks, this class can be used to simplify the development\r\n * Note that since the features manager is using the `IWebXRFeature` you are in no way obligated to use this class\r\n */\r\nexport abstract class WebXRAbstractFeature implements IWebXRFeature {\r\n    private _attached: boolean = false;\r\n    private _disableAutoAttachWarningEmitted: boolean = false;\r\n    private _removeOnDetach: {\r\n        observer: Nullable<Observer<any>>;\r\n        observable: Observable<any>;\r\n    }[] = [];\r\n\r\n    /**\r\n     * Is this feature disposed?\r\n     */\r\n    public isDisposed: boolean = false;\r\n\r\n    /**\r\n     * Should auto-attach be disabled?\r\n     */\r\n    public disableAutoAttach: boolean = false;\r\n\r\n    /** @internal */\r\n    public _autoAttachPolicyBeforeAttach?: boolean;\r\n\r\n    protected _xrNativeFeatureName: string = \"\";\r\n\r\n    /**\r\n     * The name of the native xr feature name (like anchor, hit-test, or hand-tracking)\r\n     */\r\n    public get xrNativeFeatureName() {\r\n        return this._xrNativeFeatureName;\r\n    }\r\n\r\n    public set xrNativeFeatureName(name: string) {\r\n        // check if feature was initialized while in session but needs to be initialized before the session starts\r\n        if (!this._xrSessionManager.isNative && name && this._xrSessionManager.inXRSession && this._xrSessionManager.enabledFeatures?.indexOf(name) === -1) {\r\n            Logger.Warn(`The feature ${name} needs to be enabled before starting the XR session. Note - It is still possible it is not supported.`);\r\n        }\r\n        this._xrNativeFeatureName = name;\r\n    }\r\n\r\n    /**\r\n     * Observers registered here will be executed when the feature is attached\r\n     */\r\n    public onFeatureAttachObservable: Observable<IWebXRFeature> = new Observable();\r\n    /**\r\n     * Observers registered here will be executed when the feature is detached\r\n     */\r\n    public onFeatureDetachObservable: Observable<IWebXRFeature> = new Observable();\r\n\r\n    /**\r\n     * The dependencies of this feature, if any\r\n     */\r\n    public dependsOn?: string[];\r\n\r\n    /**\r\n     * Construct a new (abstract) WebXR feature\r\n     * @param _xrSessionManager the xr session manager for this feature\r\n     */\r\n    constructor(protected _xrSessionManager: WebXRSessionManager) {}\r\n\r\n    /**\r\n     * Is this feature attached\r\n     */\r\n    public get attached() {\r\n        return this._attached;\r\n    }\r\n\r\n    /**\r\n     * attach this feature\r\n     *\r\n     * @param force should attachment be forced (even when already attached)\r\n     * @returns true if successful, false is failed or already attached\r\n     */\r\n    public attach(force?: boolean): boolean {\r\n        // do not attach a disposed feature\r\n        if (this.isDisposed) {\r\n            return false;\r\n        }\r\n        if (!force) {\r\n            if (this.attached) {\r\n                return false;\r\n            }\r\n        } else {\r\n            if (this.attached) {\r\n                // detach first, to be sure\r\n                this.detach();\r\n            }\r\n        }\r\n\r\n        // if this is a native WebXR feature, check if it is enabled on the session\r\n        // For now only check if not using babylon native\r\n        // vision OS doesn't support the enabledFeatures array, so just warn instead of failing\r\n        if (!this._xrSessionManager.enabledFeatures) {\r\n            Logger.Warn(\"session.enabledFeatures is not available on this device. It is possible that this feature is not supported.\");\r\n        } else if (!this._xrSessionManager.isNative && this.xrNativeFeatureName && this._xrSessionManager.enabledFeatures.indexOf(this.xrNativeFeatureName) === -1) {\r\n            return false;\r\n        }\r\n\r\n        this._attached = true;\r\n        this._addNewAttachObserver(this._xrSessionManager.onXRFrameObservable, (frame) => this._onXRFrame(frame));\r\n        this.onFeatureAttachObservable.notifyObservers(this);\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     * detach this feature.\r\n     *\r\n     * @returns true if successful, false if failed or already detached\r\n     */\r\n    public detach(): boolean {\r\n        if (!this._attached) {\r\n            this.disableAutoAttach = true;\r\n            return false;\r\n        }\r\n        this._attached = false;\r\n        for (const toRemove of this._removeOnDetach) {\r\n            toRemove.observable.remove(toRemove.observer);\r\n        }\r\n        this.onFeatureDetachObservable.notifyObservers(this);\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     * Dispose this feature and all of the resources attached\r\n     */\r\n    public dispose(): void {\r\n        this.detach();\r\n        this.isDisposed = true;\r\n        this.onFeatureAttachObservable.clear();\r\n        this.onFeatureDetachObservable.clear();\r\n    }\r\n\r\n    /**\r\n     * This function will be executed during before enabling the feature and can be used to not-allow enabling it.\r\n     * Note that at this point the session has NOT started, so this is purely checking if the browser supports it\r\n     *\r\n     * @returns whether or not the feature is compatible in this environment\r\n     */\r\n    public isCompatible(): boolean {\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     * Disables future automatic attachment when a runtime capability required by the feature is unavailable.\r\n     * @param warning the specific warning explaining why the feature was disabled\r\n     * @returns false so feature attach implementations can return the result directly\r\n     */\r\n    protected _disableAutoAttach(warning: string): false {\r\n        if (!this._disableAutoAttachWarningEmitted) {\r\n            Logger.Warn(warning);\r\n            this._disableAutoAttachWarningEmitted = true;\r\n        }\r\n        _MarkWebXRFeatureWithSpecificDisableWarning(this);\r\n        this.disableAutoAttach = true;\r\n        return false;\r\n    }\r\n\r\n    /**\r\n     * This is used to register callbacks that will automatically be removed when detach is called.\r\n     * @param observable the observable to which the observer will be attached\r\n     * @param callback the callback to register\r\n     * @param insertFirst should the callback be executed as soon as it is registered\r\n     */\r\n    protected _addNewAttachObserver<T>(observable: Observable<T>, callback: (eventData: T, eventState: EventState) => void, insertFirst?: boolean) {\r\n        this._removeOnDetach.push({\r\n            observable,\r\n            observer: observable.add(callback, undefined, insertFirst),\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Code in this function will be executed on each xrFrame received from the browser.\r\n     * This function will not execute after the feature is detached.\r\n     * @param _xrFrame the current frame\r\n     */\r\n    protected abstract _onXRFrame(_xrFrame: XRFrame): void;\r\n}\r\n"]}

package/XR/features/WebXRDepthSensing.pure.d.ts

@@ -52,7 +52,12 @@ export declare class WebXRDepthSensing extends WebXRAbstractFeature {
     private _cachedDepthBuffer;
     private _cachedWebGLTexture;
     private _cachedDepthImageTexture;
+    private _cachedDepthImageTextureWrapsExternalTexture;
+    private _cpuDepthViewStates;
+    private _disableAutoAttachBeforeWebGPUGPUDepth;
+    private _disabledForWebGPUGPUDepth;
     private _onCameraObserver;
+    private _onSessionEndedObserver;
     /**
      * Width of depth data. If depth data is not exist, returns null.
      */
@@ -130,6 +135,8 @@ export declare class WebXRDepthSensing extends WebXRAbstractFeature {
     dispose(): void;
     protected _onXRFrame(_xrFrame: XRFrame): void;
     private _updateDepthInformationAndTextureCPUDepthUsage;
+    private _clearCPUDepthBinding;
+    private _bindCPUDepthView;
     private _updateDepthInformationAndTextureWebGLDepthUsage;
     /**
      * Extends the session init object if needed