org.kynosarges.tektosyne.geometry

Class Angle

java.lang.Object

org.kynosarges.tektosyne.geometry.Angle

public final class Angle
extends java.lang.Object

Provides constants and methods to manipulate angles in radians and degrees.

Field Summary

Fields

Modifier and Type	Field and Description
static double	DEGREES_TO_RADIANS The factor that converts an angle from degrees to radians.
static double	RADIANS_TO_DEGREES The factor that converts an angle from radians to degrees.

Method Summary

Modifier and Type	Method and Description
static Compass	degreesToCompass(double degrees) Converts the specified angle in degrees to the nearest Compass point.
static double	distanceDegrees(double start, double end) Finds the shortest distance between two specified normalized angles, in degrees.
static double	distanceRadians(double start, double end) Finds the shortest distance between two specified normalized angles, in radians.
static double	normalizeDegrees(double degrees) Normalizes the specified angle in degrees to the interval [0, 360).
static double	normalizeRadians(double radians) Normalizes the specified angle in radians to the interval [0, 2 Math.PI).
static int	normalizeRoundedDegrees(double degrees) Normalizes the specified angle in degrees to the interval [0, 360), after rounding to the nearest Integer.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEGREES_TO_RADIANS

public static final double DEGREES_TO_RADIANS

The factor that converts an angle from degrees to radians. Holds the value Math.PI / 180.

See Also:

Constant Field Values

RADIANS_TO_DEGREES

public static final double RADIANS_TO_DEGREES

The factor that converts an angle from radians to degrees. Holds the value 180 / Math.PI.

See Also:

Constant Field Values

Method Detail

degreesToCompass

public static Compass degreesToCompass(double degrees)

Converts the specified angle in degrees to the nearest Compass point.

Parameters:

degrees - the angle in degrees to convert. This value is taken Fortran.modulo(double, double) 360 degrees, and may therefore lie outside the interval [0, 360).

Returns:

the Compass point nearest the specified degrees

distanceDegrees

public static double distanceDegrees(double start,
                                     double end)

Finds the shortest distance between two specified normalized angles, in degrees. Both specified angles must be normalized to the half-open interval [0, 360), e.g. using normalizeDegrees(double). If so, distanceDegrees returns the value within the half-open interval (-180, 180] that solves the following equation: end = normalizeDegrees(double)(start + distanceDegrees(start, end))

Parameters:

start - the angle from which the distance is measured, in normalized degrees

end - the angle to which the distance is measured, in normalized degrees

Returns:

the shortest distance between start and end, in signed degrees

distanceRadians

public static double distanceRadians(double start,
                                     double end)

Finds the shortest distance between two specified normalized angles, in radians. Both specified angles must be normalized to the half-open interval [0, 2 Math.PI), e.g. using normalizeRadians(double). If so, distanceRadians returns the value within the half-open interval (-Math.PI, Math.PI] that solves the following equation: end = normalizeRadians(double)(start + distanceRadians(start, end))

Parameters:

start - the angle from which the distance is measured, in normalized radians

end - the angle to which the distance is measured, in normalized radians

Returns:

the shortest distance between start and end, in signed radians

normalizeDegrees

public static double normalizeDegrees(double degrees)

Normalizes the specified angle in degrees to the interval [0, 360).

Parameters:

degrees - the angle in degrees to normalize

Returns:

the specified degrees normalized to the half-open interval [0, 360)

normalizeRoundedDegrees

public static int normalizeRoundedDegrees(double degrees)

Normalizes the specified angle in degrees to the interval [0, 360), after rounding to the nearest Integer. Uses Fortran.nint(double) to round degrees before normalization. The result is guaranteed to be an Integer value within [0, 359].

Parameters:

degrees - the angle in degrees to normalize

Returns:

the specified degrees rounded to the nearest Integer and normalized to the half-open interval [0, 360)

Throws:

java.lang.ArithmeticException - if degrees overflows Integer

normalizeRadians

public static double normalizeRadians(double radians)

Normalizes the specified angle in radians to the interval [0, 2 Math.PI).

Parameters:

radians - the angle in radians to normalize

Returns:

the specified radians normalized to the half-open interval [0, 2 Math.PI)