org.joml

Class AxisAngle4f

java.lang.Object

org.joml.AxisAngle4f

All Implemented Interfaces:

Externalizable, Serializable

public class AxisAngle4f
extends Object
implements Externalizable

Represents a 3D rotation of a given radians about an axis represented as an unit 3D vector.

This class uses single-precision components.

Author:

Kai Burjack

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
float	angle The angle in radians.
float	x The x-component of the rotation axis.
float	y The y-component of the rotation axis.
float	z The z-component of the rotation axis.

Constructor Summary

Constructors

Constructor and Description
AxisAngle4f() Create a new AxisAngle4f with zero rotation about (0, 0, 1).
AxisAngle4f(AxisAngle4f a) Create a new AxisAngle4f with the same values of a.
AxisAngle4f(float angle, float x, float y, float z) Create a new AxisAngle4f with the given values.
AxisAngle4f(float angle, Vector3fc v) Create a new AxisAngle4f with the given values.
AxisAngle4f(Quaternionfc q) Create a new AxisAngle4f from the given Quaternionfc.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
Matrix3d	get(Matrix3d m) Set the given Matrix3d to a rotation transformation equivalent to this AxisAngle4f.
Matrix3f	get(Matrix3f m) Set the given Matrix3f to a rotation transformation equivalent to this AxisAngle4f.
Matrix4d	get(Matrix4d m) Set the given Matrix4d to a rotation transformation equivalent to this AxisAngle4f.
Matrix4f	get(Matrix4f m) Set the given Matrix4f to a rotation transformation equivalent to this AxisAngle4f.
Quaterniond	get(Quaterniond q) Set the given Quaterniond to be equivalent to this AxisAngle4f rotation.
Quaternionf	get(Quaternionf q) Set the given Quaternionf to be equivalent to this AxisAngle4f rotation.
int	hashCode()
AxisAngle4f	normalize() Normalize the axis vector.
void	readExternal(ObjectInput in)
AxisAngle4f	rotate(float ang) Increase the rotation angle by the given amount.
AxisAngle4f	set(AxisAngle4f a) Set this AxisAngle4f to the values of a.
AxisAngle4f	set(float angle, float x, float y, float z) Set this AxisAngle4f to the given values.
AxisAngle4f	set(float angle, Vector3fc v) Set this AxisAngle4f to the given values.
AxisAngle4f	set(Matrix3dc m) Set this AxisAngle4f to be equivalent to the rotation of the given Matrix3dc.
AxisAngle4f	set(Matrix3fc m) Set this AxisAngle4f to be equivalent to the rotation of the given Matrix3fc.
AxisAngle4f	set(Matrix4dc m) Set this AxisAngle4f to be equivalent to the rotational component of the given Matrix4dc.
AxisAngle4f	set(Matrix4fc m) Set this AxisAngle4f to be equivalent to the rotational component of the given Matrix4fc.
AxisAngle4f	set(Matrix4x3fc m) Set this AxisAngle4f to be equivalent to the rotational component of the given Matrix4x3fc.
AxisAngle4f	set(Quaterniondc q) Set this AxisAngle4f to be equivalent to the given Quaterniondc.
AxisAngle4f	set(Quaternionfc q) Set this AxisAngle4f to be equivalent to the given Quaternionfc.
String	toString() Return a string representation of this AxisAngle4f.
String	toString(NumberFormat formatter) Return a string representation of this AxisAngle4f by formatting the components with the given NumberFormat.
Vector3f	transform(Vector3f v) Transform the given vector by the rotation transformation described by this AxisAngle4f.
Vector3f	transform(Vector3fc v, Vector3f dest) Transform the given vector by the rotation transformation described by this AxisAngle4f and store the result in dest.
Vector4f	transform(Vector4f v) Transform the given vector by the rotation transformation described by this AxisAngle4f.
Vector4f	transform(Vector4fc v, Vector4f dest) Transform the given vector by the rotation transformation described by this AxisAngle4f and store the result in dest.
void	writeExternal(ObjectOutput out)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

angle

public float angle

The angle in radians.

x

public float x

The x-component of the rotation axis.

y

public float y

The y-component of the rotation axis.

z

public float z

The z-component of the rotation axis.

Constructor Detail

AxisAngle4f

public AxisAngle4f()

Create a new AxisAngle4f with zero rotation about (0, 0, 1).

AxisAngle4f

public AxisAngle4f(AxisAngle4f a)

Create a new AxisAngle4f with the same values of a.

Parameters:

a - the AngleAxis4f to copy the values from

AxisAngle4f

public AxisAngle4f(Quaternionfc q)

Create a new AxisAngle4f from the given Quaternionfc.

Reference: http://www.euclideanspace.com

Parameters:

q - the quaternion from which to create the new AngleAxis4f

AxisAngle4f

public AxisAngle4f(float angle,
                   float x,
                   float y,
                   float z)

Create a new AxisAngle4f with the given values.

Parameters:

angle - the angle in radians

x - the x-coordinate of the rotation axis

y - the y-coordinate of the rotation axis

z - the z-coordinate of the rotation axis

AxisAngle4f

public AxisAngle4f(float angle,
                   Vector3fc v)

Create a new AxisAngle4f with the given values.

Parameters:

angle - the angle in radians

v - the rotation axis as a Vector3f

Method Detail

set

public AxisAngle4f set(AxisAngle4f a)

Set this AxisAngle4f to the values of a.

Parameters:

a - the AngleAxis4f to copy the values from

Returns:

this

set

public AxisAngle4f set(float angle,
                       float x,
                       float y,
                       float z)

Set this AxisAngle4f to the given values.

Parameters:

angle - the angle in radians

x - the x-coordinate of the rotation axis

y - the y-coordinate of the rotation axis

z - the z-coordinate of the rotation axis

Returns:

this

set

public AxisAngle4f set(float angle,
                       Vector3fc v)

Set this AxisAngle4f to the given values.

Parameters:

angle - the angle in radians

v - the rotation axis as a Vector3f

Returns:

this

set

public AxisAngle4f set(Quaternionfc q)

Set this AxisAngle4f to be equivalent to the given Quaternionfc.

Parameters:

q - the quaternion to set this AngleAxis4f from

Returns:

this

set

public AxisAngle4f set(Quaterniondc q)

Set this AxisAngle4f to be equivalent to the given Quaterniondc.

Parameters:

q - the quaternion to set this AngleAxis4f from

Returns:

this

set

public AxisAngle4f set(Matrix3fc m)

Set this AxisAngle4f to be equivalent to the rotation of the given Matrix3fc.

Parameters:

m - the Matrix3fc to set this AngleAxis4f from

Returns:

this

set

public AxisAngle4f set(Matrix3dc m)

Set this AxisAngle4f to be equivalent to the rotation of the given Matrix3dc.

Parameters:

m - the Matrix3d to set this AngleAxis4f from

Returns:

this

set

public AxisAngle4f set(Matrix4fc m)

Set this AxisAngle4f to be equivalent to the rotational component of the given Matrix4fc.

Parameters:

m - the Matrix4fc to set this AngleAxis4f from

Returns:

this

set

public AxisAngle4f set(Matrix4x3fc m)

Set this AxisAngle4f to be equivalent to the rotational component of the given Matrix4x3fc.

Parameters:

m - the Matrix4x3fc to set this AngleAxis4f from

Returns:

this

set

public AxisAngle4f set(Matrix4dc m)

Set this AxisAngle4f to be equivalent to the rotational component of the given Matrix4dc.

Parameters:

m - the Matrix4dc to set this AngleAxis4f from

Returns:

this

get

public Quaternionf get(Quaternionf q)

Set the given Quaternionf to be equivalent to this AxisAngle4f rotation.

Parameters:

q - the quaternion to set

Returns:

q

See Also:

Quaternionf.set(AxisAngle4f)

get

public Quaterniond get(Quaterniond q)

Set the given Quaterniond to be equivalent to this AxisAngle4f rotation.

Parameters:

q - the quaternion to set

Returns:

q

See Also:

Quaterniond.set(AxisAngle4f)

get

public Matrix4f get(Matrix4f m)

Set the given Matrix4f to a rotation transformation equivalent to this AxisAngle4f.

Parameters:

m - the matrix to set

Returns:

m

See Also:

Matrix4f.set(AxisAngle4f)

get

public Matrix3f get(Matrix3f m)

Set the given Matrix3f to a rotation transformation equivalent to this AxisAngle4f.

Parameters:

m - the matrix to set

Returns:

m

See Also:

Matrix3f.set(AxisAngle4f)

get

public Matrix4d get(Matrix4d m)

Set the given Matrix4d to a rotation transformation equivalent to this AxisAngle4f.

Parameters:

m - the matrix to set

Returns:

m

See Also:

Matrix4f.set(AxisAngle4f)

get

public Matrix3d get(Matrix3d m)

Set the given Matrix3d to a rotation transformation equivalent to this AxisAngle4f.

Parameters:

m - the matrix to set

Returns:

m

See Also:

Matrix3f.set(AxisAngle4f)

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Throws:

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Throws:

IOException

ClassNotFoundException

normalize

public AxisAngle4f normalize()

Normalize the axis vector.

Returns:

this

rotate

public AxisAngle4f rotate(float ang)

Increase the rotation angle by the given amount.

This method also takes care of wrapping around.

Parameters:

ang - the angle increase

Returns:

this

transform

public Vector3f transform(Vector3f v)

Transform the given vector by the rotation transformation described by this AxisAngle4f.

Parameters:

v - the vector to transform

Returns:

v

transform

public Vector3f transform(Vector3fc v,
                          Vector3f dest)

Transform the given vector by the rotation transformation described by this AxisAngle4f and store the result in dest.

Parameters:

v - the vector to transform

dest - will hold the result

Returns:

dest

transform

public Vector4f transform(Vector4f v)

Transform the given vector by the rotation transformation described by this AxisAngle4f.

Parameters:

v - the vector to transform

Returns:

v

transform

public Vector4f transform(Vector4fc v,
                          Vector4f dest)

Transform the given vector by the rotation transformation described by this AxisAngle4f and store the result in dest.

Parameters:

v - the vector to transform

dest - will hold the result

Returns:

dest

toString

public String toString()

Return a string representation of this AxisAngle4f.

This method creates a new DecimalFormat on every invocation with the format string " 0.000E0;-".

Overrides:

toString in class Object

Returns:

the string representation

toString

public String toString(NumberFormat formatter)

Return a string representation of this AxisAngle4f by formatting the components with the given NumberFormat.

Parameters:

formatter - the NumberFormat used to format the vector components with

Returns:

the string representation

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object