Added premultiply() method (mrdoob#8797)

WestLangley · mrdoob · commit 4744cbca549a · 2016-05-03T00:07:38.000-04:00
diff --git a/docs/api/math/Quaternion.html b/docs/api/math/Quaternion.html
@@ -107,9 +107,14 @@ <h3>[method:Quaternion normalize]() [page:Quaternion this]</h3>
 		Normalizes this quaternion.
 		</div>
 
-		<h3>[method:Quaternion multiply]( [page:Quaternion b] ) [page:Quaternion this]</h3>
+		<h3>[method:Quaternion multiply]( [page:Quaternion q] ) [page:Quaternion this]</h3>
 		<div>
-		Multiplies this quaternion by *b*.
+		Multiplies this quaternion by *q*.
+		</div>
+
+		<h3>[method:Quaternion premultiply]( [page:Quaternion q] ) [page:Quaternion this]</h3>
+		<div>
+		Pre-multiplies this quaternion by *q*.
 		</div>
 
 		<h3>[method:Quaternion multiplyQuaternions]( [page:Quaternion a], [page:Quaternion b] ) [page:Quaternion this]</h3>
diff --git a/src/math/Quaternion.js b/src/math/Quaternion.js
@@ -375,6 +375,12 @@ THREE.Quaternion.prototype = {
 
 	},
 
+	premultiply: function ( q ) {
+
+		return this.multiplyQuaternions( q, this );
+
+	},
+
 	multiplyQuaternions: function ( a, b ) {
 
 		// from http://www.euclideanspace.com/maths/algebra/realNormedAlgebra/quaternions/code/index.htm
