public static class Path2D.Double extends Path2D implements Serializable
Double class defines a geometric path with
coordinates stored in double precision floating point.Path2D.Double, Path2D.FloatWIND_EVEN_ODD, WIND_NON_ZERO| Constructor and Description |
|---|
Path2D.Double()
Constructs a new empty double precision
Path2D object
with a default winding rule of Path2D.WIND_NON_ZERO. |
Path2D.Double(int rule)
Constructs a new empty double precision
Path2D object
with the specified winding rule to control operations that
require the interior of the path to be defined. |
Path2D.Double(int rule,
int initialCapacity)
Constructs a new empty double precision
Path2D object
with the specified winding rule and the specified initial
capacity to store path segments. |
Path2D.Double(Shape s)
Constructs a new double precision
Path2D object
from an arbitrary Shape object. |
Path2D.Double(Shape s,
AffineTransform at)
Constructs a new double precision
Path2D object
from an arbitrary Shape object, transformed by an
AffineTransform object. |
| Modifier and Type | Method and Description |
|---|---|
void |
append(PathIterator pi,
boolean connect)
Appends the geometry of the specified
PathIterator object
to the path, possibly connecting the new geometry to the existing
path segments with a line segment. |
Object |
clone()
Creates a new object of the same class as this object.
|
void |
curveTo(double x1,
double y1,
double x2,
double y2,
double x3,
double y3)
Adds a curved segment, defined by three new points, to the path by
drawing a Bézier curve that intersects both the current
coordinates and the specified coordinates
(x3,y3),
using the specified points (x1,y1) and (x2,y2) as
Bézier control points. |
Rectangle2D |
getBounds2D()
Returns a high precision and more accurate bounding box of
the
Shape than the getBounds method. |
PathIterator |
getPathIterator(AffineTransform at)
Returns an iterator object that iterates along the
Shape boundary and provides access to the geometry of the
Shape outline. |
void |
lineTo(double x,
double y)
Adds a point to the path by drawing a straight line from the
current coordinates to the new specified coordinates
specified in double precision.
|
void |
moveTo(double x,
double y)
Adds a point to the path by moving to the specified
coordinates specified in double precision.
|
void |
quadTo(double x1,
double y1,
double x2,
double y2)
Adds a curved segment, defined by two new points, to the path by
drawing a Quadratic curve that intersects both the current
coordinates and the specified coordinates
(x2,y2),
using the specified point (x1,y1) as a quadratic
parametric control point. |
void |
transform(AffineTransform at)
Transforms the geometry of this path using the specified
AffineTransform. |
append, closePath, contains, contains, contains, contains, contains, contains, contains, contains, createTransformedShape, getBounds, getCurrentPoint, getPathIterator, getWindingRule, intersects, intersects, intersects, intersects, reset, setWindingRulepublic Path2D.Double()
Path2D object
with a default winding rule of Path2D.WIND_NON_ZERO.public Path2D.Double(int rule)
Path2D object
with the specified winding rule to control operations that
require the interior of the path to be defined.rule - the winding rulePath2D.WIND_EVEN_ODD,
Path2D.WIND_NON_ZEROpublic Path2D.Double(int rule,
int initialCapacity)
Path2D object
with the specified winding rule and the specified initial
capacity to store path segments.
This number is an initial guess as to how many path segments
are in the path, but the storage is expanded as needed to store
whatever path segments are added to this path.rule - the winding ruleinitialCapacity - the estimate for the number of path segments
in the pathPath2D.WIND_EVEN_ODD,
Path2D.WIND_NON_ZEROpublic Path2D.Double(Shape s)
Path2D object
from an arbitrary Shape object.
All of the initial geometry and the winding rule for this path are
taken from the specified Shape object.s - the specified Shape objectpublic Path2D.Double(Shape s, AffineTransform at)
Path2D object
from an arbitrary Shape object, transformed by an
AffineTransform object.
All of the initial geometry and the winding rule for this path are
taken from the specified Shape object and transformed
by the specified AffineTransform object.s - the specified Shape objectat - the specified AffineTransform objectpublic final void moveTo(double x,
double y)
public final void lineTo(double x,
double y)
public final void quadTo(double x1,
double y1,
double x2,
double y2)
(x2,y2),
using the specified point (x1,y1) as a quadratic
parametric control point.
All coordinates are specified in double precision.public final void curveTo(double x1,
double y1,
double x2,
double y2,
double x3,
double y3)
(x3,y3),
using the specified points (x1,y1) and (x2,y2) as
Bézier control points.
All coordinates are specified in double precision.curveTo in class Path2Dx1 - the X coordinate of the first Bézier control pointy1 - the Y coordinate of the first Bézier control pointx2 - the X coordinate of the second Bézier control pointy2 - the Y coordinate of the second Bézier control pointx3 - the X coordinate of the final end pointy3 - the Y coordinate of the final end pointpublic final void append(PathIterator pi, boolean connect)
PathIterator object
to the path, possibly connecting the new geometry to the existing
path segments with a line segment.
If the connect parameter is true and the
path is not empty then any initial moveTo in the
geometry of the appended Shape is turned into a
lineTo segment.
If the destination coordinates of such a connecting lineTo
segment match the ending coordinates of a currently open
subpath then the segment is omitted as superfluous.
The winding rule of the specified Shape is ignored
and the appended geometry is governed by the winding
rule specified for this path.public final void transform(AffineTransform at)
AffineTransform.
The geometry is transformed in place, which permanently changes the
boundary defined by this object.public final Rectangle2D getBounds2D()
Shape than the getBounds method.
Note that there is no guarantee that the returned
Rectangle2D is the smallest bounding box that encloses
the Shape, only that the Shape lies
entirely within the indicated Rectangle2D. The
bounding box returned by this method is usually tighter than that
returned by the getBounds method and never fails due
to overflow problems since the return value can be an instance of
the Rectangle2D that uses double precision values to
store the dimensions.
Note that the
definition of insideness can lead to situations where points
on the defining outline of the shape may not be considered
contained in the returned bounds object, but only in cases
where those points are also not considered contained in the original
shape.
If a point is inside the shape according to the
contains(point) method, then it must
be inside the returned Rectangle2D bounds object according
to the contains(point) method of the
bounds. Specifically:
shape.contains(p) requires bounds.contains(p)
If a point is not inside the shape, then it might
still be contained in the bounds object:
bounds.contains(p) does not imply shape.contains(p)
getBounds2D in interface ShapeRectangle2D that is a
high-precision bounding box of the Shape.Shape.getBounds()public PathIterator getPathIterator(AffineTransform at)
Shape boundary and provides access to the geometry of the
Shape outline. If an optional AffineTransform
is specified, the coordinates returned in the iteration are
transformed accordingly.
Each call to this method returns a fresh PathIterator
object that traverses the geometry of the Shape object
independently from any other PathIterator objects in use
at the same time.
It is recommended, but not guaranteed, that objects
implementing the Shape interface isolate iterations
that are in process from any changes that might occur to the original
object's geometry during such iterations.
The iterator for this class is not multi-threaded safe,
which means that the Path2D class does not
guarantee that modifications to the geometry of this
Path2D object do not affect any iterations of
that geometry that are already in process.
getPathIterator in interface Shapeat - an AffineTransformPathIterator that iterates along the boundary
of this Shape and provides access to the geometry
of this Shape's outlinepublic final Object clone()
clone in class Path2DOutOfMemoryError - if there is not enough memory.Cloneable Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b138