|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectcom.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 LinearRings.
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
CoordinateSequences. |
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 Geometrys (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 Geometrys 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 Geometrys 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 Geometrys 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 PolygonSRID - 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 LinearRings if the empty
geometry is to be created.precisionModel - the specification of the grid of allowable points
for this PolygonSRID - 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 LinearRings if the empty
geometry is to be created.| Method Detail |
public Coordinate getCoordinate()
GeometryGeometry.
getCoordinate in class GeometryCoordinate which is a vertex of this Geometry.
Returns null if this Geometry is emptypublic Coordinate[] getCoordinates()
GeometryGeometry s vertices. If you modify the coordinates
in this array, be sure to call #geometryChanged afterwards.
The Geometrys contained by composite Geometrys
must be Geometry's; that is, they must implement getCoordinates.
getCoordinates in class GeometryGeometrypublic int getNumPoints()
GeometryGeometrys vertices. The Geometry
s contained by composite Geometrys must be
Geometry's; that is, they must implement getNumPoints
getNumPoints in class GeometryGeometrypublic int getDimension()
GeometryGeometry.
getDimension in class Geometrypublic int getBoundaryDimension()
GeometryGeometrys inherent boundary.
getBoundaryDimension in class GeometryDimension.FALSE if the boundary is the empty geometry.public boolean isEmpty()
GeometryGeometry is
empty.
isEmpty in class Geometrytrue if this Geometry equals the empty
geometrypublic boolean isSimple()
isSimple in class GeometrytrueGeometry.isValid()public boolean isRectangle()
isRectangle in class Geometrypublic LineString getExteriorRing()
public int getNumInteriorRing()
public LineString getInteriorRingN(int n)
public java.lang.String getGeometryType()
Geometrycom.vivid.jts.geom
interface.
getGeometryType in class GeometryGeometrys most specific com.vividsolutions.jts.geom
interfacepublic double getArea()
Polygon
getArea in class Geometrypublic double getLength()
Polygon
getLength in class Geometrypublic Geometry getBoundary()
getBoundary in class GeometryGeometry.getBoundary()protected Envelope computeEnvelopeInternal()
GeometryGeometry
, 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 GeometryGeometrys bounding box; if the Geometry
is empty, Envelope#isNull will return true
public boolean equalsExact(Geometry other,
double tolerance)
GeometryGeometrys are exactly equal,
up to a specified distance tolerance.
Two Geometries are exactly equal within a distance tolerance
if and only if:
Geometrys are
composites and any children are not Geometrys, returns
false.
equalsExact in class Geometryother - 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)
GeometryGeometry'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 Geometryfilter - the filter to apply to this Geometry's
coordinatespublic void apply(CoordinateSequenceFilter filter)
GeometryGeometry's
CoordinateSequences.
If this method modifies any coordinate values,
#geometryChanged() must be called to update the geometry state.
apply in class Geometryfilter - the filter to applypublic void apply(GeometryFilter filter)
GeometryGeometry and its
subelement Geometrys (if any).
Only GeometryCollections and subclasses
have subelement Geometry's.
apply in class Geometryfilter - the filter to apply to this Geometry (and
its children, if it is a GeometryCollection).public void apply(GeometryComponentFilter filter)
Geometry
apply in class Geometryfilter - the filter to apply to this Geometry.public java.lang.Object clone()
Polygon object.
(including all coordinates contained by it).
clone in class Geometrypublic Geometry convexHull()
GeometryPolygon 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 Points in argument Geometry |
Geometry class of result |
|---|---|
| 0 | empty GeometryCollection |
| 1 | Point |
| 2 | LineString |
| 3 or more | Polygon |
convexHull in class GeometryGeometry'
s pointspublic void normalize()
GeometryGeometry to normal form (or
canonical form ). Normal form is a unique representation for Geometry
s. It can be used to test whether two Geometrys 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 Geometryprotected int compareToSameClass(java.lang.Object o)
GeometryGeometry is greater than, equal to,
or less than another Geometry having the same class.
compareToSameClass in class Geometryo - a Geometry having the same class as this Geometry
o, as
defined in "Normal Form For Geometry" in the JTS Technical
Specifications
protected int compareToSameClass(java.lang.Object o,
CoordinateSequenceComparator comp)
GeometryGeometry is greater than, equal to,
or less than another Geometry of the same class.
using the given CoordinateSequenceComparator.
compareToSameClass in class Geometryo - a Geometry having the same class as this Geometrycomp - 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 | |||||||||