javax.vecmath
Class Vector4f

java.lang.Object
  extended by javax.vecmath.Tuple4f
      extended by javax.vecmath.Vector4f
All Implemented Interfaces:
java.io.Serializable, java.lang.Cloneable

public class Vector4f
extends Tuple4f
implements java.io.Serializable

A 4 element vector that is represented by single precision floating point x,y,z,w coordinates.

Author:
Kenji hiranabe
See Also:
Serialized Form

Field Summary
 
Fields inherited from class javax.vecmath.Tuple4f
w, x, y, z
 
Constructor Summary
Vector4f()
          Constructs and initializes a Vector4f to (0,0,0,0).
Vector4f(float[] v)
          Constructs and initializes a Vector4f from the specified array of length 4.
Vector4f(float x, float y, float z, float w)
          Constructs and initializes a Vector4f from the specified xyzw coordinates.
Vector4f(Tuple3f t1)
          Constructs and initializes a Vector4f from the specified Tuple3f.
Vector4f(Tuple4d t1)
          Constructs and initializes a Vector4f from the specified Tuple4d.
Vector4f(Tuple4f t1)
          Constructs and initializes a Vector4f from the specified Tuple4f.
Vector4f(Vector4d v1)
          Constructs and initializes a Vector4f from the specified Vector4d.
Vector4f(Vector4f v1)
          Constructs and initializes a Vector4f from the specified Vector4f.
 
Method Summary
 float angle(Vector4f v1)
          Returns the (4-space) angle in radians between this vector and the vector parameter; the return value is constrained to the range [0,PI].
 java.lang.Object clone()
           
 float dot(Vector4f v1)
          Computes the dot product of the this vector and vector v1.
 float length()
          Returns the length of this vector.
 float lengthSquared()
          Returns the squared length of this vector.
 void normalize()
          Normalizes this vector in place.
 void normalize(Vector4d v1)
          Sets the value of this vector to the normalization of vector v1.
 void set(Tuple3f t1)
          Sets the x,y,z components of this point to the corresponding components of tuple t1.
 
Methods inherited from class javax.vecmath.Tuple4f
absolute, absolute, add, add, clamp, clamp, clampMax, clampMax, clampMin, clampMin, epsilonEquals, equals, equals, get, get, hashCode, interpolate, interpolate, negate, negate, scale, scale, scaleAdd, scaleAdd, set, set, set, set, sub, sub, toString
 
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

Vector4f

public Vector4f()
Constructs and initializes a Vector4f to (0,0,0,0).


Vector4f

public Vector4f(float[] v)
Constructs and initializes a Vector4f from the specified array of length 4.

Parameters:
v - the array of length 4 containing xyzw in order

Vector4f

public Vector4f(float x,
                float y,
                float z,
                float w)
Constructs and initializes a Vector4f from the specified xyzw coordinates.

Parameters:
x - the x coordinate
y - the y coordinate
z - the z coordinate
w - the w coordinate

Vector4f

public Vector4f(Tuple3f t1)
Constructs and initializes a Vector4f from the specified Tuple3f. The x,y,z components of this point are set to the corresponding components of tuple t1. The w component of this point is set to 0.

Parameters:
t1 - the tuple to be copied
Since:
Java3D 1.2

Vector4f

public Vector4f(Tuple4d t1)
Constructs and initializes a Vector4f from the specified Tuple4d.

Parameters:
t1 - the Tuple4d containing the initialization x y z w data

Vector4f

public Vector4f(Tuple4f t1)
Constructs and initializes a Vector4f from the specified Tuple4f.

Parameters:
t1 - the Tuple4f containing the initialization x y z w data

Vector4f

public Vector4f(Vector4d v1)
Constructs and initializes a Vector4f from the specified Vector4d.

Parameters:
v1 - the Vector4d containing the initialization x y z w data

Vector4f

public Vector4f(Vector4f v1)
Constructs and initializes a Vector4f from the specified Vector4f.

Parameters:
v1 - the Vector4f containing the initialization x y z w data
Method Detail

angle

public final float angle(Vector4f v1)
Returns the (4-space) angle in radians between this vector and the vector parameter; the return value is constrained to the range [0,PI].

Parameters:
v1 - the other vector
Returns:
the angle in radians in the range [0,PI]

clone

public java.lang.Object clone()
Specified by:
clone in class Tuple4f

dot

public final float dot(Vector4f v1)
Computes the dot product of the this vector and vector v1.

Parameters:
v1 - the other vector
Returns:
the dot product of this vector and v1

length

public final float length()
Returns the length of this vector.

Returns:
the length of this vector as a float

lengthSquared

public final float lengthSquared()
Returns the squared length of this vector.

Returns:
the squared length of this vectoras a float

normalize

public final void normalize()
Normalizes this vector in place.


normalize

public final void normalize(Vector4d v1)
Sets the value of this vector to the normalization of vector v1.

Parameters:
v1 - the un-normalized vector

set

public final void set(Tuple3f t1)
Sets the x,y,z components of this point to the corresponding components of tuple t1. The w component of this point is set to 1.

Parameters:
t1 - the tuple to be copied
Since:
Java3D 1.2