Java Doc for Arc2D.java in  » 6.0-JDK-Core » AWT » java » awt » geom » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Home
Java Source Code / Java Documentation
1.6.0 JDK Core
2.6.0 JDK Modules
3.6.0 JDK Modules com.sun
4.6.0 JDK Modules com.sun.java
5.6.0 JDK Modules sun
6.6.0 JDK Platform
7.Ajax
8.Apache Harmony Java SE
9.Aspect oriented
10.Authentication Authorization
11.Blogger System
12.Build
13.Byte Code
14.Cache
15.Chart
16.Chat
17.Code Analyzer
18.Collaboration
19.Content Management System
20.Database Client
21.Database DBMS
22.Database JDBC Connection Pool
23.Database ORM
24.Development
25.EJB Server
26.ERP CRM Financial
27.ESB
28.Forum
29.Game
30.GIS
31.Graphic 3D
32.Graphic Library
33.Groupware
34.HTML Parser
35.IDE
36.IDE Eclipse
37.IDE Netbeans
38.Installer
39.Internationalization Localization
40.Inversion of Control
41.Issue Tracking
42.J2EE
43.J2ME
44.JBoss
45.JMS
46.JMX
47.Library
48.Mail Clients
49.Music
50.Net
51.Parser
52.PDF
53.Portal
54.Profiler
55.Project Management
56.Report
57.RSS RDF
58.Rule Engine
59.Science
60.Scripting
61.Search Engine
62.Security
63.Sevlet Container
64.Source Control
65.Swing Library
66.Template Engine
67.Test Coverage
68.Testing
69.UML
70.Web Crawler
71.Web Framework
72.Web Mail
73.Web Server
74.Web Services
75.Web Services apache cxf 2.2.6
76.Web Services AXIS2
77.Wiki Engine
78.Workflow Engines
79.XML
80.XML UI
Java Source Code / Java Documentation » 6.0 JDK Core » AWT » java.awt.geom 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   java.awt.geom.RectangularShape
      java.awt.geom.Arc2D

Arc2D
abstract public class Arc2D extends RectangularShape (Code)
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.
version:
   10 Feb 1997
author:
   Jim Graham
since:
   1.2


Inner Class :public static class Float extends Arc2D implements Serializable
Inner Class :public static class Double extends Arc2D implements Serializable

Field Summary
final public static  intCHORD
     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.
final public static  intOPEN
     The closure type for an open arc with no path segments connecting the two ends of the arc segment.
final public static  intPIE
     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()
     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 Arc2D.OPEN .

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

Method Summary
public  booleancontains(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.
Parameters:
  y - The Y coordinate of the point to test.
public  booleancontains(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.
public  booleancontains(Rectangle2D r)
     Determines whether or not the interior of the arc entirely contains the specified rectangle.
Parameters:
  r - The Rectangle2D to test.
public  booleancontainsAngle(double angle)
     Determines whether or not the specified angle is within the angular extents of the arc.
Parameters:
  angle - The angle to test.
public  booleanequals(Object obj)
     Determines whether or not the specified Object is equal to this Arc2D.
abstract public  doublegetAngleExtent()
     Returns the angular extent of the arc.
abstract public  doublegetAngleStart()
     Returns the starting angle of the arc.
public  intgetArcType()
     Returns the arc closure type of the arc: Arc2D.OPEN , Arc2D.CHORD , or Arc2D.PIE .
public  Rectangle2DgetBounds2D()
     Returns the high-precision framing rectangle of the arc.
public  Point2DgetEndPoint()
     Returns the ending point of the arc.
public  PathIteratorgetPathIterator(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.
public  Point2DgetStartPoint()
     Returns the starting point of the arc.
public  inthashCode()
     Returns the hashcode for this Arc2D.
public  booleanintersects(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.
abstract protected  Rectangle2DmakeBounds(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.
Parameters:
  y - The Y coordinate of the upper-left corner of the framing rectangle.
Parameters:
  w - The width of the framing rectangle.
Parameters:
  h - The height of the framing rectangle.
static  doublenormalizeDegrees(double angle)
    
abstract public  voidsetAngleExtent(double angExt)
     Sets the angular extent of this arc to the specified double value.
abstract public  voidsetAngleStart(double angSt)
     Sets the starting angle of this arc to the specified double value.
public  voidsetAngleStart(Point2D p)
     Sets the starting angle of this arc to the angle that the specified point defines relative to the center of this arc.
public  voidsetAngles(double x1, double y1, double x2, double y2)
     Sets the starting angle and angular extent of this arc using two sets of coordinates.
public  voidsetAngles(Point2D p1, Point2D p2)
     Sets the starting angle and angular extent of this arc using two points.
abstract public  voidsetArc(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.
public  voidsetArc(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.
Parameters:
  size - The Dimension2D representing the width and height of the full ellipse of which this arc is a partial section.
Parameters:
  angSt - The starting angle of the arc in degrees.
public  voidsetArc(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.
Parameters:
  angSt - The starting angle of the arc in degrees.
public  voidsetArc(Arc2D a)
     Sets this arc to be the same as the specified arc.
public  voidsetArcByCenter(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.
public  voidsetArcByTangent(Point2D p1, Point2D p2, Point2D p3, double radius)
     Sets the position, bounds, and angular extents of this arc to the specified value.
public  voidsetArcType(int type)
     Sets the closure type of this arc to the specified value: OPEN, CHORD, or PIE.
public  voidsetFrame(double x, double y, double w, double h)
     Note that the arc partially inscribes the framing rectangle of this RectangularShape .

Field Detail
CHORD
final public static int CHORD(Code)
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



OPEN
final public static int OPEN(Code)
The closure type for an open arc with no path segments connecting the two ends of the arc segment.
since:
   1.2



PIE
final public static int PIE(Code)
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




Constructor Detail
Arc2D
Arc2D()(Code)
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 Arc2D.OPEN . It is provided only to enable serialization of subclasses.
See Also:   java.awt.geom.Arc2D.Float
See Also:   java.awt.geom.Arc2D.Double




Arc2D
protected Arc2D(int type)(Code)
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.
Parameters:
  type - The closure type of this arc: Arc2D.OPEN, Arc2D.CHORD, or Arc2D.PIE.
See Also:   java.awt.geom.Arc2D.Float
See Also:   java.awt.geom.Arc2D.Double
since:
   1.2




Method Detail
contains
public boolean contains(double x, double y)(Code)
Determines whether or not the specified point is inside the boundary of the arc.
Parameters:
  x - The X coordinate of the point to test.
Parameters:
  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.
since:
   1.2



contains
public boolean contains(double x, double y, double w, double h)(Code)
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.
Parameters:
  y - The Y coordinate of the rectangle's upper-left corner.
Parameters:
  w - The width of the rectangle.
Parameters:
  h - The height of the rectangle. true if the arc contains the rectangle, false if the arc doesn't contain the rectangle.
since:
   1.2



contains
public boolean contains(Rectangle2D r)(Code)
Determines whether or not the interior of the arc entirely contains the specified rectangle.
Parameters:
  r - The Rectangle2D to test. true if the arc contains the rectangle, false if the arc doesn't contain the rectangle.
since:
   1.2



containsAngle
public boolean containsAngle(double angle)(Code)
Determines whether or not the specified angle is within the angular extents of the arc.
Parameters:
  angle - The angle to test. true if the arc contains the angle, false if the arc doesn't contain the angle.
since:
   1.2



equals
public boolean equals(Object obj)(Code)
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.
Parameters:
  obj - an Object to be compared with thisArc2D. true if obj is an instanceof Arc2D and has the same values;false otherwise.
since:
   1.6



getAngleExtent
abstract public double getAngleExtent()(Code)
Returns the angular extent of the arc. A double value that represents the angular extent of the arc in degrees.
See Also:   Arc2D.setAngleExtent
since:
   1.2



getAngleStart
abstract public double getAngleStart()(Code)
Returns the starting angle of the arc. A double value that represents the starting angle of the arc in degrees.
See Also:   Arc2D.setAngleStart
since:
   1.2



getArcType
public int getArcType()(Code)
Returns the arc closure type of the arc: Arc2D.OPEN , Arc2D.CHORD , or Arc2D.PIE . One of the integer constant closure types defined in this class.
See Also:   Arc2D.setArcType
since:
   1.2



getBounds2D
public Rectangle2D getBounds2D()(Code)
Returns the high-precision framing rectangle of the arc. The framing rectangle contains only the part of this 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 RectangularShape.getBounds 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. the Rectangle2D that represents the arc's framing rectangle.
since:
   1.2




getEndPoint
public Point2D getEndPoint()(Code)
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. A Point2D object representing the x,y coordinates of the ending point of the arc.
since:
   1.2



getPathIterator
public PathIterator getPathIterator(AffineTransform at)(Code)
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. A PathIterator that defines the arc's boundary.
since:
   1.2



getStartPoint
public Point2D getStartPoint()(Code)
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. A Point2D object representing the x,y coordinates of the starting point of the arc.
since:
   1.2



hashCode
public int hashCode()(Code)
Returns the hashcode for this Arc2D. the hashcode for this Arc2D.
since:
   1.6



intersects
public boolean intersects(double x, double y, double w, double h)(Code)
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.
Parameters:
  y - The Y coordinate of the rectangle's upper-left corner.
Parameters:
  w - The width of the rectangle.
Parameters:
  h - The height of the rectangle. true if the arc intersects the rectangle, false if the arc doesn't intersect the rectangle.
since:
   1.2



makeBounds
abstract protected Rectangle2D makeBounds(double x, double y, double w, double h)(Code)
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.
Parameters:
  y - The Y coordinate of the upper-left corner of the framing rectangle.
Parameters:
  w - The width of the framing rectangle.
Parameters:
  h - The height of the framing rectangle. a Rectangle2D that is the framing rectangleof this arc.
since:
   1.2



normalizeDegrees
static double normalizeDegrees(double angle)(Code)



setAngleExtent
abstract public void setAngleExtent(double angExt)(Code)
Sets the angular extent of this arc to the specified double value.
Parameters:
  angExt - The angular extent of the arc in degrees.
See Also:   Arc2D.getAngleExtent
since:
   1.2



setAngleStart
abstract public void setAngleStart(double angSt)(Code)
Sets the starting angle of this arc to the specified double value.
Parameters:
  angSt - The starting angle of the arc in degrees.
See Also:   Arc2D.getAngleStart
since:
   1.2



setAngleStart
public void setAngleStart(Point2D p)(Code)
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.
See Also:   Arc2D.getAngleStart
since:
   1.2



setAngles
public void setAngles(double x1, double y1, double x2, double y2)(Code)
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.
Parameters:
  y1 - The Y coordinate of the arc's starting point.
Parameters:
  x2 - The X coordinate of the arc's ending point.
Parameters:
  y2 - The Y coordinate of the arc's ending point.
since:
   1.2



setAngles
public void setAngles(Point2D p1, Point2D p2)(Code)
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.
Parameters:
  p2 - The Point2D that defines the arc's ending point.
since:
   1.2



setArc
abstract public void setArc(double x, double y, double w, double h, double angSt, double angExt, int closure)(Code)
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.
Parameters:
  y - The Y coordinate of the upper-left corner of the arc.
Parameters:
  w - The overall width of the full ellipse of which this arc is a partial section.
Parameters:
  h - The overall height of the full ellipse of which this arc is a partial section.
Parameters:
  angSt - The starting angle of the arc in degrees.
Parameters:
  angExt - The angular extent of the arc in degrees.
Parameters:
  closure - The closure type for the arc:Arc2D.OPEN, Arc2D.CHORD, or Arc2D.PIE.
since:
   1.2



setArc
public void setArc(Point2D loc, Dimension2D size, double angSt, double angExt, int closure)(Code)
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.
Parameters:
  size - The Dimension2D representing the width and height of the full ellipse of which this arc is a partial section.
Parameters:
  angSt - The starting angle of the arc in degrees.
Parameters:
  angExt - The angular extent of the arc in degrees.
Parameters:
  closure - The closure type for the arc:Arc2D.OPEN, Arc2D.CHORD, or Arc2D.PIE.
since:
   1.2



setArc
public void setArc(Rectangle2D rect, double angSt, double angExt, int closure)(Code)
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.
Parameters:
  angSt - The starting angle of the arc in degrees.
Parameters:
  angExt - The angular extent of the arc in degrees.
Parameters:
  closure - The closure type for the arc:Arc2D.OPEN, Arc2D.CHORD, or Arc2D.PIE.
since:
   1.2



setArc
public void setArc(Arc2D a)(Code)
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)(Code)
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.
Parameters:
  y - The Y coordinate of the center of the arc.
Parameters:
  radius - The radius of the arc.
Parameters:
  angSt - The starting angle of the arc in degrees.
Parameters:
  angExt - The angular extent of the arc in degrees.
Parameters:
  closure - The closure type for the arc:Arc2D.OPEN, Arc2D.CHORD, or Arc2D.PIE.
since:
   1.2



setArcByTangent
public void setArcByTangent(Point2D p1, Point2D p2, Point2D p3, double radius)(Code)
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).
Parameters:
  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).
Parameters:
  p3 - The third point that defines the arc. The ending angle of the arc is tangent to the line specified by points (p2, p3).
Parameters:
  radius - The radius of the arc.
since:
   1.2



setArcType
public void setArcType(int type)(Code)
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: Arc2D.OPEN, Arc2D.CHORD, or Arc2D.PIE.
throws:
  IllegalArgumentException - if type is not0, 1, or 2.+
See Also:   Arc2D.getArcType
since:
   1.2



setFrame
public void setFrame(double x, double y, double w, double h)(Code)
Note that the arc partially inscribes the framing rectangle of this RectangularShape .
since:
   1.2



Methods inherited from java.awt.geom.RectangularShape
public Object clone()(Code)(Java Doc)
public boolean contains(Point2D p)(Code)(Java Doc)
public boolean contains(Rectangle2D r)(Code)(Java Doc)
public Rectangle getBounds()(Code)(Java Doc)
public double getCenterX()(Code)(Java Doc)
public double getCenterY()(Code)(Java Doc)
public Rectangle2D getFrame()(Code)(Java Doc)
abstract public double getHeight()(Code)(Java Doc)
public double getMaxX()(Code)(Java Doc)
public double getMaxY()(Code)(Java Doc)
public double getMinX()(Code)(Java Doc)
public double getMinY()(Code)(Java Doc)
public PathIterator getPathIterator(AffineTransform at, double flatness)(Code)(Java Doc)
abstract public double getWidth()(Code)(Java Doc)
abstract public double getX()(Code)(Java Doc)
abstract public double getY()(Code)(Java Doc)
public boolean intersects(Rectangle2D r)(Code)(Java Doc)
abstract public boolean isEmpty()(Code)(Java Doc)
abstract public void setFrame(double x, double y, double w, double h)(Code)(Java Doc)
public void setFrame(Point2D loc, Dimension2D size)(Code)(Java Doc)
public void setFrame(Rectangle2D r)(Code)(Java Doc)
public void setFrameFromCenter(double centerX, double centerY, double cornerX, double cornerY)(Code)(Java Doc)
public void setFrameFromCenter(Point2D center, Point2D corner)(Code)(Java Doc)
public void setFrameFromDiagonal(double x1, double y1, double x2, double y2)(Code)(Java Doc)
public void setFrameFromDiagonal(Point2D p1, Point2D p2)(Code)(Java Doc)

Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.