- java.lang.Object
-
- java.awt.geom.FlatteningPathIterator
-
- All Implemented Interfaces:
- PathIterator
public class FlatteningPathIterator extends Object implements PathIterator
TheFlatteningPathIterator
class returns a flattened view of anotherPathIterator
object. OtherShape
classes can use this class to provide flattening behavior for their paths without having to perform the interpolation calculations themselves.
-
-
Field Summary
-
Fields inherited from interface java.awt.geom.PathIterator
SEG_CLOSE, SEG_CUBICTO, SEG_LINETO, SEG_MOVETO, SEG_QUADTO, WIND_EVEN_ODD, WIND_NON_ZERO
-
-
Constructor Summary
Constructors Constructor and Description FlatteningPathIterator(PathIterator src, double flatness)
Constructs a newFlatteningPathIterator
object that flattens a path as it iterates over it.FlatteningPathIterator(PathIterator src, double flatness, int limit)
Constructs a newFlatteningPathIterator
object that flattens a path as it iterates over it.
-
Method Summary
Methods Modifier and Type Method and Description int
currentSegment(double[] coords)
Returns the coordinates and type of the current path segment in the iteration.int
currentSegment(float[] coords)
Returns the coordinates and type of the current path segment in the iteration.double
getFlatness()
Returns the flatness of this iterator.int
getRecursionLimit()
Returns the recursion limit of this iterator.int
getWindingRule()
Returns the winding rule for determining the interior of the path.boolean
isDone()
Tests if the iteration is complete.void
next()
Moves the iterator to the next segment of the path forwards along the primary direction of traversal as long as there are more points in that direction.
-
-
-
Constructor Detail
-
FlatteningPathIterator
public FlatteningPathIterator(PathIterator src, double flatness)
Constructs a newFlatteningPathIterator
object that flattens a path as it iterates over it. The iterator does not subdivide any curve read from the source iterator to more than 10 levels of subdivision which yields a maximum of 1024 line segments per curve.- Parameters:
src
- the original unflattened path being iterated overflatness
- the maximum allowable distance between the control points and the flattened curve
-
FlatteningPathIterator
public FlatteningPathIterator(PathIterator src, double flatness, int limit)
Constructs a newFlatteningPathIterator
object that flattens a path as it iterates over it. Thelimit
parameter allows you to control the maximum number of recursive subdivisions that the iterator can make before it assumes that the curve is flat enough without measuring against theflatness
parameter. The flattened iteration therefore never generates more than a maximum of(2^limit)
line segments per curve.- Parameters:
src
- the original unflattened path being iterated overflatness
- the maximum allowable distance between the control points and the flattened curvelimit
- the maximum number of recursive subdivisions allowed for any curved segment- Throws:
- ifIllegalArgumentException
flatness
orlimit
is less than zero
-
-
Method Detail
-
getFlatness
public double getFlatness()
Returns the flatness of this iterator.- Returns:
- the flatness of this
FlatteningPathIterator
.
-
getRecursionLimit
public int getRecursionLimit()
Returns the recursion limit of this iterator.- Returns:
- the recursion limit of this
FlatteningPathIterator
.
-
getWindingRule
public int getWindingRule()
Returns the winding rule for determining the interior of the path.- Specified by:
getWindingRule
in interfacePathIterator
- Returns:
- the winding rule of the original unflattened path being iterated over.
- See Also:
PathIterator.WIND_EVEN_ODD
,PathIterator.WIND_NON_ZERO
-
isDone
public boolean isDone()
Tests if the iteration is complete.- Specified by:
isDone
in interfacePathIterator
- Returns:
true
if all the segments have been read;false
otherwise.
-
next
public void next()
Moves the iterator to the next segment of the path forwards along the primary direction of traversal as long as there are more points in that direction.- Specified by:
next
in interfacePathIterator
-
currentSegment
public int currentSegment(float[] coords)
Returns the coordinates and type of the current path segment in the iteration. The return value is the path segment type: SEG_MOVETO, SEG_LINETO, or SEG_CLOSE. A float array of length 6 must be passed in and can be used to store the coordinates of the point(s). Each point is stored as a pair of float x,y coordinates. SEG_MOVETO and SEG_LINETO types return one point, and SEG_CLOSE does not return any points.- Specified by:
currentSegment
in interfacePathIterator
- Parameters:
coords
- an array that holds the data returned from this method- Returns:
- the path segment type of the current path segment.
- Throws:
- if there are no more elements in the flattening path to be returned.NoSuchElementException
- See Also:
PathIterator.SEG_MOVETO
,PathIterator.SEG_LINETO
,PathIterator.SEG_CLOSE
-
currentSegment
public int currentSegment(double[] coords)
Returns the coordinates and type of the current path segment in the iteration. The return value is the path segment type: SEG_MOVETO, SEG_LINETO, or SEG_CLOSE. A double array of length 6 must be passed in and can be used to store the coordinates of the point(s). Each point is stored as a pair of double x,y coordinates. SEG_MOVETO and SEG_LINETO types return one point, and SEG_CLOSE does not return any points.- Specified by:
currentSegment
in interfacePathIterator
- Parameters:
coords
- an array that holds the data returned from this method- Returns:
- the path segment type of the current path segment.
- Throws:
- if there are no more elements in the flattening path to be returned.NoSuchElementException
- See Also:
PathIterator.SEG_MOVETO
,PathIterator.SEG_LINETO
,PathIterator.SEG_CLOSE
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
21/11/2024 21:58:02 Cette version de la page est en cache (à la date du 21/11/2024 21:58:02) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 30/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-java/awt/geom/flatteningpathiterator.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.