Class GeometryFactory

public GeometryFactory(CoordinateSequenceFactory coordinateSequenceFactory)

Constructs a GeometryFactory that generates Geometries having the given CoordinateSequence implementation, a double-precision floating PrecisionModel and a spatial-reference ID of 0.

public GeometryFactory(PrecisionModel precisionModel)

Constructs a GeometryFactory that generates Geometries having the given PrecisionModel and the default CoordinateSequence implementation.

Parameters:

precisionModel - the PrecisionModel to use

public GeometryFactory(PrecisionModel precisionModel,
                       int SRID)

Constructs a GeometryFactory that generates Geometries having the given PrecisionModel and spatial-reference ID, and the default CoordinateSequence implementation.

Parameters:

precisionModel - the PrecisionModel to use

SRID - the SRID to use

public GeometryFactory(PrecisionModel precisionModel,
                       int SRID,
                       CoordinateSequenceFactory coordinateSequenceFactory)

Constructs a GeometryFactory that generates Geometries having the given PrecisionModel, spatial-reference ID, and CoordinateSequence implementation.

public Geometry buildGeometry(Collection geomList)

Build an appropriate Geometry, MultiGeometry, or GeometryCollection to contain the Geometrys in it. For example:

• If geomList contains a single Polygon, the Polygon is returned.
• If geomList contains several Polygons, a MultiPolygon is returned.
• If geomList contains some Polygons and some LineStrings, a GeometryCollection is returned.
• If geomList is empty, an empty GeometryCollection is returned

Note that this method does not "flatten" Geometries in the input, and hence if any MultiGeometries are contained in the input a GeometryCollection containing them will be returned.

Parameters:

geomList - the Geometrys to combine

Returns:

a Geometry of the "smallest", "most type-specific" class that can contain the elements of geomList .

public Geometry createGeometry(Geometry g)

Returns:

a clone of g based on a CoordinateSequence created by this GeometryFactory's CoordinateSequenceFactory

public GeometryCollection createGeometryCollection(Geometry[] geometries)

Creates a GeometryCollection using the given Geometries; a null or empty array will create an empty GeometryCollection.

Parameters:

geometries - Geometries, each of which may be empty but not null

public LineString createLineString(CoordinateSequence coordinates)

Creates a LineString using the given CoordinateSequence; a null or empty CoordinateSequence will create an empty LineString. Consecutive points must not be equal.

Parameters:

coordinates - a CoordinateSequence possibly empty, or null

public LineString createLineString(Coordinate[] coordinates)

Creates a LineString using the given Coordinates; a null or empty array will create an empty LineString. Consecutive points must not be equal.

Parameters:

coordinates - an array without null elements, or an empty array, or null

public LinearRing createLinearRing(CoordinateSequence coordinates)

Creates a LinearRing using the given CoordinateSequence; a null or empty CoordinateSequence will create an empty LinearRing. The points must form a closed and simple linestring. Consecutive points must not be equal.

Parameters:

coordinates - a CoordinateSequence possibly empty, or null

public LinearRing createLinearRing(Coordinate[] coordinates)

Creates a LinearRing using the given Coordinates; a null or empty array will create an empty LinearRing. The points must form a closed and simple linestring. Consecutive points must not be equal.

Parameters:

coordinates - an array without null elements, or an empty array, or null

public MultiLineString createMultiLineString(LineString[] lineStrings)

Creates a MultiLineString using the given LineStrings; a null or empty array will create an empty MultiLineString.

Parameters:

lineStrings - LineStrings, each of which may be empty but not null

public MultiPoint createMultiPoint(CoordinateSequence coordinates)

Creates a MultiPoint using the given CoordinateSequence; a null or empty CoordinateSequence will create an empty MultiPoint.

Parameters:

coordinates - a CoordinateSequence possibly empty, or null

public MultiPoint createMultiPoint(Coordinate[] coordinates)

Creates a MultiPoint using the given Coordinates; a null or empty array will create an empty MultiPoint.

Parameters:

coordinates - an array without null elements, or an empty array, or null

public MultiPoint createMultiPoint(Point[] point)

Creates a MultiPoint using the given Points; a null or empty array will create an empty MultiPoint.

Parameters:

public MultiPolygon createMultiPolygon(Polygon[] polygons)

Creates a MultiPolygon using the given Polygons; a null or empty array will create an empty Polygon. The polygons must conform to the assertions specified in the OpenGIS Simple Features Specification for SQL.

Parameters:

polygons - Polygons, each of which may be empty but not null

public Point createPoint(Coordinate coordinate)

Creates a Point using the given Coordinate; a null Coordinate will create an empty Geometry.

public Point createPoint(CoordinateSequence coordinates)

Creates a Point using the given CoordinateSequence; a null or empty CoordinateSequence will create an empty Point.

public static Point createPointFromInternalCoord(Coordinate coord,
                                                 Geometry exemplar)

public Polygon createPolygon(LinearRing shell,
                             LinearRing[] holes)

Constructs a Polygon with the given exterior boundary and interior boundaries.

Parameters:

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.

public CoordinateSequenceFactory getCoordinateSequenceFactory()

public PrecisionModel getPrecisionModel()

Returns the PrecisionModel that Geometries created by this factory will be associated with.

public Geometry toGeometry(Envelope envelope)

If the Envelope is a null Envelope, returns an empty Point. If the Envelope is a point, returns a non-empty Point. If the Envelope is a rectangle, returns a Polygon whose points are (minx, miny), (maxx, miny), (maxx, maxy), (minx, maxy), (minx, miny).

Parameters:

envelope - the Envelope to convert to a Geometry

Returns:

an empty Point (for null Envelope s), a Point (when min x = max x and min y = max y) or a Polygon (in all other cases)

public static Geometry[] toGeometryArray(Collection geometries)

Converts the List to an array.

Parameters:

geometries - the list of Geometry's to convert

Returns:

the List in array format

public static LineString[] toLineStringArray(Collection lineStrings)

Converts the List to an array.

Parameters:

lineStrings - the List of LineStrings to convert

Returns:

the List in array format

public static LinearRing[] toLinearRingArray(Collection linearRings)

Converts the List to an array.

Parameters:

linearRings - the List of LinearRings to convert

Returns:

the List in array format

public static MultiLineString[] toMultiLineStringArray(Collection multiLineStrings)

Converts the List to an array.

Parameters:

multiLineStrings - the List of MultiLineStrings to convert

Returns:

the List in array format

public static MultiPoint[] toMultiPointArray(Collection multiPoints)

Converts the List to an array.

Parameters:

multiPoints - the List of MultiPoints to convert

Returns:

the List in array format

public static MultiPolygon[] toMultiPolygonArray(Collection multiPolygons)

Converts the List to an array.

Parameters:

multiPolygons - the List of MultiPolygons to convert

Returns:

the List in array format

public static Point[] toPointArray(Collection points)

Converts the List to an array.

Parameters:

points - the List of Points to convert

Returns:

the List in array format

public static Polygon[] toPolygonArray(Collection polygons)

Converts the List to an array.

Parameters:

polygons - the List of Polygons to convert

Returns:

the List in array format