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
)