IPolylineFactory.hpp

#pragma once
 
#include "DM/config.hpp"
#include "DM/Handle.hpp"
#include "DM/IPolyline.hpp"
#include "DM/AutoLink.hpp" //enable autolink
 
DM_NAMESPACE_BEGIN
 
 
/// \brief factory interface for creating polyline objects
/** Polyline may consists of multiple independent lines. Although line part may be closed, the objects 
    does not represent the enclosed area. The object remains a linear object. For describing areas use
    polygons.
*/
class DM_API IPolylineFactory : public ObjectBase
{
public:
 
  /// \brief functor class to only add certain parts to the polyline factory
  class  IPartFunctor : public ObjectBase {
  protected:
    virtual ~IPartFunctor() {}
  
  public:
    virtual bool operator()(const IPolyline::IPart &part) const = 0;
  };
 
  static IPolylineFactory* New();
 
protected:
  virtual ~IPolylineFactory() {}
 
public:
  virtual void clear() = 0;
  virtual void reservePoint(unsigned size) = 0; ///< reserve memory for points
 
  virtual IPolylineFactory& addPoint(const IPoint &pt) = 0;
  virtual IPolylineFactory& addPoint(PointHandle pt) = 0;
  virtual IPolylineFactory& addPoint(double x, double y) = 0;
  virtual IPolylineFactory& addPoint(double x, double y, double z) = 0;
 
  virtual IPolylineFactory& insertPoint(unsigned idx, const IPoint &pt) = 0;
  virtual IPolylineFactory& insertPoint(unsigned idx, PointHandle pt) = 0;
  virtual IPolylineFactory& insertPoint(unsigned idx, double x, double y) = 0;
  virtual IPolylineFactory& insertPoint(unsigned idx, double x, double y, double z) = 0;
 
  virtual IPolylineFactory& addPolyline(const IPolyline &line, bool mergeConnectedParts = false) = 0;
 
  ///< allows adding only certain parts of an existing polyline object into the factory
  virtual IPolylineFactory& addPolyline(const IPolyline &line, const IPartFunctor &partFunc) = 0;
  ///< add a part of another polyline object into the factory
  virtual IPolylineFactory& addPolyline(const IPolyline::IPart &part) = 0;
 
  virtual IPolylineFactory& closePart() = 0;
 
  virtual IPolylineFactory& addPart() = 0;
 
  virtual PolylineHandle getPolyline(bool clear = true) = 0;
};
 
typedef Handle<IPolylineFactory> PolylineFactoryHandle;
 
DM_NAMESPACE_END