/********************************************************************** * * GEOS - Geometry Engine Open Source * http://geos.osgeo.org * * Copyright (C) 2011 Sandro Santilli * Copyright (C) 2006 Refractions Research Inc. * * This is free software; you can redistribute and/or modify it under * the terms of the GNU Lesser General Public Licence as published * by the Free Software Foundation. * See the COPYING file for more information. * ********************************************************************** * * Last port: geom/GeometryFactory.java r320 (JTS-1.12) * **********************************************************************/ #pragma once #include #include #include #include #include #include #include #include #include #include #include #include namespace geos { namespace geom { class Coordinate; class CoordinateSequence; class Envelope; class Geometry; class GeometryCollection; class LineString; class LinearRing; class MultiLineString; class MultiPoint; class MultiPolygon; class Polygon; } } namespace geos { namespace geom { // geos::geom /** * \brief * Supplies a set of utility methods for building Geometry objects * from CoordinateSequence or other Geometry objects. * * Note that the factory constructor methods do not change the input * coordinates in any way. * In particular, they are not rounded to the supplied PrecisionModel. * It is assumed that input Coordinates meet the given precision. */ class GEOS_DLL GeometryFactory { private: struct GeometryFactoryDeleter { void operator()(GeometryFactory* p) const { p->destroy(); } }; public: using Ptr = std::unique_ptr; /** * \brief * Constructs a GeometryFactory that generates Geometries having a * floating PrecisionModel and a spatial-reference ID of 0. */ static GeometryFactory::Ptr create(); /** * \brief * Constructs a GeometryFactory that generates Geometries having * the given PrecisionModel and the default CoordinateSequence * implementation. * * @param pm the PrecisionModel to use */ static GeometryFactory::Ptr create(const PrecisionModel* pm); /** * \brief * Constructs a GeometryFactory that generates Geometries having * the given {@link PrecisionModel} and spatial-reference ID, * and the default CoordinateSequence implementation. * * @param pm the PrecisionModel to use, will be copied internally * @param newSRID the SRID to use */ static GeometryFactory::Ptr create(const PrecisionModel* pm, int newSRID); /** * \brief Copy constructor * * @param gf the GeometryFactory to clone from */ static GeometryFactory::Ptr create(const GeometryFactory& gf); /** * \brief * Return a pointer to the default GeometryFactory. * This is a global shared object instantiated * using default constructor. */ static const GeometryFactory* getDefaultInstance(); //Skipped a lot of list to array convertors static std::unique_ptr createPointFromInternalCoord(const Coordinate* coord, const Geometry* exemplar); /// Converts an Envelope to a Geometry. /// /// Returned Geometry can be a Point, a Polygon or an EMPTY geom. /// std::unique_ptr toGeometry(const Envelope* envelope) const; /// \brief /// Returns the PrecisionModel that Geometries created by this /// factory will be associated with. const PrecisionModel* getPrecisionModel() const { return &precisionModel; }; /// Creates an EMPTY Point std::unique_ptr createPoint(std::size_t coordinateDimension = 2) const; /// Creates a Point using the given Coordinate std::unique_ptr createPoint(const Coordinate& coordinate) const; std::unique_ptr createPoint(const CoordinateXY& coordinate) const; std::unique_ptr createPoint(const CoordinateXYM& coordinate) const; std::unique_ptr createPoint(const CoordinateXYZM& coordinate) const; /// Creates a Point taking ownership of the given CoordinateSequence std::unique_ptr createPoint(std::unique_ptr&& coordinates) const; /// Creates a Point with a deep-copy of the given CoordinateSequence. std::unique_ptr createPoint(const CoordinateSequence& coordinates) const; /// Construct an EMPTY GeometryCollection std::unique_ptr createGeometryCollection() const; /// Construct the EMPTY Geometry std::unique_ptr createEmptyGeometry() const; /// Construct a GeometryCollection taking ownership of given arguments template std::unique_ptr createGeometryCollection( std::vector> && newGeoms) const { // Can't use make_unique because constructor is protected return std::unique_ptr(new GeometryCollection(Geometry::toGeometryArray(std::move(newGeoms)), *this)); } /// Constructs a GeometryCollection with a deep-copy of args std::unique_ptr createGeometryCollection( const std::vector& newGeoms) const; /// Construct an EMPTY MultiLineString std::unique_ptr createMultiLineString() const; /// Construct a MultiLineString with a deep-copy of given arguments std::unique_ptr createMultiLineString( const std::vector& fromLines) const; /// Construct a MultiLineString taking ownership of given arguments std::unique_ptr createMultiLineString( std::vector> && fromLines) const; std::unique_ptr createMultiLineString( std::vector> && fromLines) const; /// Construct an EMPTY MultiPolygon std::unique_ptr createMultiPolygon() const; /// Construct a MultiPolygon with a deep-copy of given arguments std::unique_ptr createMultiPolygon( const std::vector& fromPolys) const; /// Construct a MultiPolygon taking ownership of given arguments std::unique_ptr createMultiPolygon( std::vector> && fromPolys) const; std::unique_ptr createMultiPolygon( std::vector> && fromPolys) const; /// Construct an EMPTY LinearRing std::unique_ptr createLinearRing(std::size_t coordinateDimension = 2) const; /// Construct a LinearRing taking ownership of given arguments std::unique_ptr createLinearRing( std::unique_ptr && newCoords) const; /// Construct a LinearRing with a deep-copy of given arguments std::unique_ptr createLinearRing( const CoordinateSequence& coordinates) const; /// Constructs an EMPTY MultiPoint. std::unique_ptr createMultiPoint() const; template std::unique_ptr createMultiPoint(const T& fromCoords) const { std::vector> pts; pts.reserve(fromCoords.size()); for (const auto& c : fromCoords) { pts.emplace_back(createPoint(c)); } return createMultiPoint(std::move(pts)); } /// Construct a MultiPoint taking ownership of given arguments std::unique_ptr createMultiPoint(std::vector> && newPoints) const; std::unique_ptr createMultiPoint(std::vector> && newPoints) const; /// Construct a MultiPoint with a deep-copy of given arguments std::unique_ptr createMultiPoint( const std::vector& fromPoints) const; /// \brief /// Construct a MultiPoint containing a Point geometry /// for each Coordinate in the given list. std::unique_ptr createMultiPoint( const CoordinateSequence& fromCoords) const; /// Construct an EMPTY Polygon std::unique_ptr createPolygon(std::size_t coordinateDimension = 2) const; /// Construct a Polygon taking ownership of given arguments std::unique_ptr createPolygon(std::unique_ptr && shell) const; std::unique_ptr createPolygon(std::unique_ptr && shell, std::vector> && holes) const; /// Construct a Polygon from a Coordinate vector, taking ownership of the vector std::unique_ptr createPolygon(CoordinateSequence && coords) const; /// Construct a Polygon with a deep-copy of given arguments Polygon* createPolygon(const LinearRing& shell, const std::vector& holes) const; /// Construct an EMPTY LineString std::unique_ptr createLineString(std::size_t coordinateDimension = 2) const; /// Copy a LineString std::unique_ptr createLineString(const LineString& ls) const; /// Construct a LineString taking ownership of given argument std::unique_ptr createLineString( std::unique_ptr && coordinates) const; /// Construct a LineString with a deep-copy of given argument std::unique_ptr createLineString( const CoordinateSequence& coordinates) const; /** * Creates an empty atomic geometry of the given dimension. * If passed a dimension of -1 will create an empty {@link GeometryCollection}. * * @param dimension the required dimension (-1, 0, 1 or 2) * @return an empty atomic geometry of given dimension */ std::unique_ptr createEmpty(int dimension) const; /** * Creates an empty atomic geometry of the given type. * @param typeId the desired GeometryTypeId * @return an empty atomic geometry of given dimension */ std::unique_ptr createEmpty(GeometryTypeId typeId) const; std::unique_ptr createMulti(std::unique_ptr && geom) const; /** * 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. * * @param geoms the Geometrys to combine * * @return A Geometry of the "smallest", "most type-specific" * class that can contain the elements of geomList. * * NOTE: the returned Geometry will take ownership of the * given vector AND its elements */ std::unique_ptr buildGeometry(std::vector> && geoms) const; std::unique_ptr buildGeometry(std::vector> && geoms) const; std::unique_ptr buildGeometry(std::vector> && geoms) const; std::unique_ptr buildGeometry(std::vector> && geoms) const; /// See buildGeometry(std::vector&) for semantics // /// Will clone the geometries accessible trough the iterator. /// /// @tparam T an iterator yielding something which casts to const Geometry* /// @param from start iterator /// @param toofar end iterator /// template std::unique_ptr buildGeometry(T from, T toofar) const { bool isHeterogeneous = false; std::size_t count = 0; int geomClass = -1; for(T i = from; i != toofar; ++i) { ++count; const Geometry* g = *i; if(geomClass < 0) { geomClass = g->getSortIndex(); } else if(geomClass != g->getSortIndex()) { isHeterogeneous = true; } } // for the empty geometry, return an empty GeometryCollection if(count == 0) { return std::unique_ptr(createGeometryCollection()); } // for the single geometry, return a clone if(count == 1) { return (*from)->clone(); } // Now we know it is a collection // FIXME: // Until we tweak all the createMulti* interfaces // to support taking iterators we'll have to build // a custom vector here. std::vector> fromGeoms; for(T i = from; i != toofar; ++i) { fromGeoms.push_back((*i)->clone()); } // for an heterogeneous ... if(isHeterogeneous) { return createGeometryCollection(std::move(fromGeoms)); } // At this point we know the collection is not hetereogenous. switch((*from)->getDimension()) { case Dimension::A: return createMultiPolygon(std::move(fromGeoms)); case Dimension::L: return createMultiLineString(std::move(fromGeoms)); case Dimension::P: return createMultiPoint(std::move(fromGeoms)); default: throw geos::util::IllegalArgumentException(std::string("Invalid geometry type.")); } } /** \brief * This function does the same thing of the omonimouse function * taking vector pointer instead of reference. * * The difference is that this version will copy needed data * leaving ownership to the caller. */ std::unique_ptr buildGeometry(const std::vector& geoms) const; int getSRID() const { return SRID; }; /// Returns a clone of given Geometry. std::unique_ptr createGeometry(const Geometry* g) const; /// Destroy a Geometry, or release it void destroyGeometry(Geometry* g) const; /// Request that the instance is deleted. /// /// It will really be deleted only after last child Geometry is /// deleted. Do not use the instance anymore after calling this function /// (unless you're a live child!). /// void destroy(); protected: /** * \brief * Constructs a GeometryFactory that generates Geometries having a * floating PrecisionModel and a spatial-reference ID of 0. */ GeometryFactory(); /** * \brief * Constructs a GeometryFactory that generates Geometries having * the given PrecisionModel and the default CoordinateSequence * implementation. * * @param pm the PrecisionModel to use */ GeometryFactory(const PrecisionModel* pm); /** * \brief * Constructs a GeometryFactory that generates Geometries having * the given {@link PrecisionModel} and spatial-reference ID, * and the default CoordinateSequence implementation. * * @param pm the PrecisionModel to use, will be copied internally * @param newSRID the SRID to use */ GeometryFactory(const PrecisionModel* pm, int newSRID); /** * \brief Copy constructor * * @param gf the GeometryFactory to clone from */ GeometryFactory(const GeometryFactory& gf); /// Destructor virtual ~GeometryFactory(); private: PrecisionModel precisionModel; int SRID; mutable int _refCount; bool _autoDestroy; friend class Geometry; void addRef() const; void dropRef() const; }; } // namespace geos::geom } // namespace geos