/********************************************************************
**                Image Component Library (ICL)                    **
**                                                                 **
** Copyright (C) 2006-2012 CITEC, University of Bielefeld          **
**                         Neuroinformatics Group                  **
** Website: www.iclcv.org and                                      **
**          http://opensource.cit-ec.de/projects/icl               **
**                                                                 **
** File   : include/ICLMarkers/MarkerMetricsICL1.h                 **
** Module : ICLBlob                                                **
** Authors: Christof Elbrechter                                    **
**                                                                 **
**                                                                 **
** Commercial License                                              **
** ICL can be used commercially, please refer to our website       **
** www.iclcv.org for more details.                                 **
**                                                                 **
** GNU General Public License Usage                                **
** Alternatively, this file may be used under the terms of the     **
** GNU General Public License version 3.0 as published by the      **
** Free Software Foundation and appearing in the file LICENSE.GPL  **
** included in the packaging of this file.  Please review the      **
** following information to ensure the GNU General Public License  **
** version 3.0 requirements will be met:                           **
** http://www.gnu.org/copyleft/gpl.html.                           **
**                                                                 **
** 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.                                          **
**                                                                 **
*********************************************************************/

#ifndef ICL_MARKER_METRIC_ICL1_H
#define ICL_MARKER_METRIC_ICL1_H

#include <ICLMarkers/MarkerCodeICL1.h>
#include <ICLUtils/Rect32f.h>
#include <ICLUtils/Point32f.h>

namespace icl{
  
  /// Marker metrics for "icl1" markers
  /** each marker has
      - a border of width 1 unit -> root regions
      - 4 child regions (cr) each of height 3 units and width 11 units
      - each child regions contains 1 to 5 child-child-regions (ccr)
        each round and with diameter of 1 unit
      
      <pre>
      #############<- border (root region)
      #           # 
      # #       # #
      #         <-#-- child region cr 0
      #############
      #           # 
      # #   #   # #
      #         <-#-- child region cr 1
      #############
      #           # 
      # # #   # # #
      #         <-#-- child region cr 2
      #############
      #           # 
      # # # # # # #
      # ^        <-#-- child region cr 3
      ##|##########
        | 
        child child region ccr 0
      </pre>
      
      The ccr's are distributed towards the edges, only in case of 
      a single ccr within a cr, it is placed in the middle.
      
      The whole marker structure becomes 13 x 17 units. These are 
      mapped linearily to the actual marker size in mm;
  */
  struct MarkerMetricsICL1 : public MarkerCodeICL1 {

    /// real dimension of the root region
    Size32f root;
    
    /// child region struct
    struct CR : public Rect32f{
      /// list of child child regions
      std::vector<Rect32f> ccrs;
    };
    
    /// child regions
    CR crs[4];
    
    /// creates a metric instance from given code and real size in mm
    MarkerMetricsICL1(const MarkerCodeICL1 &c, const Size32f &markerSizeMM);
    
  };
  
}

#endif