IPointSet.hpp

#pragma once
 
#include "DM/config.hpp"
#include "DM/IAddInfoLayout.hpp"
#include "DM/Handle.hpp"
#include "DM/IGeometry.hpp"
#include "DM/IAddInfo.hpp"
#include "DM/IAddInfoContainer.hpp"
#include "DM/IPoint.hpp"
#include "DM/Iterator.hpp"
#include "DM/AutoLink.hpp" //enable autolink
 
DM_NAMESPACE_BEGIN
 
/// \brief a set of 3d point object
class DM_API IPointSet : public IGeometry
{
public:
  typedef ConstIterator<IPoint>    const_iterator_point;      ///< Point iterator
 
  ///create a new point set with size points   
  static IPointSet* New(unsigned size = 0);
 
  IPointSet* clone() const override = 0;
 
protected:
  virtual ~IPointSet() {}
 
public:
  virtual unsigned sizePoint() const = 0; ///< number of points within the set
  virtual void reservePoint(unsigned size) = 0;       ///< reserve memory for points
  virtual void resizePoint(unsigned resize) = 0;      ///< resize memory for points
  virtual void removePoint(unsigned) = 0;             ///< remove points at the given index
  virtual void clearPoint() = 0;                      ///< remove all points from point set
  virtual void addPoint(const DM::IPoint &pt) = 0;
  virtual void addPoint(const DM::PointHandle &pt) = 0;
  virtual void addPoint(double x, double y, double z) = 0;
 
  /// \brief sorting points by distance to given reference point 
  /**
    \param[in] refPt      reference point used for distance computation
    \param[in] dim        dimension of distance (2 = 2d distance, 3 = 3d distance)  
    \param[in] ascending  sort in ascending or descending order
  */
  virtual void sortByDistance(const DM::IPoint &refPt, int dim, bool ascending = true) = 0;
  /// \brief sorting points by distance to given reference point and remove points that exceeds a certain distance
  /**
    \param[in] refPt       reference point used for distance computation
    \param[in] dim         dimension of distance (2 = 2d distance, 3 = 3d distance)
    \param[in] maxDistance all points that are further away than the given distance are dropped 
    \param[in] ascending  sort in ascending or descending order
  */
  virtual void sortByDistanceAndClip(const DM::IPoint &refPt, int dim, double maxDistance, bool ascending = true) = 0;
 
  virtual const_iterator_point beginPoint() const = 0;
  virtual const_iterator_point endPoint() const = 0;
 
  virtual const IPoint& operator[](unsigned) const = 0;
  virtual IPoint& operator[](unsigned) = 0;
 
  virtual const PointHandle& operator()(unsigned idx) const = 0;
  virtual PointHandle& operator()(unsigned idx) = 0;
};
 
typedef Handle< IPointSet > PointSetHandle;
 
DM_NAMESPACE_END