org.apache.commons.geometry.euclidean.twod.rotation

Class Rotation2D

java.lang.Object

org.apache.commons.geometry.euclidean.twod.rotation.Rotation2D

All Implemented Interfaces:

Function<Vector2D,Vector2D>, UnaryOperator<Vector2D>, Transform<Vector2D>, EuclideanTransform<Vector2D>

public final class Rotation2D
extends Object
implements EuclideanTransform<Vector2D>

Class representing a rotation in 2 dimensional Euclidean space. Positive rotations are in a counter-clockwise direction.

Method Summary

Modifier and Type	Method and Description
Vector2D	apply(Vector2D pt)
Vector2D	applyVector(Vector2D vec) Apply this transform to the given vector, ignoring translations.
static Rotation2D	createVectorRotation(Vector2D u, Vector2D v) Create a rotation instance that rotates the vector u to point in the direction of vector v.
boolean	equals(Object obj)
double	getAngle() Get the angle of rotation in radians.
int	hashCode()
static Rotation2D	identity() Return an instance representing the identity rotation, ie a rotation of zero radians.
Rotation2D	inverse()
static Rotation2D	of(double angle) Create a new instance with the given angle of rotation.
boolean	preservesOrientation()
AffineTransformMatrix2D	toMatrix() Return an AffineTransformMatrix2D representing the same rotation as this instance.
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.function.Function

andThen, compose

Method Detail

getAngle

public double getAngle()

Get the angle of rotation in radians.

Returns:

the angle of rotation in radians

inverse

public Rotation2D inverse()

Specified by:

inverse in interface Transform<Vector2D>

preservesOrientation

public boolean preservesOrientation()

This method simply returns true since rotations always preserve the orientation of the space.

Specified by:

preservesOrientation in interface Transform<Vector2D>

apply

public Vector2D apply(Vector2D pt)

Specified by:

apply in interface Function<Vector2D,Vector2D>

applyVector

public Vector2D applyVector(Vector2D vec)

Apply this transform to the given vector, ignoring translations.

This method can be used to transform vector instances representing displacements between points. For example, if v represents the difference between points p1 and p2, then transform.applyVector(v) will represent the difference between p1 and p2 after transform is applied.

This method simply calls apply(vec) since rotations treat points and vectors similarly.

Specified by:

applyVector in interface EuclideanTransform<Vector2D>

Parameters:

vec - the vector to transform

Returns:

the new, transformed vector

toMatrix

public AffineTransformMatrix2D toMatrix()

Return an AffineTransformMatrix2D representing the same rotation as this instance.

Returns:

a transform matrix representing the same rotation

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

of

public static Rotation2D of(double angle)

Create a new instance with the given angle of rotation.

Parameters:

angle - the angle of rotation in radians

Returns:

a new instance with the given angle of rotation

identity

public static Rotation2D identity()

Return an instance representing the identity rotation, ie a rotation of zero radians.

Specified by:

identity in interface Function<Vector2D,Vector2D>

Specified by:

identity in interface UnaryOperator<Vector2D>

Returns:

an instance representing a rotation of zero radians

createVectorRotation

public static Rotation2D createVectorRotation(Vector2D u,
                                              Vector2D v)

Create a rotation instance that rotates the vector u to point in the direction of vector v.

Parameters:

u - input vector

v - target vector

Returns:

a rotation instance that rotates u to point in the direction of v

Throws:

IllegalArgumentException - if either vector cannot be normalized