Arc2D.Double
, Arc2D.Float
public abstract class Arc2D extends RectangularShape
Arc2D
is the abstract superclass for all objects that store a 2D arc defined by a framing rectangle, start angle, angular extent (length of the arc), and a closure type (OPEN
, CHORD
, or PIE
). The arc is a partial section of a full ellipse which inscribes the framing rectangle of its parent RectangularShape
. The angles are specified relative to the non-square framing rectangle such that 45 degrees always falls on the line from the center of the ellipse to the upper right corner of the framing rectangle. As a result, if the framing rectangle is noticeably longer along one axis than the other, the angles to the start and end of the arc segment will be skewed farther along the longer axis of the frame.
The actual storage representation of the coordinates is left to the subclass.
Modifier and Type | Class | Description |
---|---|---|
static class |
Arc2D.Double |
This class defines an arc specified in double precision. |
static class |
Arc2D.Float |
This class defines an arc specified in float precision. |
Modifier and Type | Field | Description |
---|---|---|
static final int |
CHORD |
The closure type for an arc closed by drawing a straight line segment from the start of the arc segment to the end of the arc segment. |
static final int |
OPEN |
The closure type for an open arc with no path segments connecting the two ends of the arc segment. |
static final int |
PIE |
The closure type for an arc closed by drawing straight line segments from the start of the arc segment to the center of the full ellipse and from that point to the end of the arc segment. |
Modifier | Constructor | Description |
---|---|---|
protected |
This is an abstract class that cannot be instantiated directly. |
|
protected |
This is an abstract class that cannot be instantiated directly. |
Modifier and Type | Method | Description |
---|---|---|
boolean |
contains |
Determines whether or not the specified point is inside the boundary of the arc. |
boolean |
contains |
Determines whether or not the interior of the arc entirely contains the specified rectangle. |
boolean |
contains |
Determines whether or not the interior of the arc entirely contains the specified rectangle. |
boolean |
containsAngle |
Determines whether or not the specified angle is within the angular extents of the arc. |
boolean |
equals |
Determines whether or not the specified Object is equal to this Arc2D . |
abstract double |
getAngleExtent() |
Returns the angular extent of the arc. |
abstract double |
getAngleStart() |
Returns the starting angle of the arc. |
int |
getArcType() |
|
Rectangle2D |
getBounds2D() |
Returns the high-precision framing rectangle of the arc. |
Point2D |
getEndPoint() |
Returns the ending point of the arc. |
PathIterator |
getPathIterator |
Returns an iteration object that defines the boundary of the arc. |
Point2D |
getStartPoint() |
Returns the starting point of the arc. |
int |
hashCode() |
Returns the hashcode for this Arc2D . |
boolean |
intersects |
Determines whether or not the interior of the arc intersects the interior of the specified rectangle. |
protected abstract Rectangle2D |
makeBounds |
Constructs a Rectangle2D of the appropriate precision to hold the parameters calculated to be the framing rectangle of this arc. |
abstract void |
setAngleExtent |
Sets the angular extent of this arc to the specified double value. |
void |
setAngles |
Sets the starting angle and angular extent of this arc using two sets of coordinates. |
void |
setAngles |
Sets the starting angle and angular extent of this arc using two points. |
abstract void |
setAngleStart |
Sets the starting angle of this arc to the specified double value. |
void |
setAngleStart |
Sets the starting angle of this arc to the angle that the specified point defines relative to the center of this arc. |
abstract void |
setArc |
Sets the location, size, angular extents, and closure type of this arc to the specified double values. |
void |
setArc |
Sets this arc to be the same as the specified arc. |
void |
setArc |
Sets the location, size, angular extents, and closure type of this arc to the specified values. |
void |
setArc |
Sets the location, size, angular extents, and closure type of this arc to the specified values. |
void |
setArcByCenter |
Sets the position, bounds, angular extents, and closure type of this arc to the specified values. |
void |
setArcByTangent |
Sets the position, bounds, and angular extents of this arc to the specified value. |
void |
setArcType |
Sets the closure type of this arc to the specified value: OPEN , CHORD , or PIE . |
void |
setFrame |
Sets the location and size of the framing rectangle of this Shape to the specified rectangular values. |
clone, contains, getBounds, getCenterX, getCenterY, getFrame, getHeight, getMaxX, getMaxY, getMinX, getMinY, getPathIterator, getWidth, getX, getY, intersects, isEmpty, setFrame, setFrame, setFrameFromCenter, setFrameFromCenter, setFrameFromDiagonal, setFrameFromDiagonal
public static final int OPEN
public static final int CHORD
public static final int PIE
protected Arc2D()
This constructor creates an object with a default closure type of OPEN
. It is provided only to enable serialization of subclasses.
protected Arc2D(int type)
public abstract double getAngleStart()
public abstract double getAngleExtent()
public int getArcType()
public Point2D getStartPoint()
Point2D
object representing the x,y coordinates of the starting point of the arc.public Point2D getEndPoint()
Point2D
object representing the x,y coordinates of the ending point of the arc.public abstract void setArc(double x, double y, double w, double h, double angSt, double angExt, int closure)
x
- The X coordinate of the upper-left corner of the arc.y
- The Y coordinate of the upper-left corner of the arc.w
- The overall width of the full ellipse of which this arc is a partial section.h
- The overall height of the full ellipse of which this arc is a partial section.angSt
- The starting angle of the arc in degrees.angExt
- The angular extent of the arc in degrees.closure
- The closure type for the arc: OPEN
, CHORD
, or PIE
.public void setArc(Point2D loc, Dimension2D size, double angSt, double angExt, int closure)
loc
- The Point2D
representing the coordinates of the upper-left corner of the arc.size
- The Dimension2D
representing the width and height of the full ellipse of which this arc is a partial section.angSt
- The starting angle of the arc in degrees.angExt
- The angular extent of the arc in degrees.closure
- The closure type for the arc: OPEN
, CHORD
, or PIE
.public void setArc(Rectangle2D rect, double angSt, double angExt, int closure)
rect
- The framing rectangle that defines the outer boundary of the full ellipse of which this arc is a partial section.angSt
- The starting angle of the arc in degrees.angExt
- The angular extent of the arc in degrees.closure
- The closure type for the arc: OPEN
, CHORD
, or PIE
.public void setArc(Arc2D a)
a
- The Arc2D
to use to set the arc's values.public void setArcByCenter(double x, double y, double radius, double angSt, double angExt, int closure)
x
- The X coordinate of the center of the arc.y
- The Y coordinate of the center of the arc.radius
- The radius of the arc.angSt
- The starting angle of the arc in degrees.angExt
- The angular extent of the arc in degrees.closure
- The closure type for the arc: OPEN
, CHORD
, or PIE
.public void setArcByTangent(Point2D p1, Point2D p2, Point2D p3, double radius)
p1
- The first point that defines the arc. The starting angle of the arc is tangent to the line specified by points (p1, p2).p2
- The second point that defines the arc. The starting angle of the arc is tangent to the line specified by points (p1, p2). The ending angle of the arc is tangent to the line specified by points (p2, p3).p3
- The third point that defines the arc. The ending angle of the arc is tangent to the line specified by points (p2, p3).radius
- The radius of the arc.public abstract void setAngleStart(double angSt)
angSt
- The starting angle of the arc in degrees.public abstract void setAngleExtent(double angExt)
angExt
- The angular extent of the arc in degrees.public void setAngleStart(Point2D p)
p
- The Point2D
that defines the starting angle.public void setAngles(double x1, double y1, double x2, double y2)
x1
- The X coordinate of the arc's starting point.y1
- The Y coordinate of the arc's starting point.x2
- The X coordinate of the arc's ending point.y2
- The Y coordinate of the arc's ending point.public void setAngles(Point2D p1, Point2D p2)
p1
- The Point2D
that defines the arc's starting point.p2
- The Point2D
that defines the arc's ending point.public void setArcType(int type)
OPEN
, CHORD
, or PIE
.type
- The integer constant that represents the closure type of this arc: OPEN
, CHORD
, or PIE
.IllegalArgumentException
- if type
is not 0, 1, or 2.+public void setFrame(double x, double y, double w, double h)
Shape
to the specified rectangular values. Note that the arc partially inscribes the framing rectangle of this RectangularShape
.setFrame
in class RectangularShape
x
- the X coordinate of the upper-left corner of the specified rectangular shapey
- the Y coordinate of the upper-left corner of the specified rectangular shapew
- the width of the specified rectangular shapeh
- the height of the specified rectangular shapepublic Rectangle2D getBounds2D()
Arc2D
that is in between the starting and ending angles and contains the pie wedge, if this Arc2D
has a PIE
closure type. This method differs from the getBounds
in that the getBounds
method only returns the bounds of the enclosing ellipse of this Arc2D
without considering the starting and ending angles of this Arc2D
.
Rectangle2D
that represents the arc's framing rectangle.protected abstract Rectangle2D makeBounds(double x, double y, double w, double h)
Rectangle2D
of the appropriate precision to hold the parameters calculated to be the framing rectangle of this arc.x
- The X coordinate of the upper-left corner of the framing rectangle.y
- The Y coordinate of the upper-left corner of the framing rectangle.w
- The width of the framing rectangle.h
- The height of the framing rectangle.Rectangle2D
that is the framing rectangle of this arc.public boolean containsAngle(double angle)
angle
- The angle to test.true
if the arc contains the angle, false
if the arc doesn't contain the angle.public boolean contains(double x, double y)
x
- The X coordinate of the point to test.y
- The Y coordinate of the point to test.true
if the point lies within the bound of the arc, false
if the point lies outside of the arc's bounds.public boolean intersects(double x, double y, double w, double h)
x
- The X coordinate of the rectangle's upper-left corner.y
- The Y coordinate of the rectangle's upper-left corner.w
- The width of the rectangle.h
- The height of the rectangle.true
if the arc intersects the rectangle, false
if the arc doesn't intersect the rectangle.public boolean contains(double x, double y, double w, double h)
x
- The X coordinate of the rectangle's upper-left corner.y
- The Y coordinate of the rectangle's upper-left corner.w
- The width of the rectangle.h
- The height of the rectangle.true
if the arc contains the rectangle, false
if the arc doesn't contain the rectangle.public boolean contains(Rectangle2D r)
contains
in interface Shape
contains
in class RectangularShape
r
- The Rectangle2D
to test.true
if the arc contains the rectangle, false
if the arc doesn't contain the rectangle.public PathIterator getPathIterator(AffineTransform at)
Arc2D
guarantees that modifications to the geometry of the arc do not affect any iterations of that geometry that are already in process.at
- an optional AffineTransform
to be applied to the coordinates as they are returned in the iteration, or null if the untransformed coordinates are desired.PathIterator
that defines the arc's boundary.public int hashCode()
Arc2D
.public boolean equals(Object obj)
Object
is equal to this Arc2D
. The specified Object
is equal to this Arc2D
if it is an instance of Arc2D
and if its location, size, arc extents and type are the same as this Arc2D
.
© 1993, 2023, 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/21/docs/api/java.desktop/java/awt/geom/Arc2D.html