Don't describe a particular implementation's details in the interface declaration.

This commit is contained in:
David Hoover
2012-05-10 21:45:03 -07:00
parent be0d761aa2
commit 6d920c1211
4 changed files with 8 additions and 26 deletions
+2 -7
View File
@@ -96,9 +96,7 @@ interface IMatrix3
Matrix3 invert (); Matrix3 invert ();
/** /**
* Inverts this matrix and places the result in the given object. This code is based on the * Inverts this matrix and places the result in the given object.
* examples in the <a href="http://www.j3d.org/matrix_faq/matrfaq_latest.html">Matrix and
* Quaternion FAQ</a>.
* *
* @return a reference to the result matrix, for chaining. * @return a reference to the result matrix, for chaining.
*/ */
@@ -221,10 +219,7 @@ interface IMatrix3
Vector transformVector (IVector vector, Vector result); Vector transformVector (IVector vector, Vector result);
/** /**
* Extracts the rotation component of the matrix. This uses the iterative polar decomposition * Extracts the rotation component of the matrix.
* algorithm described by
* <a href="http://www.cs.wisc.edu/graphics/Courses/838-s2002/Papers/polar-decomp.pdf">Ken
* Shoemake</a>.
*/ */
double extractRotation (); double extractRotation ();
+2 -6
View File
@@ -120,9 +120,7 @@ public interface IMatrix4
Matrix4 invert (); Matrix4 invert ();
/** /**
* Inverts this matrix and places the result in the given object. This code is based on the * Inverts this matrix and places the result in the given object.
* examples in the <a href="http://www.j3d.org/matrix_faq/matrfaq_latest.html">Matrix and
* Quaternion FAQ</a>.
* *
* @return a reference to the result matrix, for chaining. * @return a reference to the result matrix, for chaining.
*/ */
@@ -258,9 +256,7 @@ public interface IMatrix4
/** /**
* Extracts the rotation component of the matrix and places it in the provided result * Extracts the rotation component of the matrix and places it in the provided result
* quaternion. This uses the iterative polar decomposition algorithm described by * quaternion.
* <a href="http://www.cs.wisc.edu/graphics/Courses/838-s2002/Papers/polar-decomp.pdf">Ken
* Shoemake</a>.
* *
* @return a reference to the result quaternion, for chaining. * @return a reference to the result quaternion, for chaining.
*/ */
+2 -7
View File
@@ -96,9 +96,7 @@ interface IMatrix3
Matrix3 invert (); Matrix3 invert ();
/** /**
* Inverts this matrix and places the result in the given object. This code is based on the * Inverts this matrix and places the result in the given object.
* examples in the <a href="http://www.j3d.org/matrix_faq/matrfaq_latest.html">Matrix and
* Quaternion FAQ</a>.
* *
* @return a reference to the result matrix, for chaining. * @return a reference to the result matrix, for chaining.
*/ */
@@ -221,10 +219,7 @@ interface IMatrix3
Vector transformVector (IVector vector, Vector result); Vector transformVector (IVector vector, Vector result);
/** /**
* Extracts the rotation component of the matrix. This uses the iterative polar decomposition * Extracts the rotation component of the matrix.
* algorithm described by
* <a href="http://www.cs.wisc.edu/graphics/Courses/838-s2002/Papers/polar-decomp.pdf">Ken
* Shoemake</a>.
*/ */
float extractRotation (); float extractRotation ();
+2 -6
View File
@@ -120,9 +120,7 @@ public interface IMatrix4
Matrix4 invert (); Matrix4 invert ();
/** /**
* Inverts this matrix and places the result in the given object. This code is based on the * Inverts this matrix and places the result in the given object.
* examples in the <a href="http://www.j3d.org/matrix_faq/matrfaq_latest.html">Matrix and
* Quaternion FAQ</a>.
* *
* @return a reference to the result matrix, for chaining. * @return a reference to the result matrix, for chaining.
*/ */
@@ -258,9 +256,7 @@ public interface IMatrix4
/** /**
* Extracts the rotation component of the matrix and places it in the provided result * Extracts the rotation component of the matrix and places it in the provided result
* quaternion. This uses the iterative polar decomposition algorithm described by * quaternion.
* <a href="http://www.cs.wisc.edu/graphics/Courses/838-s2002/Papers/polar-decomp.pdf">Ken
* Shoemake</a>.
* *
* @return a reference to the result quaternion, for chaining. * @return a reference to the result quaternion, for chaining.
*/ */