super-three 0.157.0 → 0.157.1

package/build/three.js

@@ -14754,7 +14754,7 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 				if ( boxMesh === undefined ) {
 
 					boxMesh = new Mesh(
-						new BoxGeometry( 1, 1, 1 ),
+						new BoxGeometry( 10000, 10000, 10000 ),
 						new ShaderMaterial( {
 							name: 'BackgroundCubeMaterial',
 							uniforms: cloneUniforms( ShaderLib.backgroundCube.uniforms ),
@@ -17850,6 +17850,103 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 	}
 
+	/**
+	 * @author fernandojsg / http://fernandojsg.com
+	 * @author Takahiro https://github.com/takahirox
+	 */
+
+	class WebGLMultiview {
+
+		 constructor( renderer, extensions, gl ) {
+
+			 this.renderer = renderer;
+
+			 this.DEFAULT_NUMVIEWS = 2;
+			 this.maxNumViews = 0;
+			 this.gl = gl;
+
+			 this.extensions = extensions;
+
+			 this.available = this.extensions.has( 'OCULUS_multiview' );
+
+			 if ( this.available ) {
+
+				 const extension = this.extensions.get( 'OCULUS_multiview' );
+
+				 this.maxNumViews = this.gl.getParameter( extension.MAX_VIEWS_OVR );
+
+				 this.mat4 = [];
+				 this.mat3 = [];
+				 this.cameraArray = [];
+
+				 for ( var i = 0; i < this.maxNumViews; i ++ ) {
+
+					 this.mat4[ i ] = new Matrix4();
+					 this.mat3[ i ] = new Matrix3();
+
+				 }
+
+			 }
+
+		 }
+
+		 //
+		 getCameraArray( camera ) {
+
+			 if ( camera.isArrayCamera ) return camera.cameras;
+
+			 this.cameraArray[ 0 ] = camera;
+
+			 return this.cameraArray;
+
+		 }
+
+		 updateCameraProjectionMatricesUniform( camera, uniforms ) {
+
+			 var cameras = this.getCameraArray( camera );
+
+			 for ( var i = 0; i < cameras.length; i ++ ) {
+
+				 this.mat4[ i ].copy( cameras[ i ].projectionMatrix );
+
+			 }
+
+			 uniforms.setValue( this.gl, 'projectionMatrices', this.mat4 );
+
+		 }
+
+		 updateCameraViewMatricesUniform( camera, uniforms ) {
+
+			 var cameras = this.getCameraArray( camera );
+
+			 for ( var i = 0; i < cameras.length; i ++ ) {
+
+				 this.mat4[ i ].copy( cameras[ i ].matrixWorldInverse );
+
+			 }
+
+			 uniforms.setValue( this.gl, 'viewMatrices', this.mat4 );
+
+		 }
+
+		 updateObjectMatricesUniforms( object, camera, uniforms ) {
+
+			 var cameras = this.getCameraArray( camera );
+
+			 for ( var i = 0; i < cameras.length; i ++ ) {
+
+				 this.mat4[ i ].multiplyMatrices( cameras[ i ].matrixWorldInverse, object.matrixWorld );
+				 this.mat3[ i ].getNormalMatrix( this.mat4[ i ] );
+
+			 }
+
+			 uniforms.setValue( this.gl, 'modelViewMatrices', this.mat4 );
+			 uniforms.setValue( this.gl, 'normalMatrices', this.mat3 );
+
+		 }
+
+	}
+
 	function WebGLObjects( gl, geometries, attributes, info ) {
 
 		let updateMap = new WeakMap();
@@ -19543,6 +19640,8 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 		let prefixVertex, prefixFragment;
 		let versionString = parameters.glslVersion ? '#version ' + parameters.glslVersion + '\n' : '';
 
+		const numMultiviewViews = parameters.numMultiviewViews;
+
 		if ( parameters.isRawShaderMaterial ) {
 
 			prefixVertex = [
@@ -19949,6 +20048,53 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 				'#define textureCubeGradEXT textureGrad'
 			].join( '\n' ) + '\n' + prefixFragment;
 
+			// Multiview
+
+			if ( numMultiviewViews > 0 ) {
+
+				// TODO: fix light transforms here?
+
+				prefixVertex = 	[
+					'#extension GL_OVR_multiview : require',
+					'layout(num_views = ' + numMultiviewViews + ') in;',
+					'#define VIEW_ID gl_ViewID_OVR'
+				].join( '\n' ) + '\n' + prefixVertex;
+
+				prefixVertex = prefixVertex.replace(
+					[
+						'uniform mat4 modelViewMatrix;',
+						'uniform mat4 projectionMatrix;',
+						'uniform mat4 viewMatrix;',
+						'uniform mat3 normalMatrix;'
+					].join( '\n' ),
+					[
+						'uniform mat4 modelViewMatrices[' + numMultiviewViews + '];',
+						'uniform mat4 projectionMatrices[' + numMultiviewViews + '];',
+						'uniform mat4 viewMatrices[' + numMultiviewViews + '];',
+						'uniform mat3 normalMatrices[' + numMultiviewViews + '];',
+
+						'#define modelViewMatrix modelViewMatrices[VIEW_ID]',
+						'#define projectionMatrix projectionMatrices[VIEW_ID]',
+						'#define viewMatrix viewMatrices[VIEW_ID]',
+						'#define normalMatrix normalMatrices[VIEW_ID]'
+					].join( '\n' )
+				);
+
+				prefixFragment = [
+					'#extension GL_OVR_multiview : require',
+					'#define VIEW_ID gl_ViewID_OVR'
+				].join( '\n' ) + '\n' + prefixFragment;
+
+				prefixFragment = prefixFragment.replace(
+					'uniform mat4 viewMatrix;',
+					[
+						'uniform mat4 viewMatrices[' + numMultiviewViews + '];',
+						'#define viewMatrix viewMatrices[VIEW_ID]'
+					].join( '\n' )
+				);
+
+			}
+
 		}
 
 		const vertexGlsl = versionString + prefixVertex + vertexShader;
@@ -20113,6 +20259,7 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 		this.program = program;
 		this.vertexShader = glVertexShader;
 		this.fragmentShader = glFragmentShader;
+		this.numMultiviewViews = numMultiviewViews;
 
 		return this;
 
@@ -20342,6 +20489,8 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 			const currentRenderTarget = renderer.getRenderTarget();
 
+			const numMultiviewViews = currentRenderTarget && currentRenderTarget.isWebGLMultiviewRenderTarget ? currentRenderTarget.numViews : 0;
+
 			const IS_INSTANCEDMESH = object.isInstancedMesh === true;
 
 			const HAS_MAP = !! material.map;
@@ -20432,6 +20581,7 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 				instancingColor: IS_INSTANCEDMESH && object.instanceColor !== null,
 
 				supportsVertexTextures: SUPPORTS_VERTEX_TEXTURES,
+				numMultiviewViews: numMultiviewViews,
 				outputColorSpace: ( currentRenderTarget === null ) ? renderer.outputColorSpace : ( currentRenderTarget.isXRRenderTarget === true ? currentRenderTarget.texture.colorSpace : LinearSRGBColorSpace ),
 
 				map: HAS_MAP,
@@ -20779,6 +20929,8 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 				_programLayers.enable( 18 );
 			if ( parameters.decodeVideoTexture )
 				_programLayers.enable( 19 );
+			if ( parameters.numMultiviewViews )
+				_programLayers.enable( 20 );
 
 			array.push( _programLayers.mask );
 
@@ -23614,12 +23766,16 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 		const maxSamples = capabilities.maxSamples;
 		const multisampledRTTExt = extensions.has( 'WEBGL_multisampled_render_to_texture' ) ? extensions.get( 'WEBGL_multisampled_render_to_texture' ) : null;
 		const supportsInvalidateFramebuffer = typeof navigator === 'undefined' ? false : /OculusBrowser/g.test( navigator.userAgent );
+		const multiviewExt = extensions.has( 'OCULUS_multiview' ) ? extensions.get( 'OCULUS_multiview' ) : null;
 
 		const _videoTextures = new WeakMap();
 		let _canvas;
 
 		const _sources = new WeakMap(); // maps WebglTexture objects to instances of Source
 
+		let _deferredUploads = [];
+		let _deferTextureUploads = false;
+
 		// cordova iOS (as of 5.0) still uses UIWebView, which provides OffscreenCanvas,
 		// also OffscreenCanvas.getContext("webgl"), but not OffscreenCanvas.getContext("2d")!
 		// Some implementations may only implement OffscreenCanvas partially (e.g. lacking 2d).
@@ -24087,8 +24243,11 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 				} else {
 
-					uploadTexture( textureProperties, texture, slot );
-					return;
+					if ( uploadTexture( textureProperties, texture, slot ) ) {
+
+						return;
+
+					}
 
 				}
 
@@ -24321,8 +24480,45 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 		}
 
+		function setDeferTextureUploads( deferFlag ) {
+
+			_deferTextureUploads = deferFlag;
+
+		}
+
+		function runDeferredUploads() {
+
+			const previousDeferSetting = _deferTextureUploads;
+			_deferTextureUploads = false;
+
+			for ( const upload of _deferredUploads ) {
+
+				uploadTexture( upload.textureProperties, upload.texture, upload.slot );
+				upload.texture.isPendingDeferredUpload = false;
+
+			}
+
+			_deferredUploads = [];
+
+			_deferTextureUploads = previousDeferSetting;
+
+		}
+
 		function uploadTexture( textureProperties, texture, slot ) {
 
+			if ( _deferTextureUploads ) {
+
+				if ( ! texture.isPendingDeferredUpload ) {
+
+					texture.isPendingDeferredUpload = true;
+					_deferredUploads.push( { textureProperties: textureProperties, texture: texture, slot: slot } );
+
+				}
+
+				return false;
+
+			}
+
 			let textureType = _gl.TEXTURE_2D;
 
 			if ( texture.isDataArrayTexture || texture.isCompressedArrayTexture ) textureType = _gl.TEXTURE_2D_ARRAY;
@@ -24739,6 +24935,7 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 			}
 
 			textureProperties.__version = texture.version;
+			return true;
 
 		}
 
@@ -24968,7 +25165,11 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 				const width = Math.max( 1, renderTarget.width >> level );
 				const height = Math.max( 1, renderTarget.height >> level );
 
-				if ( textureTarget === _gl.TEXTURE_3D || textureTarget === _gl.TEXTURE_2D_ARRAY ) {
+				if ( renderTarget.isWebGLMultiviewRenderTarget === true ) {
+
+					state.texStorage3D( _gl.TEXTURE_2D_ARRAY, 0, glInternalFormat, renderTarget.width, renderTarget.height, renderTarget.numViews );
+
+				} else if ( textureTarget === _gl.TEXTURE_3D || textureTarget === _gl.TEXTURE_2D_ARRAY ) {
 
 					state.texImage3D( textureTarget, level, glInternalFormat, width, height, renderTarget.depth, 0, glFormat, glType, null );
 
@@ -24982,13 +25183,31 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 			state.bindFramebuffer( _gl.FRAMEBUFFER, framebuffer );
 
-			if ( useMultisampledRTT( renderTarget ) ) {
+			const multisampled = useMultisampledRTT( renderTarget );
+
+			if ( renderTarget.isWebGLMultiviewRenderTarget === true ) {
+
+				if ( multisampled ) {
+
+					multiviewExt.framebufferTextureMultisampleMultiviewOVR( _gl.FRAMEBUFFER, _gl.COLOR_ATTACHMENT0, properties.get( texture ).__webglTexture, 0, getRenderTargetSamples( renderTarget ), 0, renderTarget.numViews );
+
+				} else {
+
+					multiviewExt.framebufferTextureMultiviewOVR( _gl.FRAMEBUFFER, _gl.COLOR_ATTACHMENT0, properties.get( texture ).__webglTexture, 0, 0, renderTarget.numViews );
 
-				multisampledRTTExt.framebufferTexture2DMultisampleEXT( _gl.FRAMEBUFFER, attachment, textureTarget, properties.get( texture ).__webglTexture, 0, getRenderTargetSamples( renderTarget ) );
+				}
 
 			} else if ( textureTarget === _gl.TEXTURE_2D || ( textureTarget >= _gl.TEXTURE_CUBE_MAP_POSITIVE_X && textureTarget <= _gl.TEXTURE_CUBE_MAP_NEGATIVE_Z ) ) { // see #24753
 
-				_gl.framebufferTexture2D( _gl.FRAMEBUFFER, attachment, textureTarget, properties.get( texture ).__webglTexture, level );
+				if ( multisampled ) {
+
+					multisampledRTTExt.framebufferTexture2DMultisampleEXT( _gl.FRAMEBUFFER, attachment, textureTarget, properties.get( texture ).__webglTexture, 0, getRenderTargetSamples( renderTarget ) );
+
+				} else {
+
+					_gl.framebufferTexture2D( _gl.FRAMEBUFFER, attachment, textureTarget, properties.get( texture ).__webglTexture, level );
+
+				}
 
 			}
 
@@ -25002,7 +25221,59 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 			_gl.bindRenderbuffer( _gl.RENDERBUFFER, renderbuffer );
 
-			if ( renderTarget.depthBuffer && ! renderTarget.stencilBuffer ) {
+			if ( renderTarget.isWebGLMultiviewRenderTarget === true ) {
+
+				const useMultisample = useMultisampledRTT( renderTarget );
+				const numViews = renderTarget.numViews;
+
+				const depthTexture = renderTarget.depthTexture;
+				let glInternalFormat = _gl.DEPTH_COMPONENT24;
+				let glDepthAttachment = _gl.DEPTH_ATTACHMENT;
+
+				if ( depthTexture && depthTexture.isDepthTexture ) {
+
+					if ( depthTexture.type === FloatType ) {
+
+						glInternalFormat = _gl.DEPTH_COMPONENT32F;
+
+					} else if ( depthTexture.type === UnsignedInt248Type ) {
+
+						glInternalFormat = _gl.DEPTH24_STENCIL8;
+						glDepthAttachment = _gl.DEPTH_STENCIL_ATTACHMENT;
+
+					}
+
+					// we're defaulting to _gl.DEPTH_COMPONENT24 so don't assign here
+					// or else DeepScan will complain
+
+					// else if ( depthTexture.type === UnsignedIntType ) {
+
+					// 	glInternalFormat = _gl.DEPTH_COMPONENT24;
+
+					// }
+
+				}
+
+				let depthStencilTexture = properties.get( renderTarget.depthTexture ).__webglTexture;
+				if ( depthStencilTexture === undefined ) {
+
+					depthStencilTexture = _gl.createTexture();
+					_gl.bindTexture( _gl.TEXTURE_2D_ARRAY, depthStencilTexture );
+					_gl.texStorage3D( _gl.TEXTURE_2D_ARRAY, 1, glInternalFormat, renderTarget.width, renderTarget.height, numViews );
+
+				}
+
+				if ( useMultisample ) {
+
+					multiviewExt.framebufferTextureMultisampleMultiviewOVR( _gl.FRAMEBUFFER, glDepthAttachment, depthStencilTexture, 0, getRenderTargetSamples( renderTarget ), 0, numViews );
+
+				} else {
+
+					multiviewExt.framebufferTextureMultiviewOVR( _gl.FRAMEBUFFER, glDepthAttachment, depthStencilTexture, 0, 0, numViews );
+
+				}
+
+			} else if ( renderTarget.depthBuffer && ! renderTarget.stencilBuffer ) {
 
 				let glInternalFormat = ( isWebGL2 === true ) ? _gl.DEPTH_COMPONENT24 : _gl.DEPTH_COMPONENT16;
 
@@ -25126,37 +25397,85 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 			}
 
 			setTexture2D( renderTarget.depthTexture, 0 );
+			if ( renderTarget.depthTexture.image.depth != 1 ) {
+
+				setTexture2DArray( renderTarget.depthTexture, 0 );
+
+			} else {
+
+				setTexture2D( renderTarget.depthTexture, 0 );
+
+			}
 
 			const webglDepthTexture = properties.get( renderTarget.depthTexture ).__webglTexture;
 			const samples = getRenderTargetSamples( renderTarget );
 
-			if ( renderTarget.depthTexture.format === DepthFormat ) {
+			if ( renderTarget.isWebGLMultiviewRenderTarget === true ) {
 
-				if ( useMultisampledRTT( renderTarget ) ) {
+				const useMultisample = useMultisampledRTT( renderTarget );
+				const numViews = renderTarget.numViews;
 
-					multisampledRTTExt.framebufferTexture2DMultisampleEXT( _gl.FRAMEBUFFER, _gl.DEPTH_ATTACHMENT, _gl.TEXTURE_2D, webglDepthTexture, 0, samples );
+				if ( renderTarget.depthTexture.format === DepthFormat ) {
 
-				} else {
+					if ( useMultisample ) {
 
-					_gl.framebufferTexture2D( _gl.FRAMEBUFFER, _gl.DEPTH_ATTACHMENT, _gl.TEXTURE_2D, webglDepthTexture, 0 );
+						multiviewExt.framebufferTextureMultisampleMultiviewOVR( _gl.FRAMEBUFFER, _gl.DEPTH_ATTACHMENT, webglDepthTexture, 0, samples, 0, numViews );
 
-				}
+					} else {
 
-			} else if ( renderTarget.depthTexture.format === DepthStencilFormat ) {
+						multiviewExt.framebufferTextureMultiviewOVR( _gl.FRAMEBUFFER, _gl.DEPTH_ATTACHMENT, webglDepthTexture, 0, 0, numViews );
+
+					}
 
-				if ( useMultisampledRTT( renderTarget ) ) {
+				} else if ( renderTarget.depthTexture.format === DepthStencilFormat ) {
 
-					multisampledRTTExt.framebufferTexture2DMultisampleEXT( _gl.FRAMEBUFFER, _gl.DEPTH_STENCIL_ATTACHMENT, _gl.TEXTURE_2D, webglDepthTexture, 0, samples );
+					if ( useMultisample ) {
+
+						multiviewExt.framebufferTextureMultisampleMultiviewOVR( _gl.FRAMEBUFFER, _gl.DEPTH_STENCIL_ATTACHMENT, webglDepthTexture, 0, samples, 0, numViews );
+
+					} else {
+
+						multiviewExt.framebufferTextureMultiviewOVR( _gl.FRAMEBUFFER, _gl.DEPTH_STENCIL_ATTACHMENT, webglDepthTexture, 0, 0, numViews );
+
+					}
 
 				} else {
 
-					_gl.framebufferTexture2D( _gl.FRAMEBUFFER, _gl.DEPTH_STENCIL_ATTACHMENT, _gl.TEXTURE_2D, webglDepthTexture, 0 );
+					throw new Error( 'Unknown depthTexture format' );
 
 				}
 
 			} else {
 
-				throw new Error( 'Unknown depthTexture format' );
+				if ( renderTarget.depthTexture.format === DepthFormat ) {
+
+					if ( useMultisampledRTT( renderTarget ) ) {
+
+						multisampledRTTExt.framebufferTexture2DMultisampleEXT( _gl.FRAMEBUFFER, _gl.DEPTH_ATTACHMENT, _gl.TEXTURE_2D, webglDepthTexture, 0, samples );
+
+					} else {
+
+						_gl.framebufferTexture2D( _gl.FRAMEBUFFER, _gl.DEPTH_ATTACHMENT, _gl.TEXTURE_2D, webglDepthTexture, 0 );
+
+					}
+
+				} else if ( renderTarget.depthTexture.format === DepthStencilFormat ) {
+
+					if ( useMultisampledRTT( renderTarget ) ) {
+
+						multisampledRTTExt.framebufferTexture2DMultisampleEXT( _gl.FRAMEBUFFER, _gl.DEPTH_STENCIL_ATTACHMENT, _gl.TEXTURE_2D, webglDepthTexture, 0, samples );
+
+					} else {
+
+						_gl.framebufferTexture2D( _gl.FRAMEBUFFER, _gl.DEPTH_STENCIL_ATTACHMENT, _gl.TEXTURE_2D, webglDepthTexture, 0 );
+
+					}
+
+				} else {
+
+					throw new Error( 'Unknown depthTexture format' );
+
+				}
 
 			}
 
@@ -25435,6 +25754,12 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 				}
 
+				if ( renderTarget.isWebGLMultiviewRenderTarget === true ) {
+
+					glTextureType = _gl.TEXTURE_2D_ARRAY;
+
+				}
+
 				state.bindTexture( glTextureType, textureProperties.__webglTexture );
 				setTextureParameters( glTextureType, texture, supportsMips );
 
@@ -25464,9 +25789,9 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 			// Setup depth and stencil buffers
 
-			if ( renderTarget.depthBuffer ) {
+			if ( renderTarget.depthBuffer || renderTarget.isWebGLMultiviewRenderTarget === true ) {
 
-				setupDepthRenderbuffer( renderTarget );
+				this.setupDepthRenderbuffer( renderTarget );
 
 			}
 
@@ -25702,12 +26027,16 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 		this.setTexture3D = setTexture3D;
 		this.setTextureCube = setTextureCube;
 		this.rebindTextures = rebindTextures;
+		this.uploadTexture = uploadTexture;
 		this.setupRenderTarget = setupRenderTarget;
 		this.updateRenderTargetMipmap = updateRenderTargetMipmap;
 		this.updateMultisampleRenderTarget = updateMultisampleRenderTarget;
+		this.setupDepthTexture = setupDepthTexture;
 		this.setupDepthRenderbuffer = setupDepthRenderbuffer;
 		this.setupFrameBufferTexture = setupFrameBufferTexture;
 		this.useMultisampledRTT = useMultisampledRTT;
+		this.runDeferredUploads = runDeferredUploads;
+		this.setDeferTextureUploads = setDeferTextureUploads;
 
 	}
 
@@ -26564,6 +26893,39 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 		dispatchEvent: EventDispatcher.prototype.dispatchEvent
 	} );
 
+	/**
+	 * @author fernandojsg / http://fernandojsg.com
+	 * @author Takahiro https://github.com/takahirox
+	 */
+
+
+	class WebGLMultiviewRenderTarget extends WebGLRenderTarget {
+
+		constructor( width, height, numViews, options = {} ) {
+
+			super( width, height, options );
+
+			this.depthBuffer = false;
+			this.stencilBuffer = false;
+
+			this.numViews = numViews;
+
+		}
+
+		copy( source ) {
+
+			super.copy( source );
+
+			this.numViews = source.numViews;
+
+			return this;
+
+		}
+
+	}
+
+	WebGLMultiviewRenderTarget.prototype.isWebGLMultiviewRenderTarget = true;
+
 	const _moveEvent = { type: 'move' };
 
 	class WebXRController {
@@ -26958,7 +27320,7 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 	class WebXRManager extends EventDispatcher {
 
-		constructor( renderer, gl ) {
+		constructor( renderer, gl, extensions, useMultiview ) {
 
 			super();
 
@@ -27014,6 +27376,7 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 			this.enabled = false;
 
 			this.isPresenting = false;
+			this.isMultiview = false;
 
 			this.getCameraPose = function ( ) {
 
@@ -27257,29 +27620,51 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 						}
 
+						scope.isMultiview = useMultiview && extensions.has( 'OCULUS_multiview' );
+
 						const projectionlayerInit = {
 							colorFormat: gl.RGBA8,
 							depthFormat: glDepthFormat,
 							scaleFactor: framebufferScaleFactor
 						};
 
+						if ( scope.isMultiview ) {
+
+							projectionlayerInit.textureType = 'texture-array';
+
+						}
+
 						glBinding = new XRWebGLBinding( session, gl );
 
 						glProjLayer = glBinding.createProjectionLayer( projectionlayerInit );
 
 						session.updateRenderState( { layers: [ glProjLayer ] } );
 
-						newRenderTarget = new WebGLRenderTarget(
-							glProjLayer.textureWidth,
-							glProjLayer.textureHeight,
-							{
-								format: RGBAFormat,
-								type: UnsignedByteType,
-								depthTexture: new DepthTexture( glProjLayer.textureWidth, glProjLayer.textureHeight, depthType, undefined, undefined, undefined, undefined, undefined, undefined, depthFormat ),
-								stencilBuffer: attributes.stencil,
-								colorSpace: renderer.outputColorSpace,
-								samples: attributes.antialias ? 4 : 0
-							} );
+						const renderTargetOptions = {
+							format: RGBAFormat,
+							type: UnsignedByteType,
+							depthTexture: new DepthTexture( glProjLayer.textureWidth, glProjLayer.textureHeight, depthType, undefined, undefined, undefined, undefined, undefined, undefined, depthFormat ),
+							stencilBuffer: attributes.stencil,
+							colorSpace: renderer.outputColorSpace,
+							samples: attributes.antialias ? 4 : 0
+						};
+
+						if ( scope.isMultiview ) {
+
+							const extension = extensions.get( 'OCULUS_multiview' );
+
+							this.maxNumViews = gl.getParameter( extension.MAX_VIEWS_OVR );
+
+							newRenderTarget = new WebGLMultiviewRenderTarget( glProjLayer.textureWidth, glProjLayer.textureHeight, 2, renderTargetOptions );
+
+						} else {
+
+							newRenderTarget = new WebGLRenderTarget(
+								glProjLayer.textureWidth,
+								glProjLayer.textureHeight,
+								renderTargetOptions );
+
+						}
 
 						const renderTargetProperties = renderer.properties.get( newRenderTarget );
 						renderTargetProperties.__ignoreDepthValues = glProjLayer.ignoreDepthValues;
@@ -28731,6 +29116,7 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 				preserveDrawingBuffer = false,
 				powerPreference = 'default',
 				failIfMajorPerformanceCaveat = false,
+				multiviewStereo = false,
 			} = parameters;
 
 			this.isWebGLRenderer = true;
@@ -28965,6 +29351,7 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 			let extensions, capabilities, state, info;
 			let properties, textures, cubemaps, cubeuvmaps, attributes, geometries, objects;
 			let programCache, materials, renderLists, renderStates, clipping, shadowMap;
+			let multiview;
 
 			let background, morphtargets, bufferRenderer, indexedBufferRenderer;
 
@@ -28998,6 +29385,7 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 				renderLists = new WebGLRenderLists();
 				renderStates = new WebGLRenderStates( extensions, capabilities );
 				background = new WebGLBackground( _this, cubemaps, cubeuvmaps, state, objects, _alpha, premultipliedAlpha );
+				multiview = new WebGLMultiview( _this, extensions, _gl );
 				shadowMap = new WebGLShadowMap( _this, objects, capabilities );
 				uniformsGroups = new WebGLUniformsGroups( _gl, info, capabilities, state );
 
@@ -29020,7 +29408,7 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 			// xr
 
-			const xr = ( typeof navigator !== 'undefined' && 'xr' in navigator ) ? new WebXRManager( _this, _gl ) : new WebVRManager( _this );
+			const xr = ( typeof navigator !== 'undefined' && 'xr' in navigator ) ? new WebXRManager( _this, _gl, extensions, multiviewStereo ) : new WebVRManager( _this );
 
 			this.xr = xr;
 
@@ -29767,13 +30155,23 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 				if ( camera.isArrayCamera ) {
 
-					const cameras = camera.cameras;
+					if ( xr.enabled && xr.isMultiview ) {
+
+						textures.setDeferTextureUploads( true );
+
+						renderScene( currentRenderList, scene, camera, camera.cameras[ 0 ].viewport );
 
-					for ( let i = 0, l = cameras.length; i < l; i ++ ) {
+					} else {
+
+						const cameras = camera.cameras;
 
-						const camera2 = cameras[ i ];
+						for ( let i = 0, l = cameras.length; i < l; i ++ ) {
 
-						renderScene( currentRenderList, scene, camera2, camera2.viewport );
+							const camera2 = cameras[ i ];
+
+							renderScene( currentRenderList, scene, camera2, camera2.viewport );
+
+						}
 
 					}
 
@@ -29801,6 +30199,8 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 				if ( scene.isScene === true ) scene.onAfterRender( _this, scene, camera );
 
+				textures.runDeferredUploads();
+
 				if ( xr.enabled && xr.submitFrame ) {
 
 					xr.submitFrame();
@@ -30268,6 +30668,7 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 				materialProperties.vertexAlphas = parameters.vertexAlphas;
 				materialProperties.vertexTangents = parameters.vertexTangents;
 				materialProperties.toneMapping = parameters.toneMapping;
+				materialProperties.numMultiviewViews = parameters.numMultiviewViews;
 
 			}
 
@@ -30299,6 +30700,8 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 				}
 
+				const numMultiviewViews = _currentRenderTarget && _currentRenderTarget.isWebGLMultiviewRenderTarget ? _currentRenderTarget.numViews : 0;
+
 				const morphAttribute = geometry.morphAttributes.position || geometry.morphAttributes.normal || geometry.morphAttributes.color;
 				const morphTargetsCount = ( morphAttribute !== undefined ) ? morphAttribute.length : 0;
 
@@ -30402,6 +30805,10 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 						needsProgramChange = true;
 
+					} else if ( materialProperties.numMultiviewViews !== numMultiviewViews ) {
+
+						needsProgramChange = true;
+
 					}
 
 				} else {
@@ -30448,8 +30855,17 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 					// common camera uniforms
 
-					p_uniforms.setValue( _gl, 'projectionMatrix', camera.projectionMatrix );
-					p_uniforms.setValue( _gl, 'viewMatrix', camera.matrixWorldInverse );
+					if ( program.numMultiviewViews > 0 ) {
+
+						multiview.updateCameraProjectionMatricesUniform( camera, p_uniforms );
+						multiview.updateCameraViewMatricesUniform( camera, p_uniforms );
+
+					} else {
+
+						p_uniforms.setValue( _gl, 'projectionMatrix', camera.projectionMatrix );
+						p_uniforms.setValue( _gl, 'viewMatrix', camera.matrixWorldInverse );
+
+					}
 
 					const uCamPos = p_uniforms.map.cameraPosition;
 
@@ -30597,8 +31013,17 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 
 				// common matrices
 
-				p_uniforms.setValue( _gl, 'modelViewMatrix', object.modelViewMatrix );
-				p_uniforms.setValue( _gl, 'normalMatrix', object.normalMatrix );
+				if ( program.numMultiviewViews > 0 ) {
+
+					multiview.updateObjectMatricesUniforms( object, camera, p_uniforms );
+
+				} else {
+
+					p_uniforms.setValue( _gl, 'modelViewMatrix', object.modelViewMatrix );
+					p_uniforms.setValue( _gl, 'normalMatrix', object.normalMatrix );
+
+				}
+
 				p_uniforms.setValue( _gl, 'modelMatrix', object.matrixWorld );
 
 				// UBOs
@@ -30708,20 +31133,16 @@ console.warn( 'Scripts "build/three.js" and "build/three.min.js" are deprecated
 				const renderTargetProperties = properties.get( renderTarget );
 				renderTargetProperties.__hasExternalTextures = true;
 
-				if ( renderTargetProperties.__hasExternalTextures ) {
+				renderTargetProperties.__autoAllocateDepthBuffer = depthTexture === undefined;
 
-					renderTargetProperties.__autoAllocateDepthBuffer = depthTexture === undefined;
+				if ( ! renderTargetProperties.__autoAllocateDepthBuffer && ! _currentRenderTarget.isWebGLMultiviewRenderTarget ) {
 
-					if ( ! renderTargetProperties.__autoAllocateDepthBuffer ) {
+					// The multisample_render_to_texture extension doesn't work properly if there
+					// are midframe flushes and an external depth buffer. Disable use of the extension.
+					if ( extensions.has( 'WEBGL_multisampled_render_to_texture' ) === true ) {
 
-						// The multisample_render_to_texture extension doesn't work properly if there
-						// are midframe flushes and an external depth buffer. Disable use of the extension.
-						if ( extensions.has( 'WEBGL_multisampled_render_to_texture' ) === true ) {
-
-							console.warn( 'THREE.WebGLRenderer: Render-to-texture extension was disabled because an external texture was provided' );
-							renderTargetProperties.__useRenderToTexture = false;
-
-						}
+						console.warn( 'THREE.WebGLRenderer: Render-to-texture extension was disabled because an external texture was provided' );
+						renderTargetProperties.__useRenderToTexture = false;
 
 					}