IPolylineFactory.hpp

#ifndef DM_IPOLYLINE_FACTORY_HPP_INCLUDED
#define DM_IPOLYLINE_FACTORY_HPP_INCLUDED

#ifdef _MSC_VER
  #pragma once
#endif

#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 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

#endif //DM_IPOLYLINE_CREATOR_HPP_INCLUDED