agi.foundation.geometry.shapes

(agi.foundation.core-2024r3.jar)

Class Curve

java.lang.Object

agi.foundation.geometry.shapes.Figure

agi.foundation.geometry.shapes.Curve

public abstract class Curve
extends Figure

A 1-dimensional geometric figure.

Constructor Summary

Constructors

Constructor and Description
Curve()

Method Summary

Modifier and Type	Method and Description
abstract double	getAngleSubtended() Gets the angle subtended by the curve.
abstract Cartesian	getFinalPoint() Gets the final point of the curve.
abstract Cartesian	getInitialPoint() Gets the initial point of the curve.
ArrayList<PointOnCurve>	getPoints(double granularity) Provides a collection of points along the curve at the requested granularity.
abstract Cartesian	interpolateUsingAngleSubtended(double angle) Provides the location of a point on the curve that is at the indicated angle defined between the InitialPoint (get) and FinalPoint (get).
abstract Cartesian	interpolateUsingFraction(double fraction) Provides the location of a point on the curve that is the indicated fraction of the distance between the InitialPoint (get) and FinalPoint (get).

Methods inherited from class agi.foundation.geometry.shapes.Figure

getIsConnected

Methods inherited from class java.lang.Object

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

Constructor Detail

Curve

public Curve()

Method Detail

getAngleSubtended

public abstract double getAngleSubtended()

Gets the angle subtended by the curve.

The value of the angle subtended may not represent an angular measure from a consistent vertex. For simple curves, it is an angular measure determined from a vertex in a space convenient for expressing points on the curve. For complex curves, it is the sum of the angles subtended by each of the constituent curves.

getInitialPoint

@Nonnull
public abstract Cartesian getInitialPoint()

Gets the initial point of the curve.

getFinalPoint

@Nonnull
public abstract Cartesian getFinalPoint()

Gets the final point of the curve.

interpolateUsingFraction

@Nonnull
public abstract Cartesian interpolateUsingFraction(double fraction)

Provides the location of a point on the curve that is the indicated fraction of the distance between the InitialPoint (get) and FinalPoint (get).

The value of the fraction parameter should range between 0.0 and 1.0.

Parameters:

fraction - The portion of the distance along the curve.

Returns:

The point at the indicated position along the curve.

interpolateUsingAngleSubtended

@Nonnull
public abstract Cartesian interpolateUsingAngleSubtended(double angle)

Provides the location of a point on the curve that is at the indicated angle defined between the InitialPoint (get) and FinalPoint (get).

The value of the angle parameter should range between 0.0 and AngleSubtended (get).

Parameters:

angle - The angle from the initial point.

Returns:

The point at the indicated position along the curve.

getPoints

@Nonnull
public ArrayList<PointOnCurve> getPoints(double granularity)

Provides a collection of points along the curve at the requested granularity.

Parameters:

granularity - The increment of AngleSubtended (get) used to generate the intermediate points between the initial and final points.

Returns:

The collection of points. The points will be ordered in increasing order by Fraction (get)