Visual Servoing Platform  version 3.6.1 under development (2024-12-17)
vpDirectShowGrabber.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  * DirectShow framegrabber.
33  *
34  * Authors:
35  * Bruno Renier
36  * Anthony Saunier
37  *
38 *****************************************************************************/
39 
40 #ifndef vpDirectShowGrabber_hh
41 #define vpDirectShowGrabber_hh
42 
43 #include <visp3/core/vpConfig.h>
44 #if (defined(VISP_HAVE_DIRECTSHOW))
45 
46 #include <visp3/core/vpFrameGrabber.h>
47 #include <visp3/core/vpImage.h>
48 #include <visp3/core/vpRGBa.h>
49 
50 BEGIN_VISP_NAMESPACE
51 class vpDirectShowGrabberImpl;
52 
64 class VISP_EXPORT vpDirectShowGrabber : public vpFrameGrabber
65 {
66  vpDirectShowGrabberImpl *grabber;
67 
68 public:
69  unsigned int getHeight();
70  unsigned int getWidth();
71 
73  virtual ~vpDirectShowGrabber();
74 
75  void open();
77  void open(vpImage<vpRGBa> &I);
78 
80  void acquire(vpImage<vpRGBa> &I);
81 
82  void close();
83 
84  // get the number of capture devices
85  unsigned int getDeviceNumber();
86 
87  // change the capture device
88  bool setDevice(unsigned int id);
89 
90  // displays a list of available devices
91  void displayDevices();
92 
93  // set image size
94  bool setImageSize(unsigned int width, unsigned int height);
95 
96  // set source framerate
97  bool setFramerate(double framerate);
98 
99  // set capture format
100  bool setFormat(unsigned int width, unsigned int height, double framerate);
101 
102  // get capture format
103  void getFormat(unsigned int &width, unsigned int &height, double &framerate);
104 
105  // Get the available capture formats
106  bool getStreamCapabilities();
107 
108  // Set capture MediaType
109  bool setMediaType(int mediaTypeID);
110 
111  // Get current capture MediaType
112  int getMediaType();
113 };
114 END_VISP_NAMESPACE
115 #endif
116 #endif
class for windows direct show devices
Base class for all video devices. It is designed to provide a front end to video sources.
virtual void open(vpImage< unsigned char > &I)=0
unsigned int getWidth() const
Return the number of columns in the image.
virtual void acquire(vpImage< unsigned char > &I)=0
unsigned int getHeight() const
Return the number of rows in the image.
virtual void close()=0