Package com.luciad.geometries

Class BezierCurve

java.lang.Object

com.luciad.geometries.Geometry

com.luciad.geometries.Curve

com.luciad.geometries.BezierCurve

All Implemented Interfaces:

AutoCloseable

public final class BezierCurve
extends Curve
implements AutoCloseable

Represents a quadratic or cubic BezierCurve.

A Bézier curve is defined by 3 or 4 control points:

• the start point
• one control point for a quadratic curve, or two control points for a cubic curve
• the end point

See Also:

• GeometryFactory#createQuadraticBezierCurve
• GeometryFactory#createCubicBezierCurve

Method Summary

Modifier and Type	Method	Description
void	close()
protected void	finalize()
Coordinate	getControlPoint(long index)	Retrieves the control point at the given index.
long	getControlPointCount()	Returns the amount of control points defining the Bézier curve.
Coordinate	getEndPoint()	Returns the end point (third control point) of the quadratic Bézier curve.
Coordinate	getStartPoint()	Returns the start point (first control point) of the quadratic Bézier curve.
BezierCurve	moveControlPoint(Coordinate newLocation, long index)	Moves the control point at the given index to a new location.
BezierCurve	moveEndPoint(Coordinate newLocation)	Returns a copy of the Bézier curve with a moved end point.
BezierCurve	moveStartPoint(Coordinate newLocation)	Returns a copy of the Bézier curve with a moved start point.

Methods inherited from class com.luciad.geometries.Curve

computePoint, getLength2D

Methods inherited from class com.luciad.geometries.Geometry

getBounds, getReference

Methods inherited from class java.lang.Object

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

Method Details

finalize

protected void finalize()

Overrides:

finalize in class Curve

close

public void close()

Specified by:

close in interface AutoCloseable

Overrides:

close in class Curve

getControlPointCount

public long getControlPointCount()

Returns the amount of control points defining the Bézier curve.

• For a quadratic curve, it returns 3.
• For a cubic curve, it returns 4.

Returns:

the amount of control points defining the Bézier curve.

Since:

2024.1

getStartPoint

@NotNull
public Coordinate getStartPoint()

Returns the start point (first control point) of the quadratic Bézier curve.

Returns:

the start point (first control point) of the quadratic Bézier curve.

getEndPoint

@NotNull
public Coordinate getEndPoint()

Returns the end point (third control point) of the quadratic Bézier curve.

Returns:

the end point (third control point) of the quadratic Bézier curve.

getControlPoint

@NotNull
public Coordinate getControlPoint(long index)
                           throws IllegalArgumentException

Retrieves the control point at the given index.

The available indices depends on the degree of the Bézier curve.

• Quadratic Bézier curve (degree 2 => 3 control points):
  • 0 => start control point
  • 1 => intermediate control point
  • 2 => end control point
• Cubic Bézier curve (degree 3 => 4 control points):
  • 0 => start control point
  • 1 or 2 => intermediate control points
  • 3 => end control point

Using indices out of this range will result in an exception.

Bézier curves with a higher degree are currently not supported.

Parameters:

index - the index of the control point

Returns:

a copy of the Bézier curve with a moved control point.

Throws:

IllegalArgumentException - when the index of the control point is out of range (i.e. larger than 2 or 3, depending on the degree of the Bézier curve)

Since:

2024.1

moveStartPoint

@NotNull
public BezierCurve moveStartPoint(@NotNull
 Coordinate newLocation)

Returns a copy of the Bézier curve with a moved start point.

Parameters:

newLocation - the new location of the point.

Returns:

a copy of the Bézier curve with a moved start point.

moveEndPoint

@NotNull
public BezierCurve moveEndPoint(@NotNull
 Coordinate newLocation)

Returns a copy of the Bézier curve with a moved end point.

Parameters:

newLocation - the new location of the point.

Returns:

a copy of the Bézier curve with a moved end point.

moveControlPoint

@NotNull
public BezierCurve moveControlPoint(@NotNull
 Coordinate newLocation,
 long index)
                             throws IllegalArgumentException

Moves the control point at the given index to a new location.

The available indices depends on the degree of the Bézier curve.

• Quadratic Bézier curve (degree 2 => 3 control points):
  • 0 => start control point
  • 1 => intermediate control point
  • 2 => end control point
• Cubic Bézier curve (degree 3 => 4 control points):
  • 0 => start control point
  • 1 or 2 => intermediate control points
  • 3 => end control point

Using indices out of this range will result in an exception.

Bézier curves with a higher degree are currently not supported.

Parameters:

newLocation - the new location of the control point.

index - the index of the control point

Returns:

a copy of the Bézier curve with a moved control point.

Throws:

IllegalArgumentException - when the index of the control point is out of range (i.e. larger than 2 or 3, depending on the degree of the Bézier curve)

Since:

2024.1