Contents | Package | Class | Tree | Deprecated | Index | Help Java 1.2 Beta 3
PREV | NEXT SHOW LISTS | HIDE LISTS

Class java.awt.geom.Arc2D

java.lang.Object
    |
    +----java.awt.geom.RectangularShape
            |
            +----java.awt.geom.Arc2D
Subclasses:
Arc2D.Double, Arc2D.Float

public abstract class Arc2D
extends RectangularShape
An arc defined by a bounding rectangle, start angle and angular extent, and a closure type (one of OPEN, CHORD, or PIE). The bounding rectangle defines the outer boundary of the full ellipse of which this arc is a partial section. The angles are specified relative to the non-square extents of the bounding rectangle such that 45 degrees always falls on the line from the center of the ellipse to the upper right corner of the bounding rectangle. As a result, if the bounding rectangle is noticeably longer in 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 bounds.

This class is only the abstract superclass for all objects which store a 2D arc. The actual storage representation of the coordinates is left to the subclass.


Inner Class Summary
static   Arc2D.Double
An arc specified in double precision,
static   Arc2D.Float
An arc specified in float precision,
 

Field Summary
static int  CHORD
The closure type for an arc closed by drawing a straight line segment from the start 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 back to the end of the arc segment.
 

Constructor Summary
 Arc2D(int type)
Constructs a new arc of the specified closure type.
 

Method Summary
boolean  contains(double x, double y)
Test if a given Point is inside the boundary of the shape.
boolean  contains(double x, double y, double w, double h)
Test if the interior of the Shape entirely contains the given set of rectangular coordinates.
boolean  contains(Rectangle2D r)
Test if the interior of the Shape entirely contains the given Rectangle.
boolean  containsAngle(double angle)
Tests if a given angle is within the angular extents of the arc.
double  getAngleExtent()
Returns the arc length (angular extent) of the arc (in degrees).
double  getAngleStart()
Returns the starting angle of the arc (in degrees).
int  getArcType()
Returns the arc closure type of the arc.
Rectangle2D  getBounds2D()
Return the high precision bounding box of the shape.
Point2D  getEndPoint()
Returns the ending point of the arc.
PathIterator  getPathIterator(AffineTransform at)
Return an iteration object that defines the boundary of the shape.
Point2D  getStartPoint()
Returns the starting point of the arc.
boolean  intersects(double x, double y, double w, double h)
Test if the interior of the Shape intersects the interior of a given Rectangle.
Rectangle2D  makeBounds(double x, double y, double w, double h)
Construct a rectangle object of the appropriate precision to hold the parameters calculated to be the bounding box of this arc.
static double  normalizeDegrees(double angle)
 
void  setAngleExtent(double angExt)
Sets the angular extent of this arc to the specified double value (in degrees).
void  setAngles(double x1, double y1, double x2, double y2)
Sets the angular extents of this arc to the angles that the specified point coordinates define relative to the center of this arc.
void  setAngles(Point2D p1, Point2D p2)
Sets the angular extents of this arc to the angles that the specified Point objects define relative to the center of this arc.
void  setAngleStart(double angSt)
Sets the starting angle of this arc to the specified double value (in degrees).
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.
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(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 Point and Dimension and double 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 Rectangle and double values.
void  setArc(Arc2D a)
Sets this arc to be the same as the specified Arc.
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 double values based on a center point and a radius rather than a bounding box for the full ellipse.
void  setArcByTangent(Point2D p1, Point2D p2, Point2D p3, double radius)
Sets the position, bounds, and angular extents of this arc so that the starting angle is tangent to the line specified by points (p1, p2) and the ending angle is tangent to the line specified by points (p2, p3) with the given radius.
void  setArcType(int type)
Sets the closure type of this arc to the specified value.
void  setBounds(double x, double y, double w, double h)
Sets the location and size of the outer bounds of this shape to the specified rectangular values.
static double  toDegrees(double angrad)
 
static double  toRadians(double angdeg)
 
 
Methods inherited from class java.awt.geom.RectangularShape
 clone, contains, contains, getBottom, getBounds, getCenterX, getCenterY, getHeight, getLeft, getPathIterator, getRight, getTop, getWidth, getX, getY, intersects, isEmpty, setBounds, setBounds, setBounds, setBoundsFromCenter, setBoundsFromCenter, setBoundsFromDiagonal, setBoundsFromDiagonal
 
Methods inherited from class java.lang.Object
 clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

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.

CHORD

public static final int CHORD
The closure type for an arc closed by drawing a straight line segment from the start to the end of the arc segment.

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 back to the end of the arc segment.
Constructor Detail

Arc2D

protected Arc2D(int type)
Constructs a new arc of the specified closure type.
Method Detail

getAngleStart

public abstract double getAngleStart()
Returns the starting angle of the arc (in degrees).

getAngleExtent

public abstract double getAngleExtent()
Returns the arc length (angular extent) of the arc (in degrees).

getArcType

public int getArcType()
Returns the arc closure type of the arc.
See Also:
OPEN, CHORD, PIE

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.

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.

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.

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 Point and Dimension and double values.

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 Rectangle and double values.

setArc

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

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 double values based on a center point and a radius rather than a bounding box for the full ellipse.

setArcByTangent

public void setArcByTangent(Point2D p1,
                            Point2D p2,
                            Point2D p3,
                            double radius)
Sets the position, bounds, and angular extents of this arc so that the starting angle is tangent to the line specified by points (p1, p2) and the ending angle is tangent to the line specified by points (p2, p3) with the given radius.

setAngleStart

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

setAngleExtent

public abstract void setAngleExtent(double angExt)
Sets the angular extent of this arc to the specified double value (in degrees).

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.

setAngles

public void setAngles(double x1,
                      double y1,
                      double x2,
                      double y2)
Sets the angular extents of this arc to the angles that the specified point coordinates define relative to the center of this arc. The arc will always be non-empty and extend counterclockwise from the first point around to the second point.

setAngles

public void setAngles(Point2D p1,
                      Point2D p2)
Sets the angular extents of this arc to the angles that the specified Point objects define relative to the center of this arc. The arc will always be non-empty and extend counterclockwise from the first point around to the second point.

setArcType

public void setArcType(int type)
Sets the closure type of this arc to the specified value.
See Also:
OPEN, CHORD, PIE

setBounds

public void setBounds(double x,
                      double y,
                      double w,
                      double h)
Sets the location and size of the outer bounds of this shape to the specified rectangular values.
Overrides:
setBounds in class RectangularShape

getBounds2D

public Rectangle2D getBounds2D()
Return the high precision bounding box of the shape.

makeBounds

protected abstract Rectangle2D makeBounds(double x,
                                          double y,
                                          double w,
                                          double h)
Construct a rectangle object of the appropriate precision to hold the parameters calculated to be the bounding box of this arc.

toDegrees

protected static double toDegrees(double angrad)

toRadians

protected static double toRadians(double angdeg)

normalizeDegrees

protected static double normalizeDegrees(double angle)

containsAngle

public boolean containsAngle(double angle)
Tests if a given angle is within the angular extents of the arc.

contains

public boolean contains(double x,
                        double y)
Test if a given Point is inside the boundary of the shape.

intersects

public boolean intersects(double x,
                          double y,
                          double w,
                          double h)
Test if the interior of the Shape intersects the interior of a given Rectangle.

contains

public boolean contains(double x,
                        double y,
                        double w,
                        double h)
Test if the interior of the Shape entirely contains the given set of rectangular coordinates.

contains

public boolean contains(Rectangle2D r)
Test if the interior of the Shape entirely contains the given Rectangle.
Overrides:
contains in class RectangularShape

getPathIterator

public PathIterator getPathIterator(AffineTransform at)
Return an iteration object that defines the boundary of the shape.

Contents | Package | Class | Tree | Deprecated | Index | Help Java 1.2 Beta 3
PREV | NEXT SHOW LISTS | HIDE LISTS

Submit a bug or feature
Submit comments/suggestions about new javadoc look.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.