BCHCode.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   : ICLMarkers/src/ICLMarkers/BCHCode.h                    **
** Module : ICLMarkers                                             **
** Authors: Christof Elbrechter                                    **
**                                                                 **
**                                                                 **
** 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.GPL  **
** 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 <bitset>
#include <ICLUtils/BasicTypes.h>
#include <ICLUtils/Uncopyable.h>
#include <ICLCore/Img.h>

namespace icl{
  namespace markers{
    
    typedef std::bitset<36> BCHCode;
  
    typedef std::bitset<4096> BCHCodeSubSet;
    
    struct DecodedBCHCode{
      BCHCode origCode;      
      BCHCode correctedCode; 
      int id;                
      int errors;            
      
      operator bool() const { return id >= 0; }
  
      bool operator<(const DecodedBCHCode &c){
        return errors < c.errors;
      }
    };
  
    struct DecodedBCHCode2D : public DecodedBCHCode{
      DecodedBCHCode2D(){}
      DecodedBCHCode2D(const DecodedBCHCode &code):DecodedBCHCode(code),rot(Rot0){}
      enum Rotation{ Rot0, Rot90, Rot180, Rot270} rot;
    };
  
    std::ostream &operator<<(std::ostream &s, const DecodedBCHCode2D::Rotation &r);
  

    class BCHCoder : public utils::Uncopyable{
      class Impl; 
      Impl *impl; 
      
      public:
      BCHCoder();
  
      ~BCHCoder();
                  
      static BCHCode encode(int idx);
    

      static core::Img8u createMarkerImage(int idx, int border=2, const utils::Size &resultSize=utils::Size::null);
  
      static BCHCode rotateCode(const BCHCode &in);
  
      
      DecodedBCHCode decode(const BCHCode &code);
      
      DecodedBCHCode decode(const icl8u data[36]);
      
      DecodedBCHCode decode(const core::Img8u &image, bool useROI=true) throw (utils::ICLException);
      

      DecodedBCHCode2D decode2D(const core::Img8u &image, int maxID=4095, bool useROI=true) throw (utils::ICLException);
      
    };
  } // namespace markers
}