Visual Servoing Platform  version 3.6.1 under development (2024-12-17)
vpUeyeGrabber.h
1 /****************************************************************************
2  *
3  * ViSP, open source Visual Servoing Platform software.
4  * Copyright (C) 2005 - 2023 by Inria. All rights reserved.
5  *
6  * This software is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  * See the file LICENSE.txt at the root directory of this source
11  * distribution for additional information about the GNU GPL.
12  *
13  * For using ViSP with software that can not be combined with the GNU
14  * GPL, please contact Inria about acquiring a ViSP Professional
15  * Edition License.
16  *
17  * See https://visp.inria.fr for more information.
18  *
19  * This software was developed at:
20  * Inria Rennes - Bretagne Atlantique
21  * Campus Universitaire de Beaulieu
22  * 35042 Rennes Cedex
23  * France
24  *
25  * If you have questions regarding the use of this file, please contact
26  * Inria at visp@inria.fr
27  *
28  * This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
29  * WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
30  *
31  * Description:
32  * IDS uEye interface.
33  *
34 *****************************************************************************/
35 
36 #ifndef _vpUeyeGrabber_h_
37 #define _vpUeyeGrabber_h_
38 
39 #include <visp3/core/vpConfig.h>
40 #include <visp3/core/vpImage.h>
41 
42 #ifdef VISP_HAVE_UEYE
43 
44 BEGIN_VISP_NAMESPACE
84 class VISP_EXPORT vpUeyeGrabber
85 {
86 public:
87  vpUeyeGrabber();
88  virtual ~vpUeyeGrabber();
89 
90  void acquire(vpImage<unsigned char> &I, double *timestamp_camera = nullptr, std::string *timestamp_system = nullptr);
91  void acquire(vpImage<vpRGBa> &I, double *timestamp_camera = nullptr, std::string *timestamp_system = nullptr);
92 
93  std::string getActiveCameraModel() const;
94  std::string getActiveCameraSerialNumber() const;
95 
96  std::vector<unsigned int> getCameraIDList() const;
97  std::vector<std::string> getCameraModelList() const;
98  std::vector<std::string> getCameraSerialNumberList() const;
99  double getFramerate() const;
100  unsigned int getFrameHeight() const;
101  unsigned int getFrameWidth() const;
102 
103  bool isConnected() const;
104  void loadParameters(const std::string &filename);
105  void open(vpImage<unsigned char> &I);
106  void open(vpImage<vpRGBa> &I);
107 
108  bool setActiveCamera(unsigned int cam_index);
109  bool setColorMode(const std::string &color_mode);
110  bool setExposure(bool auto_exposure, double exposure_ms = -1);
111  bool setFrameRate(bool auto_frame_rate, double manual_frame_rate_hz = -1);
112  bool setGain(bool auto_gain, int master_gain = -1, bool gain_boost = false);
113  void setSubsampling(int factor);
114  void setVerbose(bool verbose);
115  void setWhiteBalance(bool auto_wb);
116 
117 private:
118  vpUeyeGrabber(const vpUeyeGrabber &); // noncopyable
119  vpUeyeGrabber &operator=(const vpUeyeGrabber &); //
120 
121  class vpUeyeGrabberImpl;
122  vpUeyeGrabberImpl *m_impl;
123 };
124 END_VISP_NAMESPACE
125 #endif
126 #endif