All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.vecmath.Tuple3f

java.lang.Object
   |
   +----java.vecmath.Tuple3f

public abstract class Tuple3f
extends Object
A generic 3 element tuple that is represented by single precision floating point x,y,z coordinates.


Variable Index

 o x
The x coordinate.
 o y
The y coordinate.
 o z
The z coordinate.

Constructor Index

 o Tuple3f()
Constructs and initializes a Tuple3f to (0,0,0).
 o Tuple3f(float, float, float)
Constructs and initializes a Tuple3f from the specified xyz coordinates.
 o Tuple3f(float[])
Constructs and initializes a Tuple3f from the array of length 3.
 o Tuple3f(Tuple3d)
Constructs and initializes a Tuple3f from the specified Tuple3d.
 o Tuple3f(Tuple3f)
Constructs and initializes a Tuple3f from the specified Tuple3f.

Method Index

 o absolute()
Sets each component of this tuple to its absolute value.
 o absolute(Tuple3f)
Sets each component of the tuple parameter to its absolute value and places the modified values into this tuple.
 o add(Tuple3f)
Sets the value of this tuple to the vector sum of itself and tuple t1.
 o add(Tuple3f, Tuple3f)
Sets the value of this tuple to the vector sum of tuples t1 and t2.
 o clamp(float, float)
Clamps this tuple to the range [low, high].
 o clamp(float, float, Tuple3f)
Clamps the tuple parameter to the range [low, high] and places the values into this tuple.
 o clampMax(float)
Clamps the maximum value of this tuple to the max parameter.
 o clampMax(float, Tuple3f)
Clamps the maximum value of the tuple parameter to the max parameter and places the values into this tuple.
 o clampMin(float)
Clamps the minimum value of this tuple to the min parameter.
 o clampMin(float, Tuple3f)
Clamps the minimum value of the tuple parameter to the min parameter and places the values into this tuple.
 o epsilonEquals(Tuple3f, float)
Returns true if the L-infinite distance between this tuple and tuple t1 is less than or equal to the epsilon parameter, otherwise returns false.
 o equals(Tuple3f)
Returns true if all of the data members of Tuple3f t1 are equal to the corresponding data members in this Tuple3f.
 o get(float[])
Gets the value of this tuple and copies the values into t[].
 o get(Tuple3f)
Gets the value of this tuple and copies the values into the Tuple3f method argument.
 o hashCode()
Returns a hash number based on the data values in this object.
 o interpolate(Tuple3f, float)
Linearly interpolates between this tuple and tuple t1 and places the result into this tuple: this = alpha*this + (1-alpha)*t1.
 o interpolate(Tuple3f, Tuple3f, float)
Linearly interpolates between tuples t1 and t2 and places the result into this tuple: this = alpha*t1 + (1-alpha)*t2.
 o negate()
Negates the value of this tuple in place.
 o negate(Tuple3f)
Sets the value of this tuple to the negation of tuple t1.
 o scale(float)
Sets the value of this tuple to the scalar multiplication of the scale factor with this.
 o scale(float, Tuple3f)
Sets the value of this vector to the scalar multiplication of tuple t1.
 o scaleAdd(float, Tuple3f, Tuple3f)
Sets the value of this tuple to the scalar multiplication of tuple t1 and then adds tuple t2 (this = s*t1 + t2).
 o set(float, float, float)
Sets the value of this tuple to the specified xyz coordinates.
 o set(float[])
Sets the value of this tuple to the xyz coordinates specified in the array of length 3.
 o set(Tuple3d)
Sets the value of this tuple to the value of the Tuple3d argument.
 o set(Tuple3f)
Sets the value of this tuple to the value of tuple t1.
 o sub(Tuple3f)
Sets the value of this tuple to the vector difference of itself and tuple t1 (this = this - t1) .
 o sub(Tuple3f, Tuple3f)
Sets the value of this tuple to the vector difference of tuples t1 and t2 (this = t1 - t2).
 o toString()
Returns a string that contains the values of this Tuple3f.

Variables

 o x
 public float x
The x coordinate.

 o y
 public float y
The y coordinate.

 o z
 public float z
The z coordinate.

Constructors

 o Tuple3f
 public Tuple3f(float x,
                float y,
                float z)
Constructs and initializes a Tuple3f from the specified xyz coordinates.

Parameters:
x - the x coordinate
y - the y coordinate
z - the z coordinate
 o Tuple3f
 public Tuple3f(float t[])
Constructs and initializes a Tuple3f from the array of length 3.

Parameters:
t - the array of length 3 containing xyz in order
 o Tuple3f
 public Tuple3f(Tuple3f t1)
Constructs and initializes a Tuple3f from the specified Tuple3f.

Parameters:
t1 - the Tuple3f containing the initialization x y z data
 o Tuple3f
 public Tuple3f(Tuple3d t1)
Constructs and initializes a Tuple3f from the specified Tuple3d.

Parameters:
t1 - the Tuple3d containing the initialization x y z data
 o Tuple3f
 public Tuple3f()
Constructs and initializes a Tuple3f to (0,0,0).

Methods

 o toString
 public String toString()
Returns a string that contains the values of this Tuple3f. The form is (x,y,z).

Returns:
the String representation
Overrides:
toString in class Object
 o set
 public final void set(float x,
                       float y,
                       float z)
Sets the value of this tuple to the specified xyz coordinates.

Parameters:
x - the x coordinate
y - the y coordinate
z - the z coordinate
 o set
 public final void set(float t[])
Sets the value of this tuple to the xyz coordinates specified in the array of length 3.

Parameters:
t - the array of length 3 containing xyz in order
 o set
 public final void set(Tuple3f t1)
Sets the value of this tuple to the value of tuple t1.

Parameters:
t1 - the tuple to be copied
 o set
 public final void set(Tuple3d t1)
Sets the value of this tuple to the value of the Tuple3d argument.

Parameters:
t1 - the tuple to be copied
 o get
 public final void get(float t[])
Gets the value of this tuple and copies the values into t[].

Parameters:
t - array of length 3 into which the values are copied
 o get
 public final void get(Tuple3f t)
Gets the value of this tuple and copies the values into the Tuple3f method argument.

Parameters:
t - Tuple3f object into which that values of this object are copied
 o add
 public final void add(Tuple3f t1,
                       Tuple3f t2)
Sets the value of this tuple to the vector sum of tuples t1 and t2.

Parameters:
t1 - the first tuple
t2 - the second tuple
 o add
 public final void add(Tuple3f t1)
Sets the value of this tuple to the vector sum of itself and tuple t1.

Parameters:
t1 - the other tuple
 o sub
 public final void sub(Tuple3f t1,
                       Tuple3f t2)
Sets the value of this tuple to the vector difference of tuples t1 and t2 (this = t1 - t2).

Parameters:
t1 - the first tuple
t2 - the second tuple
 o sub
 public final void sub(Tuple3f t1)
Sets the value of this tuple to the vector difference of itself and tuple t1 (this = this - t1) .

Parameters:
t1 - the other tuple
 o negate
 public final void negate(Tuple3f t1)
Sets the value of this tuple to the negation of tuple t1.

Parameters:
t1 - the source tuple
 o negate
 public final void negate()
Negates the value of this tuple in place.

 o scale
 public final void scale(float s,
                         Tuple3f t1)
Sets the value of this vector to the scalar multiplication of tuple t1.

Parameters:
s - the scalar value
t1 - the source tuple
 o scale
 public final void scale(float s)
Sets the value of this tuple to the scalar multiplication of the scale factor with this.

Parameters:
s - the scalar value
 o scaleAdd
 public final void scaleAdd(float s,
                            Tuple3f t1,
                            Tuple3f t2)
Sets the value of this tuple to the scalar multiplication of tuple t1 and then adds tuple t2 (this = s*t1 + t2).

Parameters:
s - the scalar value
t1 - the tuple to be scaled and added
t2 - the tuple to be added without a scale
 o equals
 public boolean equals(Tuple3f t1)
Returns true if all of the data members of Tuple3f t1 are equal to the corresponding data members in this Tuple3f.

Parameters:
t1 - The vector with which the comparison is made.
Returns:
true or false
 o epsilonEquals
 public boolean epsilonEquals(Tuple3f t1,
                              float epsilon)
Returns true if the L-infinite distance between this tuple and tuple t1 is less than or equal to the epsilon parameter, otherwise returns false. The L-infinite distance is equal to MAX[abs(x1-x2), abs(y1-y2), abs(z1-z2)].

Parameters:
t1 - The tuple to be compared to this tuple
epsilon - the threshold value
 o hashCode
 public int hashCode()
Returns a hash number based on the data values in this object. Two different Tuple3f objects with identical data values (ie, returns true for equals(Tuple3f) ) will return the same hash number. Two tuples with different data members may return the same hash value, although this is not likely.

Returns:
the integer hash value
Overrides:
hashCode in class Object
 o clamp
 public final void clamp(float min,
                         float max,
                         Tuple3f t)
Clamps the tuple parameter to the range [low, high] and places the values into this tuple.

Parameters:
min - The lowest value in the tuple after clamping
max - The highest value in the tuple after clamping
t - The source tuple, which will not be modified
 o clampMin
 public final void clampMin(float min,
                            Tuple3f t)
Clamps the minimum value of the tuple parameter to the min parameter and places the values into this tuple.

Parameters:
min - The lowest value in the tuple after clamping
t - The source tuple, which will not be modified
 o clampMax
 public final void clampMax(float max,
                            Tuple3f t)
Clamps the maximum value of the tuple parameter to the max parameter and places the values into this tuple.

Parameters:
max - The highest value in the tuple after clamping
t - The source tuple, which will not be modified
 o absolute
 public final void absolute(Tuple3f t)
Sets each component of the tuple parameter to its absolute value and places the modified values into this tuple.

Parameters:
t - The source tuple, which will not be modified
 o clamp
 public final void clamp(float min,
                         float max)
Clamps this tuple to the range [low, high].

Parameters:
min - The lowest value in this tuple after clamping
max - The highest value in this tuple after clamping
 o clampMin
 public final void clampMin(float min)
Clamps the minimum value of this tuple to the min parameter.

Parameters:
min - The lowest value in this tuple after clamping
 o clampMax
 public final void clampMax(float max)
Clamps the maximum value of this tuple to the max parameter.

Parameters:
max - The highest value in the tuple after clamping
 o absolute
 public final void absolute()
Sets each component of this tuple to its absolute value.

 o interpolate
 public final void interpolate(Tuple3f t1,
                               Tuple3f t2,
                               float alpha)
Linearly interpolates between tuples t1 and t2 and places the result into this tuple: this = alpha*t1 + (1-alpha)*t2.

Parameters:
t1 - the first tuple
t2 - the second tuple
alpha - the alpha interpolation parameter
 o interpolate
 public final void interpolate(Tuple3f t1,
                               float alpha)
Linearly interpolates between this tuple and tuple t1 and places the result into this tuple: this = alpha*this + (1-alpha)*t1.

Parameters:
t1 - the first tuple
alpha - the alpha interpolation parameter

All Packages  Class Hierarchy  This Package  Previous  Next  Index