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.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/BasicTypes.h>
#include <ICLUtils/Uncopyable.h>
#include <ICLCore/Img.h>
#include <bitset>

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;
    };

    ICLMarkers_API std::ostream &operator<<(std::ostream &s, const DecodedBCHCode2D::Rotation &r);


    class ICLMarkers_API 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) ;


      DecodedBCHCode2D decode2D(const core::Img8u &image, int maxID=4095, bool useROI=true) ;

    };
  } // namespace markers
}