toxiclibs 0.9.1 → 0.9.2

data/src/toxi/geom/Matrix4f.java

@@ -28,7 +28,6 @@
  * $Date: 2008-02-28 20:18:51 +0000 (Thu, 28 Feb 2008) $
  * $State$
  */
-
 package toxi.geom;
 
 import toxi.math.MathUtils;
@@ -36,7 +35,7 @@ import toxi.math.MathUtils;
 /**
  * A single precision floating point 4 by 4 matrix. Primarily to support 3D
  * rotations.
- * 
+ *
  */
 public class Matrix4f implements java.io.Serializable, Cloneable {
 
@@ -51,7 +50,7 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * "matrix2" in turn and treats it as the right-hand side of the matrix
      * equation Ax = LUx = b. The solution vector replaces the original column
      * of the matrix.
-     * 
+     *
      * If "matrix2" is the identity matrix, the procedure replaces its contents
      * with the inverse of the matrix from which "matrix1" was originally
      * derived.
@@ -234,39 +233,23 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Constructs and initializes a Matrix4f from the specified 16 values.
-     * 
-     * @param m00
-     *            the [0][0] element
-     * @param m01
-     *            the [0][1] element
-     * @param m02
-     *            the [0][2] element
-     * @param m03
-     *            the [0][3] element
-     * @param m10
-     *            the [1][0] element
-     * @param m11
-     *            the [1][1] element
-     * @param m12
-     *            the [1][2] element
-     * @param m13
-     *            the [1][3] element
-     * @param m20
-     *            the [2][0] element
-     * @param m21
-     *            the [2][1] element
-     * @param m22
-     *            the [2][2] element
-     * @param m23
-     *            the [2][3] element
-     * @param m30
-     *            the [3][0] element
-     * @param m31
-     *            the [3][1] element
-     * @param m32
-     *            the [3][2] element
-     * @param m33
-     *            the [3][3] element
+     *
+     * @param m00 the [0][0] element
+     * @param m01 the [0][1] element
+     * @param m02 the [0][2] element
+     * @param m03 the [0][3] element
+     * @param m10 the [1][0] element
+     * @param m11 the [1][1] element
+     * @param m12 the [1][2] element
+     * @param m13 the [1][3] element
+     * @param m20 the [2][0] element
+     * @param m21 the [2][1] element
+     * @param m22 the [2][2] element
+     * @param m23 the [2][3] element
+     * @param m30 the [3][0] element
+     * @param m31 the [3][1] element
+     * @param m32 the [3][2] element
+     * @param m33 the [3][3] element
      */
     public Matrix4f(float m00, float m01, float m02, float m03, float m10,
             float m11, float m12, float m13, float m20, float m21, float m22,
@@ -296,9 +279,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Constructs and initializes a Matrix4f from the specified 16 element
      * array. this.m00 =v[0], this.m01=v[1], etc.
-     * 
-     * @param v
-     *            the array of length 16 containing in order
+     *
+     * @param v the array of length 16 containing in order
      */
     public Matrix4f(float[] v) {
         this.m00 = v[0];
@@ -328,13 +310,10 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * translation, and scale values; the scale is applied only to the
      * rotational components of the matrix (upper 3x3) and not to the
      * translational components of the matrix.
-     * 
-     * @param m1
-     *            the rotation matrix representing the rotational components
-     * @param t1
-     *            the translational components of the matrix
-     * @param s
-     *            the scale value applied to the rotational components
+     *
+     * @param m1 the rotation matrix representing the rotational components
+     * @param t1 the translational components of the matrix
+     * @param s the scale value applied to the rotational components
      */
     public Matrix4f(Matrix3d m1, Vec3D t1, float s) {
         this.m00 = (float) (m1.m00 * s);
@@ -361,9 +340,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Constructs a new matrix with the same values as the Matrix4f parameter.
-     * 
-     * @param m1
-     *            the source matrix
+     *
+     * @param m1 the source matrix
      */
     public Matrix4f(Matrix4f m1) {
         this.m00 = m1.m00;
@@ -392,13 +370,10 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * Constructs and initializes a Matrix4f from the quaternion, translation,
      * and scale values; the scale is applied only to the rotational components
      * of the matrix (upper 3x3) and not to the translational components.
-     * 
-     * @param q1
-     *            the quaternion value representing the rotational component
-     * @param t1
-     *            the translational component of the matrix
-     * @param s
-     *            the scale value applied to the rotational components
+     *
+     * @param q1 the quaternion value representing the rotational component
+     * @param t1 the translational component of the matrix
+     * @param s the scale value applied to the rotational components
      */
     public Matrix4f(Quaternion q1, Vec3D t1, float s) {
         m00 = (float) (s * (1.0 - 2.0 * q1.y * q1.y - 2.0 * q1.z * q1.z));
@@ -426,9 +401,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Adds a scalar to each component of this matrix.
-     * 
-     * @param scalar
-     *            the scalar adder
+     *
+     * @param scalar the scalar adder
      */
     public final void add(float scalar) {
         m00 += scalar;
@@ -452,11 +426,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Adds a scalar to each component of the matrix m1 and places the result
      * into this. Matrix m1 is not modified.
-     * 
-     * @param scalar
-     *            the scalar adder
-     * @param m1
-     *            the original matrix values
+     *
+     * @param scalar the scalar adder
+     * @param m1 the original matrix values
      */
     public final void add(float scalar, Matrix4f m1) {
         this.m00 = m1.m00 + scalar;
@@ -479,9 +451,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Sets the value of this matrix to the sum of itself and matrix m1.
-     * 
-     * @param m1
-     *            the other matrix
+     *
+     * @param m1 the other matrix
      */
     public final void add(Matrix4f m1) {
         this.m00 += m1.m00;
@@ -507,11 +478,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Sets the value of this matrix to the matrix sum of matrices m1 and m2.
-     * 
-     * @param m1
-     *            the first matrix
-     * @param m2
-     *            the second matrix
+     *
+     * @param m1 the first matrix
+     * @param m2 the second matrix
      */
     public final void add(Matrix4f m1, Matrix4f m2) {
         this.m00 = m1.m00 + m2.m00;
@@ -537,10 +506,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Creates a new object of the same class as this object.
-     * 
+     *
      * @return a clone of this instance.
-     * @exception OutOfMemoryError
-     *                if there is not enough memory.
+     * @exception OutOfMemoryError if there is not enough memory.
      * @see java.lang.Cloneable
      * @since vecmath 1.3
      */
@@ -555,29 +523,27 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 //
 //        return m1;
 //    }
-
     /**
      * Computes the determinate of this matrix.
-     * 
+     *
      * @return the determinate of the matrix
      */
     public final float determinant() {
         float det;
 
         // cofactor exapainsion along first row
-
         det = m00
                 * (m11 * m22 * m33 + m12 * m23 * m31 + m13 * m21 * m32 - m13
-                        * m22 * m31 - m11 * m23 * m32 - m12 * m21 * m33);
+                * m22 * m31 - m11 * m23 * m32 - m12 * m21 * m33);
         det -= m01
                 * (m10 * m22 * m33 + m12 * m23 * m30 + m13 * m20 * m32 - m13
-                        * m22 * m30 - m10 * m23 * m32 - m12 * m20 * m33);
+                * m22 * m30 - m10 * m23 * m32 - m12 * m20 * m33);
         det += m02
                 * (m10 * m21 * m33 + m11 * m23 * m30 + m13 * m20 * m31 - m13
-                        * m21 * m30 - m10 * m23 * m31 - m11 * m20 * m33);
+                * m21 * m30 - m10 * m23 * m31 - m11 * m20 * m33);
         det -= m03
                 * (m10 * m21 * m32 + m11 * m22 * m30 + m12 * m20 * m31 - m12
-                        * m21 * m30 - m10 * m22 * m31 - m11 * m20 * m32);
+                * m21 * m30 - m10 * m22 * m31 - m11 * m20 * m32);
 
         return (det);
     }
@@ -587,12 +553,10 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * is less than or equal to the epsilon parameter, otherwise returns false.
      * The L-infinite distance is equal to MAX[i=0,1,2,3 ; j=0,1,2,3 ;
      * abs(this.m(i,j) - m1.m(i,j)]
-     * 
-     * @param m1
-     *            the matrix to be compared to this matrix
-     * @param epsilon
-     *            the threshold value
-     * @return 
+     *
+     * @param m1 the matrix to be compared to this matrix
+     * @param epsilon the threshold value
+     * @return
      */
     public boolean epsilonEquals(Matrix4f m1, float epsilon) {
 
@@ -657,9 +621,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Returns true if all of the data members of Matrix4f m1 are equal to the
      * corresponding data members in this Matrix4f.
-     * 
-     * @param m1
-     *            the matrix with which the comparison is made.
+     *
+     * @param m1 the matrix with which the comparison is made.
      * @return true or false
      */
     public boolean equals(Matrix4f m1) {
@@ -682,9 +645,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * Returns true if the Object t1 is of type Matrix4f and all of the data
      * members of t1 are equal to the corresponding data members in this
      * Matrix4f.
-     * 
-     * @param t1
-     *            the matrix with which the comparison is made.
+     *
+     * @param t1 the matrix with which the comparison is made.
      * @return true or false
      */
     @Override
@@ -733,9 +695,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * Performs an SVD normalization of this matrix in order to acquire the
      * normalized rotational component; the values are placed into the Matrix3d
      * parameter.
-     * 
-     * @param m1
-     *            matrix into which the rotational component is placed
+     *
+     * @param m1 matrix into which the rotational component is placed
      */
     public final void get(Matrix3d m1) {
 
@@ -762,11 +723,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * Performs an SVD normalization of this matrix to calculate the rotation as
      * a 3x3 matrix, the translation, and the scale. None of the matrix values
      * are modified.
-     * 
-     * @param m1
-     *            the normalized matrix representing the rotation
-     * @param t1
-     *            the translation component
+     *
+     * @param m1 the normalized matrix representing the rotation
+     * @param t1 the translation component
      * @return the scale component of this transform
      */
     public final double get(Matrix3d m1, Vec3D t1) {
@@ -798,9 +757,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * Performs an SVD normalization of this matrix in order to acquire the
      * normalized rotational component; the values are placed into the Quat4f
      * parameter.
-     * 
-     * @param q1
-     *            quaternion into which the rotation component is placed
+     *
+     * @param q1 quaternion into which the rotation component is placed
      */
     public final void get(Quaternion q1) {
         double[] tmp_rot = new double[9]; // scratch matrix
@@ -844,9 +802,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Retrieves the translational components of this matrix.
-     * 
-     * @param trans
-     *            the vector that will receive the translational component
+     *
+     * @param trans the vector that will receive the translational component
      */
     public final void get(Vec3D trans) {
         trans.x = m03;
@@ -857,35 +814,38 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Copies the matrix values in the specified column into the array
      * parameter.
-     * 
-     * @param column
-     *            the matrix column
-     * @param v
-     *            the array into which the matrix row values will be copied
+     *
+     * @param column the matrix column
+     * @param v the array into which the matrix row values will be copied
      */
     public final void getColumn(int column, float v[]) {
-        if (column == 0) {
-            v[0] = m00;
-            v[1] = m10;
-            v[2] = m20;
-            v[3] = m30;
-        } else if (column == 1) {
-            v[0] = m01;
-            v[1] = m11;
-            v[2] = m21;
-            v[3] = m31;
-        } else if (column == 2) {
-            v[0] = m02;
-            v[1] = m12;
-            v[2] = m22;
-            v[3] = m32;
-        } else if (column == 3) {
-            v[0] = m03;
-            v[1] = m13;
-            v[2] = m23;
-            v[3] = m33;
-        } else {
-            throw new ArrayIndexOutOfBoundsException();
+        switch (column) {
+            case 0:
+                v[0] = m00;
+                v[1] = m10;
+                v[2] = m20;
+                v[3] = m30;
+                break;
+            case 1:
+                v[0] = m01;
+                v[1] = m11;
+                v[2] = m21;
+                v[3] = m31;
+                break;
+            case 2:
+                v[0] = m02;
+                v[1] = m12;
+                v[2] = m22;
+                v[3] = m32;
+                break;
+            case 3:
+                v[0] = m03;
+                v[1] = m13;
+                v[2] = m23;
+                v[3] = m33;
+                break;
+            default:
+                throw new ArrayIndexOutOfBoundsException();
         }
 
     }
@@ -893,46 +853,47 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Copies the matrix values in the specified column into the vector
      * parameter.
-     * 
-     * @param column
-     *            the matrix column
-     * @param v
-     *            the vector into which the matrix row values will be copied
+     *
+     * @param column the matrix column
+     * @param v the vector into which the matrix row values will be copied
      */
     public final void getColumn(int column, Vec4D v) {
-        if (column == 0) {
-            v.x = m00;
-            v.y = m10;
-            v.z = m20;
-            v.w = m30;
-        } else if (column == 1) {
-            v.x = m01;
-            v.y = m11;
-            v.z = m21;
-            v.w = m31;
-        } else if (column == 2) {
-            v.x = m02;
-            v.y = m12;
-            v.z = m22;
-            v.w = m32;
-        } else if (column == 3) {
-            v.x = m03;
-            v.y = m13;
-            v.z = m23;
-            v.w = m33;
-        } else {
-            throw new ArrayIndexOutOfBoundsException();
+        switch (column) {
+            case 0:
+                v.x = m00;
+                v.y = m10;
+                v.z = m20;
+                v.w = m30;
+                break;
+            case 1:
+                v.x = m01;
+                v.y = m11;
+                v.z = m21;
+                v.w = m31;
+                break;
+            case 2:
+                v.x = m02;
+                v.y = m12;
+                v.z = m22;
+                v.w = m32;
+                break;
+            case 3:
+                v.x = m03;
+                v.y = m13;
+                v.z = m23;
+                v.w = m33;
+                break;
+            default:
+                throw new ArrayIndexOutOfBoundsException();
         }
 
     }
 
     /**
      * Retrieves the value at the specified row and column of this matrix.
-     * 
-     * @param row
-     *            the row number to be retrieved (zero indexed)
-     * @param column
-     *            the column number to be retrieved (zero indexed)
+     *
+     * @param row the row number to be retrieved (zero indexed)
+     * @param column the column number to be retrieved (zero indexed)
      * @return the value at the indexed element
      */
     public final float getElement(int row, int column) {
@@ -1004,9 +965,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get the first matrix element in the first row.
-     * 
+     *
      * @return Returns the m00.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM00() {
@@ -1015,9 +976,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get the second matrix element in the first row.
-     * 
+     *
      * @return Returns the m01.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM01() {
@@ -1026,9 +987,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get the third matrix element in the first row.
-     * 
+     *
      * @return Returns the m02.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM02() {
@@ -1037,9 +998,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get the fourth element of the first row.
-     * 
+     *
      * @return Returns the m03.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM03() {
@@ -1048,9 +1009,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get first matrix element in the second row.
-     * 
+     *
      * @return Returns the m10.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM10() {
@@ -1059,9 +1020,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get second matrix element in the second row.
-     * 
+     *
      * @return Returns the m11.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM11() {
@@ -1070,9 +1031,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get the third matrix element in the second row.
-     * 
+     *
      * @return Returns the m12.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM12() {
@@ -1081,9 +1042,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get the fourth element of the second row.
-     * 
+     *
      * @return Returns the m13.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM13() {
@@ -1092,9 +1053,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get the first matrix element in the third row.
-     * 
+     *
      * @return Returns the m20.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM20() {
@@ -1103,9 +1064,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get the second matrix element in the third row.
-     * 
+     *
      * @return Returns the m21.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM21() {
@@ -1114,9 +1075,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get the third matrix element in the third row.
-     * 
+     *
      * @return Returns the m22.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM22() {
@@ -1125,9 +1086,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get the fourth element of the third row.
-     * 
+     *
      * @return Returns the m23.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM23() {
@@ -1136,9 +1097,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get the first element of the fourth row.
-     * 
+     *
      * @return Returns the m30.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM30() {
@@ -1147,9 +1108,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get the second element of the fourth row.
-     * 
+     *
      * @return Returns the m31.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM31() {
@@ -1158,9 +1119,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get the third element of the fourth row.
-     * 
+     *
      * @return Returns the m32.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM32() {
@@ -1169,9 +1130,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Get the fourth element of the fourth row.
-     * 
+     *
      * @return Returns the m33.
-     * 
+     *
      * @since vecmath 1.5
      */
     public final float getM33() {
@@ -1181,9 +1142,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Gets the upper 3x3 values of this matrix and places them into the matrix
      * m1.
-     * 
-     * @param m1
-     *            the matrix that will hold the values
+     *
+     * @param m1 the matrix that will hold the values
      */
     public final void getRotationScale(Matrix3d m1) {
         m1.m00 = m00;
@@ -1199,70 +1159,76 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Copies the matrix values in the specified row into the array parameter.
-     * 
-     * @param row
-     *            the matrix row
-     * @param v
-     *            the array into which the matrix row values will be copied
+     *
+     * @param row the matrix row
+     * @param v the array into which the matrix row values will be copied
      */
     public final void getRow(int row, float v[]) {
-        if (row == 0) {
-            v[0] = m00;
-            v[1] = m01;
-            v[2] = m02;
-            v[3] = m03;
-        } else if (row == 1) {
-            v[0] = m10;
-            v[1] = m11;
-            v[2] = m12;
-            v[3] = m13;
-        } else if (row == 2) {
-            v[0] = m20;
-            v[1] = m21;
-            v[2] = m22;
-            v[3] = m23;
-        } else if (row == 3) {
-            v[0] = m30;
-            v[1] = m31;
-            v[2] = m32;
-            v[3] = m33;
-        } else {
-            throw new ArrayIndexOutOfBoundsException();
+        switch (row) {
+            case 0:
+                v[0] = m00;
+                v[1] = m01;
+                v[2] = m02;
+                v[3] = m03;
+                break;
+            case 1:
+                v[0] = m10;
+                v[1] = m11;
+                v[2] = m12;
+                v[3] = m13;
+                break;
+            case 2:
+                v[0] = m20;
+                v[1] = m21;
+                v[2] = m22;
+                v[3] = m23;
+                break;
+            case 3:
+                v[0] = m30;
+                v[1] = m31;
+                v[2] = m32;
+                v[3] = m33;
+                break;
+            default:
+                throw new ArrayIndexOutOfBoundsException();
         }
 
     }
 
     /**
      * Copies the matrix values in the specified row into the vector parameter.
-     * 
-     * @param row
-     *            the matrix row
-     * @param v
-     *            the vector into which the matrix row values will be copied
+     *
+     * @param row the matrix row
+     * @param v the vector into which the matrix row values will be copied
      */
     public final void getRow(int row, Vec4D v) {
-        if (row == 0) {
-            v.x = m00;
-            v.y = m01;
-            v.z = m02;
-            v.w = m03;
-        } else if (row == 1) {
-            v.x = m10;
-            v.y = m11;
-            v.z = m12;
-            v.w = m13;
-        } else if (row == 2) {
-            v.x = m20;
-            v.y = m21;
-            v.z = m22;
-            v.w = m23;
-        } else if (row == 3) {
-            v.x = m30;
-            v.y = m31;
-            v.z = m32;
-            v.w = m33;
-        } else {
-            throw new ArrayIndexOutOfBoundsException();
+        switch (row) {
+            case 0:
+                v.x = m00;
+                v.y = m01;
+                v.z = m02;
+                v.w = m03;
+                break;
+            case 1:
+                v.x = m10;
+                v.y = m11;
+                v.z = m12;
+                v.w = m13;
+                break;
+            case 2:
+                v.x = m20;
+                v.y = m21;
+                v.z = m22;
+                v.w = m23;
+                break;
+            case 3:
+                v.x = m30;
+                v.y = m31;
+                v.z = m32;
+                v.w = m33;
+                break;
+            default:
+                throw new ArrayIndexOutOfBoundsException();
         }
 
     }
@@ -1272,7 +1238,7 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * uniform scale factor. If the matrix has non-uniform scale factors, the
      * largest of the x, y, and z scale factors will be returned. This matrix is
      * not modified.
-     * 
+     *
      * @return the scale factor of this matrix
      */
     public final float getScale() {
@@ -1305,31 +1271,30 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * Matrix4f.equals returns true) will return the same hash code value. Two
      * objects with different data members may return the same hash value,
      * although this is not likely.
-     * 
+     *
      * @return the integer hash code value
      */
     // @Override
     // public int hashCode() {
-        // long bits = 1L;
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m00);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m01);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m02);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m03);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m10);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m11);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m12);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m13);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m20);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m21);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m22);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m23);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m30);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m31);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m32);
-        // bits = 31L * bits + VecMathUtil.floatToIntBits(m33);
-        // return (int) (bits ^ (bits >> 32));
+    // long bits = 1L;
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m00);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m01);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m02);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m03);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m10);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m11);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m12);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m13);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m20);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m21);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m22);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m23);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m30);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m31);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m32);
+    // bits = 31L * bits + VecMathUtil.floatToIntBits(m33);
+    // return (int) (bits ^ (bits >> 32));
     // }
-
     /**
      * Inverts this matrix in place.
      */
@@ -1340,9 +1305,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Sets the value of this matrix to the matrix inverse of the passed (user
      * declared) matrix m1.
-     * 
-     * @param m1
-     *            the matrix to be inverted
+     *
+     * @param m1 the matrix to be inverted
      */
     public final void invert(Matrix4f m1) {
 
@@ -1353,7 +1317,7 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * General invert routine. Inverts m1 and places the result in "this". Note
      * that this routine handles both the "this" version and the non-"this"
      * version.
-     * 
+     *
      * Also note that since this routine is slow anyway, we won't worry about
      * allocating a little bit of garbage.
      */
@@ -1365,7 +1329,6 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
         // Use LU decomposition and backsubstitution code specifically
         // for floating-point 4x4 matrices.
-
         // Copy source matrix to t1tmp
         temp[0] = m1.m00;
         temp[1] = m1.m01;
@@ -1427,9 +1390,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Multiplies each element of this matrix by a scalar.
-     * 
-     * @param scalar
-     *            the scalar multiplier.
+     *
+     * @param scalar the scalar multiplier.
      */
     public final void mul(float scalar) {
         m00 *= scalar;
@@ -1453,11 +1415,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Multiplies each element of matrix m1 by a scalar and places the result
      * into this. Matrix m1 is not modified.
-     * 
-     * @param scalar
-     *            the scalar multiplier.
-     * @param m1
-     *            the original matrix.
+     *
+     * @param scalar the scalar multiplier.
+     * @param m1 the original matrix.
      */
     public final void mul(float scalar, Matrix4f m1) {
         this.m00 = m1.m00 * scalar;
@@ -1481,16 +1441,15 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Sets the value of this matrix to the result of multiplying itself with
      * matrix m1.
-     * 
-     * @param m1
-     *            the other matrix
+     *
+     * @param m1 the other matrix
      */
     public final void mul(Matrix4f m1) {
         float mm00, mm01, mm02, mm03, mm10, mm11, mm12, mm13, mm20, mm21, mm22, mm23, mm30, mm31, mm32, mm33; // vars
-                                                                                              // for
-                                                                                              // temp
-                                                                                              // result
-                                                                                              // matrix
+        // for
+        // temp
+        // result
+        // matrix
 
         mm00 = this.m00 * m1.m00 + this.m01 * m1.m10 + this.m02 * m1.m20
                 + this.m03 * m1.m30;
@@ -1549,11 +1508,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Sets the value of this matrix to the result of multiplying the two
      * argument matrices together.
-     * 
-     * @param m1
-     *            the first matrix
-     * @param m2
-     *            the second matrix
+     *
+     * @param m1 the first matrix
+     * @param m2 the second matrix
      */
     public final void mul(Matrix4f m1, Matrix4f m2) {
         if (this != m1 && this != m2) {
@@ -1595,10 +1552,10 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
                     + m1.m33 * m2.m33;
         } else {
             float mm00, mm01, mm02, mm03, mm10, mm11, mm12, mm13, mm20, mm21, mm22, mm23, mm30, mm31, mm32, mm33; // vars
-                                                                                                  // for
-                                                                                                  // temp
-                                                                                                  // result
-                                                                                                  // matrix
+            // for
+            // temp
+            // result
+            // matrix
             mm00 = m1.m00 * m2.m00 + m1.m01 * m2.m10 + m1.m02 * m2.m20 + m1.m03
                     * m2.m30;
             mm01 = m1.m00 * m2.m01 + m1.m01 * m2.m11 + m1.m02 * m2.m21 + m1.m03
@@ -1657,11 +1614,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Multiplies the transpose of matrix m1 times the transpose of matrix m2,
      * and places the result into this.
-     * 
-     * @param m1
-     *            the matrix on the left hand side of the multiplication
-     * @param m2
-     *            the matrix on the right hand side of the multiplication
+     *
+     * @param m1 the matrix on the left hand side of the multiplication
+     * @param m2 the matrix on the right hand side of the multiplication
      */
     public final void mulTransposeBoth(Matrix4f m1, Matrix4f m2) {
         if (this != m1 && this != m2) {
@@ -1702,11 +1657,11 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
                     + m1.m33 * m2.m33;
         } else {
             float mm00, mm01, mm02, mm03, mm10, mm11, mm12, mm13, mm20, mm21, mm22, mm23, // vars
-                                                                              // for
-                                                                              // temp
-                                                                              // result
-                                                                              // matrix
-            mm30, mm31, mm32, mm33;
+                    // for
+                    // temp
+                    // result
+                    // matrix
+                    mm30, mm31, mm32, mm33;
 
             mm00 = m1.m00 * m2.m00 + m1.m10 * m2.m01 + m1.m20 * m2.m02 + m1.m30
                     * m2.m03;
@@ -1767,11 +1722,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Multiplies the transpose of matrix m1 times matrix m2, and places the
      * result into this.
-     * 
-     * @param m1
-     *            the matrix on the left hand side of the multiplication
-     * @param m2
-     *            the matrix on the right hand side of the multiplication
+     *
+     * @param m1 the matrix on the left hand side of the multiplication
+     * @param m2 the matrix on the right hand side of the multiplication
      */
     public final void mulTransposeLeft(Matrix4f m1, Matrix4f m2) {
         if (this != m1 && this != m2) {
@@ -1812,11 +1765,11 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
                     + m1.m33 * m2.m33;
         } else {
             float mm00, mm01, mm02, mm03, mm10, mm11, mm12, mm13, mm20, mm21, mm22, mm23, // vars
-                                                                              // for
-                                                                              // temp
-                                                                              // result
-                                                                              // matrix
-            mm30, mm31, mm32, mm33;
+                    // for
+                    // temp
+                    // result
+                    // matrix
+                    mm30, mm31, mm32, mm33;
 
             mm00 = m1.m00 * m2.m00 + m1.m10 * m2.m10 + m1.m20 * m2.m20 + m1.m30
                     * m2.m30;
@@ -1877,11 +1830,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Multiplies matrix m1 times the transpose of matrix m2, and places the
      * result into this.
-     * 
-     * @param m1
-     *            the matrix on the left hand side of the multiplication
-     * @param m2
-     *            the matrix on the right hand side of the multiplication
+     *
+     * @param m1 the matrix on the left hand side of the multiplication
+     * @param m2 the matrix on the right hand side of the multiplication
      */
     public final void mulTransposeRight(Matrix4f m1, Matrix4f m2) {
         if (this != m1 && this != m2) {
@@ -1922,11 +1873,11 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
                     + m1.m33 * m2.m33;
         } else {
             float mm00, mm01, mm02, mm03, mm10, mm11, mm12, mm13, mm20, mm21, mm22, mm23, // vars
-                                                                              // for
-                                                                              // temp
-                                                                              // result
-                                                                              // matrix
-            mm30, mm31, mm32, mm33;
+                    // for
+                    // temp
+                    // result
+                    // matrix
+                    mm30, mm31, mm32, mm33;
 
             mm00 = m1.m00 * m2.m00 + m1.m01 * m2.m01 + m1.m02 * m2.m02 + m1.m03
                     * m2.m03;
@@ -2009,9 +1960,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Sets the value of this matrix equal to the negation of of the Matrix4f
      * parameter.
-     * 
-     * @param m1
-     *            the source matrix
+     *
+     * @param m1 the source matrix
      */
     public final void negate(Matrix4f m1) {
         this.m00 = -m1.m00;
@@ -2035,9 +1985,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Sets the value of this matrix to a counter clockwise rotation about the x
      * axis.
-     * 
-     * @param angle
-     *            the angle to rotate about the X axis in radians
+     *
+     * @param angle the angle to rotate about the X axis in radians
      */
     public final void rotX(float angle) {
         float sinAngle, cosAngle;
@@ -2069,9 +2018,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Sets the value of this matrix to a counter clockwise rotation about the y
      * axis.
-     * 
-     * @param angle
-     *            the angle to rotate about the Y axis in radians
+     *
+     * @param angle the angle to rotate about the Y axis in radians
      */
     public final void rotY(float angle) {
         float sinAngle, cosAngle;
@@ -2103,9 +2051,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Sets the value of this matrix to a counter clockwise rotation about the z
      * axis.
-     * 
-     * @param angle
-     *            the angle to rotate about the Z axis in radians
+     *
+     * @param angle the angle to rotate about the Z axis in radians
      */
     public final void rotZ(float angle) {
         float sinAngle, cosAngle;
@@ -2137,9 +2084,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Sets the value of this matrix to a scale matrix with the the passed scale
      * amount.
-     * 
-     * @param scale
-     *            the scale factor for the matrix
+     *
+     * @param scale the scale factor for the matrix
      */
     public final void set(float scale) {
         this.m00 = scale;
@@ -2167,11 +2113,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * Sets the value of this transform to a scale and translation matrix; the
      * scale is not applied to the translation and all of the matrix values are
      * modified.
-     * 
-     * @param scale
-     *            the scale factor for the matrix
-     * @param t1
-     *            the translation amount
+     *
+     * @param scale the scale factor for the matrix
+     * @param t1 the translation amount
      */
     public final void set(float scale, Vec3D t1) {
         this.m00 = scale;
@@ -2199,9 +2143,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * Sets the values in this Matrix4f equal to the row-major array parameter
      * (ie, the first four elements of the array will be copied into the first
      * row of this matrix, etc.).
-     * 
-     * @param m
-     *            the single precision array of length 16
+     *
+     * @param m the single precision array of length 16
      */
     public final void set(float[] m) {
         m00 = m[0];
@@ -2227,9 +2170,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * values in the double precision Matrix3d argument; the other elements of
      * this matrix are initialized as if this were an identity matrix (i.e.,
      * affine matrix with no translational component).
-     * 
-     * @param m1
-     *            the double-precision 3x3 matrix
+     *
+     * @param m1 the double-precision 3x3 matrix
      */
     public final void set(Matrix3d m1) {
         m00 = (float) m1.m00;
@@ -2254,13 +2196,10 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * Sets the value of this matrix from the rotation expressed by the rotation
      * matrix m1, the translation t1, and the scale factor. The translation is
      * not modified by the scale.
-     * 
-     * @param m1
-     *            the rotation component
-     * @param t1
-     *            the translation component
-     * @param scale
-     *            the scale factor
+     *
+     * @param m1 the rotation component
+     * @param t1 the translation component
+     * @param scale the scale factor
      */
     public final void set(Matrix3d m1, Vec3D t1, double scale) {
         this.m00 = (float) (m1.m00 * scale);
@@ -2286,9 +2225,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Sets the value of this matrix to a copy of the passed matrix m1.
-     * 
-     * @param m1
-     *            the matrix to be copied
+     *
+     * @param m1 the matrix to be copied
      */
     public final void set(Matrix4f m1) {
         this.m00 = m1.m00;
@@ -2315,9 +2253,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Sets the value of this matrix to the matrix conversion of the single
      * precision quaternion argument.
-     * 
-     * @param q1
-     *            the quaternion to be converted
+     *
+     * @param q1 the quaternion to be converted
      */
     public final void set(Quaternion q1) {
         this.m00 = (1.0f - 2.0f * q1.y * q1.y - 2.0f * q1.z * q1.z);
@@ -2345,13 +2282,10 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Sets the value of this matrix from the rotation expressed by the
      * quaternion q1, the translation t1, and the scale s.
-     * 
-     * @param q1
-     *            the rotation expressed as a quaternion
-     * @param t1
-     *            the translation
-     * @param s
-     *            the scale value
+     *
+     * @param q1 the rotation expressed as a quaternion
+     * @param t1 the translation
+     * @param s the scale value
      */
     public final void set(Quaternion q1, Vec3D t1, double s) {
         this.m00 = (float) (s * (1.0 - 2.0 * q1.y * q1.y - 2.0 * q1.z * q1.z));
@@ -2379,13 +2313,10 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Sets the value of this matrix from the rotation expressed by the
      * quaternion q1, the translation t1, and the scale s.
-     * 
-     * @param q1
-     *            the rotation expressed as a quaternion
-     * @param t1
-     *            the translation
-     * @param s
-     *            the scale value
+     *
+     * @param q1 the rotation expressed as a quaternion
+     * @param t1 the translation
+     * @param s the scale value
      */
     public final void set(Quaternion q1, Vec3D t1, float s) {
         this.m00 = (s * (1.0f - 2.0f * q1.y * q1.y - 2.0f * q1.z * q1.z));
@@ -2413,9 +2344,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Sets the value of this matrix to a translate matrix with the passed
      * translation value.
-     * 
-     * @param v1
-     *            the translation amount
+     *
+     * @param v1 the translation amount
      */
     public final void set(Vec3D v1) {
         this.m00 = (float) 1.0;
@@ -2443,11 +2373,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * Sets the value of this transform to a scale and translation matrix; the
      * translation is scaled by the scale factor and all of the matrix values
      * are modified.
-     * 
-     * @param t1
-     *            the translation amount
-     * @param scale
-     *            the scale factor for the matrix
+     *
+     * @param t1 the translation amount
+     * @param scale the scale factor for the matrix
      */
     public final void set(Vec3D t1, float scale) {
         this.m00 = scale;
@@ -2473,11 +2401,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Sets the specified column of this matrix4f to the four values provided.
-     * 
-     * @param column
-     *            the column number to be modified (zero indexed)
-     * @param v
-     *            the replacement column
+     *
+     * @param column the column number to be modified (zero indexed)
+     * @param v the replacement column
      */
     public final void setColumn(int column, float v[]) {
         switch (column) {
@@ -2516,17 +2442,12 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Sets the specified column of this matrix4f to the four values provided.
-     * 
-     * @param column
-     *            the column number to be modified (zero indexed)
-     * @param x
-     *            the first row element
-     * @param y
-     *            the second row element
-     * @param z
-     *            the third row element
-     * @param w
-     *            the fourth row element
+     *
+     * @param column the column number to be modified (zero indexed)
+     * @param x the first row element
+     * @param y the second row element
+     * @param z the third row element
+     * @param w the fourth row element
      */
     public final void setColumn(int column, float x, float y, float z, float w) {
         switch (column) {
@@ -2565,11 +2486,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Sets the specified column of this matrix4f to the vector provided.
-     * 
-     * @param column
-     *            the column number to be modified (zero indexed)
-     * @param v
-     *            the replacement column
+     *
+     * @param column the column number to be modified (zero indexed)
+     * @param v the replacement column
      */
     public final void setColumn(int column, Vec4D v) {
         switch (column) {
@@ -2608,13 +2527,10 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Sets the specified element of this matrix4f to the value provided.
-     * 
-     * @param row
-     *            the row number to be modified (zero indexed)
-     * @param column
-     *            the column number to be modified (zero indexed)
-     * @param value
-     *            the new value
+     *
+     * @param row the row number to be modified (zero indexed)
+     * @param column the column number to be modified (zero indexed)
+     * @param value the new value
      */
     public final void setElement(int row, int column, float value) {
         switch (row) {
@@ -2726,10 +2642,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the first matrix element in the first row.
-     * 
-     * @param m00
-     *            The m00 to set.
-     * 
+     *
+     * @param m00 The m00 to set.
+     *
      * @since vecmath 1.5
      */
     public final void setM00(float m00) {
@@ -2738,10 +2653,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the second matrix element in the first row.
-     * 
-     * @param m01
-     *            The m01 to set.
-     * 
+     *
+     * @param m01 The m01 to set.
+     *
      * @since vecmath 1.5
      */
     public final void setM01(float m01) {
@@ -2750,10 +2664,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the third matrix element in the first row.
-     * 
-     * @param m02
-     *            The m02 to set.
-     * 
+     *
+     * @param m02 The m02 to set.
+     *
      * @since vecmath 1.5
      */
     public final void setM02(float m02) {
@@ -2762,10 +2675,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the fourth element of the first row.
-     * 
-     * @param m03
-     *            The m03 to set.
-     * 
+     *
+     * @param m03 The m03 to set.
+     *
      * @since vecmath 1.5
      */
     public final void setM03(float m03) {
@@ -2774,10 +2686,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set first matrix element in the second row.
-     * 
-     * @param m10
-     *            The m10 to set.
-     * 
+     *
+     * @param m10 The m10 to set.
+     *
      * @since vecmath 1.5
      */
     public final void setM10(float m10) {
@@ -2786,10 +2697,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the second matrix element in the second row.
-     * 
-     * @param m11
-     *            The m11 to set.
-     * 
+     *
+     * @param m11 The m11 to set.
+     *
      * @since vecmath 1.5
      */
     public final void setM11(float m11) {
@@ -2798,10 +2708,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the third matrix element in the second row.
-     * 
-     * @param m12
-     *            The m12 to set.
-     * 
+     *
+     * @param m12 The m12 to set.
+     *
      * @since vecmath 1.5
      */
     public final void setM12(float m12) {
@@ -2810,10 +2719,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the fourth element of the second row.
-     * 
-     * @param m13
-     *            The m13 to set.
-     * 
+     *
+     * @param m13 The m13 to set.
+     *
      * @since vecmath 1.5
      */
     public final void setM13(float m13) {
@@ -2822,10 +2730,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the first matrix element in the third row.
-     * 
-     * @param m20
-     *            The m20 to set.
-     * 
+     *
+     * @param m20 The m20 to set.
+     *
      * @since vecmath 1.5
      */
     public final void setM20(float m20) {
@@ -2834,10 +2741,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the second matrix element in the third row.
-     * 
-     * @param m21
-     *            The m21 to set.
-     * 
+     *
+     * @param m21 The m21 to set.
+     *
      * @since vecmath 1.5
      */
     public final void setM21(float m21) {
@@ -2846,10 +2752,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the third matrix element in the third row.
-     * 
-     * @param m22
-     *            The m22 to set.
-     * 
+     *
+     * @param m22 The m22 to set.
+     *
      * @since vecmath 1.5
      */
     public final void setM22(float m22) {
@@ -2858,10 +2763,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the fourth element of the third row.
-     * 
-     * @param m23
-     *            The m23 to set.
-     * 
+     *
+     * @param m23 The m23 to set.
+     *
      * @since vecmath 1.5
      */
     public final void setM23(float m23) {
@@ -2870,11 +2774,10 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the first element of the fourth row.
-     * 
-     * @param m30
-     *            The m30 to set.
-     * 
-     * 
+     *
+     * @param m30 The m30 to set.
+     *
+     *
      * @since vecmath 1.5
      */
     public final void setM30(float m30) {
@@ -2883,10 +2786,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the second element of the fourth row.
-     * 
-     * @param m31
-     *            The m31 to set.
-     * 
+     *
+     * @param m31 The m31 to set.
+     *
      * @since vecmath 1.5
      */
     public final void setM31(float m31) {
@@ -2895,11 +2797,10 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the third element of the fourth row.
-     * 
-     * @param m32
-     *            The m32 to set.
-     * 
-     * 
+     *
+     * @param m32 The m32 to set.
+     *
+     *
      * @since vecmath 1.5
      */
     public final void setM32(float m32) {
@@ -2908,10 +2809,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Set the fourth element of the fourth row.
-     * 
-     * @param m33
-     *            The m33 to set.
-     * 
+     *
+     * @param m33 The m33 to set.
+     *
      * @since vecmath 1.5
      */
     public final void setM33(float m33) {
@@ -2925,9 +2825,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * this object's upper 3x3 matrix to factor out the scale, then this
      * object's upper 3x3 matrix components are replaced by the passed rotation
      * components, and then the scale is reapplied to the rotational components.
-     * 
-     * @param m1
-     *            double precision 3x3 matrix
+     *
+     * @param m1 double precision 3x3 matrix
      */
     public final void setRotation(Matrix3d m1) {
         double[] tmp_rot = new double[9];
@@ -2956,9 +2855,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * object's upper 3x3 matrix to factor out the scale, then this object's
      * upper 3x3 matrix components are replaced by the matrix equivalent of the
      * quaternion, and then the scale is reapplied to the rotational components.
-     * 
-     * @param q1
-     *            the quaternion that specifies the rotation
+     *
+     * @param q1 the quaternion that specifies the rotation
      */
     public final void setRotation(Quaternion q1) {
         double[] tmp_rot = new double[9]; // scratch matrix
@@ -2982,9 +2880,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Replaces the upper 3x3 matrix values of this matrix with the values in
      * the matrix m1.
-     * 
-     * @param m1
-     *            the matrix that will be the new upper 3x3
+     *
+     * @param m1 the matrix that will be the new upper 3x3
      */
     public final void setRotationScale(Matrix3d m1) {
         m00 = (float) m1.m00;
@@ -3001,11 +2898,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Sets the specified row of this matrix4f to the four values provided in
      * the passed array.
-     * 
-     * @param row
-     *            the row number to be modified (zero indexed)
-     * @param v
-     *            the replacement row
+     *
+     * @param row the row number to be modified (zero indexed)
+     * @param v the replacement row
      */
     public final void setRow(int row, float v[]) {
         switch (row) {
@@ -3044,17 +2939,12 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Sets the specified row of this matrix4f to the four values provided.
-     * 
-     * @param row
-     *            the row number to be modified (zero indexed)
-     * @param x
-     *            the first column element
-     * @param y
-     *            the second column element
-     * @param z
-     *            the third column element
-     * @param w
-     *            the fourth column element
+     *
+     * @param row the row number to be modified (zero indexed)
+     * @param x the first column element
+     * @param y the second column element
+     * @param z the third column element
+     * @param w the fourth column element
      */
     public final void setRow(int row, float x, float y, float z, float w) {
         switch (row) {
@@ -3093,11 +2983,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Sets the specified row of this matrix4f to the Vector provided.
-     * 
-     * @param row
-     *            the row number to be modified (zero indexed)
-     * @param v
-     *            the replacement row
+     *
+     * @param row the row number to be modified (zero indexed)
+     * @param v the replacement row
      */
     public final void setRow(int row, Vec4D v) {
         switch (row) {
@@ -3138,9 +3026,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * Sets the scale component of the current matrix by factoring out the
      * current scale (by doing an SVD) from the rotational component and
      * multiplying by the new scale.
-     * 
-     * @param scale
-     *            the new scale amount
+     *
+     * @param scale the new scale amount
      */
     public final void setScale(float scale) {
 
@@ -3165,9 +3052,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Modifies the translational components of this matrix to the values of the
      * Vector3f argument; the other values of this matrix are not modified.
-     * 
-     * @param trans
-     *            the translational component
+     *
+     * @param trans the translational component
      */
     public final void setTranslation(Vec3D trans) {
         m03 = trans.x;
@@ -3200,9 +3086,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Sets this matrix to the matrix difference of itself and matrix m1 (this =
      * this - m1).
-     * 
-     * @param m1
-     *            the other matrix
+     *
+     * @param m1 the other matrix
      */
     public final void sub(Matrix4f m1) {
         this.m00 -= m1.m00;
@@ -3229,11 +3114,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Performs an element-by-element subtraction of matrix m2 from matrix m1
      * and places the result into matrix this (this = m2 - m1).
-     * 
-     * @param m1
-     *            the first matrix
-     * @param m2
-     *            the second matrix
+     *
+     * @param m1 the first matrix
+     * @param m2 the second matrix
      */
     public final void sub(Matrix4f m1, Matrix4f m2) {
         this.m00 = m1.m00 - m2.m00;
@@ -3259,24 +3142,29 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Returns a string that contains the values of this Matrix4f.
-     * 
+     *
      * @return the String representation
      */
     @Override
     public String toString() {
-        return this.m00 + ", " + this.m01 + ", " + this.m02 + ", " + this.m03
-                + "\n" + this.m10 + ", " + this.m11 + ", " + this.m12 + ", "
-                + this.m13 + "\n" + this.m20 + ", " + this.m21 + ", "
-                + this.m22 + ", " + this.m23 + "\n" + this.m30 + ", "
-                + this.m31 + ", " + this.m32 + ", " + this.m33 + "\n";
+        return String.join("\n",
+                String.format("%d, %d, %d, %d",
+                        this.m00, this.m01, this.m02, this.m03),
+                String.format("%d, %d, %d, %d",
+                        this.m10, this.m11, this.m12, this.m13),
+                String.format("%d, %d, %d, %d",
+                        this.m20, this.m21, this.m22, this.m23),
+                String.format("%d, %d, %d, %d",
+                        this.m30, this.m31, this.m32, this.m33),
+                ""
+        );
     }
 
     /**
      * Transform the vector vec using this Transform and place the result back
      * into vec.
-     * 
-     * @param vec
-     *            the single precision vector to be transformed
+     *
+     * @param vec the single precision vector to be transformed
      */
     public final void transform(Vec4D vec) {
         float x, y, z;
@@ -3293,11 +3181,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Transform the vector vec using this Matrix4f and place the result into
      * vecOut.
-     * 
-     * @param vec
-     *            the single precision vector to be transformed
-     * @param vecOut
-     *            the vector into which the transformed values are placed
+     *
+     * @param vec the single precision vector to be transformed
+     * @param vecOut the vector into which the transformed values are placed
      */
     public final void transform(Vec4D vec, Vec4D vecOut) {
         float x, y, z;
@@ -3314,9 +3200,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * Transforms the point parameter with this Matrix4f and places the result
      * back into point. The fourth element of the point input paramter is
      * assumed to be one.
-     * 
-     * @param point
-     *            the input point to be transformed.
+     *
+     * @param point the input point to be transformed.
      */
     public final void transformOne(Vec3D point) {
         float x, y;
@@ -3331,11 +3216,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
      * Transforms the point parameter with this Matrix4f and places the result
      * into pointOut. The fourth element of the point input paramter is assumed
      * to be one.
-     * 
-     * @param point
-     *            the input point to be transformed.
-     * @param pointOut
-     *            the transformed point
+     *
+     * @param point the input point to be transformed.
+     * @param pointOut the transformed point
      */
     public final void transformOne(Vec3D point, Vec3D pointOut) {
         float x, y;
@@ -3349,9 +3232,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Transforms the normal parameter by this transform and places the value
      * back into normal. The fourth element of the normal is assumed to be zero.
-     * 
-     * @param normal
-     *            the input normal to be transformed.
+     *
+     * @param normal the input normal to be transformed.
      */
     public final void transformZero(Vec3D normal) {
         float x, y;
@@ -3366,11 +3248,9 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
     /**
      * Transforms the normal parameter by this Matrix4f and places the value
      * into normalOut. The fourth element of the normal is assumed to be zero.
-     * 
-     * @param normal
-     *            the input normal to be transformed.
-     * @param normalOut
-     *            the transformed normal
+     *
+     * @param normal the input normal to be transformed.
+     * @param normalOut the transformed normal
      */
     public final void transformZero(Vec3D normal, Vec3D normalOut) {
         float x, y;
@@ -3414,9 +3294,8 @@ public class Matrix4f implements java.io.Serializable, Cloneable {
 
     /**
      * Sets the value of this matrix to the transpose of the argument matrix.
-     * 
-     * @param m1
-     *            the matrix to be transposed
+     *
+     * @param m1 the matrix to be transposed
      */
     public final void transpose(Matrix4f m1) {
         if (this != m1) {