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.
-
x
- The x coordinate.
-
y
- The y coordinate.
-
z
- The z coordinate.
-
Tuple3f()
- Constructs and initializes a Tuple3f to (0,0,0).
-
Tuple3f(float, float, float)
- Constructs and initializes a Tuple3f from the specified xyz coordinates.
-
Tuple3f(float[])
- Constructs and initializes a Tuple3f from the array of length 3.
-
Tuple3f(Tuple3d)
- Constructs and initializes a Tuple3f from the specified Tuple3d.
-
Tuple3f(Tuple3f)
- Constructs and initializes a Tuple3f from the specified Tuple3f.
-
absolute()
- Sets each component of this tuple to its absolute value.
-
absolute(Tuple3f)
-
Sets each component of the tuple parameter to its absolute
value and places the modified values into this tuple.
-
add(Tuple3f)
-
Sets the value of this tuple to the vector sum of itself and tuple t1.
-
add(Tuple3f, Tuple3f)
- Sets the value of this tuple to the vector sum of tuples t1 and t2.
-
clamp(float, float)
- Clamps this tuple to the range [low, high].
-
clamp(float, float, Tuple3f)
-
Clamps the tuple parameter to the range [low, high] and
places the values into this tuple.
-
clampMax(float)
- Clamps the maximum value of this tuple to the max parameter.
-
clampMax(float, Tuple3f)
-
Clamps the maximum value of the tuple parameter to the max
parameter and places the values into this tuple.
-
clampMin(float)
- Clamps the minimum value of this tuple to the min parameter.
-
clampMin(float, Tuple3f)
-
Clamps the minimum value of the tuple parameter to the min
parameter and places the values into this tuple.
-
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.
-
equals(Tuple3f)
- Returns true if all of the data members of Tuple3f t1 are
equal to the corresponding data members in this Tuple3f.
-
get(float[])
-
Gets the value of this tuple and copies the values into t[].
-
get(Tuple3f)
- Gets the value of this tuple and copies the values into the
Tuple3f method argument.
-
hashCode()
- Returns a hash number based on the data values in this
object.
-
interpolate(Tuple3f, float)
-
Linearly interpolates between this tuple and tuple t1 and
places the result into this tuple: this = alpha*this + (1-alpha)*t1.
-
interpolate(Tuple3f, Tuple3f, float)
-
Linearly interpolates between tuples t1 and t2 and places the
result into this tuple: this = alpha*t1 + (1-alpha)*t2.
-
negate()
- Negates the value of this tuple in place.
-
negate(Tuple3f)
- Sets the value of this tuple to the negation of tuple t1.
-
scale(float)
- Sets the value of this tuple to the scalar multiplication
of the scale factor with this.
-
scale(float, Tuple3f)
- Sets the value of this vector to the scalar multiplication
of tuple t1.
-
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).
-
set(float, float, float)
- Sets the value of this tuple to the specified xyz coordinates.
-
set(float[])
- Sets the value of this tuple to the xyz coordinates specified in
the array of length 3.
-
set(Tuple3d)
- Sets the value of this tuple to the value of the Tuple3d argument.
-
set(Tuple3f)
- Sets the value of this tuple to the value of tuple t1.
-
sub(Tuple3f)
-
Sets the value of this tuple to the vector difference of
itself and tuple t1 (this = this - t1) .
-
sub(Tuple3f, Tuple3f)
- Sets the value of this tuple to the vector difference
of tuples t1 and t2 (this = t1 - t2).
-
toString()
- Returns a string that contains the values of this Tuple3f.
x
public float x
- The x coordinate.
y
public float y
- The y coordinate.
z
public float z
- The z coordinate.
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
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
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
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
Tuple3f
public Tuple3f()
- Constructs and initializes a Tuple3f to (0,0,0).
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
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
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
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
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
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
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
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
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
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
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
negate
public final void negate(Tuple3f t1)
- Sets the value of this tuple to the negation of tuple t1.
- Parameters:
- t1 - the source tuple
negate
public final void negate()
- Negates the value of this tuple in place.
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
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
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
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
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
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
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
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
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
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
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
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
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
absolute
public final void absolute()
- Sets each component of this tuple to its absolute value.
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
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