Class GeometryCollection

protected Geometry[] geometries

Internal representation of this GeometryCollection.

public GeometryCollection(Geometry[] geometries,
                          GeometryFactory factory)

Parameters:

geometries - the Geometrys for this GeometryCollection, or null or an empty array to create the empty geometry. Elements may be empty Geometrys, but not nulls.

public GeometryCollection(Geometry[] geometries,
                          PrecisionModel precisionModel,
                          int SRID)

Deprecated. Use GeometryFactory instead

public void apply(CoordinateFilter filter)

Performs an operation with or on this Geometry's coordinates. If you are using this method to modify the geometry, be sure to call #geometryChanged() afterwards. 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).

Overrides:

apply in interface Geometry

Parameters:

filter - the filter to apply to this Geometry's coordinates

public void apply(GeometryComponentFilter filter)

Performs an operation with or on this Geometry and its component Geometry's. Only GeometryCollections and Polygons have component Geometry's; for Polygons they are the LinearRings of the shell and holes.

Overrides:

apply in interface Geometry

Parameters:

filter - the filter to apply to this Geometry.

public void apply(GeometryFilter filter)

Performs an operation with or on this Geometry and its subelement Geometrys (if any). Only GeometryCollections and subclasses have subelement Geometry's.

Overrides:

apply in interface Geometry

Parameters:

filter - the filter to apply to this Geometry (and its children, if it is a GeometryCollection).

public Object clone()

Overrides:

clone in interface Geometry

protected int compareToSameClass(Object o)

Returns whether this Geometry is greater than, equal to, or less than another Geometry having the same class.

Overrides:

compareToSameClass in interface Geometry

Parameters:

o - a Geometry having the same class as this Geometry

Returns:

a positive number, 0, or a negative number, depending on whether this object is greater than, equal to, or less than o, as defined in "Normal Form For Geometry" in the JTS Technical Specifications

protected int compareToSameClass(Object o,
                                 CoordinateSequenceComparator comp)

Returns whether this Geometry is greater than, equal to, or less than another Geometry of the same class. using the given CoordinateSequenceComparator.

Overrides:

compareToSameClass in interface Geometry

Parameters:

o - a Geometry having the same class as this Geometry

comp - a CoordinateSequenceComparator

Returns:

a positive number, 0, or a negative number, depending on whether this object is greater than, equal to, or less than o, as defined in "Normal Form For Geometry" in the JTS Technical Specifications

protected Envelope computeEnvelopeInternal()

Returns the minimum and maximum x and y values in this 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.

Overrides:

computeEnvelopeInternal in interface Geometry

Returns:

this Geometrys bounding box; if the Geometry is empty, Envelope#isNull will return true

public boolean equalsExact(Geometry other,
                           double tolerance)

Returns true if the two Geometrys are exactly equal, up to a specified distance tolerance. Two Geometries are exactly equal within a distance tolerance if and only if:

• they have the same class
• they have the same values for their vertices, within the given tolerance distance, in exactly the same order.

If this and the other Geometrys are composites and any children are not Geometrys, returns false.

Overrides:

equalsExact in interface Geometry

Parameters:

other - the Geometry with which to compare this Geometry

Returns:

true if this and the other Geometry are of the same class and have equal internal data.

public double getArea()

Returns the area of this GeometryCollection

Overrides:

getArea in interface Geometry

Returns:

the area of the polygon

public Geometry getBoundary()

Returns the boundary, or the empty geometry if this Geometry is empty. For a discussion of this function, see the OpenGIS Simple Features Specification. As stated in SFS Section 2.1.13.1, "the boundary of a Geometry is a set of Geometries of the next lower dimension."

Overrides:

getBoundary in interface Geometry

Returns:

the closure of the combinatorial boundary of this Geometry

public int getBoundaryDimension()

Returns the dimension of this Geometrys inherent boundary.

Overrides:

getBoundaryDimension in interface Geometry

Returns:

the dimension of the boundary of the class implementing this interface, whether or not this object is the empty geometry. Returns Dimension.FALSE if the boundary is the empty geometry.

public Coordinate getCoordinate()

Returns a vertex of this Geometry.

Overrides:

getCoordinate in interface Geometry

Returns:

a Coordinate which is a vertex of this Geometry. Returns null if this Geometry is empty

public Coordinate[] getCoordinates()

Collects all coordinates of all subgeometries into an Array. Note that while changes to the coordinate objects themselves may modify the Geometries in place, the returned Array as such is only a temporary container which is not synchronized back.

Overrides:

getCoordinates in interface Geometry

Returns:

the collected coordinates

public int getDimension()

Returns the dimension of this Geometry.

Overrides:

getDimension in interface Geometry

Returns:

the dimension of the class implementing this interface, whether or not this object is the empty geometry

public Geometry getGeometryN(int n)

Returns an element Geometry from a GeometryCollection (or this, if the geometry is not a collection).

Overrides:

getGeometryN in interface Geometry

Parameters:

n - the index of the geometry element

Returns:

the n'th geometry contained in this geometry

public String getGeometryType()

Returns the name of this object's com.vivid.jts.geom interface.

Overrides:

getGeometryType in interface Geometry

Returns:

the name of this Geometrys most specific com.vividsolutions.jts.geom interface

public double getLength()

Returns the length of this Geometry. Linear geometries return their length. Areal geometries return their perimeter. They override this function to compute the area. Others return 0.0

Overrides:

getLength in interface Geometry

Returns:

the length of the Geometry

public int getNumGeometries()

Returns the number of Geometrys in a GeometryCollection (or 1, if the geometry is not a collection).

Overrides:

getNumGeometries in interface Geometry

Returns:

the number of geometries contained in this geometry

public int getNumPoints()

Returns the count of this Geometrys vertices. The Geometry s contained by composite Geometrys must be Geometry's; that is, they must implement getNumPoints

Overrides:

getNumPoints in interface Geometry

Returns:

the number of vertices in this Geometry

public boolean isEmpty()

Returns whether or not the set of points in this Geometry is empty.

Overrides:

isEmpty in interface Geometry

Returns:

true if this Geometry equals the empty geometry

public boolean isSimple()

Tests whether this Geometry is simple. In general, the SFS specification of simplicity follows the rule:

• A Geometry is simple iff the only self-intersections are at boundary points.

Simplicity is defined for each Geometry subclass as follows:

• Valid polygonal geometries are simple by definition, so isSimple trivially returns true.
• Linear geometries are simple iff they do not self-intersect at points other than boundary points.
• Zero-dimensional geometries (points) are simple iff they have no repeated points.
• Empty Geometrys are always simple

Overrides:

isSimple in interface Geometry

Returns:

true if this Geometry has any points of self-tangency, self-intersection or other anomalous points

See Also:

Geometry.isValid()

public void normalize()

Converts this Geometry 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.

Overrides:

normalize in interface Geometry