All Packages Class Hierarchy This Package Previous Next Index
Class java.awt.geom.CubicCurve2D
java.lang.Object
|
+----java.awt.geom.CubicCurve2D
- public abstract class CubicCurve2D
- extends Object
- implements Shape
A cubic parametric curve segment in (x, y) coordinate space.
This class is only the abstract superclass for all objects which
store a 2D cubic curve segment.
The actual storage representation of the coordinates is left to
the subclass.
CubicCurve2D.Float- A cubic parametric curve segment specified with float coordinates.
CubicCurve2D()
-
contains(double, double)
- Test if a given coordinate is inside the boundary of the shape.
contains(double, double, double, double)
- Test if the interior of the Shape entirely contains the given
set of rectangular coordinates.
contains(Point2D)
- Test if a given Point is inside the boundary of the shape.
contains(Rectangle2D)
- Test if the interior of the Shape entirely contains the given
Rectangle.
getBounds()
- Return the bounding box of the shape.
getCtrlX1()
- Returns the X coordinate of the first control point in double precision.
getCtrlX2()
- Returns the X coordinate of the second control point
in double precision.
getCtrlY1()
- Returns the Y coordinate of the first control point in double precision.
getCtrlY2()
- Returns the Y coordinate of the second control point
in double precision.
getFlatness()
- Returns the flatness, or maximum distance of a
controlpoint from the line connecting the endpoints, of this curve.
getFlatness(double, double, double, double, double, double, double, double)
- Returns the flatness, or maximum distance of a
controlpoint from the line connecting the endpoints, of the
cubic curve specified by the indicated controlpoints.
getFlatness(double[], int)
- Returns the flatness, or maximum distance of a
controlpoint from the line connecting the endpoints, of the
cubic curve specified by the controlpoints stored in the
indicated array at the indicated index.
getFlatnessSq()
- Returns the square of the flatness, or maximum distance of a
controlpoint from the line connecting the endpoints, of this curve.
getFlatnessSq(double, double, double, double, double, double, double, double)
- Returns the square of the flatness, or maximum distance of a
controlpoint from the line connecting the endpoints, of the
cubic curve specified by the indicated controlpoints.
getFlatnessSq(double[], int)
- Returns the square of the flatness, or maximum distance of a
controlpoint from the line connecting the endpoints, of the
cubic curve specified by the controlpoints stored in the
indicated array at the indicated index.
getPathIterator(AffineTransform)
- Return an iteration object that defines the boundary of the
shape.
getPathIterator(AffineTransform, double)
- Return an iteration object that defines the boundary of the
flattened shape.
getX1()
- Returns the X coordinate of the start point in double precision.
getX2()
- Returns the X coordinate of the end point in double precision.
getY1()
- Returns the Y coordinate of the start point in double precision.
getY2()
- Returns the Y coordinate of the end point in double precision.
intersects(double, double, double, double)
- Test if the Shape intersects the interior of a given
set of rectangular coordinates.
intersects(Rectangle2D)
- Test if the Shape intersects the interior of a given
Rectangle.
setCurve(CubicCurve2D)
- Sets the location of the endpoints and controlpoints of this curve
to the same as those in the specified CubicCurve.
setCurve(double, double, double, double, double, double, double, double)
- Sets the location of the endpoints and controlpoints of this curve
to the specified double coordinates.
setCurve(double[], int)
- Sets the location of the endpoints and controlpoints of this curve
to the double coordinates at the specified offset in the specified
array.
setCurve(Point2D, Point2D, Point2D, Point2D)
- Sets the location of the endpoints and controlpoints of this curve
to the specified Point coordinates.
setCurve(Point2D[], int)
- Sets the location of the endpoints and controlpoints of this curve
to the coordinates of the Point objects at the specified offset in
the specified array.
solveCubic(double[])
- Solve the cubic whose coefficients are in the eqn array and
place the non-complex roots back into the array, returning the
number of roots.
subdivide(CubicCurve2D, CubicCurve2D)
- Subdivides this cubic curve and stores the resulting two
subdivided curves into the left and right curve parameters.
subdivide(CubicCurve2D, CubicCurve2D, CubicCurve2D)
- Subdivides the cubic curve specified by the src parameter
and stores the resulting two subdivided curves into the left
and right curve parameters.
subdivide(double[], int, double[], int, double[], int)
- Subdivides the cubic curve specified by the the coordinates
stored in the src array at indices (srcoff) through (srcoff + 7)
and stores the resulting two subdivided curves into the two
result arrays at the corresponding indices.
CubicCurve2D
protected CubicCurve2D()
getX1
public abstract double getX1()
- Returns the X coordinate of the start point in double precision.
getY1
public abstract double getY1()
- Returns the Y coordinate of the start point in double precision.
getCtrlX1
public abstract double getCtrlX1()
- Returns the X coordinate of the first control point in double precision.
getCtrlY1
public abstract double getCtrlY1()
- Returns the Y coordinate of the first control point in double precision.
getCtrlX2
public abstract double getCtrlX2()
- Returns the X coordinate of the second control point
in double precision.
getCtrlY2
public abstract double getCtrlY2()
- Returns the Y coordinate of the second control point
in double precision.
getX2
public abstract double getX2()
- Returns the X coordinate of the end point in double precision.
getY2
public abstract double getY2()
- Returns the Y coordinate of the end point in double precision.
setCurve
public abstract void setCurve(double x1,
double y1,
double ctrlx1,
double ctrly1,
double ctrlx2,
double ctrly2,
double x2,
double y2)
- Sets the location of the endpoints and controlpoints of this curve
to the specified double coordinates.
setCurve
public void setCurve(double[] coords,
int offset)
- Sets the location of the endpoints and controlpoints of this curve
to the double coordinates at the specified offset in the specified
array.
setCurve
public void setCurve(Point2D p1,
Point2D cp1,
Point2D cp2,
Point2D p2)
- Sets the location of the endpoints and controlpoints of this curve
to the specified Point coordinates.
setCurve
public void setCurve(Point2D[] pts,
int offset)
- Sets the location of the endpoints and controlpoints of this curve
to the coordinates of the Point objects at the specified offset in
the specified array.
setCurve
public void setCurve(CubicCurve2D c)
- Sets the location of the endpoints and controlpoints of this curve
to the same as those in the specified CubicCurve.
getFlatnessSq
public static double getFlatnessSq(double x1,
double y1,
double ctrlx1,
double ctrly1,
double ctrlx2,
double ctrly2,
double x2,
double y2)
- Returns the square of the flatness, or maximum distance of a
controlpoint from the line connecting the endpoints, of the
cubic curve specified by the indicated controlpoints.
getFlatness
public static double getFlatness(double x1,
double y1,
double ctrlx1,
double ctrly1,
double ctrlx2,
double ctrly2,
double x2,
double y2)
- Returns the flatness, or maximum distance of a
controlpoint from the line connecting the endpoints, of the
cubic curve specified by the indicated controlpoints.
getFlatnessSq
public static double getFlatnessSq(double[] coords,
int offset)
- Returns the square of the flatness, or maximum distance of a
controlpoint from the line connecting the endpoints, of the
cubic curve specified by the controlpoints stored in the
indicated array at the indicated index.
getFlatness
public static double getFlatness(double[] coords,
int offset)
- Returns the flatness, or maximum distance of a
controlpoint from the line connecting the endpoints, of the
cubic curve specified by the controlpoints stored in the
indicated array at the indicated index.
getFlatnessSq
public double getFlatnessSq()
- Returns the square of the flatness, or maximum distance of a
controlpoint from the line connecting the endpoints, of this curve.
getFlatness
public double getFlatness()
- Returns the flatness, or maximum distance of a
controlpoint from the line connecting the endpoints, of this curve.
subdivide
public void subdivide(CubicCurve2D left,
CubicCurve2D right)
- Subdivides this cubic curve and stores the resulting two
subdivided curves into the left and right curve parameters.
Either or both of the left and right objects may be the same
as this object or null.
- Parameters:
- left - the cubic curve object for storing for the left or
first half of the subdivided curve
- right - the cubic curve object for storing for the right or
second half of the subdivided curve
subdivide
public static void subdivide(CubicCurve2D src,
CubicCurve2D left,
CubicCurve2D right)
- Subdivides the cubic curve specified by the src parameter
and stores the resulting two subdivided curves into the left
and right curve parameters.
Either or both of the left and right objects may be the same
as the src object or null.
- Parameters:
- src - the cubic curve to be subdivided
- left - the cubic curve object for storing for the left or
first half of the subdivided curve
- right - the cubic curve object for storing for the right or
second half of the subdivided curve
subdivide
public static void subdivide(double[] src,
int srcoff,
double[] left,
int leftoff,
double[] right,
int rightoff)
- Subdivides the cubic curve specified by the the coordinates
stored in the src array at indices (srcoff) through (srcoff + 7)
and stores the resulting two subdivided curves into the two
result arrays at the corresponding indices.
Either or both of the left and right arrays may be null or a
reference to the same array as the src array.
Note that the last point in the first subdivided curve is the
same as the first point in the second subdivided curve and thus
it is possible to pass the same array for left and right and
to use offsets such that rightoff equals (leftoff + 6) in order
to avoid allocating extra storage for this common point.
- Parameters:
- src - the array holding the coordinates for the source curve
- srcoff - the offset into the array of the beginning of the
the 6 source coordinates
- left - the array for storing the coordinates for the first
half of the subdivided curve
- leftoff - the offset into the array of the beginning of the
the 6 left coordinates
- right - the array for storing the coordinates for the second
half of the subdivided curve
- rightoff - the offset into the array of the beginning of the
the 6 right coordinates
solveCubic
public static int solveCubic(double[] eqn)
- Solve the cubic whose coefficients are in the eqn array and
place the non-complex roots back into the array, returning the
number of roots. The quadratic solved is represented by the
equation:
eqn = {c, b, a, d}
dx^3 + ax^2 + bx + c = 0
A return value of -1 is used to distinguish a constant equation,
which may be always 0 or never 0, from an equation which has no
zeroes.
- Returns:
- the number of roots, or -1 if the equation is a constant
contains
public boolean contains(double x,
double y)
- Test if a given coordinate is inside the boundary of the shape.
contains
public boolean contains(Point2D p)
- Test if a given Point is inside the boundary of the shape.
intersects
public boolean intersects(double x,
double y,
double w,
double h)
- Test if the Shape intersects the interior of a given
set of rectangular coordinates.
intersects
public boolean intersects(Rectangle2D r)
- Test if the Shape intersects the interior of a given
Rectangle.
contains
public boolean contains(double x,
double y,
double w,
double h)
- Test if the interior of the Shape entirely contains the given
set of rectangular coordinates.
contains
public boolean contains(Rectangle2D r)
- Test if the interior of the Shape entirely contains the given
Rectangle.
getBounds
public Rectangle getBounds()
- Return the bounding box of the shape.
getPathIterator
public PathIterator getPathIterator(AffineTransform at)
- Return an iteration object that defines the boundary of the
shape.
getPathIterator
public PathIterator getPathIterator(AffineTransform at,
double flatness)
- Return an iteration object that defines the boundary of the
flattened shape.
All Packages Class Hierarchy This Package Previous Next Index
Submit a bug or feature