PerspectiveCamera: New helper methods getFrustumBounds(), getFrustumSize().

docs/api/en/cameras/PerspectiveCamera.html

@@ -118,6 +118,26 @@ <h2>Methods</h2>
 		<h3>[method:undefined clearViewOffset]()</h3>
 		<p>Removes any offset set by the [page:PerspectiveCamera.setViewOffset .setViewOffset] method.</p>
 
+		<h3>[method:Object frustumCorners]( [param:Float distance] )</h3>
+		<p>
+			Provides positions of the camera's frustum corners at a given distance from the camera.
+			Returns an object with topLeft, topRight, bottomRight, and bottomLeft properties where each property is a
+			[page:Vector3].
+		</p>
+
+		<h3>[method:Vector2 frustumDimensions]( [param:Float distance] )</h3>
+		<p>
+			Calculates the height and width of the camera's frustum at a given distance from the camera.
+			Returns a [page:Vector2] where x is width and y is height.
+		</p>
+
+		<h3>[method:undefined getBounds]( [param:Float distance], [param:Vector2 minTarget], [param:Vector2 maxTarget] )
+		</h3>
+		<p>
+			Calculates the XY of the min/max bounds for the camera's viewable rectangle at a given distance.
+			Results are copied into minTarget and maxTarget input vars.
+		</p>
+
 		<h3>[method:Float getEffectiveFOV]()</h3>
 		<p>Returns the current vertical field of view angle in degrees considering .zoom.</p>
 
@@ -214,6 +234,5 @@ <h2>Source</h2>
 		<p>
 			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
 		</p>
-
 	</body>
-</html>
+</html>

examples/jsm/utils/CameraUtils.js

@@ -1,7 +1,8 @@
 import {
 	MathUtils,
 	Quaternion,
-	Vector3
+	Vector3,
+	Vector2
 } from 'three';
 
 const _va = /*@__PURE__*/ new Vector3(), // from pe to pa
@@ -11,8 +12,9 @@ const _va = /*@__PURE__*/ new Vector3(), // from pe to pa
 	_vu = /*@__PURE__*/ new Vector3(), // up axis of screen
 	_vn = /*@__PURE__*/ new Vector3(), // normal vector of screen
 	_vec = /*@__PURE__*/ new Vector3(), // temporary vector
-	_quat = /*@__PURE__*/ new Quaternion(); // temporary quaternion
-
+	_quat = /*@__PURE__*/ new Quaternion(), // temporary quaternion
+	_minTarget = /*@__PURE__*/ new Vector2(), // temporary vector2 for minBound
+	_maxTarget = /*@__PURE__*/ new Vector2(); // temporary vector2 for maxBound
 
 /** Set a PerspectiveCamera's projectionMatrix and quaternion
  * to exactly frame the corners of an arbitrary rectangle.
@@ -64,10 +66,33 @@ function frameCorners( camera, bottomLeftCorner, bottomRightCorner, topLeftCorne
 		camera.fov =
 			MathUtils.RAD2DEG / Math.min( 1.0, camera.aspect ) *
 			Math.atan( ( _vec.copy( pb ).sub( pa ).length() +
-							( _vec.copy( pc ).sub( pa ).length() ) ) / _va.length() );
+				( _vec.copy( pc ).sub( pa ).length() ) ) / _va.length() );
 
 	}
 
 }
 
-export { frameCorners };
+/** Calculate a PerspectiveCamera frustum's corners at a given distance from the camera.
+ * Returns an object with topLeft, topRight, bottomRight, and bottomLeft properties. Each property is a Vector3.
+ * Should work on all PerspectiveCameras where the frustum is rectangular in shape.
+ * Including asymmetric rectangular frustums like those used by webXR cameras.
+ * @param {number} distance - Distance from the camera
+ * @param {camera} camera - The PerspectiveCamera to calculate the frustum corners from */
+function getFrustumCorners( camera, distance ) {
+
+	camera.getBounds( distance, _minTarget, _maxTarget );
+
+	camera.updateMatrixWorld( true, false );
+
+	// .set() -> Calculates the corner position
+	// .applyMatrix4() -> Accounts for camera position/rotation/scale
+	return {
+		topLeft: _vec.set( _minTarget.x, _maxTarget.y, - distance ).applyMatrix4( camera.matrixWorld ).clone(),
+		topRight: _vec.set( _maxTarget.x, _maxTarget.y, - distance ).applyMatrix4( camera.matrixWorld ).clone(),
+		bottomRight: _vec.set( _maxTarget.x, _minTarget.y, - distance ).applyMatrix4( camera.matrixWorld ).clone(),
+		bottomLeft: _vec.set( _minTarget.x, _minTarget.y, - distance ).applyMatrix4( camera.matrixWorld ).clone(),
+	};
+
+}
+
+export { frameCorners, getFrustumCorners };

src/cameras/PerspectiveCamera.js

@@ -1,5 +1,13 @@
 import { Camera } from './Camera.js';
 import * as MathUtils from '../math/MathUtils.js';
+import { Vector2 } from '../math/Vector2.js';
+import { Vector3 } from '../math/Vector3.js';
+
+// Temp constants used by getFrustumBounds()/getFrustumDimensions()
+const _tempV3 = /*@__PURE__*/ new Vector3();
+const _minTarget = /*@__PURE__*/ new Vector2();
+const _maxTarget = /*@__PURE__*/ new Vector2();
+
 
 class PerspectiveCamera extends Camera {
 
@@ -99,6 +107,39 @@ class PerspectiveCamera extends Camera {
 
 	}
 
+	/*
+	 * Computes 2D bounds of the camera's frustum at a given distance along the viewing direction.
+	 * Copies max/min height and width of the frustum's rectangle into minTarget and maxTarget.
+	 * Results are in the camera's local coordinate space, independent of its global position/rotation/scale.
+	 */
+	getFrustumBounds( distance, minTarget, maxTarget ) {
+
+		_tempV3.set( - 1, - 1, 0.5 ).applyMatrix4( this.projectionMatrixInverse );
+		_tempV3.multiplyScalar( distance / Math.abs( _tempV3.z ) );
+		minTarget.x = _tempV3.x;
+		minTarget.y = _tempV3.y;
+
+		_tempV3.set( 1, 1, 0.5 ).applyMatrix4( this.projectionMatrixInverse );
+		_tempV3.multiplyScalar( distance / Math.abs( _tempV3.z ) );
+		maxTarget.x = _tempV3.x;
+		maxTarget.y = _tempV3.y;
+
+	}
+
+	/*
+	 * Computes the height/width of the camera's frustum at a given distance along the viewing direction.
+	 * Copies the result into provided target Vector2 where x is width and y is height.
+ 	 */
+	getFrustumDimensions( distance, target ) {
+
+		this.getBounds( distance, _minTarget, _maxTarget );
+		target.x = _maxTarget.x - _minTarget.x;
+		target.y = _maxTarget.y - _minTarget.y;
+
+		return target;
+
+	}
+
 	/**
 	 * Sets an offset in a larger frustum. This is useful for multi-window or
 	 * multi-monitor/multi-machine setups.