DCDevice.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   : ICLIO/src/ICLIO/DCDevice.h                             **
** Module : ICLIO                                                  **
** 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 <ICLIO/DC.h>
#include <string>
#include <vector>
#include <ICLCore/Types.h>
#include <ICLUtils/Size.h>

namespace icl{
  namespace io{
    class DCGrabber;
    namespace dc{
      class DCGrabberThread;
    }
    class ICLIO_API DCDevice{
      public:

      static std::string getTypeID(const std::string &model, const std::string &vendor);

      static std::string getTypeID(const dc1394camera_t *cam);


      std::string getTypeID() const{ return getTypeID(m_poCam); }

      static const DCDevice null;

      friend class icl::io::DCGrabber;

      friend class icl::io::dc::DCGrabberThread;

      static void dc1394_reset_bus(bool verbose=false);

      struct ICLIO_API Mode{
        Mode(dc1394video_mode_t vm, dc1394framerate_t fr):
          videomode(vm),framerate(fr){}


        Mode(const std::string &stringRepr);

        Mode(dc1394camera_t *cam);


        std::string toString() const;

        bool supportedBy(dc1394camera_t *cam) const;

        dc1394video_mode_t videomode;

        dc1394framerate_t framerate;

        bool operator==(const Mode &m) const{ return videomode == m.videomode && framerate == m.framerate; }

        bool operator!=(const Mode &m) const{ return !((*this)==m);}
      };

      dc1394camera_t *getCam() const { return m_poCam; }

      Mode getMode() const{ return Mode(m_poCam); }

      std::vector<Mode> getModes() const ;

      std::string getModesInfo() const ;

      std::string getVendorID() const;

      std::string getModelID() const;

      uint64_t getGUID() const;

      icl32s getUnit() const;

      icl32s getUnitSpecID() const;


      std::string getUniqueStringIdentifier() const;

      bool isNull() const { return m_poCam == 0; }

      void show(const std::string &title="DCDevice") const;

      bool supports(const Mode &mode) const;


      dc1394color_filter_t getBayerFilterLayout() const;


      void setISOSpeed(int mbits);

      bool supportsDC800();

      private:
      DCDevice(dc1394camera_t *cam):
      m_poCam(cam){//,m_eCameraTypeID(estimateCameraType(cam)){
        estimateBayerFilterMode();
      }


      void setMode(const Mode &mode);


      void reset() { if(!isNull()) dc1394_camera_reset(m_poCam); }


      dc1394camera_t *m_poCam;

      void estimateBayerFilterMode();

      enum BayerFilterMode{
        BF_RGGB = DC1394_COLOR_FILTER_RGGB,
        BF_GBRG = DC1394_COLOR_FILTER_GBRG,
        BF_GRBG = DC1394_COLOR_FILTER_GRBG,
        BF_BGGR = DC1394_COLOR_FILTER_BGGR,
        BF_NONE,
        BF_FROM_MODE,
        BF_FROM_FEATURE
      };

      // CameraTypeID m_eCameraTypeID;
      BayerFilterMode m_eBayerFilterMode;
    };
  } // namespace io
}