adding the lerp to Math class mrdoob#9728 (mrdoob#9767)

koolkap · mrdoob · commit aa3df26a2aaf · 2016-09-25T19:29:41.000-07:00
* adding the lerp to Math class mrdoob#9728 Adding the precise interpolation from point x to y using factor t. * Adding the documentation for Lerp function Adding the lerp in doc support
diff --git a/docs/api/math/Math.html b/docs/api/math/Math.html
@@ -75,6 +75,18 @@ <h3>[method:Float radToDeg]( [page:Float radians] )</h3>
 		Converts radians to degrees
 		</div>
 
+		<h3>[method:Float lerp]( [page:Float x], [page:Float y], [page:Float t] )</h3>
+		<div>
+		x -- Start point. <br />
+		y -- End point. <br />
+		t -- Closed unit interval from [0,1].
+		</div>
+		<div>
+		Returns a value interpolated from two known points based on the interval.<br/><br/>
+
+		[link:https://en.wikipedia.org/wiki/Linear_interpolation Wikipedia]
+		</div>
+
 		<h3>[method:Float smoothstep]( [page:Float x], [page:Float min], [page:Float max] )</h3>
 		<div>
 		x -- The value to evaluate based on its position between min and max. <br />
diff --git a/src/math/Math.js b/src/math/Math.js
@@ -70,6 +70,13 @@ _Math = {
 
 	},
 
+	//https://en.wikipedia.org/wiki/Linear_interpolation
+	
+	lerp: function( x, y, t ){
+
+		return ( 1 - t ) * x + t * y;
+	},
+
 	// http://en.wikipedia.org/wiki/Smoothstep
 
 	smoothstep: function ( x, min, max ) {
