Merge pull request #15796 from WestLangley/dev-set_viewport

WebGLRenderer: support Vector4 arg in setViewport()

Author: mrdoob

docs/api/en/renderers/WebGLRenderer.html

@@ -468,8 +468,16 @@ <h3>[method:null setTextureCube]( [param:CubeTexture cubeTexture], [param:Number
 		The slot number can be found as a value of the uniform of the sampler.
 		</p>
 
-		<h3>[method:null setViewport]( [param:Integer x], [param:Integer y], [param:Integer width], [param:Integer height] )</h3>
-		<p>Sets the viewport to render from (x, y) to (x + width, y + height).</p>
+		<h3>[method:null setViewport]( [param:Integer x], [param:Integer y], [param:Integer width], [param:Integer height] )<br />
+		[method:null setViewport]( [param:Vector4 vector] )</h3>
+
+		<p>
+		The x, y, width, and height parameters of the viewport.<br />
+		Optionally, a 4-component vector specifying the parameters of a viewport.<br /><br />
+
+		Sets the viewport to render from (x, y) to (x + width, y + height).<br />
+		(x, y) is the lower-left corner of the region.
+		</p>
 
 		<h2>Source</h2>
 

src/renderers/WebGLRenderer.d.ts

@@ -223,8 +223,9 @@ export class WebGLRenderer implements Renderer {
 
   /**
    * Sets the viewport to render from (x, y) to (x + width, y + height).
+   * (x, y) is the lower-left corner of the region.
    */
-  setViewport(x?: number, y?: number, width?: number, height?: number): void;
+  setViewport(x: Vector4 | number, y?: number, width?: number, height?: number): void;
 
   /**
    * Sets the scissor area from (x, y) to (x + width, y + height).

src/renderers/WebGLRenderer.js

@@ -452,7 +452,16 @@ function WebGLRenderer( parameters ) {
 
 	this.setViewport = function ( x, y, width, height ) {
 
-		_viewport.set( x, y, width, height );
+		if ( x.isVector4 ) {
+
+			_viewport.set( x.x, x.y, x.z, x.w );
+
+		} else {
+
+			_viewport.set( x, y, width, height );
+
+		}
+
 		state.viewport( _currentViewport.copy( _viewport ).multiplyScalar( _pixelRatio ) );
 
 	};