OpenCV视频I/O(1）视频采集类VideoCapture介绍

操作系统：ubuntu22.04
OpenCV版本：OpenCV4.9
IDE:Visual Studio Code
编程语言：C++11

算法描述

用于从视频文件、图像序列或摄像头捕获视频的类。
该类提供了用于从摄像头捕获视频或读取视频文件和图像序列的 C++ API。
以下是该类的使用方法：

#include <opencv2/core.hpp>
#include <opencv2/videoio.hpp>
#include <opencv2/highgui.hpp>
#include <iostream>
#include <stdio.h>
using namespace cv;
using namespace std;
int main(int, char**)
{
    Mat frame;
    //--- INITIALIZE VIDEOCAPTURE
    VideoCapture cap;
    // open the default camera using default API
    // cap.open(0);
    // OR advance usage: select any API backend
    int deviceID = 0;             // 0 = open default camera
    int apiID = cv::CAP_ANY;      // 0 = autodetect default API
    // open selected camera using selected API
    cap.open(deviceID, apiID);
    // check if we succeeded
    if (!cap.isOpened()) {
        cerr << "ERROR! Unable to open camera\n";
        return -1;
    }
    //--- GRAB AND WRITE LOOP
    cout << "Start grabbing" << endl
        << "Press any key to terminate" << endl;
    for (;;)
    {
        // wait for a new frame from camera and store it into 'frame'
        cap.read(frame);
        // check if we succeeded
        if (frame.empty()) {
            cerr << "ERROR! blank frame grabbed\n";
            break;
        }
        // show live and wait for a key with timeout long enough to show images
        imshow("Live", frame);
        if (waitKey(5) >= 0)
            break;
    }
    // the camera will be deinitialized automatically in VideoCapture destructor
    return 0;
}

注意
在 C API 中，使用黑盒结构 CvCapture 代替 VideoCapture。

(C++) 使用 VideoCapture 接口的基本示例可以在 OPENCV_SOURCE_CODE/samples/cpp/videocapture_starter.cpp 找到。
(Python) 使用 VideoCapture 接口的基本示例可以在 OPENCV_SOURCE_CODE/samples/python/video.py 找到。
(Python) 多线程视频处理的示例可以在 OPENCV_SOURCE_CODE/samples/python/video_threaded.py 找到。
(Python) 展示 Video4Linux2 后端部分特性的 VideoCapture 示例可以在 OPENCV_SOURCE_CODE/samples/python/video_v4l2.py 找到。

构造函数1

默认构造函数

cv::VideoCapture::VideoCapture	(		)

构造函数2

使用 API 优先级打开视频文件、捕获设备或 IP 视频流以进行视频捕获。
这是一个重载成员函数，为方便而提供。它与上述函数的不同之处仅在于它接受的参数

cv::VideoCapture::VideoCapture	
(
	const String & 	filename,
    int 	apiPreference = CAP_ANY 
)

参数2

参数filename 它可以是：
- 视频文件的名称（例如，video.avi）
- 图像序列（例如，img_%02d.jpg，这将读取如 img_00.jpg、img_01.jpg、img_02.jpg 等样的样本）
- 视频流的 URL（例如，protocol://host:port/script_name?script_params|auth）
- 在使用 GStreamer 作为后端的情况下，GStreamer pipeline 字符串（gst-launch 工具格式）。请注意，每个视频流或 IP 摄像头馈送都有自己的 URL 方案。请参考源流的文档以了解正确的 URL。
参数apiPreference 首选的捕获 API 后端。可以在多个可用的情况下强制使用特定的读取器实现：例如，cv::CAP_FFMPEG 或 cv::CAP_IMAGES 或 cv::CAP_DSHOW。

构造函数3

使用 API 优先级和参数打开视频文件、捕获设备或 IP 视频流以进行视频捕获。
这是一个重载成员函数，为方便而提供。它与上述函数的不同之处仅在于它接受的参数。params 参数允许指定以成对形式编码的额外参数.（paramId_1, paramValue_1, paramId_2, paramValue_2, …）。参见 [cv::VideoCaptureProperties](https://docs.opencv.org/4.9.0/d4/d15/group__videoio__flags__base.html#gaeb8dd9c89c10a5c63c139bf7c4f5704d)。

cv::VideoCapture::VideoCapture	
(
	const String & 	filename,
	int 	apiPreference,
	const std::vector< int > & 	params 
)

构造函数4

打开摄像头以进行视频捕获。
这是一个重载成员函数，为方便而提供。它与上述函数的不同之处仅在于它接受的参数。


cv::VideoCapture::VideoCapture
(
	int 	index,
	int 	apiPreference = CAP_ANY 
)

参数4

参数index 要打开的视频捕获设备的 ID。为了使用默认后端打开默认摄像头，只需传递 0。（为了向后兼容，在 apiPreference 为 CAP_ANY 时，使用 camera_id + domain_offset (CAP_*) 是有效的）
参数apiPreference 首选的捕获 API 后端。可以在多个可用的情况下强制使用特定的读取器实现：例如，cv::CAP_DSHOW 或 cv::CAP_MSMF 或 cv::CAP_V4L。

构造函数5

使用 API 优先级和参数打开摄像头以进行视频捕获。
这是一个重载成员函数，为方便而提供。它与上述函数的不同之处仅在于它接受的参数。params 参数允许指定以成对形式编码的额外参数（paramId_1, paramValue_1, paramId_2, paramValue_2, …）。参见 cv::VideoCaptureProperties。


cv::VideoCapture::VideoCapture
(
	int 	index,
	int 	apiPreference,
	const std::vector< int > & 	params 
)

jndingxin