SetOfSurfels.h

#pragma once

#if defined(SetOfSurfels_RECURSES)
#error Recursive header files inclusion detected in SetOfSurfels.h
#else // defined(SetOfSurfels_RECURSES)

#define SetOfSurfels_RECURSES

#if !defined SetOfSurfels_h

#define SetOfSurfels_h

// Inclusions
#include <iostream>
#include <vector>
#include "DGtal/base/Common.h"
#include "DGtal/topology/Topology.h"
#include "DGtal/topology/SurfelAdjacency.h"
#include "DGtal/topology/SurfelNeighborhood.h"
#include "DGtal/topology/SurfelSetPredicate.h"

namespace DGtal
{

  // template class SetOfSurfels
  template < typename TKSpace, 
             typename TSurfelSet = typename TKSpace::SurfelSet >
  class SetOfSurfels
  {
  public:
    
    class Tracker
    {
    public:
      // -------------------- associated types --------------------
      typedef Tracker Self;
      typedef SetOfSurfels<TKSpace,TSurfelSet> DigitalSurfaceContainer;
      typedef typename TKSpace::SCell Surfel;
      
      // -------------------- inner types --------------------
      typedef TKSpace KSpace;
      typedef SurfelNeighborhood<KSpace> Neighborhood;

    public:
      Tracker( const DigitalSurfaceContainer & aSurface, 
               const Surfel & s );

      Tracker( const Tracker & other );

      ~Tracker();

      const DigitalSurfaceContainer & surface() const;
      const Surfel & current() const;
      Dimension orthDir() const;

      void move( const Surfel & s );
      
      uint8_t adjacent( Surfel & s, Dimension d, bool pos ) const;
      
    private:
      const DigitalSurfaceContainer & mySurface;
      Neighborhood myNeighborhood;

    };

    // ----------------------- associated types ------------------------------
  public:
    typedef SetOfSurfels<TKSpace,TSurfelSet> Self;
    typedef TKSpace KSpace;
    typedef typename KSpace::SCell Surfel;
    typedef typename KSpace::Size Size;
    // Model of CSurfelSet
    typedef TSurfelSet SurfelSet;

    // BOOST_CONCEPT_ASSERT(( CCellularGridSpaceND< KSpace > ));
    // BOOST_CONCEPT_ASSERT(( CSurfelSet< SurfelSet > ));

    // -------------------- specific types ------------------------------
    typedef typename SurfelSet::const_iterator SurfelConstIterator;
    typedef typename KSpace::Space Space;
    typedef typename KSpace::Point Point;
    typedef Tracker DigitalSurfaceTracker;

    // ----------------------- other types ------------------------------
  public:
    typedef SurfelAdjacency<KSpace::dimension> Adjacency;
    typedef typename KSpace::Cell Cell;
    typedef typename KSpace::SCell SCell;
    typedef typename KSpace::CellSet CellSet;
    typedef typename KSpace::SCellSet SCellSet;
    typedef SurfelSetPredicate<SurfelSet, Surfel> SurfelPredicate;

    // ----------------------- Standard services ------------------------------
  public:

    ~SetOfSurfels();

    SetOfSurfels ( const SetOfSurfels & other );

    SetOfSurfels( const KSpace & aKSpace,
                  const Adjacency & adj,
                  SurfelSet aSetOfSurfels = SurfelSet() );

    // Mutator to set of surfels.
    SurfelSet & surfelSet();
    // Accessor to set of surfels.
    const SurfelSet & surfelSet() const;

    const Adjacency & surfelAdjacency() const;
    Adjacency & surfelAdjacency();
    const SurfelPredicate & surfelPredicate() const;

    // --------- CDigitalSurfaceContainer realization -------------------------
  public:

    const KSpace & space() const;
    bool isInside( const Surfel & s ) const;

    SurfelConstIterator begin() const;

    SurfelConstIterator end() const;

    Size nbSurfels() const;

    bool empty() const;

    DigitalSurfaceTracker* newTracker( const Surfel & s ) const;

    Connectedness connectedness() const;

    // ----------------------- Interface --------------------------------------
  public:

    void selfDisplay ( std::ostream & out ) const;

    bool isValid() const;

    // ------------------------- Protected Datas ------------------------------
  private:
    // ------------------------- Private Datas --------------------------------
  private:
    const KSpace & myKSpace;
    SurfelSet mySurfelSet;
    SurfelPredicate mySurfelPredicate;
    Adjacency mySurfelAdjacency;

    // ------------------------- Hidden services ------------------------------
  protected:

  private:

    SetOfSurfels & operator= ( const SetOfSurfels & other );

    // ------------------------- Internals ------------------------------------
  private:

  }; // end of class SetOfSurfels


  template <typename TKSpace, typename TSurfelSet>
  std::ostream&
  operator<< ( std::ostream & out, 
               const SetOfSurfels<TKSpace, TSurfelSet> & object );

} // namespace DGtal


// Includes inline functions.
#include "DGtal/topology/SetOfSurfels.ih"

//                                                                           //

#endif // !defined SetOfSurfels_h

#undef SetOfSurfels_RECURSES
#endif // else defined(SetOfSurfels_RECURSES)