- 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
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-java/awt/geom/FlatteningPathIterator.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.