

PREV CLASS NEXT CLASS  FRAMES NO FRAMES  
SUMMARY: NESTED  FIELD  CONSTR  METHOD  DETAIL: FIELD  CONSTR  METHOD 
java.lang.Object com.vividsolutions.jts.geom.Geometry com.vividsolutions.jts.geom.Polygon
Represents a linear polygon, which may include holes.
The shell and holes of the polygon are represented by LinearRing
s.
In a valid polygon, holes may touch the shell or other holes at a single point.
However, no sequence of touching holes may split the polygon into two pieces.
The orientation of the rings in the polygon does not matter.
The shell and holes must conform to the assertions specified in the OpenGIS Simple Features Specification for SQL .
Field Summary  
protected LinearRing[] 
holes
The interior boundaries, if any. 
protected LinearRing 
shell
The exterior boundary, or null if this Polygon
is empty. 
Fields inherited from class com.vividsolutions.jts.geom.Geometry 
envelope, factory, SRID 
Constructor Summary  
Polygon(LinearRing shell,
LinearRing[] holes,
GeometryFactory factory)
Constructs a Polygon with the given exterior boundary and
interior boundaries. 

Polygon(LinearRing shell,
LinearRing[] holes,
PrecisionModel precisionModel,
int SRID)
Deprecated. Use GeometryFactory instead 

Polygon(LinearRing shell,
PrecisionModel precisionModel,
int SRID)
Deprecated. Use GeometryFactory instead 
Method Summary  
void 
apply(CoordinateFilter filter)
Performs an operation with or on this Geometry 's
coordinates. 
void 
apply(CoordinateSequenceFilter filter)
Performs an operation on the coordinates in this Geometry 's
CoordinateSequence s. 
void 
apply(GeometryComponentFilter filter)
Performs an operation with or on this Geometry and its component Geometry's. 
void 
apply(GeometryFilter filter)
Performs an operation with or on this Geometry and its
subelement Geometry s (if any). 
java.lang.Object 
clone()
Creates and returns a full copy of this Polygon object. 
protected int 
compareToSameClass(java.lang.Object o)
Returns whether this Geometry is greater than, equal to,
or less than another Geometry having the same class. 
protected int 
compareToSameClass(java.lang.Object o,
CoordinateSequenceComparator comp)
Returns whether this Geometry is greater than, equal to,
or less than another Geometry of the same class. 
protected Envelope 
computeEnvelopeInternal()
Returns the minimum and maximum x and y values in this Geometry
, or a null Envelope if this Geometry is empty. 
Geometry 
convexHull()
Computes the smallest convex Polygon that contains all the
points in the Geometry . 
boolean 
equalsExact(Geometry other,
double tolerance)
Returns true if the two Geometry s are exactly equal,
up to a specified distance tolerance. 
double 
getArea()
Returns the area of this Polygon 
Geometry 
getBoundary()
Computes the boundary of this geometry 
int 
getBoundaryDimension()
Returns the dimension of this Geometry s inherent boundary. 
Coordinate 
getCoordinate()
Returns a vertex of this Geometry . 
Coordinate[] 
getCoordinates()
Returns this Geometry s vertices. 
int 
getDimension()
Returns the dimension of this Geometry . 
LineString 
getExteriorRing()

java.lang.String 
getGeometryType()
Returns the name of this object's com.vivid.jts.geom
interface. 
LineString 
getInteriorRingN(int n)

double 
getLength()
Returns the perimeter of this Polygon 
int 
getNumInteriorRing()

int 
getNumPoints()
Returns the count of this Geometry s vertices. 
boolean 
isEmpty()
Returns whether or not the set of points in this Geometry is
empty. 
boolean 
isRectangle()

boolean 
isSimple()
Tests if a valid polygon is simple. 
void 
normalize()
Converts this Geometry to normal form (or
canonical form ). 
Methods inherited from class com.vividsolutions.jts.geom.Geometry 
buffer, buffer, buffer, checkNotGeometryCollection, compare, compareTo, compareTo, contains, coveredBy, covers, crosses, difference, disjoint, distance, equal, equals, equalsExact, geometryChanged, geometryChangedAction, getCentroid, getEnvelope, getEnvelopeInternal, getFactory, getGeometryN, getInteriorPoint, getNumGeometries, getPrecisionModel, getSRID, getUserData, hasNonEmptyElements, hasNullElements, intersection, intersects, isEquivalentClass, isValid, isWithinDistance, overlaps, relate, relate, setSRID, setUserData, symDifference, toString, toText, touches, union, within 
Methods inherited from class java.lang.Object 
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait 
Field Detail 
protected LinearRing shell
null
if this Polygon
is empty.
protected LinearRing[] holes
Constructor Detail 
public Polygon(LinearRing shell, PrecisionModel precisionModel, int SRID)
Polygon
with the given exterior boundary.
shell
 the outer boundary of the new Polygon
,
or null
or an empty LinearRing
if the empty
geometry is to be created.precisionModel
 the specification of the grid of allowable points
for this Polygon
SRID
 the ID of the Spatial Reference System used by this
Polygon
public Polygon(LinearRing shell, LinearRing[] holes, PrecisionModel precisionModel, int SRID)
Polygon
with the given exterior boundary and
interior boundaries.
shell
 the outer boundary of the new Polygon
,
or null
or an empty LinearRing
if the empty
geometry is to be created.holes
 the inner boundaries of the new Polygon
, or null
or empty LinearRing
s if the empty
geometry is to be created.precisionModel
 the specification of the grid of allowable points
for this Polygon
SRID
 the ID of the Spatial Reference System used by this
Polygon
public Polygon(LinearRing shell, LinearRing[] holes, GeometryFactory factory)
Polygon
with the given exterior boundary and
interior boundaries.
shell
 the outer boundary of the new Polygon
,
or null
or an empty LinearRing
if the empty
geometry is to be created.holes
 the inner boundaries of the new Polygon
, or null
or empty LinearRing
s if the empty
geometry is to be created.Method Detail 
public Coordinate getCoordinate()
Geometry
Geometry
.
getCoordinate
in class Geometry
Coordinate
which is a vertex of this Geometry
.
Returns null
if this Geometry is emptypublic Coordinate[] getCoordinates()
Geometry
Geometry
s vertices. If you modify the coordinates
in this array, be sure to call #geometryChanged afterwards.
The Geometry
s contained by composite Geometry
s
must be Geometry's; that is, they must implement getCoordinates
.
getCoordinates
in class Geometry
Geometry
public int getNumPoints()
Geometry
Geometry
s vertices. The Geometry
s contained by composite Geometry
s must be
Geometry's; that is, they must implement getNumPoints
getNumPoints
in class Geometry
Geometry
public int getDimension()
Geometry
Geometry
.
getDimension
in class Geometry
public int getBoundaryDimension()
Geometry
Geometry
s inherent boundary.
getBoundaryDimension
in class Geometry
Dimension.FALSE
if the boundary is the empty geometry.public boolean isEmpty()
Geometry
Geometry
is
empty.
isEmpty
in class Geometry
true
if this Geometry
equals the empty
geometrypublic boolean isSimple()
isSimple
in class Geometry
true
Geometry.isValid()
public boolean isRectangle()
isRectangle
in class Geometry
public LineString getExteriorRing()
public int getNumInteriorRing()
public LineString getInteriorRingN(int n)
public java.lang.String getGeometryType()
Geometry
com.vivid.jts.geom
interface.
getGeometryType
in class Geometry
Geometry
s most specific com.vividsolutions.jts.geom
interfacepublic double getArea()
Polygon
getArea
in class Geometry
public double getLength()
Polygon
getLength
in class Geometry
public Geometry getBoundary()
getBoundary
in class Geometry
Geometry.getBoundary()
protected Envelope computeEnvelopeInternal()
Geometry
Geometry
, or a null Envelope
if this Geometry
is empty.
Unlike getEnvelopeInternal
, this method calculates the Envelope
each time it is called; getEnvelopeInternal
caches the result
of this method.
computeEnvelopeInternal
in class Geometry
Geometry
s bounding box; if the Geometry
is empty, Envelope#isNull
will return true
public boolean equalsExact(Geometry other, double tolerance)
Geometry
Geometry
s are exactly equal,
up to a specified distance tolerance.
Two Geometries are exactly equal within a distance tolerance
if and only if:
Geometry
s are
composites and any children are not Geometry
s, returns
false
.
equalsExact
in class Geometry
other
 the Geometry
with which to compare this Geometry
true
if this and the other Geometry
are of the same class and have equal internal data.public void apply(CoordinateFilter filter)
Geometry
Geometry
's
coordinates.
If this method modifies any coordinate values,
#geometryChanged() must be called to update the geometry state.
Note that you cannot use this
method to
modify this Geometry if its underlying CoordinateSequence's #get method
returns a copy of the Coordinate, rather than the actual Coordinate stored
(if it even stores Coordinates at all).
apply
in class Geometry
filter
 the filter to apply to this Geometry
's
coordinatespublic void apply(CoordinateSequenceFilter filter)
Geometry
Geometry
's
CoordinateSequence
s.
If this method modifies any coordinate values,
#geometryChanged() must be called to update the geometry state.
apply
in class Geometry
filter
 the filter to applypublic void apply(GeometryFilter filter)
Geometry
Geometry
and its
subelement Geometry
s (if any).
Only GeometryCollections and subclasses
have subelement Geometry's.
apply
in class Geometry
filter
 the filter to apply to this Geometry
(and
its children, if it is a GeometryCollection
).public void apply(GeometryComponentFilter filter)
Geometry
apply
in class Geometry
filter
 the filter to apply to this Geometry
.public java.lang.Object clone()
Polygon
object.
(including all coordinates contained by it).
clone
in class Geometry
public Geometry convexHull()
Geometry
Polygon
that contains all the
points in the Geometry
. This obviously applies only to Geometry
s which contain 3 or more points; the results for degenerate cases are
specified as follows:
Number of Point s in argument Geometry 
Geometry class of result 

0  empty GeometryCollection 
1  Point 
2  LineString 
3 or more  Polygon 
convexHull
in class Geometry
Geometry
'
s pointspublic void normalize()
Geometry
Geometry
to normal form (or
canonical form ). Normal form is a unique representation for Geometry
s. It can be used to test whether two Geometry
s are equal
in a way that is independent of the ordering of the coordinates within
them. Normal form equality is a stronger condition than topological
equality, but weaker than pointwise equality. The definitions for normal
form use the standard lexicographical ordering for coordinates. "Sorted in
order of coordinates" means the obvious extension of this ordering to
sequences of coordinates.
normalize
in class Geometry
protected int compareToSameClass(java.lang.Object o)
Geometry
Geometry
is greater than, equal to,
or less than another Geometry
having the same class.
compareToSameClass
in class Geometry
o
 a Geometry
having the same class as this Geometry
o
, as
defined in "Normal Form For Geometry" in the JTS Technical
Specificationsprotected int compareToSameClass(java.lang.Object o, CoordinateSequenceComparator comp)
Geometry
Geometry
is greater than, equal to,
or less than another Geometry
of the same class.
using the given CoordinateSequenceComparator
.
compareToSameClass
in class Geometry
o
 a Geometry
having the same class as this Geometry
comp
 a CoordinateSequenceComparator
o
, as
defined in "Normal Form For Geometry" in the JTS Technical
Specifications


PREV CLASS NEXT CLASS  FRAMES NO FRAMES  
SUMMARY: NESTED  FIELD  CONSTR  METHOD  DETAIL: FIELD  CONSTR  METHOD 