Add access to WebXR depth texture + add example (#1018)

* Add access to depth texture

* Update three.js

* Ignore example

* Format

Author: Methuselah96

examples-testing/index.js

@@ -113,6 +113,7 @@ const exceptionList = [
     'webxr_xr_ballshooter',
     'webxr_xr_cubes',
     'webxr_xr_dragging',
+    'webxr_xr_dragging_custom_depth',
     'webxr_xr_haptics',
     'webxr_xr_paint',
     'webxr_xr_sculpt',

three.js

@@ -24,4 +24,6 @@ export class WebXRDepthSensing {
     getMesh(cameraXR: WebXRArrayCamera): Mesh | null;
 
     reset(): void;
+
+    getDepthTexture(): Texture | null;
 }

types/three/src/renderers/webxr/WebXRDepthSensing.d.ts

@@ -6,6 +6,8 @@ import { ArrayCamera } from "../../cameras/ArrayCamera.js";
 import { PerspectiveCamera } from "../../cameras/PerspectiveCamera.js";
 import { EventDispatcher } from "../../core/EventDispatcher.js";
 import { Vector4 } from "../../math/Vector4.js";
+import { Mesh } from "../../objects/Mesh.js";
+import { Texture } from "../../textures/Texture.js";
 import { WebGLRenderer } from "../WebGLRenderer.js";
 import { XRGripSpace, XRHandSpace, XRTargetRaySpace } from "./WebXRController.js";
 
@@ -22,7 +24,10 @@ export interface WebXRManagerEventMap {
 }
 
 export class WebXRManager extends EventDispatcher<WebXRManagerEventMap> {
-    constructor(renderer: WebGLRenderer, gl: WebGLRenderingContext);
+    /**
+     * @default true
+     */
+    cameraAutoUpdate: boolean;
 
     /**
      * @default false
@@ -34,44 +39,49 @@ export class WebXRManager extends EventDispatcher<WebXRManagerEventMap> {
      */
     isPresenting: boolean;
 
-    /**
-     * @default true
-     */
-    cameraAutoUpdate: boolean;
+    constructor(renderer: WebGLRenderer, gl: WebGLRenderingContext);
+
+    getController: (index: number) => XRTargetRaySpace;
+
+    getControllerGrip: (index: number) => XRGripSpace;
+
+    getHand: (index: number) => XRHandSpace;
+
+    setFramebufferScaleFactor: (value: number) => void;
 
-    getController(index: number): XRTargetRaySpace;
+    setReferenceSpaceType: (value: XRReferenceSpaceType) => void;
 
-    getControllerGrip(index: number): XRGripSpace;
+    getReferenceSpace: () => XRReferenceSpace | null;
 
-    getHand(index: number): XRHandSpace;
+    setReferenceSpace: (value: XRReferenceSpace) => void;
 
-    setFramebufferScaleFactor(value: number): void;
+    getBaseLayer: () => XRWebGLLayer | XRProjectionLayer;
 
-    setReferenceSpaceType(value: XRReferenceSpaceType): void;
+    getBinding: () => XRWebGLBinding;
 
-    getReferenceSpace(): XRReferenceSpace | null;
+    getFrame: () => XRFrame;
 
-    setReferenceSpace(value: XRReferenceSpace): void;
+    getSession: () => XRSession | null;
 
-    getBaseLayer(): XRWebGLLayer | XRProjectionLayer;
+    setSession: (value: XRSession | null) => Promise<void>;
 
-    getBinding(): XRWebGLBinding;
+    getEnvironmentBlendMode: () => XREnvironmentBlendMode | undefined;
 
-    getFrame(): XRFrame;
+    getDepthTexture: () => Texture | null;
 
-    getSession(): XRSession | null;
+    updateCamera: (camera: PerspectiveCamera) => void;
 
-    setSession(value: XRSession | null): Promise<void>;
+    getCamera: () => WebXRArrayCamera;
 
-    getCamera(): WebXRArrayCamera;
+    getFoveation: () => number | undefined;
 
-    updateCamera(camera: PerspectiveCamera): void;
+    setFoveation: (value: number) => void;
 
-    setAnimationLoop(callback: XRFrameRequestCallback | null): void;
+    hasDepthSensing: () => boolean;
 
-    getFoveation(): number | undefined;
+    getDepthSensingMesh: () => Mesh | null;
 
-    setFoveation(value: number): void;
+    setAnimationLoop: (callback: XRFrameRequestCallback | null) => void;
 
-    dispose(): void;
+    dispose: () => void;
 }