minor math lib updates

src/math/Mat3.js

@@ -28,17 +28,18 @@ function Mat3(elements){
  * @todo Create another function that immediately creates an identity matrix eg. eye()
  */
 Mat3.prototype.identity = function(){
-    this.elements[0] = 1;
-    this.elements[1] = 0;
-    this.elements[2] = 0;
+    var e = this.elements;
+    e[0] = 1;
+    e[1] = 0;
+    e[2] = 0;
 
-    this.elements[3] = 0;
-    this.elements[4] = 1;
-    this.elements[5] = 0;
+    e[3] = 0;
+    e[4] = 1;
+    e[5] = 0;
 
-    this.elements[6] = 0;
-    this.elements[7] = 0;
-    this.elements[8] = 1;
+    e[6] = 0;
+    e[7] = 0;
+    e[8] = 1;
 };
 
 /**

src/math/Vec3.js

@@ -173,24 +173,40 @@ Vec3.prototype.unit = function(target){
 };
 
 /**
- * Get the 2-norm (length) of the vector
+ * Get the length of the vector
  * @method norm
  * @return {Number}
+ * @deprecated Use .length() instead
  */
 Vec3.prototype.norm = function(){
     var x=this.x, y=this.y, z=this.z;
     return Math.sqrt(x*x + y*y + z*z);
 };
 
+/**
+ * Get the length of the vector
+ * @method length
+ * @return {Number}
+ */
+Vec3.prototype.length = Vec3.prototype.norm;
+
 /**
  * Get the squared length of the vector
  * @method norm2
  * @return {Number}
+ * @deprecated Use .lengthSquared() instead.
  */
 Vec3.prototype.norm2 = function(){
     return this.dot(this);
 };
 
+/**
+ * Get the squared length of the vector.
+ * @method lengthSquared
+ * @return {Number}
+ */
+Vec3.prototype.lengthSquared = Vec3.prototype.norm2;
+
 /**
  * Get distance from this point to another point
  * @method distanceTo
@@ -206,12 +222,13 @@ Vec3.prototype.distanceTo = function(p){
 };
 
 /**
- * Multiply the vector with a scalar
+ * Multiply all the components of the vector with a scalar.
  * @deprecated Use .scale instead
  * @method mult
  * @param {Number} scalar
- * @param {Vec3} target
+ * @param {Vec3} target The vector to save the result in.
  * @return {Vec3}
+ * @deprecated Use .scale() instead
  */
 Vec3.prototype.mult = function(scalar,target){
     target = target || new Vec3();
@@ -290,8 +307,8 @@ Vec3.prototype.tangents = function(t1,t2){
         n.cross(t1,t2);
     } else {
         // The normal length is zero, make something up
-        t1.set(1,0,0).normalize();
-        t2.set(0,1,0).normalize();
+        t1.set(1, 0, 0);
+        t2.set(0, 1, 0);
     }
 };