FlatteningPathIterator JDK 1.6)

Description

public class FlatteningPathIterator

The FlatteningPathIterator class returns a flattened view of another PathIterator object.

The FlatteningPathIterator class returns a flattened view of
another PathIterator object. Other Shape
classes can use this class to provide flattening behavior for their paths
without having to perform the interpolation calculations themselves.

See also:

Constructors

public FlatteningPathIterator (PathIterator src, double flatness)

Constructs a new FlatteningPathIterator object that flattens a path as it iterates over it.

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 - the original unflattened path being iterated over
- flatness - the maximum allowable distance between the control points and the flattened curve

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

Constructs a new FlatteningPathIterator object that flattens a path as it iterates over it.

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 - the original unflattened path being iterated over
- flatness - the maximum allowable distance between the control points and the flattened curve
- limit - the maximum number of recursive subdivisions allowed for any curved segment
Throws:
- IllegalArgumentException - if flatness or limit is less than zero

Methods

Hide/Show inherited methods

public int currentSegment (double[] coords) [Specified in PathIterator]

Returns the coordinates and type of the current path segment in the iteration.

public int currentSegment (float[] coords) [Specified in PathIterator]

Returns the coordinates and type of the current path segment in the iteration.

pack-private void ensureHoldCapacity (int want)

public double getFlatness ()

Returns the flatness of this iterator.

Returns the flatness of this iterator.
Returns: the flatness of this FlatteningPathIterator.

public int getRecursionLimit ()

Returns the recursion limit of this iterator.

Returns the recursion limit of this iterator.
Returns: the recursion limit of this FlatteningPathIterator.

public int getWindingRule () [Specified in PathIterator]

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

public boolean isDone () [Specified in PathIterator]

Tests if the iteration is complete.

Tests if the iteration is complete.
Returns: true if all the segments have been read; false otherwise.

public void next () [Specified in PathIterator]

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.

Fields

Hide/Show inherited fields

pack-private double curx

pack-private double cury

pack-private boolean done

pack-privatefinalstatic int GROW_SIZE = "24"

pack-private double hold

pack-private int holdEnd

pack-private int holdIndex

pack-private int holdType

pack-private int levelIndex

pack-private int levels

pack-private int limit

pack-private double movx

pack-private double movy

publicfinalstatic int SEG_CLOSE = "4" [Inherited From PathIterator]

The segment type constant that specifies that the preceding subpath should be closed by appending a line segment back to the point corresponding to the most recent SEG_MOVETO.

publicfinalstatic int SEG_CUBICTO = "3" [Inherited From PathIterator]

The segment type constant for the set of 3 points that specify a cubic parametric curve to be drawn from the most recently specified point.

The segment type constant for the set of 3 points that specify
a cubic parametric curve to be drawn from the most recently
specified point.
The curve is interpolated by solving the parametric control
equation in the range (t=[0..1]) using
the most recently specified (current) point (CP),
the first control point (P1),
the second control point (P2),
and the final interpolated control point (P3).
The parametric control equation for this curve is:


          P(t) = B(3,0)*CP + B(3,1)*P1 + B(3,2)*P2 + B(3,3)*P3
          0 <= t <= 1

        B(n,m) = mth coefficient of nth degree Bernstein polynomial
               = C(n,m) * t^(m) * (1 - t)^(n-m)
        C(n,m) = Combinations of n things, taken m at a time
               = n! / (m! * (n-m)!)

This form of curve is commonly known as a Bézier curve.

publicfinalstatic int SEG_LINETO = "1" [Inherited From PathIterator]

The segment type constant for a point that specifies the end point of a line to be drawn from the most recently specified point.

publicfinalstatic int SEG_MOVETO = "0" [Inherited From PathIterator]

The segment type constant for a point that specifies the starting location for a new subpath.

publicfinalstatic int SEG_QUADTO = "2" [Inherited From PathIterator]

The segment type constant for the pair of points that specify a quadratic parametric curve to be drawn from the most recently specified point.

The segment type constant for the pair of points that specify
a quadratic parametric curve to be drawn from the most recently
specified point.
The curve is interpolated by solving the parametric control
equation in the range (t=[0..1]) using
the most recently specified (current) point (CP),
the first control point (P1),
and the final interpolated control point (P2).
The parametric control equation for this curve is:


          P(t) = B(2,0)*CP + B(2,1)*P1 + B(2,2)*P2
          0 <= t <= 1

        B(n,m) = mth coefficient of nth degree Bernstein polynomial
               = C(n,m) * t^(m) * (1 - t)^(n-m)
        C(n,m) = Combinations of n things, taken m at a time
               = n! / (m! * (n-m)!)

pack-private double squareflat

pack-private PathIterator src

publicfinalstatic int WIND_EVEN_ODD = "0" [Inherited From PathIterator]

The winding rule constant for specifying an even-odd rule for determining the interior of a path.

publicfinalstatic int WIND_NON_ZERO = "1" [Inherited From PathIterator]

The winding rule constant for specifying a non-zero rule for determining the interior of a path.