OpenJDK 27 · java.awt.geom.FlatteningPathIterator · APIdia, the JavaDoc alternative

Field Summary

Modifier and Type	Field and Description
pack-priv double	curx
pack-priv double	cury
pack-priv boolean	done
pack-priv static final int	GROW_SIZE
pack-priv double[]	hold
pack-priv int	holdEnd
pack-priv int	holdIndex
pack-priv int	holdType
pack-priv int	levelIndex
pack-priv int[]	levels
pack-priv int	limit
pack-priv double	movx
pack-priv double	movy
pack-priv double	squareflat
pack-priv PathIterator	src

Constructor Summary

Access	Constructor and Description
public	FlatteningPathIterator(PathIterator the original unflattened path being iterated over src, double the maximum allowable distance between the control points and the flattened curve flatness) Constructs a new `FlatteningPathIterator` object that flattens a path as it iterates over it.
public	FlatteningPathIterator(PathIterator the original unflattened path being iterated over src, double the maximum allowable distance between the control points and the flattened curve flatness, int the maximum number of recursive subdivisions allowed for any curved segment limit) Constructs a new `FlatteningPathIterator` object that flattens a path as it iterates over it.

Method Summary

Modifier and Type	Method and Description
public int	Returns: the path segment type of the current path segment. currentSegment(float[] an array that holds the data returned from this method coords) Implements java.awt.geom.PathIterator.currentSegment. Returns the coordinates and type of the current path segment in the iteration.
public int	Returns: the path segment type of the current path segment. currentSegment(double[] an array that holds the data returned from this method coords) Implements java.awt.geom.PathIterator.currentSegment. Returns the coordinates and type of the current path segment in the iteration.
pack-priv void	ensureHoldCapacity(int want)
public double	Returns: the flatness of this `FlatteningPathIterator`. getFlatness() Returns the flatness of this iterator.
public int	Returns: the recursion limit of this `FlatteningPathIterator`. getRecursionLimit() Returns the recursion limit of this iterator.
public int	Returns: the winding rule of the original unflattened path being iterated over. getWindingRule() Implements java.awt.geom.PathIterator.getWindingRule. Returns the winding rule for determining the interior of the path.
public boolean	Returns: `true` if all the segments have been read; `false` otherwise. isDone() Implements java.awt.geom.PathIterator.isDone. Tests if the iteration is complete.
public void	next() Implements java.awt.geom.PathIterator.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.
private void	next(boolean doNext)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

curx	back to summary
pack-priv double curx

cury	back to summary
pack-priv double cury

done	back to summary
pack-priv boolean done

GROW_SIZE	back to summary
pack-priv static final int GROW_SIZE

hold	back to summary
pack-priv double[] hold

holdEnd	back to summary
pack-priv int holdEnd

holdIndex	back to summary
pack-priv int holdIndex

holdType	back to summary
pack-priv int holdType

levelIndex	back to summary
pack-priv int levelIndex

levels	back to summary
pack-priv int[] levels

limit	back to summary
pack-priv int limit

movx	back to summary
pack-priv double movx

movy	back to summary
pack-priv double movy

squareflat	back to summary
pack-priv double squareflat

src	back to summary
pack-priv PathIterator src

Constructor Detail

FlatteningPathIterator back to summary

FlatteningPathIterator	back to summary
public FlatteningPathIterator(PathIterator src, double flatness) Constructs a new `FlatteningPathIterator` 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:PathIterator the original unflattened path being iterated over flatness:double the maximum allowable distance between the control points and the flattened curve

public FlatteningPathIterator(PathIterator src, double flatness)

Constructs a new FlatteningPathIterator 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:PathIterator: the original unflattened path being iterated over
flatness:double: the maximum allowable distance between the control points and the flattened curve

FlatteningPathIterator back to summary

FlatteningPathIterator	back to summary
public FlatteningPathIterator(PathIterator src, double flatness, int limit) Constructs a new `FlatteningPathIterator` object that flattens a path as it iterates over it. The `limit` 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 the `flatness` parameter. The flattened iteration therefore never generates more than a maximum of `(2^limit)` line segments per curve. Parameters src:PathIterator the original unflattened path being iterated over flatness:double the maximum allowable distance between the control points and the flattened curve limit:int the maximum number of recursive subdivisions allowed for any curved segment Exceptions IllegalArgumentException: if `flatness` or `limit` is less than zero

public FlatteningPathIterator(PathIterator src, double flatness, int limit)

Constructs a new FlatteningPathIterator object that flattens a path as it iterates over it. The limit 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 the flatness parameter. The flattened iteration therefore never generates more than a maximum of (2^limit) line segments per curve.

Parameters

src:PathIterator: the original unflattened path being iterated over
flatness:double: the maximum allowable distance between the control points and the flattened curve
limit:int: the maximum number of recursive subdivisions allowed for any curved segment

Exceptions

IllegalArgumentException:: if flatness or limit is less than zero

Method Detail

currentSegment back to summary

currentSegment	back to summary
public int currentSegment(float[] coords) Implements java.awt.geom.PathIterator.currentSegment. 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. Parameters coords:float[] an array that holds the data returned from this method Returns:int the path segment type of the current path segment. Exceptions NoSuchElementException: if there are no more elements in the flattening path to be returned. See Also `PathIterator#SEG_MOVETO`, `PathIterator#SEG_LINETO`, `PathIterator#SEG_CLOSE`

public int currentSegment(float[] coords)

Implements java.awt.geom.PathIterator.currentSegment.

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.

Parameters

coords:float[]: an array that holds the data returned from this method

Returns:int

the path segment type of the current path segment.

Exceptions

NoSuchElementException:: if there are no more elements in the flattening path to be returned.

currentSegment back to summary

currentSegment	back to summary
public int currentSegment(double[] coords) Implements java.awt.geom.PathIterator.currentSegment. 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. Parameters coords:double[] an array that holds the data returned from this method Returns:int the path segment type of the current path segment. Exceptions NoSuchElementException: if there are no more elements in the flattening path to be returned. See Also `PathIterator#SEG_MOVETO`, `PathIterator#SEG_LINETO`, `PathIterator#SEG_CLOSE`

public int currentSegment(double[] coords)

Implements java.awt.geom.PathIterator.currentSegment.

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.

Parameters

coords:double[]: an array that holds the data returned from this method

Returns:int

the path segment type of the current path segment.

Exceptions

NoSuchElementException:: if there are no more elements in the flattening path to be returned.

ensureHoldCapacity	back to summary
pack-priv void ensureHoldCapacity(int want)

getFlatness back to summary

getFlatness	back to summary
public double getFlatness() Returns the flatness of this iterator. Returns:double the flatness of this `FlatteningPathIterator`.

public double getFlatness()

Returns the flatness of this iterator.

Returns:double: the flatness of this FlatteningPathIterator.

getRecursionLimit back to summary

getRecursionLimit	back to summary
public int getRecursionLimit() Returns the recursion limit of this iterator. Returns:int the recursion limit of this `FlatteningPathIterator`.

public int getRecursionLimit()

Returns the recursion limit of this iterator.

Returns:int: the recursion limit of this FlatteningPathIterator.

getWindingRule back to summary

getWindingRule	back to summary
public int getWindingRule() Implements java.awt.geom.PathIterator.getWindingRule. Returns the winding rule for determining the interior of the path. Returns:int the winding rule of the original unflattened path being iterated over. See Also `PathIterator#WIND_EVEN_ODD`, `PathIterator#WIND_NON_ZERO`

public int getWindingRule()

Implements java.awt.geom.PathIterator.getWindingRule.

Returns the winding rule for determining the interior of the path.

Returns:int: the winding rule of the original unflattened path being iterated over.
See Also: PathIterator#WIND_EVEN_ODD, PathIterator#WIND_NON_ZERO

isDone back to summary

isDone	back to summary
public boolean isDone() Implements java.awt.geom.PathIterator.isDone. Tests if the iteration is complete. Returns:boolean `true` if all the segments have been read; `false` otherwise.

public boolean isDone()

Implements java.awt.geom.PathIterator.isDone.

Tests if the iteration is complete.

Returns:boolean: true if all the segments have been read; false otherwise.

next	back to summary
public void next() Implements java.awt.geom.PathIterator.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.

back to summary

public void next()

Implements java.awt.geom.PathIterator.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.

next	back to summary
private void next(boolean doNext)

public Class FlatteningPathIterator

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail