Module org.arakhne.afc.core.mathgeom

Package org.arakhne.afc.math.geometry.d3.afp

Class Sphere3afp.AbstractSpherePathIterator<T extends PathElement3afp>

java.lang.Object

org.arakhne.afc.math.geometry.d3.afp.Sphere3afp.AbstractSpherePathIterator<T>

Type Parameters:

T - the type of the path elements.

All Implemented Interfaces:

Cloneable, Iterator<T>, PathIterator3afp<T>, PathIterator3D<T>

Direct Known Subclasses:

Sphere3afp.SpherePathIterator, Sphere3afp.TransformedCirclePathIterator

Enclosing interface:

Sphere3afp<ST extends Shape3afp<?,?,IE,P,V,B>,IT extends Sphere3afp<?,?,IE,P,V,B>,IE extends PathElement3afp,P extends Point3D<? super P,? super V>,V extends Vector3D<? super V,? super P>,B extends RectangularPrism3afp<?,?,IE,P,V,B>>

public abstract static class Sphere3afp.AbstractSpherePathIterator<T extends PathElement3afp>
extends Object
implements PathIterator3afp<T>

Abstract iterator on the path elements of the sphere.

Discretization of the sphere with Bezier

For n segments on the sphere, the optimal distance to the control points, in the sense that the middle of the curve lies on the sphere itself, is (4/3)*tan(pi/(2n)).

In the case of a discretization with 4 bezier curves, the distance is is (4/3)*tan(pi/8) = 4*(sqrt(2)-1)/3 = 0.552284749831.

Version:

17.0 2020-01-04 14:41:43

Author:

Stéphane GALLAND

Maven Group Id:

org.arakhne.afc.core

Maven Artifact Id:

mathgeom

Field Summary

Fields

Modifier and Type	Field	Description
static double[][]	BEZIER_CONTROL_POINTS	Contains the control points for a set of 4 cubic bezier curves that approximate a sphere of radius 1 centered at (0,0,0).
static double	CTRL_POINT_DISTANCE	Distance from a Bezier curve control point on the sphere to the other control point.
protected static int	NUMBER_ELEMENTS	4 segments + close.
protected Sphere3afp<?,?,T,?,?,?>	sphere	The iterated shape.

Constructor Summary

Constructors

Constructor	Description
AbstractSpherePathIterator(Sphere3afp<?,?,T,?,?,?> sphere)	Constructor.

Method Summary

Modifier and Type	Method	Description
GeomFactory3afp<T,?,?,?>	getGeomFactory()	Replies the factory of geometrical elements.
PathWindingRule	getWindingRule()	Replies the winding rule for the path.
boolean	isCurved()	Replies the path contains a curve.
boolean	isMultiParts()	Replies the path has multiple parts, i.e. multiple MOVE_TO are inside.
boolean	isPolygon()	Replies the path is composed only by one MOVE_TO, a sequence of LINE_TO or QUAD_TO or CURVE_TO, and a single CLOSE primitives.
boolean	isPolyline()	Replies the path is composed only by one MOVE_TO, and a sequence of LINE_TO primitives.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Iterator

forEachRemaining, hasNext, next, remove

Methods inherited from interface org.arakhne.afc.math.geometry.d3.afp.PathIterator3afp

restartIterations

Field Detail

CTRL_POINT_DISTANCE

public static final double CTRL_POINT_DISTANCE

Distance from a Bezier curve control point on the sphere to the other control point.

4/3 tan (PI/(2*n)), where n is the number on points on the sphere.

See Also:

Constant Field Values

BEZIER_CONTROL_POINTS

public static final double[][] BEZIER_CONTROL_POINTS

Contains the control points for a set of 4 cubic bezier curves that approximate a sphere of radius 1 centered at (0,0,0).

NUMBER_ELEMENTS

protected static final int NUMBER_ELEMENTS

4 segments + close.

See Also:

Constant Field Values

sphere

protected final Sphere3afp<?,?,T extends PathElement3afp,?,?,?> sphere

The iterated shape.

Constructor Detail

AbstractSpherePathIterator

public AbstractSpherePathIterator(Sphere3afp<?,?,T,?,?,?> sphere)

Constructor.

Parameters:

sphere - the sphere.

Method Detail

getGeomFactory

public GeomFactory3afp<T,?,?,?> getGeomFactory()

Description copied from interface: PathIterator3afp

Replies the factory of geometrical elements.

Specified by:

getGeomFactory in interface PathIterator3afp<T extends PathElement3afp>

Returns:

the factory.

getWindingRule

@Pure
public PathWindingRule getWindingRule()

Description copied from interface: PathIterator3D

Replies the winding rule for the path.

Specified by:

getWindingRule in interface PathIterator3D<T extends PathElement3afp>

Returns:

the winding rule for the path.

isPolyline

@Pure
public boolean isPolyline()

Description copied from interface: PathIterator3D

Replies the path is composed only by one MOVE_TO, and a sequence of LINE_TO primitives.

Specified by:

isPolyline in interface PathIterator3D<T extends PathElement3afp>

Returns:

true if the path does not contain curve primitives, false otherwise.

isCurved

public boolean isCurved()

Description copied from interface: PathIterator3D

Replies the path contains a curve.

Specified by:

isCurved in interface PathIterator3D<T extends PathElement3afp>

Returns:

true if the path contains curve primitives, false otherwise.

isPolygon

public boolean isPolygon()

Description copied from interface: PathIterator3D

Replies the path is composed only by one MOVE_TO, a sequence of LINE_TO or QUAD_TO or CURVE_TO, and a single CLOSE primitives.

Specified by:

isPolygon in interface PathIterator3D<T extends PathElement3afp>

Returns:

true if the path does not contain curve primitives, false otherwise.

isMultiParts

@Pure
public boolean isMultiParts()

Description copied from interface: PathIterator3D

Replies the path has multiple parts, i.e. multiple MOVE_TO are inside. primitives.

Specified by:

isMultiParts in interface PathIterator3D<T extends PathElement3afp>

Returns:

true if the path has multiple move-to primitive, false otherwise.