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 nonsquare
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 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 int 
OPEN 
The closure type for an open arc with no path segments
connecting the two ends of the arc segment.

static 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 
Arc2D() 
This is an abstract class that cannot be instantiated directly.

protected 
Arc2D(int type) 
This is an abstract class that cannot be instantiated directly.

Modifier and Type  Method  Description 

boolean 
contains(double x,
double y) 
Determines whether or not the specified point is inside the boundary
of the arc.

boolean 
contains(double x,
double y,
double w,
double h) 
Determines whether or not the interior of the arc entirely contains
the specified rectangle.

boolean 
contains(Rectangle2D r) 
Determines whether or not the interior of the arc entirely contains
the specified rectangle.

boolean 
containsAngle(double angle) 
Determines whether or not the specified angle is within the
angular extents of the arc.

boolean 
equals(Object obj) 
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 highprecision framing rectangle of the arc.

Point2D 
getEndPoint() 
Returns the ending point of the arc.

PathIterator 
getPathIterator(AffineTransform at) 
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(double x,
double y,
double w,
double h) 
Determines whether or not the interior of the arc intersects
the interior of the specified rectangle.

protected abstract Rectangle2D 
makeBounds(double x,
double y,
double w,
double h) 
Constructs a
Rectangle2D of the appropriate precision
to hold the parameters calculated to be the framing rectangle
of this arc. 
abstract void 
setAngleExtent(double angExt) 
Sets the angular extent of this arc to the specified double
value.

void 
setAngles(double x1,
double y1,
double x2,
double y2) 
Sets the starting angle and angular extent of this arc using two
sets of coordinates.

void 
setAngles(Point2D p1,
Point2D p2) 
Sets the starting angle and angular extent of this arc using
two points.

abstract void 
setAngleStart(double angSt) 
Sets the starting angle of this arc to the specified double
value.

void 
setAngleStart(Point2D p) 
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(double x,
double y,
double w,
double h,
double angSt,
double angExt,
int closure) 
Sets the location, size, angular extents, and closure type of
this arc to the specified double values.

void 
setArc(Arc2D a) 
Sets this arc to be the same as the specified arc.

void 
setArc(Point2D loc,
Dimension2D size,
double angSt,
double angExt,
int closure) 
Sets the location, size, angular extents, and closure type of
this arc to the specified values.

void 
setArc(Rectangle2D rect,
double angSt,
double angExt,
int closure) 
Sets the location, size, angular extents, and closure type of
this arc to the specified values.

void 
setArcByCenter(double x,
double y,
double radius,
double angSt,
double angExt,
int closure) 
Sets the position, bounds, angular extents, and closure type of
this arc to the specified values.

void 
setArcByTangent(Point2D p1,
Point2D p2,
Point2D p3,
double radius) 
Sets the position, bounds, and angular extents of this arc to the
specified value.

void 
setArcType(int type) 
Sets the closure type of this arc to the specified value:
OPEN , CHORD , or PIE . 
void 
setFrame(double x,
double y,
double w,
double h) 
Sets the location and size of the framing rectangle of this
Shape to the specified rectangular values. 
finalize, getClass, notify, notifyAll, toString, wait, wait, wait
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.
Arc2D.Float
,
Arc2D.Double
protected Arc2D(int type)
type
 The closure type of this arc:
OPEN
, CHORD
, or PIE
.Arc2D.Float
,
Arc2D.Double
public abstract double getAngleStart()
setAngleStart(double)
public abstract double getAngleExtent()
setAngleExtent(double)
public int getArcType()
setArcType(int)
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 upperleft corner of the arc.y
 The Y coordinate of the upperleft 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 upperleft 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.getAngleStart()
public abstract void setAngleExtent(double angExt)
angExt
 The angular extent of the arc in degrees.getAngleExtent()
public void setAngleStart(Point2D p)
p
 The Point2D
that defines the starting angle.getAngleStart()
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.+getArcType()
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 upperleft corner of the
specified rectangular shapey
 the Y coordinate of the upperleft corner of the
specified rectangular shapew
 the width of the specified rectangular shapeh
 the height of the specified rectangular shapeRectangularShape.getFrame()
public 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.Shape.getBounds()
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 upperleft corner of the
framing rectangle.y
 The Y coordinate of the upperleft 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 upperleft corner.y
 The Y coordinate of the rectangle's upperleft 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.Area
public boolean contains(double x, double y, double w, double h)
x
 The X coordinate of the rectangle's upperleft corner.y
 The Y coordinate of the rectangle's upperleft 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.Area
,
Shape.intersects(double, double, double, double)
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.Shape.contains(double, double, double, double)
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
.hashCode
in class Object
Arc2D
.Object.equals(java.lang.Object)
,
System.identityHashCode(java.lang.Object)
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
.equals
in class Object
obj
 an Object
to be compared with this
Arc2D
.true
if obj
is an instance
of Arc2D
and has the same values;
false
otherwise.Object.hashCode()
,
HashMap
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developertargeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2017, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.
DRAFT 9internal+0adhoc.mlchung.jdk9jdeps