Visual Servoing Platform  version 3.6.1 under development (2024-03-28)
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 class vpDirectShowGrabberImpl;
51 
63 class VISP_EXPORT vpDirectShowGrabber : public vpFrameGrabber
64 {
65  vpDirectShowGrabberImpl *grabber;
66 
67 public:
68  unsigned int getHeight();
69  unsigned int getWidth();
70 
72  virtual ~vpDirectShowGrabber();
73 
74  void open();
76  void open(vpImage<vpRGBa> &I);
77 
79  void acquire(vpImage<vpRGBa> &I);
80 
81  void close();
82 
83  // get the number of capture devices
84  unsigned int getDeviceNumber();
85 
86  // change the capture device
87  bool setDevice(unsigned int id);
88 
89  // displays a list of available devices
90  void displayDevices();
91 
92  // set image size
93  bool setImageSize(unsigned int width, unsigned int height);
94 
95  // set source framerate
96  bool setFramerate(double framerate);
97 
98  // set capture format
99  bool setFormat(unsigned int width, unsigned int height, double framerate);
100 
101  // get capture format
102  void getFormat(unsigned int &width, unsigned int &height, double &framerate);
103 
104  // Get the available capture formats
105  bool getStreamCapabilities();
106 
107  // Set capture MediaType
108  bool setMediaType(int mediaTypeID);
109 
110  // Get current capture MediaType
111  int getMediaType();
112 };
113 #endif
114 #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