Package us.ihmc.euclid.axisAngle

Class AxisAngle32

java.lang.Object

us.ihmc.euclid.axisAngle.AxisAngle32

All Implemented Interfaces:

AxisAngleBasics, AxisAngleReadOnly, Clearable, EpsilonComparable<AxisAngle32>, GeometricallyComparable<AxisAngle32>, Settable<AxisAngle32>, Orientation3DBasics, Orientation3DReadOnly

public class AxisAngle32
extends java.lang.Object
implements AxisAngleBasics, Settable<AxisAngle32>, EpsilonComparable<AxisAngle32>, GeometricallyComparable<AxisAngle32>

An AxisAngle is used to represent a 3D orientation by a unitary axis of components (x, y, z) and an angle of rotation usually expressed in radians. This version of axis-angle uses single precision fields to save the value of each component. It is meant for garbage free usage and for situations where heap memory is limited. When memory is not a constraint, the use of AxisAngle is preferable.

Author:

Sylvain Bertrand

Field Summary

Fields inherited from interface us.ihmc.euclid.orientation.interfaces.Orientation3DReadOnly

ORIENTATION_2D_EPSILON

Constructor Summary

Constructors

Constructor	Description
AxisAngle32()	Creates an axis-angle that represents a "zero" rotation.
AxisAngle32(double yaw, double pitch, double roll)	Creates an axis-angle such that it represents the same orientation the yaw-pitch-roll angles represents.
AxisAngle32(float[] axisAngleArray)	Creates an axis-angle initialized with the values contained in the given array: this.setX(axisAngleArray[0]); this.setY(axisAngleArray[1]); this.setZ(axisAngleArray[2]); this.setAngle(axisAngleArray[3]);
AxisAngle32(float x, float y, float z, float angle)	Creates an axis-angle with the given values of the axis (x, y, z) and of the angle angle.
AxisAngle32(Orientation3DReadOnly orientation)	Creates an axis-angle that represents the same orientation as the given one.
AxisAngle32(Vector3DReadOnly rotationVector)	Creates an axis-angle such that it represents the same orientation the rotation vector represents.
AxisAngle32(Vector3DReadOnly axis, float angle)	Create an axis-angle from the given axis and angle.

Method Summary

Modifier and Type	Method	Description
boolean	epsilonEquals(AxisAngle32 other, double epsilon)	Tests on a per component basis, if this axis-angle is equal to other to an epsilon.
boolean	equals(java.lang.Object object)	Tests if the given object's class is the same as this, in which case the method returns AxisAngleReadOnly.equals(AxisAngleReadOnly), it returns false otherwise.
boolean	geometricallyEquals(AxisAngle32 other, double epsilon)	Tests if this and other represent the same orientation to an epsilon.
double	getAngle()	Returns the angle of this axis-angle, usually expressed in radians.
float	getAngle32()	Returns the angle of this axis-angle, usually expressed in radians.
double	getX()	Returns the x-component of the unitary axis of this axis-angle.
float	getX32()	Returns the x-component of the unitary axis of this axis-angle.
double	getY()	Returns the y-component of the unitary axis of this axis-angle.
float	getY32()	Returns the y-component of the unitary axis of this axis-angle.
double	getZ()	Returns the z-component of the unitary axis of this axis-angle.
float	getZ32()	Returns the z-component of the unitary axis of this axis-angle.
int	hashCode()	Calculates and returns a hash code value from the value of each component of this axis-angle.
void	set(float x, float y, float z, float angle)	Sets this axis-angle to represent a new rotation of axis (x, y, z) and angle of angle.
void	set(AxisAngle32 other)	Sets this axis-angle to the same value as the given axis-angle other.
void	setAngle(double angle)	Sets a new angle to this axis-angle.
void	setX(double x)	Sets a new x-component for the axis of this axis-angle.
void	setY(double y)	Sets a new y-component for the axis of this axis-angle.
void	setZ(double z)	Sets a new z-component for the axis of this axis-angle.
java.lang.String	toString()	Provides a String representation of this axis-angle as follows: (x, y, z, angle).

Methods inherited from interface us.ihmc.euclid.axisAngle.interfaces.AxisAngleBasics

absolute, append, appendInvertOther, appendPitchRotation, appendRollRotation, appendYawRotation, containsNaN, inverse, invert, multiply, multiply, multiplyInvertBoth, multiplyInvertOther, multiplyInvertThis, negate, normalize, normalizeAxis, preMultiply, preMultiplyInvertBoth, preMultiplyInvertOther, preMultiplyInvertThis, prepend, prependInvertOther, prependPitchRotation, prependRollRotation, prependYawRotation, scaleAngle, set, set, set, set, set, set, set, set, setAndNegate, setAxisAngle, setElement, setQuaternion, setRotationMatrix, setRotationVector, setToNaN, setToZero, setYawPitchRoll

Methods inherited from interface us.ihmc.euclid.axisAngle.interfaces.AxisAngleReadOnly

addTransform, axisNorm, checkIfIsZOnly, distance, epsilonEquals, equals, geometricallyEquals, get, get, get, get, get, get, get, getElement, getElement32, getEuler, getPitch, getRoll, getRotationVector, getYaw, getYawPitchRoll, inverseTransform, inverseTransform, inverseTransform, inverseTransform, isAxisUnitary, isOrientation2D, isZOnly, transform, transform, transform, transform

Methods inherited from class java.lang.Object

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

Methods inherited from interface us.ihmc.euclid.orientation.interfaces.Orientation3DBasics

appendInvertBoth, appendInvertThis, prependInvertBoth, prependInvertThis, setAndInvert, setAndNormalize, setEuler, setEuler, setRotationVector, setYawPitchRoll

Methods inherited from interface us.ihmc.euclid.orientation.interfaces.Orientation3DReadOnly

addTransform, checkIfOrientation2D, checkIfOrientation2D, inverseTransform, inverseTransform, inverseTransform, inverseTransform, inverseTransform, inverseTransform, inverseTransform, inverseTransform, inverseTransform, inverseTransform, inverseTransform, inverseTransform, isOrientation2D, toStringAsYawPitchRoll, transform, transform, transform, transform, transform, transform, transform, transform, transform, transform, transform, transform

Constructor Detail

AxisAngle32

public AxisAngle32()

Creates an axis-angle that represents a "zero" rotation. The axis is equal to (1, 0, 0) and the angle to 0.

AxisAngle32

public AxisAngle32(Orientation3DReadOnly orientation)

Creates an axis-angle that represents the same orientation as the given one.

Parameters:

orientation - the orientation to initialize this axis-angle. Not modified.

AxisAngle32

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

Creates an axis-angle with the given values of the axis (x, y, z) and of the angle angle.

Parameters:

x - x-component of the axis.

y - y-component of the axis.

z - z-component of the axis.

angle - the angle value.

AxisAngle32

public AxisAngle32(float[] axisAngleArray)

Creates an axis-angle initialized with the values contained in the given array:

• this.setX(axisAngleArray[0]);
• this.setY(axisAngleArray[1]);
• this.setZ(axisAngleArray[2]);
• this.setAngle(axisAngleArray[3]);

Parameters:

axisAngleArray - the array containing the values for this axis-angle. Not modified.

AxisAngle32

public AxisAngle32(Vector3DReadOnly axis,
                   float angle)

Create an axis-angle from the given axis and angle.

Parameters:

axis - the axis. Not modified

angle - the angle value.

AxisAngle32

public AxisAngle32(Vector3DReadOnly rotationVector)

Creates an axis-angle such that it represents the same orientation the rotation vector represents. See AxisAngleConversion.convertRotationVectorToAxisAngle(Vector3DReadOnly, AxisAngleBasics).

Parameters:

rotationVector - the rotation vector used to create this axis-angle. Not modified.

AxisAngle32

public AxisAngle32(double yaw,
                   double pitch,
                   double roll)

Creates an axis-angle such that it represents the same orientation the yaw-pitch-roll angles represents. See AxisAngleConversion.convertYawPitchRollToAxisAngle(double, double, double, AxisAngleBasics).

Parameters:

yaw - the angle to rotate about the z-axis.

pitch - the angle to rotate about the y-axis.

roll - the angle to rotate about the x-axis.

Method Detail

set

public void set(AxisAngle32 other)

Sets this axis-angle to the same value as the given axis-angle other.

Specified by:

set in interface Settable<AxisAngle32>

Parameters:

other - the other axis-angle. Not modified.

set

public final void set(float x,
                      float y,
                      float z,
                      float angle)

Sets this axis-angle to represent a new rotation of axis (x, y, z) and angle of angle.

Parameters:

x - x-component of the new axis.

y - y-component of the new axis.

z - z-component of the new axis.

angle - the new angle.

setX

public final void setX(double x)

Sets a new x-component for the axis of this axis-angle.

Specified by:

setX in interface AxisAngleBasics

Parameters:

x - the new axis x-component.

setY

public final void setY(double y)

Sets a new y-component for the axis of this axis-angle.

Specified by:

setY in interface AxisAngleBasics

Parameters:

y - the new axis y-component.

setZ

public final void setZ(double z)

Sets a new z-component for the axis of this axis-angle.

Specified by:

setZ in interface AxisAngleBasics

Parameters:

z - the new axis z-component.

setAngle

public final void setAngle(double angle)

Sets a new angle to this axis-angle.

Specified by:

setAngle in interface AxisAngleBasics

Parameters:

angle - the new angle.

getX

public double getX()

Returns the x-component of the unitary axis of this axis-angle.

Specified by:

getX in interface AxisAngleReadOnly

Returns:

the x-component of the unitary axis.

getY

public double getY()

Returns the y-component of the unitary axis of this axis-angle.

Specified by:

getY in interface AxisAngleReadOnly

Returns:

the y-component of the unitary axis.

getZ

public double getZ()

Returns the z-component of the unitary axis of this axis-angle.

Specified by:

getZ in interface AxisAngleReadOnly

Returns:

the z-component of the unitary axis.

getAngle

public final double getAngle()

Returns the angle of this axis-angle, usually expressed in radians.

Specified by:

getAngle in interface AxisAngleReadOnly

Returns:

the angle.

getAngle32

public final float getAngle32()

Returns the angle of this axis-angle, usually expressed in radians.

Specified by:

getAngle32 in interface AxisAngleReadOnly

Returns:

the angle.

getX32

public final float getX32()

Returns the x-component of the unitary axis of this axis-angle.

Specified by:

getX32 in interface AxisAngleReadOnly

Returns:

the x-component of the unitary axis.

getY32

public final float getY32()

Returns the y-component of the unitary axis of this axis-angle.

Specified by:

getY32 in interface AxisAngleReadOnly

Returns:

the y-component of the unitary axis.

getZ32

public final float getZ32()

Returns the z-component of the unitary axis of this axis-angle.

Specified by:

getZ32 in interface AxisAngleReadOnly

Returns:

the z-component of the unitary axis.

equals

public boolean equals(java.lang.Object object)

Tests if the given object's class is the same as this, in which case the method returns AxisAngleReadOnly.equals(AxisAngleReadOnly), it returns false otherwise.

Overrides:

equals in class java.lang.Object

Parameters:

object - the object to compare against this. Not modified.

Returns:

true if object and this are exactly equal, false otherwise.

epsilonEquals

public boolean epsilonEquals(AxisAngle32 other,
                             double epsilon)

Tests on a per component basis, if this axis-angle is equal to other to an epsilon. A failing test does not necessarily mean that the two axis-angles represent two different orientations.

Specified by:

epsilonEquals in interface EpsilonComparable<AxisAngle32>

Parameters:

other - the other axis-angle to compare against this. Not modified.

epsilon - tolerance to use when comparing each component.

Returns:

true if the two axis-angle are equal component-wise, false otherwise.

geometricallyEquals

public boolean geometricallyEquals(AxisAngle32 other,
                                   double epsilon)

Tests if this and other represent the same orientation to an epsilon.

Two axis-angle are considered geometrically equal if the magnitude of their difference is less than or equal to epsilon.

Note that this.geometricallyEquals(other, epsilon) == true does not necessarily imply this.epsilonEquals(other, epsilon) and vice versa.

Specified by:

geometricallyEquals in interface GeometricallyComparable<AxisAngle32>

Parameters:

other - the other axis-angle to compare against this. Not modified.

epsilon - the maximum angle for the two quaternions to be considered equal.

Returns:

true if the two axis-angle represent the same geometry, false otherwise.

toString

public java.lang.String toString()

Provides a String representation of this axis-angle as follows: (x, y, z, angle).

Overrides:

toString in class java.lang.Object

Returns:

the String representing this axis-angle.

hashCode

public int hashCode()

Calculates and returns a hash code value from the value of each component of this axis-angle.

Overrides:

hashCode in class java.lang.Object

Returns:

the hash code value for this axis-angle.