de.javagl.geom

Class CatmullRomSpline

java.lang.Object

de.javagl.geom.CatmullRomSpline

public class CatmullRomSpline
extends Object

Simple implementation of an open Catmull-Rom-Spline

Method Summary

Modifier and Type	Method and Description
static CatmullRomSpline	create(List<? extends Point2D> points, int stepsPerSegment, double alpha) Creates a new Catmull-Rom-Spline with the given control points.
static CatmullRomSpline	create(List<? extends Point2D> points, int stepsPerSegment, double alpha, boolean closed) Creates a new Catmull-Rom-Spline with the given control points.
List<Point2D>	getInterpolatedPoints() Returns an unmodifiable list containing the interpolated points.
void	setInterpolation(double alpha) Set the alpha value determining the interpolation: For 0.0, the spline is uniform.
void	updateControlPoints(List<? extends Point2D> points) Set the positions of the the control points so that they match the given points.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static CatmullRomSpline create(List<? extends Point2D> points,
                                      int stepsPerSegment,
                                      double alpha)

Creates a new Catmull-Rom-Spline with the given control points.

Parameters:

points - The control points. A deep copy of the given list will be created internally. Thus, changes in the given list or its points will not be reflected in this spline.

stepsPerSegment - The number of interpolation steps per segment

alpha - The interpolation value. For 0.0, the spline is uniform. For 0.5, the spline is centripetal. For 1.0, the spline is chordal.

Returns:

The spline

create

public static CatmullRomSpline create(List<? extends Point2D> points,
                                      int stepsPerSegment,
                                      double alpha,
                                      boolean closed)

Creates a new Catmull-Rom-Spline with the given control points.

Parameters:

points - The control points. A deep copy of the given list will be created internally. Thus, changes in the given list or its points will not be reflected in this spline.

stepsPerSegment - The number of interpolation steps per segment

alpha - The interpolation value. For 0.0, the spline is uniform. For 0.5, the spline is centripetal. For 1.0, the spline is chordal.

closed - Whether the spline should be closed

Returns:

The spline

setInterpolation

public void setInterpolation(double alpha)

Set the alpha value determining the interpolation: For 0.0, the spline is uniform. For 0.5, the spline is centripetal. For 1.0, the spline is chordal.

Parameters:

alpha - The alpha value

updateControlPoints

public void updateControlPoints(List<? extends Point2D> points)

Set the positions of the the control points so that they match the given points. The number of points in the given list must be the same as the the number of points that was used to construct this spline.

Parameters:

points - The control points

Throws:

IllegalArgumentException - If the number of points in the given list does not match the number of points that was given in the constructor

getInterpolatedPoints

public List<Point2D> getInterpolatedPoints()

Returns an unmodifiable list containing the interpolated points. Note that although the list itself is unmodifiable, the contained points are still modifiable. Changes in these points will be overwritten by this class, although the exact conditions under which they will be overwritten are not specified.

Returns:

The interpolated points