Class java.awt.Polygon 
All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.awt.Polygon 

Object
   |
   +----java.awt.Polygon
public class Polygon
extends Object
implements Shape, Serializable
The Polygon class encapsulates a description of a closed, two-dimensional region within a coordinate space. This region is bounded by an arbitrary number of line segments, each of which is one side of the polygon. Internally, a polygon comprises of a list of (x, y) coordinate pairs, where each pair defines a vertex of the polygon, and two successive pairs are the endpoints of a line that is a side of the polygon. The first and final pairs of (x, y) points are joined by a line segment that closes the polygon.

Version:
1.18, 07/01/98
Author:
Sami Shaio, Herb Jellinek
Since:
JDK1.0

Variable Index

o bounds
o npoints
The total number of points.
o xpoints
The array of x coordinates.
o ypoints
The array of y coordinates.

Constructor Index

o java.awt.Polygon()
Creates an empty polygon.
o java.awt.Polygon(int[], int[], int)
Constructs and initializes a polygon from the specified parameters.

Method Index

o addPoint(int, int)
Appends a point to this polygon.
o contains(Point)
Determines whether the specified point is inside the Polygon.
o contains(int, int)
Determines whether the specified point is contained by this polygon.
o getBoundingBox()
o getBounds()
Gets the bounding box of this polygon.
o inside(int, int)
o translate(int, int)
Translates the vertices by deltaX along the x axis and by deltaY along the y axis.

Variables

o bounds 
protected java.awt.Rectangle bounds
o npoints 
public int npoints
The total number of points.

Since: JDK1.0
o xpoints 
public int[] xpoints
The array of x coordinates.

Since: JDK1.0
o ypoints 
public int[] ypoints
The array of y coordinates.

Since: JDK1.0

Constructors

o Polygon 
public Polygon()
Creates an empty polygon.

Since:
JDK1.0
o Polygon 
public Polygon(int xpoints,
               int ypoints,
               int npoints)
Constructs and initializes a polygon from the specified parameters.

Parameters:
xpoints - an array of x coordinates.
ypoints - an array of y coordinates.
npoints - the total number of points in the polygon.
Throws: NegativeArraySizeException
if the value of npoints is negative.
Since:
JDK1.0

Methods

o addPoint 
public void addPoint(int x,
                     int y)
Appends a point to this polygon.

If an operation that calculates the bounding box of this polygon has already been performed, such as getBounds or contains, then this method updates the bounding box.

Parameters:
x - the x coordinate of the point.
y - the y coordinate of the point.
Since:
JDK1.0
See Also:
getBounds, contains
o contains 
public boolean contains(Point p)
Determines whether the specified point is inside the Polygon. Uses an even-odd insideness rule (also known as an alternating rule).

Parameters:
p - the point to be tested
o contains 
public boolean contains(int x,
                        int y)
Determines whether the specified point is contained by this polygon.

(The contains method is based on code by Hanpeter van Vliet [hvvliet

Parameters:
x - the x coordinate of the point to be tested.
y - the y coordinate of the point to be tested.
Returns:
true if the point (x, y) is contained by this polygon; false otherwise.
Since:
JDK1.1
o getBoundingBox 
public java.awt.Rectangle getBoundingBox()
Note: getBoundingBox() is deprecated. As of JDK version 1.1, replaced by getBounds().

o getBounds 
public java.awt.Rectangle getBounds()
Gets the bounding box of this polygon. The bounding box is the smallest rectangle whose sides are parallel to the x and y axes of the coordinate space, and that can completely contain the polygon.

Returns:
a rectangle that defines the bounds of this polygon.
Since:
JDK1.1
o inside 
public boolean inside(int x,
                      int y)
Note: inside() is deprecated. As of JDK version 1.1, replaced by contains(int, int).

o translate 
public void translate(int deltaX,
                      int deltaY)
Translates the vertices by deltaX along the x axis and by deltaY along the y axis.

Parameters:
deltaX - the amount to translate along the x axis
deltaY - the amount to translate along the y axis
Since:
JDK1.1 
All Packages  Class Hierarchy  This Package  Previous  Next  Index