javax.vecmath

Class AxisAngle4d

Implemented Interfaces:
Serializable

public class AxisAngle4d
extends java.lang.Object
implements Serializable

A 4 element axis angle represented by double precision floating point x,y,z,angle components. An axis angle is a rotation of angle (radians) about the vector (x,y,z).
Version:
specification 1.1, implementation $Revision: 1.11 $, $Date: 1999/10/05 07:03:50 $
Author:
Kenji hiranabe

Field Summary

double
angle
The angle.
double
x
The x coordinate.
double
y
The y coordinate.
double
z
The z coordinate.

Constructor Summary

AxisAngle4d()
Constructs and initializes a AxisAngle4d to (0,0,1,0).
AxisAngle4d(a[] )
Constructs and initializes an AxisAngle4d from the components contained in the array.
AxisAngle4d(double x, double y, double z, double angle)
Constructs and initializes an AxisAngle4d from the specified x, y, z, and angle.
AxisAngle4d(AxisAngle4d a1)
Constructs and initializes a AxisAngle4d from the specified AxisAngle4d.
AxisAngle4d(AxisAngle4f a1)
Constructs and initializes a AxisAngle4d from the specified AxisAngle4f.
AxisAngle4d(Vector3d axis, double angle)
Constructs and initializes an AxisAngle4d from the specified axis and angle.

Method Summary

boolean
epsilonEquals(AxisAngle4d a1, double epsilon)
Returns true if the L-infinite distance between this axis-angle and axis-angle t1 is less than or equal to the epsilon parameter, otherwise returns false.
boolean
equals(Object o1)
Returns true if the Object o1 is of type AxisAngle4d and all of the data members of t1 are equal to the corresponding data members in this AxisAngle4d.
boolean
equals(AxisAngle4d a1)
Returns true if all of the data members of AxisAngle4d t1 are equal to the corresponding data members in this
void
get(a[] )
Gets the value of this axis angle into the array a of length four in x,y,z,angle order.
int
hashCode()
Returns a hash number based on the data values in this object.
void
set(a[] )
Sets the value of this axis angle from the 4 values specified in the array.
void
set(double x, double y, double z, double angle)
Sets the value of this axis angle to the specified x,y,z,angle.
void
set(AxisAngle4d a1)
Sets the value of this axis angle to the value of axis angle t1.
void
set(AxisAngle4f a1)
Sets the value of this axis angle to the value of axis angle t1.
void
set(Matrix3d m1)
Sets the value of this axis-angle to the rotational component of the passed matrix.
void
set(Matrix3f m1)
Sets the value of this axis-angle to the rotational component of the passed matrix.
void
set(Matrix4d m1)
Sets the value of this axis-angle to the rotational component of the passed matrix.
void
set(Matrix4f m1)
Sets the value of this axis-angle to the rotational component of the passed matrix.
void
set(Quat4d q1)
Sets the value of this axis-angle to the rotational equivalent of the passed quaternion.
void
set(Quat4f q1)
Sets the value of this axis-angle to the rotational equivalent of the passed quaternion.
void
set(Vector3d axis, double angle)
Sets the value of this AxisAngle4d to the specified axis and angle.
String
toString()
Returns a string that contains the values of this AxisAngle4d.

Field Details

angle

public double angle
The angle.

x

public double x
The x coordinate.

y

public double y
The y coordinate.

z

public double z
The z coordinate.

Constructor Details

AxisAngle4d

public AxisAngle4d()
Constructs and initializes a AxisAngle4d to (0,0,1,0).

AxisAngle4d

public AxisAngle4d(a[] )
Constructs and initializes an AxisAngle4d from the components contained in the array.
Parameters:

AxisAngle4d

public AxisAngle4d(double x,
                   double y,
                   double z,
                   double angle)
Constructs and initializes an AxisAngle4d from the specified x, y, z, and angle.
Parameters:
x - the x coordinate
y - the y coordinate
z - the z coordinate
angle - the angle.

AxisAngle4d

public AxisAngle4d(AxisAngle4d a1)
Constructs and initializes a AxisAngle4d from the specified AxisAngle4d.
Parameters:
a1 - the AxisAngle4d containing the initialization x y z angle data

AxisAngle4d

public AxisAngle4d(AxisAngle4f a1)
Constructs and initializes a AxisAngle4d from the specified AxisAngle4f.
Parameters:
a1 - the AxisAngle4f containing the initialization x y z angle data

AxisAngle4d

public AxisAngle4d(Vector3d axis,
                   double angle)
Constructs and initializes an AxisAngle4d from the specified axis and angle.
Parameters:
axis - the axis
angle - the angle
Since:
Java 3D 1.2

Method Details

epsilonEquals

public boolean epsilonEquals(AxisAngle4d a1,
                             double epsilon)
Returns true if the L-infinite distance between this axis-angle and axis-angle 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), abs(angle1-angle2)].
Parameters:
a1 - the axis-angle to be compared to this axis-angle
epsilon - the threshold value

equals

public boolean equals(Object o1)
Returns true if the Object o1 is of type AxisAngle4d and all of the data members of t1 are equal to the corresponding data members in this AxisAngle4d.
Parameters:
o1 - the object with which the comparison is made.

equals

public boolean equals(AxisAngle4d a1)
Returns true if all of the data members of AxisAngle4d t1 are equal to the corresponding data members in this
Parameters:
a1 - the vector with which the comparison is made.

get

public final void get(a[] )
Gets the value of this axis angle into the array a of length four in x,y,z,angle order.
Parameters:

hashCode

public int hashCode()
Returns a hash number based on the data values in this object. Two different AxisAngle4d objects with identical data values (ie, returns true for equals(AxisAngle4d) ) will return the same hash number. Two vectors with different data members may return the same hash value, although this is not likely.

set

public final void set(a[] )
Sets the value of this axis angle from the 4 values specified in the array.
Parameters:

set

public final void set(double x,
                      double y,
                      double z,
                      double angle)
Sets the value of this axis angle to the specified x,y,z,angle.
Parameters:
x - the x coordinate
y - the y coordinate
z - the z coordinate
angle - the angle

set

public final void set(AxisAngle4d a1)
Sets the value of this axis angle to the value of axis angle t1.
Parameters:

set

public final void set(AxisAngle4f a1)
Sets the value of this axis angle to the value of axis angle t1.
Parameters:

set

public final void set(Matrix3d m1)
Sets the value of this axis-angle to the rotational component of the passed matrix.
Parameters:
m1 - the matrix3d

set

public final void set(Matrix3f m1)
Sets the value of this axis-angle to the rotational component of the passed matrix.
Parameters:
m1 - the matrix3f

set

public final void set(Matrix4d m1)
Sets the value of this axis-angle to the rotational component of the passed matrix.
Parameters:
m1 - the matrix4d

set

public final void set(Matrix4f m1)
Sets the value of this axis-angle to the rotational component of the passed matrix.
Parameters:
m1 - the matrix4f

set

public final void set(Quat4d q1)
Sets the value of this axis-angle to the rotational equivalent of the passed quaternion.
Parameters:
q1 - the Quat4d

set

public final void set(Quat4f q1)
Sets the value of this axis-angle to the rotational equivalent of the passed quaternion.
Parameters:
q1 - the Quat4f

set

public final void set(Vector3d axis,
                      double angle)
Sets the value of this AxisAngle4d to the specified axis and angle.
Parameters:
axis - the axis
angle - the angle
Since:
Java 3D 1.2

toString

public String toString()
Returns a string that contains the values of this AxisAngle4d. The form is (x,y,z,angle).
Returns:
the String representation