CommonFunctions.h

Go to the documentation of this file.

/*  Copyright (C) 2008 National Institute For Space Research (INPE) - Brazil.
 
    This file is part of the TerraLib - a Framework for building GIS enabled applications.
 
    TerraLib is free software: you can redistribute it and/or modify
    it under the terms of the GNU Lesser General Public License as published by
    the Free Software Foundation, either version 3 of the License,
    or (at your option) any later version.
 
    TerraLib is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    GNU Lesser General Public License for more details.
 
    You should have received a copy of the GNU Lesser General Public License
    along with TerraLib. See COPYING. If not, write to
    TerraLib Team at <terralib-team@terralib.org>.
 */
 
 /*!
   \file terralib/vp/CommonDataStructures.h
 
   \brief Utility classes, structures and definitions for Vector Processing.
 */
 
#ifndef __TERRALIB_VP_INTERNAL_COMMONFUNCTIONS_H
#define __TERRALIB_VP_INTERNAL_COMMONFUNCTIONS_H
 
//Terralib include files
#include "Config.h"
 
#include "../geometry/CommonDataStructures.h"
#include "../geometry/Enums.h"
#include "../geometry/GeometryCollection.h"
 
 
//STL include files
#include <vector>
 
namespace te
{
  namespace gm
  {
    struct Coord2D;
    class Envelope;
    class Geometry;
  }
 
  namespace vp
  {
    class Feature;
    class FeatureSet;
    class GeometryInfo;
    class SegmentInfo;
    
    
 
    /*!
      * \brief Gets the segment information related to all segments from the given geometry. An Optional filter can be used to filter the segments that will be returned
      *
      * \param geometry The geometry to be analysed
      * \param filter The optional filter
      * \param vecSegmentInfo [Return] The segments from the given geometry. The return is a parameter to make easier to create a list containing segments from several geometries
      */
    TEVPEXPORT void GetAllSegments(const te::gm::Geometry* geometry, const te::gm::Envelope& filter, std::vector<SegmentInfo>& vecSegmentInfo);
 
    /*!
      \brief Algorithm to fast detection of spatial relations between geometries. Very useful to fase dectect if two geomtries dont intercept themselves
              Sometimes can generate false positives for overlaps, but never generates false positives for disjoint and touches
 
      \param geometryA The input geometry A
      \param geometryB The input geometry B
 
      \return The detected spatial relation
    */
    TEVPEXPORT te::gm::SpatialRelation FastRelationCalculator(const te::vp::GeometryInfo * geometryInfoA, const te::vp::GeometryInfo* geometryInfoB);
 
    /*!
      \brief Algorithm to fast detection of spatial relations between geometries. Very useful to fase dectect if two geomtries dont intercept themselves
              Sometimes can generate false positives for overlaps, but never generates false positives for disjoint and touches
 
      \param geometryA The input geometry A
      \param geometryB The input geometry B
 
      \return The detected spatial relation
    */
    TEVPEXPORT te::gm::SpatialRelation FastRelationCalculator(const te::gm::Geometry* geometryA, const te::gm::Geometry* geometryB);
 
    //!< Discards all the features from the set that have null or empty geometries
    TEVPEXPORT void DiscardFeaturesWithNullAndEmptyGeometries(te::vp::FeatureSet& featureSet);
 
    //!< Splits all feature that have geometry collections in to features that have single type geometries. All the attributes are copied
    TEVPEXPORT void Multi2Single(const te::vp::Feature* feature, te::vp::FeatureSet& singleFeatureSet);
 
    //!< Splits all the features that have geometry collections in to features that have single type geometries. All the attributes are copied
    TEVPEXPORT void Multi2Single(const te::vp::FeatureSet& featureSet, te::vp::FeatureSet& singleFeatureSet);
 
    /*!
      \brief Adjust the given geometry to the given geometry type.
      \param inGeomPtr Input geometry.
      \param targetGeomType Target geometry type.
      \return A vector of converted geometries or, if the conversion is not possible, an empty vector is returned.
      \note The caller must take the ownership of the returned objects.
    */
    TEVPEXPORT te::gm::GeometryVector AdjustToGeomType(const te::gm::Geometry* inGeomPtr, te::gm::GeomType targetGeomType);
 
    /*!
      \brief Adjust the given geometries to the given geometry type.
      \param vecGeometries Input geometries vector.
      \param targetGeomType Target geometry type.
      \return A vector of converted geometries or, if the conversion is not possible, an empty vector is returned.
      \note The caller must take the ownership of the returned objects.
    */
    template< typename GeometryTypeT >
    te::gm::GeometryVector AdjustToGeomType(
      const std::vector< GeometryTypeT* >& vecGeometries, te::gm::GeomType geomType)
    {
      te::gm::GeometryVector result;
      for (std::size_t i = 0; i < vecGeometries.size(); ++i)
      {
        te::gm::GeometryVector currentResult = te::vp::AdjustToGeomType(
          vecGeometries.at(i), geomType);
        result.insert(result.end(), currentResult.begin(), currentResult.end());
      }
 
      return result;
    }
 
  }
}
 
 
 
#endif //__TERRALIB_VP_INTERNAL_COMMONFUNCTIONS_H