ImageRegionData.h

Go to the documentation of this file.

/********************************************************************
**                Image Component Library (ICL)                    **
**                                                                 **
** Copyright (C) 2006-2013 CITEC, University of Bielefeld          **
**                         Neuroinformatics Group                  **
** Website: www.iclcv.org and                                      **
**          http://opensource.cit-ec.de/projects/icl               **
**                                                                 **
** File   : ICLCV/src/ICLCV/ImageRegionData.h                      **
** Module : ICLCV                                                  **
** Authors: Christof Elbrechter, Erik Weitnauer                    **
**                                                                 **
**                                                                 **
** GNU LESSER GENERAL PUBLIC LICENSE                               **
** This file may be used under the terms of the GNU Lesser General **
** Public License version 3.0 as published by the                  **
**                                                                 **
** Free Software Foundation and appearing in the file LICENSE.LGPL **
** included in the packaging of this file.  Please review the      **
** following information to ensure the license requirements will   **
** be met: http://www.gnu.org/licenses/lgpl-3.0.txt                **
**                                                                 **
** The development of this software was supported by the           **
** Excellence Cluster EXC 277 Cognitive Interaction Technology.    **
** The Excellence Cluster EXC 277 is a grant of the Deutsche       **
** Forschungsgemeinschaft (DFG) in the context of the German       **
** Excellence Initiative.                                          **
**                                                                 **
********************************************************************/

#pragma once

#include <ICLUtils/CompatMacros.h>
#include <ICLUtils/StackTimer.h>
#include <ICLUtils/Any.h>
#include <ICLCore/Img.h>
#include <ICLCV/ImageRegionPart.h>
#include <ICLCV/ImageRegion.h>
#include <ICLCV/RegionPCAInfo.h>
#include <ICLCV/CornerDetectorCSS.h>

#include <set>

namespace icl{
  namespace cv{


    struct ICLCV_API ImageRegionData{
    private:
      typedef ImageRegionData IRD;
    public:
      friend class RegionDetector;
      friend struct ImageRegion;
      friend bool region_search_border(std::set<IRD*>&,IRD*);
      friend void collect_subregions_recursive(std::set<IRD*>&,IRD*);
      friend bool is_region_contained(IRD*,IRD*);
      friend bool region_search_outer_bb(const utils::Rect&,std::set<IRD*>&,IRD*);

    private:
      int  value;

      int id;

      mutable int size;

      const core::ImgBase *image;

      std::vector<LineSegment> segments;

      utils::Any meta;

      struct RegionGraphInfo{
        RegionGraphInfo():isBorder(false),parent(0){}

        bool isBorder;

        // region graph information
        std::set<ImageRegionData*> neighbours;

        // child regions
        std::vector<ImageRegionData*> children;

        ImageRegionData *parent;
      } *graph; 

      // structure for representing simple region information
      struct SimpleInformation{
        inline SimpleInformation():
          boundingBox(0),cog(0),pcainfo(0),
          boundaryLength(0),boundary(0),
          thinned_boundary(0),pixels(0){}
        inline ~SimpleInformation(){
          if(boundingBox) delete boundingBox;
          if(cog) delete cog;
          if(pcainfo) delete pcainfo;
          if(boundary) delete boundary;
          if(thinned_boundary) delete thinned_boundary;
          if(pixels) delete pixels;
        }
        utils::Rect *boundingBox;      
        utils::Point32f *cog;          
        RegionPCAInfo *pcainfo; 
        int boundaryLength;     

        std::vector<utils::Point> *boundary;         
        std::vector<utils::Point> *thinned_boundary; 
        std::vector<utils::Point> *pixels;           

      } *simple; 

      struct CSSParams{
        float angle_thresh;
        float rc_coeff;
        float sigma;
        float curvature_cutoff;
        float straight_line_thresh;
        std::vector<utils::Point32f> resultBuffer;

        bool isOk(CornerDetectorCSS *css) const{
          return css->getAngleThreshold() == angle_thresh &&
          css->getRCCoeff() == rc_coeff &&
          css->getSigma() == sigma &&
          css->getCurvatureCutoff() == curvature_cutoff &&
          css->getStraightLineThreshold() == straight_line_thresh;
        }

        void setFrom(CornerDetectorCSS *css){
          angle_thresh = css->getAngleThreshold();
          rc_coeff = css->getRCCoeff();
          sigma = css->getSigma();
          curvature_cutoff = css->getCurvatureCutoff();
          straight_line_thresh = css->getStraightLineThreshold();
        }
      };

      struct ComplexInformation{
        inline ComplexInformation():
          directSubRegions(0),allSubRegions(0),parent(0),
          parentTree(0),publicNeighbours(0),cssParams(0){}
        inline ~ComplexInformation(){
          if(directSubRegions) delete directSubRegions;
          if(allSubRegions) delete allSubRegions;
          if(parent) delete parent;
          if(parentTree) delete parentTree;
          if(publicNeighbours) delete publicNeighbours;
          if(cssParams) delete cssParams;
        }
        std::vector<ImageRegion> *directSubRegions;         
        std::vector<ImageRegion> *allSubRegions;            
        ImageRegion *parent;                                
        std::vector<ImageRegion> *parentTree;               
        std::vector<ImageRegion> *publicNeighbours;         
        CSSParams *cssParams;
      } *complex; 


      CornerDetectorCSS *css; 

      static ImageRegionData *createInstance(CornerDetectorCSS *css, ImageRegionPart *topRegionPart, int id, bool createGraphInfo, const core::ImgBase *image);

      inline ImageRegionData(CornerDetectorCSS *css, int value, int id, unsigned int segmentSize, bool createGraph,const core::ImgBase *image):
        value(value),id(id),size(0),image(image),segments(segmentSize),graph(createGraph ? new RegionGraphInfo : 0),
      simple(0),complex(0),css(css){}

      inline ~ImageRegionData(){
        if(graph) delete graph;
        if(simple) delete simple;
        if(complex) delete complex;
      }

      // utility function (only if linkTable is not given)
      inline void link(ImageRegionData *a){
        if(this != a){
          if(a->graph->neighbours.size() < graph->neighbours.size()){
            if(a->graph->neighbours.insert(this).second){
              graph->neighbours.insert(a);
            }
          }else{
            if(graph->neighbours.insert(a).second){
              a->graph->neighbours.insert(this);
            }
          }
        }
      }

      inline void addChild(ImageRegionData *a){
        graph->children.push_back(a);
        a->graph->parent = this;
      }

      void showTree(int indent=0) const;

      void showWithNeighbours() const;

      inline ComplexInformation *ensureComplex(){
        if(!complex) complex = new ComplexInformation;
        return complex;
      }

      inline SimpleInformation *ensureSimple(){
        if(!simple) simple = new SimpleInformation;
        return simple;
      }
    };

  } // namespace cv
}