Class Path2D.Double
- All Implemented Interfaces:
-
Shape
,Serializable
,Cloneable
- Enclosing class:
- Path2D
public static class Path2D.Double extends Path2D implements Serializable
Double
class defines a geometric path with coordinates stored in double precision floating point.- Since:
- 1.6
- See Also:
Nested Class Summary
Nested classes/interfaces declared in class java.awt.geom.Path2D
Path2D.Double, Path2D.Float
Field Summary
Fields declared in class java.awt.geom.Path2D
WIND_EVEN_ODD, WIND_NON_ZERO
Constructor Summary
Constructor | Description |
---|---|
Double() |
Constructs a new empty double precision Path2D object with a default winding rule of Path2D.WIND_NON_ZERO . |
Double |
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. |
Double |
Constructs a new empty double precision Path2D object with the specified winding rule and the specified initial capacity to store path segments. |
Double |
Constructs a new double precision Path2D object from an arbitrary Shape object. |
Double |
Constructs a new double precision Path2D object from an arbitrary Shape object, transformed by an AffineTransform object. |
Method Summary
Modifier and Type | Method | Description |
---|---|---|
final void |
append |
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. |
final Object |
clone() |
Creates a new object of the same class as this object. |
final void |
curveTo |
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. |
final Rectangle2D |
getBounds2D() |
Returns a high precision and more accurate bounding box of the Shape than the getBounds method. |
final PathIterator |
getPathIterator |
Returns an iterator object that iterates along the Shape boundary and provides access to the geometry of the Shape outline. |
final void |
lineTo |
Adds a point to the path by drawing a straight line from the current coordinates to the new specified coordinates specified in double precision. |
final void |
moveTo |
Adds a point to the path by moving to the specified coordinates specified in double precision. |
final void |
quadTo |
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. |
final void |
transform |
Transforms the geometry of this path using the specified AffineTransform . |
final void |
trimToSize() |
Trims the capacity of this Path2D instance to its current size. |
Methods declared in class java.awt.geom.Path2D
append, closePath, contains, contains, contains, contains, contains, contains, contains, contains, createTransformedShape, getBounds, getCurrentPoint, getPathIterator, getWindingRule, intersects, intersects, intersects, intersects, reset, setWindingRule
Constructor Details
Double
public Double()
Path2D
object with a default winding rule of Path2D.WIND_NON_ZERO
.- Since:
- 1.6
Double
public Double(int rule)
Path2D
object with the specified winding rule to control operations that require the interior of the path to be defined.- Parameters:
-
rule
- the winding rule - Throws:
-
IllegalArgumentException
- ifrule
is not eitherPath2D.WIND_EVEN_ODD
orPath2D.WIND_NON_ZERO
- Since:
- 1.6
- See Also:
Double
public 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.- Parameters:
-
rule
- the winding rule -
initialCapacity
- the estimate for the number of path segments in the path - Throws:
-
IllegalArgumentException
- ifrule
is not eitherPath2D.WIND_EVEN_ODD
orPath2D.WIND_NON_ZERO
-
NegativeArraySizeException
- ifinitialCapacity
is negative - Since:
- 1.6
- See Also:
Double
public 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.- Parameters:
-
s
- the specifiedShape
object - Throws:
-
NullPointerException
- ifs
isnull
- Since:
- 1.6
Double
public 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.- Parameters:
-
s
- the specifiedShape
object -
at
- the specifiedAffineTransform
object - Throws:
-
NullPointerException
- ifs
isnull
- Since:
- 1.6
Method Details
trimToSize
public final void trimToSize()
Path2D
- Specified by:
-
trimToSize
in classPath2D
moveTo
public final void moveTo(double x, double y)
lineTo
public final void lineTo(double x, double y)
quadTo
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.curveTo
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.- Specified by:
-
curveTo
in classPath2D
- Parameters:
-
x1
- the X coordinate of the first Bézier control point -
y1
- the Y coordinate of the first Bézier control point -
x2
- the X coordinate of the second Bézier control point -
y2
- the Y coordinate of the second Bézier control point -
x3
- the X coordinate of the final end point -
y3
- the Y coordinate of the final end point - Since:
- 1.6
append
public 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.transform
public final void transform(AffineTransform at)
AffineTransform
. The geometry is transformed in place, which permanently changes the boundary defined by this object.getBounds2D
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)
- Specified by:
-
getBounds2D
in interfaceShape
- Returns:
- an instance of
Rectangle2D
that is a high-precision bounding box of theShape
. - Since:
- 1.6
- See Also:
getPathIterator
public final 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.
- Specified by:
-
getPathIterator
in interfaceShape
- Parameters:
-
at
- anAffineTransform
- Returns:
- a new
PathIterator
that iterates along the boundary of thisShape
and provides access to the geometry of thisShape
's outline - Since:
- 1.6
clone
public final Object clone()
- Specified by:
-
clone
in classPath2D
- Returns:
- a clone of this instance.
- Throws:
-
OutOfMemoryError
- if there is not enough memory. - Since:
- 1.6
- See Also:
© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/awt/geom/Path2D.Double.html