eLynx SDK v3.0.1 C++ image processing API reference

Bayer.h

Go to the documentation of this file.

//============================================================================
//  Bayer.h                                            Image.Component package
//============================================================================
//  Usage : Tool for Bayer matrix and demosaicing
//----------------------------------------------------------------------------
//  Copyright (C) 2006 by eLynx project
//
//  This library is free software; you can redistribute it and/or
//  modify it under the terms of the GNU Library General Public
//  License as published by the Free Software Foundation; either
//  version 2 of the License, or (at your option) any later version.
//
//  This library is distributed in the hope that it will be useful,
//  but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
//  See the GNU Library General Public License for more details.
//----------------------------------------------------------------------------
#ifndef __Bayer_h__
#define __Bayer_h__

#include <elx/core/CoreTypes.h>
#include "ImageLib.h"
#include "ImageImpl.h"
#include "IImageGeometry.h"
#include "PixelIterator.h"

namespace eLynx {
namespace Image {

//  BM_None  BM_GRBG  BM_RGGB  BM_GBRG  BM_BGGR
//   +-+-+    +-+-+    +-+-+    +-+-+    +-+-+
//   |L|L|    |G|R|    |R|G|    |G|B|    |B|G|
//   +-+-+    +-+-+    +-+-+    +-+-+    +-+-+
//   |L|L|    |B|G|    |G|B|    |R|G|    |G|R|
//   +-+-+    +-+-+    +-+-+    +-+-+    +-+-+
enum EBayerMatrix
{
  BM_None, 
  BM_GRBG,
  BM_GBRG,
  BM_RGGB,
  BM_BGGR
};


// http://www.reference.com/browse/wiki/Demosaicing
// http://scien.stanford.edu/class/psych221/projects/99/tingchen/main.htm
enum EBayerToColorConversion
{ 
  BCC_Grey,             
  BCC_Bin2x2,           
  BCC_Raw,              
  BCC_Nearest,          

  BCC_Bilinear,         

  BCC_MalvarHeCutler,   

  BCC_Bicubic,          

  BCC_Cok,              

  BCC_Freeman,          

  BCC_Adaptive,         

  BCC_LarochePrescott,  

  BCC_Hamilton,         

  BCC_HamiltonAdams,    

  BCC_Adams,            

  BCC_WangLinXue,       

  BCC_Kimmel,           

  BCC_LukinKubasov,     

  BCC_ChuanLin,         

  BCC_WemmiaoLu,        

  BCC_PRI,              

  BCC_PMI,              

  BCC_VNG,              

  BCC_AHD,              

  BCC_ChangTan,         

  BCC_Max,
  BCC_Default = BCC_Adaptive  
};

// -Demosaicing for digital imaging device using perceptually uniform color space
// http://www.patentstorm.us/patents/6809765-fulltext.html
// http://www.13thmonkey.org/~boris/rawtobw/
// http://www.tortuga.com.au/products/info/wp/
// http://www.csee.wvu.edu/~xinl/source.html  source
// http://www.dei.unipd.it/~menond/pub/dfapd/dfapd.html
// http://people.csail.mit.edu/mtappen/iccv-sctv.pdf

// "Primary-consistent soft-decision color demosaicking for digital cameras"
// X. Wu and N. Zhang Algorithm
// IEEE Trans. Image Processing, vol. 13, pp 1263-1274, Sept. 2004.

enum EBayerToGreyConversion
{ 
  BGC_AsIs,

  BGC_Max,
  BGC_Default = BGC_AsIs
};

ExportedByImage const char * elxToString(EBayerMatrix iBayer);
ExportedByImage const char * elxToString(EBayerToGreyConversion iMethod);
ExportedByImage const char * elxToString(EBayerToColorConversion iMethod);

ExportedByImage EBayerMatrix elxGetBayerAt(EBayerMatrix iBayer, uint32 iX, uint32 iY);
ExportedByImage EBayerMatrix elxGetBayerLeft(EBayerMatrix iBayer);
ExportedByImage EBayerMatrix elxGetBayerRight(EBayerMatrix iBayer);
ExportedByImage EBayerMatrix elxGetBayerUp(EBayerMatrix iBayer);
ExportedByImage EBayerMatrix elxGetBayerDown(EBayerMatrix iBayer);

ExportedByImage EBayerMatrix elxFlipHorizontal(EBayerMatrix iBayer, uint32 iWidth);
ExportedByImage EBayerMatrix elxFlipVertical(EBayerMatrix iBayer, uint32 iHeight);
ExportedByImage EBayerMatrix elxFlip(EBayerMatrix iBayer, EFlipPlane iFlipPlane, uint32 iWidth, uint32 iHeight);

ExportedByImage EBayerMatrix elxRotate180(EBayerMatrix iBayer, uint32 iWidth, uint32 iHeight);
ExportedByImage EBayerMatrix elxRotate90Left(EBayerMatrix iBayer, uint32 iWidth);
ExportedByImage EBayerMatrix elxRotate90Right(EBayerMatrix iBayer, uint32 iHeight);
ExportedByImage EBayerMatrix elxRotate(EBayerMatrix iBayer, ERightRotation iRotation, uint32 iWidth, uint32 iHeight);


class ExportedByImage IBayerHandler
{
public:
  virtual ~IBayerHandler();

  virtual boost::shared_ptr< AbstractImage > CreateRGB(
    const AbstractImage& iImage,
    EBayerMatrix iBayer,
    EBayerToColorConversion iMethod,
    ProgressNotifier& iNotifier=ProgressNotifier_NULL) const=0;

  virtual boost::shared_ptr< AbstractImage > CreateBayer(
    const AbstractImage& iImage, 
    EBayerMatrix iBayer,
    ProgressNotifier& iNotifier=ProgressNotifier_NULL) const=0;

  virtual bool Balance(
      AbstractImage& ioImage, EBayerMatrix iBayer, 
      double iRed, double iGreen, double iBlue,
      uint32 iChannelMask) const=0;

  virtual bool ComputeMean(
      const AbstractImage& iImage, EBayerMatrix iBayer,
      double& oMeanR, double& oMeanG, double& oMeanB,
      bool ibNormalized=false) const=0;

  virtual bool ComputeStandardDeviation(
      const AbstractImage& iImage, EBayerMatrix iBayer,
      double& oMeanR, double& oMeanG, double& oMeanB,
      double& oStdDevR, double& oStdDevG, double& oStdDevB,
      bool ibNormalized=false) const=0;

  virtual bool Affine(
    AbstractImage& ioImage, EBayerMatrix iBayer,
    double iScaleR, double iOffsetR,
    double iScaleG, double iOffsetG,
    double iScaleB, double iOffsetB) const=0;
};

ExportedByImage const IBayerHandler& elxGetBayerHandler(EPixelFormat iPixelFormat);
ExportedByImage const IBayerHandler& elxGetBayerHandler(const AbstractImage& iImage);

} // namespace Image
} // namespace eLynx

#endif // __Bayer_h__

---

Generated on 14 Apr 2009 by doxygen 1.5.8