Class Arc2D

java.lang.Object

java.awt.geom.RectangularShape

java.awt.geom.Arc2D

All Implemented Interfaces:: Shape, Cloneable

Direct Known Subclasses:: 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.

Since:: 1.2

Nested Class Summary

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.

Field Summary

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.

Constructor Summary

Arc2D()

Arc2D(int type)

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.

Method Summary

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()`	Returns the arc closure type of the arc: `OPEN`, `CHORD`, or `PIE`.
`Rectangle`	`getBounds()`	Returns an integer `Rectangle` that completely encloses the `Shape`.
`Rectangle2D`	`getBounds2D()`	Returns a high precision and more accurate bounding box of the `Shape` than the `getBounds` method.
`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.

Methods declared in class RectangularShape

clone, contains, getCenterX, getCenterY, getFrame, getHeight, getMaxX, getMaxY, getMinX, getMinY, getPathIterator, getWidth, getX, getY, intersects, isEmpty, setFrame, setFrame, setFrameFromCenter, setFrameFromCenter, setFrameFromDiagonal, setFrameFromDiagonal

Modifier and Type	Method	Description
`Object`	`clone()`	Creates a new object of the same class and with the same contents as this object.
`boolean`	`contains(Point2D p)`	Tests if a specified `Point2D` is inside the boundary of the `Shape`, as described by the definition of insideness.
`double`	`getCenterX()`	Returns the X coordinate of the center of the framing rectangle of the `Shape` in `double` precision.
`double`	`getCenterY()`	Returns the Y coordinate of the center of the framing rectangle of the `Shape` in `double` precision.
`Rectangle2D`	`getFrame()`	Returns the framing `Rectangle2D` that defines the overall shape of this object.
`abstract double`	`getHeight()`	Returns the height of the framing rectangle in `double` precision.
`double`	`getMaxX()`	Returns the largest X coordinate of the framing rectangle of the `Shape` in `double` precision.
`double`	`getMaxY()`	Returns the largest Y coordinate of the framing rectangle of the `Shape` in `double` precision.
`double`	`getMinX()`	Returns the smallest X coordinate of the framing rectangle of the `Shape` in `double` precision.
`double`	`getMinY()`	Returns the smallest Y coordinate of the framing rectangle of the `Shape` in `double` precision.
`PathIterator`	`getPathIterator(AffineTransform at, double flatness)`	Returns an iterator object that iterates along the `Shape` object's boundary and provides access to a flattened view of the outline of the `Shape` object's geometry.
`abstract double`	`getWidth()`	Returns the width of the framing rectangle in `double` precision.
`abstract double`	`getX()`	Returns the X coordinate of the upper-left corner of the framing rectangle in `double` precision.
`abstract double`	`getY()`	Returns the Y coordinate of the upper-left corner of the framing rectangle in `double` precision.
`boolean`	`intersects(Rectangle2D r)`	Tests if the interior of the `Shape` intersects the interior of a specified `Rectangle2D`.
`abstract boolean`	`isEmpty()`	Determines whether the `RectangularShape` is empty.
`void`	`setFrame(Point2D loc, Dimension2D size)`	Sets the location and size of the framing rectangle of this `Shape` to the specified `Point2D` and `Dimension2D`, respectively.
`void`	`setFrame(Rectangle2D r)`	Sets the framing rectangle of this `Shape` to be the specified `Rectangle2D`.
`void`	`setFrameFromCenter(double centerX, double centerY, double cornerX, double cornerY)`	Sets the framing rectangle of this `Shape` based on the specified center point coordinates and corner point coordinates.
`void`	`setFrameFromCenter(Point2D center, Point2D corner)`	Sets the framing rectangle of this `Shape` based on a specified center `Point2D` and corner `Point2D`.
`void`	`setFrameFromDiagonal(double x1, double y1, double x2, double y2)`	Sets the diagonal of the framing rectangle of this `Shape` based on the two specified coordinates.
`void`	`setFrameFromDiagonal(Point2D p1, Point2D p2)`	Sets the diagonal of the framing rectangle of this `Shape` based on two specified `Point2D` objects.

Methods declared in class Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Modifier and Type	Method	Description
`protected void`	`finalize()`	Deprecated, for removal: This API element is subject to removal in a future version. Finalization is deprecated and subject to removal in a future release.
`final Class<?>`	`getClass()`	Returns the runtime class of this `Object`.
`final void`	`notify()`	Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()`	Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()`	Returns a string representation of the object.
`final void`	`wait()`	Causes the current thread to wait until it is awakened, typically by being notified or interrupted.
`final void`	`wait(long timeoutMillis)`	Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis, int nanos)`	Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

Field Details

OPEN

public static final int OPEN

The closure type for an open arc with no path segments connecting the two ends of the arc segment.

Since:

1.2

See Also:

CHORD

public 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.

Since:

1.2

See Also:

PIE

public 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.

Since:

1.2

See Also:

Constructor Details

Arc2D

protected Arc2D()

This is an abstract class that cannot be instantiated directly. Type-specific implementation subclasses are available for instantiation and provide a number of formats for storing the information necessary to satisfy the various accessor methods below.

This constructor creates an object with a default closure type of OPEN. It is provided only to enable serialization of subclasses.

See Also:

Arc2D

protected Arc2D(int type)

Parameters:

type - The closure type of this arc: OPEN, CHORD, or PIE.

Since:

1.2

See Also:

Method Details

getAngleStart

public abstract double getAngleStart()

Returns the starting angle of the arc.

Returns:

A double value that represents the starting angle of the arc in degrees.

Since:

1.2

See Also:

getAngleExtent

public abstract double getAngleExtent()

Returns the angular extent of the arc.

Returns:

A double value that represents the angular extent of the arc in degrees.

Since:

1.2

See Also:

getArcType

public int getArcType()

Returns the arc closure type of the arc: OPEN, CHORD, or PIE.

Returns:

One of the integer constant closure types defined in this class.

Since:

1.2

See Also:

getStartPoint

public Point2D getStartPoint()

Returns the starting point of the arc. This point is the intersection of the ray from the center defined by the starting angle and the elliptical boundary of the arc.

Returns:: A Point2D object representing the x,y coordinates of the starting point of the arc.
Since:: 1.2

getEndPoint

public Point2D getEndPoint()

Returns the ending point of the arc. This point is the intersection of the ray from the center defined by the starting angle plus the angular extent of the arc and the elliptical boundary of the arc.

Returns:: A Point2D object representing the x,y coordinates of the ending point of the arc.
Since:: 1.2

setArc

public 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.

Parameters:: 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.
Since:: 1.2

setArc

public 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.

Parameters:: 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.
Since:: 1.2

setArc

public 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.

Parameters:: 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.
Since:: 1.2

setArc

public void setArc(Arc2D a)

Sets this arc to be the same as the specified arc.

Parameters:: a - The Arc2D to use to set the arc's values.
Since:: 1.2

setArcByCenter

public 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. The arc is defined by a center point and a radius rather than a framing rectangle for the full ellipse.

Parameters:: 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.
Since:: 1.2

setArcByTangent

public void setArcByTangent(Point2D p1, Point2D p2, Point2D p3, double radius)

Sets the position, bounds, and angular extents of this arc to the specified value. The starting angle of the arc is tangent to the line specified by points (p1, p2), the ending angle is tangent to the line specified by points (p2, p3), and the arc has the specified radius.

Parameters:: 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.
Since:: 1.2

setAngleStart

public abstract void setAngleStart(double angSt)

Sets the starting angle of this arc to the specified double value.

Parameters:

angSt - The starting angle of the arc in degrees.

Since:

1.2

See Also:

setAngleExtent

public abstract void setAngleExtent(double angExt)

Sets the angular extent of this arc to the specified double value.

Parameters:

angExt - The angular extent of the arc in degrees.

Since:

1.2

See Also:

setAngleStart

public 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. The angular extent of the arc will remain the same.

Parameters:

p - The Point2D that defines the starting angle.

Since:

1.2

See Also:

setAngles

public 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. The first set of coordinates is used to determine the angle of the starting point relative to the arc's center. The second set of coordinates is used to determine the angle of the end point relative to the arc's center. The arc will always be non-empty and extend counterclockwise from the first point around to the second point.

Parameters:: 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.
Since:: 1.2

setAngles

public void setAngles(Point2D p1, Point2D p2)

Sets the starting angle and angular extent of this arc using two points. The first point is used to determine the angle of the starting point relative to the arc's center. The second point is used to determine the angle of the end point relative to the arc's center. The arc will always be non-empty and extend counterclockwise from the first point around to the second point.

Parameters:: p1 - The Point2D that defines the arc's starting point.; p2 - The Point2D that defines the arc's ending point.
Since:: 1.2

setArcType

public void setArcType(int type)

Sets the closure type of this arc to the specified value: OPEN, CHORD, or PIE.

Parameters:

type - The integer constant that represents the closure type of this arc: OPEN, CHORD, or PIE.

Throws:

IllegalArgumentException - if type is not 0, 1, or 2.+

Since:

1.2

See Also:

setFrame

public 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. Note that the arc partially inscribes the framing rectangle of this RectangularShape.

Specified by:

setFrame in class RectangularShape

Parameters:

x - the X coordinate of the upper-left corner of the specified rectangular shape

y - the Y coordinate of the upper-left corner of the specified rectangular shape

w - the width of the specified rectangular shape

h - the height of the specified rectangular shape

Since:

1.2

See Also:

getBounds2D

public Rectangle2D getBounds2D()

Returns a high precision and more accurate bounding box of the 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)

Returns:

an instance of Rectangle2D that is a high-precision bounding box of the Shape.

Since:

1.2

See Also:

getBounds

public Rectangle getBounds()

Returns an integer Rectangle that completely encloses the Shape. Note that there is no guarantee that the returned Rectangle is the smallest bounding box that encloses the Shape, only that the Shape lies entirely within the indicated Rectangle. The returned Rectangle might also fail to completely enclose the Shape if the Shape overflows the limited range of the integer data type. The getBounds2D method generally returns a tighter bounding box due to its greater flexibility in representation.

If a point is inside the shape according to the contains(point) method, then it must be inside the returned Rectangle bounds object according to the contains(point) method of the bounds. Specifically:

shape.contains(x,y) requires bounds.contains(x,y)

If a point is not inside the shape, then it might still be contained in the bounds object:

bounds.contains(x,y) does not imply shape.contains(x,y)

Specified by:

getBounds in interface Shape

Overrides:

getBounds in class RectangularShape

Returns:

an integer Rectangle that completely encloses the Shape.

Since:

1.2

See Also:

makeBounds

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.

Parameters:: 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.
Returns:: a Rectangle2D that is the framing rectangle of this arc.
Since:: 1.2

containsAngle

public boolean containsAngle(double angle)

Determines whether or not the specified angle is within the angular extents of the arc.

Parameters:: angle - The angle to test.
Returns:: true if the arc contains the angle, false if the arc doesn't contain the angle.
Since:: 1.2

contains

public boolean contains(double x, double y)

Determines whether or not the specified point is inside the boundary of the arc.

Parameters:: x - The X coordinate of the point to test.; y - The Y coordinate of the point to test.
Returns:: true if the point lies within the bound of the arc, false if the point lies outside of the arc's bounds.
Since:: 1.2

intersects

public 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.

Parameters:

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.

Returns:

true if the arc intersects the rectangle, false if the arc doesn't intersect the rectangle.

Since:

1.2

See Also:

contains

public boolean contains(double x, double y, double w, double h)

Determines whether or not the interior of the arc entirely contains the specified rectangle.

Parameters:

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.

Returns:

true if the arc contains the rectangle, false if the arc doesn't contain the rectangle.

Since:

1.2

See Also:

contains

public boolean contains(Rectangle2D r)

Determines whether or not the interior of the arc entirely contains the specified rectangle.

Specified by:

contains in interface Shape

Overrides:

contains in class RectangularShape

Parameters:

r - The Rectangle2D to test.

Returns:

true if the arc contains the rectangle, false if the arc doesn't contain the rectangle.

Since:

1.2

See Also:

getPathIterator

public PathIterator getPathIterator(AffineTransform at)

Returns an iteration object that defines the boundary of the arc. This iterator is multithread safe. Arc2D guarantees that modifications to the geometry of the arc do not affect any iterations of that geometry that are already in process.

Parameters:: 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.
Returns:: A PathIterator that defines the arc's boundary.
Since:: 1.2

hashCode

public int hashCode()

Returns the hashcode for this Arc2D.

Overrides:

hashCode in class Object

Returns:

the hashcode for this Arc2D.

Since:

1.6

See Also:

equals

public boolean equals(Object obj)

Determines whether or not the specified 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.

Overrides:

equals in class Object

Parameters:

obj - an Object to be compared with this Arc2D.

Returns:

true if obj is an instance of Arc2D and has the same values; false otherwise.

Since:

1.6

See Also:

© 1993, 2025, 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.