summaryrefslogtreecommitdiffstats
path: root/src/javax/vecmath/Vector4f.java
diff options
context:
space:
mode:
authorKevin Rushforth <[email protected]>2004-06-09 02:52:37 +0000
committerKevin Rushforth <[email protected]>2004-06-09 02:52:37 +0000
commitdf69463d936326e3f44453e9b9987b96272ae5d9 (patch)
treec0aa5a160cd3a4e9bdbd201a0e6a2c35ce763e4f /src/javax/vecmath/Vector4f.java
parent8d04fe6c33678b770bbd5c7747ca21e565648222 (diff)
Initial creation of vecmath sources in CVS repository
git-svn-id: https://svn.java.net/svn/vecmath~svn/trunk@5 dd45e54d-f42e-c781-df72-dca083a658b1
Diffstat (limited to 'src/javax/vecmath/Vector4f.java')
-rw-r--r--src/javax/vecmath/Vector4f.java209
1 files changed, 209 insertions, 0 deletions
diff --git a/src/javax/vecmath/Vector4f.java b/src/javax/vecmath/Vector4f.java
new file mode 100644
index 0000000..9ff885e
--- /dev/null
+++ b/src/javax/vecmath/Vector4f.java
@@ -0,0 +1,209 @@
+/*
+ * $RCSfile$
+ *
+ * Copyright (c) 2004 Sun Microsystems, Inc. All rights reserved.
+ *
+ * Use is subject to license terms.
+ *
+ * $Revision$
+ * $Date$
+ * $State$
+ */
+
+package javax.vecmath;
+
+import java.lang.Math;
+
+/**
+ * A 4-element vector represented by single-precision floating point x,y,z,w
+ * coordinates.
+ *
+ */
+public class Vector4f extends Tuple4f implements java.io.Serializable {
+
+ // Compatible with 1.1
+ static final long serialVersionUID = 8749319902347760659L;
+
+ /**
+ * Constructs and initializes a Vector4f from the specified xyzw coordinates.
+ * @param x the x coordinate
+ * @param y the y coordinate
+ * @param z the z coordinate
+ * @param w the w coordinate
+ */
+ public Vector4f(float x, float y, float z, float w)
+ {
+ super(x,y,z,w);
+ }
+
+
+ /**
+ * Constructs and initializes a Vector4f from the array of length 4.
+ * @param v the array of length 4 containing xyzw in order
+ */
+ public Vector4f(float[] v)
+ {
+ super(v);
+ }
+
+
+ /**
+ * Constructs and initializes a Vector4f from the specified Vector4f.
+ * @param v1 the Vector4f containing the initialization x y z w data
+ */
+ public Vector4f(Vector4f v1)
+ {
+ super(v1);
+ }
+
+
+ /**
+ * Constructs and initializes a Vector4f from the specified Vector4d.
+ * @param v1 the Vector4d containing the initialization x y z w data
+ */
+ public Vector4f(Vector4d v1)
+ {
+ super(v1);
+ }
+
+
+ /**
+ * Constructs and initializes a Vector4f from the specified Tuple4f.
+ * @param t1 the Tuple4f containing the initialization x y z w data
+ */
+ public Vector4f(Tuple4f t1)
+ {
+ super(t1);
+ }
+
+
+ /**
+ * Constructs and initializes a Vector4f from the specified Tuple4d.
+ * @param t1 the Tuple4d containing the initialization x y z w data
+ */
+ public Vector4f(Tuple4d t1)
+ {
+ super(t1);
+ }
+
+
+ /**
+ * Constructs and initializes a Vector4f from the specified Tuple3f.
+ * The x,y,z components of this vector are set to the corresponding
+ * components of tuple t1. The w component of this vector
+ * is set to 0.
+ * @param t1 the tuple to be copied
+ *
+ * @since Java 3D 1.2
+ */
+ public Vector4f(Tuple3f t1) {
+ super(t1.x, t1.y, t1.z, 0.0f);
+ }
+
+
+ /**
+ * Constructs and initializes a Vector4f to (0,0,0,0).
+ */
+ public Vector4f()
+ {
+ super();
+ }
+
+
+ /**
+ * Sets the x,y,z components of this vector to the corresponding
+ * components of tuple t1. The w component of this vector
+ * is set to 0.
+ * @param t1 the tuple to be copied
+ *
+ * @since Java 3D 1.2
+ */
+ public final void set(Tuple3f t1) {
+ this.x = t1.x;
+ this.y = t1.y;
+ this.z = t1.z;
+ this.w = 0.0f;
+ }
+
+
+ /**
+ * Returns the length of this vector.
+ * @return the length of this vector as a float
+ */
+ public final float length()
+ {
+ return
+ (float) Math.sqrt(this.x*this.x + this.y*this.y +
+ this.z*this.z + this.w*this.w);
+ }
+
+ /**
+ * Returns the squared length of this vector
+ * @return the squared length of this vector as a float
+ */
+ public final float lengthSquared()
+ {
+ return (this.x*this.x + this.y*this.y +
+ this.z*this.z + this.w*this.w);
+ }
+
+ /**
+ * returns the dot product of this vector and v1
+ * @param v1 the other vector
+ * @return the dot product of this vector and v1
+ */
+ public final float dot(Vector4f v1)
+ {
+ return (this.x*v1.x + this.y*v1.y + this.z*v1.z + this.w*v1.w);
+ }
+
+
+ /**
+ * Sets the value of this vector to the normalization of vector v1.
+ * @param v1 the un-normalized vector
+ */
+ public final void normalize(Vector4f v1)
+ {
+ float norm;
+
+ norm = (float) (1.0/Math.sqrt(v1.x*v1.x + v1.y*v1.y +
+ v1.z*v1.z + v1.w*v1.w));
+ this.x = v1.x*norm;
+ this.y = v1.y*norm;
+ this.z = v1.z*norm;
+ this.w = v1.w*norm;
+ }
+
+
+ /**
+ * Normalizes this vector in place.
+ */
+ public final void normalize()
+ {
+ float norm;
+
+ norm = (float) (1.0/Math.sqrt(this.x*this.x + this.y*this.y +
+ this.z*this.z + this.w*this.w));
+ this.x *= norm;
+ this.y *= norm;
+ this.z *= norm;
+ this.w *= norm;
+ }
+
+
+ /**
+ * Returns the (4-space) angle in radians between this vector and
+ * the vector parameter; the return value is constrained to the
+ * range [0,PI].
+ * @param v1 the other vector
+ * @return the angle in radians in the range [0,PI]
+ */
+ public final float angle(Vector4f v1)
+ {
+ double vDot = this.dot(v1) / ( this.length()*v1.length() );
+ if( vDot < -1.0) vDot = -1.0;
+ if( vDot > 1.0) vDot = 1.0;
+ return((float) (Math.acos( vDot )));
+ }
+
+}