在 OpenCV 中,视频播放主要依赖 cv::VideoCapture
类来进行视频读取和播放,同时使用 cv::imshow
进行帧显示。下面是 cv::VideoCapture
相关的基本概念和用法解析。
cv::VideoCapture
类cv::VideoCapture
用于从视频文件、摄像头或网络流中读取视频数据。它可以处理多种格式的视频文件,如 MP4、AVI、MKV 以及摄像头流数据。
cv::VideoCapture(); // 空构造函数,需要后续调用 open()
cv::VideoCapture(const std::string& filename); // 通过文件路径打开视频
cv::VideoCapture(int deviceID); // 通过设备 ID 打开摄像头
方法 | 作用 |
---|---|
bool open(const std::string& filename) |
打开视频文件 |
bool open(int deviceID) |
打开摄像头 |
bool isOpened() const |
检查是否成功打开 |
void release() |
释放资源 |
bool read(cv::Mat& frame) |
读取下一帧 |
bool grab() |
只抓取一帧数据 |
bool retrieve(cv::Mat& frame, int flag = 0) |
获取当前抓取的帧 |
double get(int propId) |
获取视频参数 |
bool set(int propId, double value) |
设置视频参数 |
一个基本的视频播放程序通常包含以下步骤:
#include
#include
int main() {
cv::VideoCapture cap("video.mp4"); // 打开视频文件
if (!cap.isOpened()) {
std::cerr << "无法打开视频文件!" << std::endl;
return -1;
}
cv::Mat frame;
while (true) {
cap >> frame; // 读取一帧
if (frame.empty()) break; // 读取完毕则退出
cv::imshow("Video Playback", frame);
// 按 'q' 退出,延迟 30ms
if (cv::waitKey(30) == 'q') break;
}
cap.release();
cv::destroyAllWindows();
return 0;
}
可以使用 get()
和 set()
获取或修改视频参数:
double fps = cap.get(cv::CAP_PROP_FPS); // 获取帧率
int width = cap.get(cv::CAP_PROP_FRAME_WIDTH); // 获取宽度
int height = cap.get(cv::CAP_PROP_FRAME_HEIGHT); // 获取高度
修改属性(仅部分参数可修改):
cap.set(cv::CAP_PROP_FRAME_WIDTH, 640);
cap.set(cv::CAP_PROP_FRAME_HEIGHT, 480);
OpenCV 默认使用系统自带的编解码器播放视频,可能不支持所有格式。可以让 OpenCV 依赖 FFmpeg 来解码:
apt install ffmpeg
或 brew install ffmpeg
进行安装。检查 OpenCV 是否支持 FFmpeg:
std::cout << "FFmpeg support: " << cv::getBuildInformation() << std::endl;
cv::VideoCapture
读取和解码较慢,不如 FFmpeg 专用库快。如果你在 C++/Qt 项目中使用 OpenCV,可以使用 QLabel
结合 QImage
进行视频播放:
#include
#include
#include
#include
void displayFrame(cv::Mat frame, QLabel* label) {
cv::cvtColor(frame, frame, cv::COLOR_BGR2RGB);
QImage img(frame.data, frame.cols, frame.rows, frame.step, QImage::Format_RGB888);
label->setPixmap(QPixmap::fromImage(img));
}
cv::VideoCapture
是 OpenCV 进行视频播放的核心类,可以从文件、摄像头读取视频。cv::imshow()
显示 -> 监听 cv::waitKey()
控制播放。#include "widget.h"
#include "ui_widget.h"
#include
#include
#include
Widget::Widget(QWidget *parent)
: QWidget(parent),
ui(new Ui::Widget),
label(new QLabel(this)),
btnPlayPause(new QPushButton("暂停", this)), // 按钮默认显示“暂停”
cap("/mnt/app/1.mp4"), // 本地视频路径
timer(new QTimer(this)),
isPlaying(true)
{
ui->setupUi(this);
setFixedSize(700, 550); // 固定窗口大小
// 设置 QLabel 位置和大小
label->setGeometry(10, 10, 640, 480);
// 设置播放/暂停按钮
btnPlayPause->setGeometry(300, 500, 100, 40);
connect(btnPlayPause, &QPushButton::clicked, this, &Widget::togglePlayback);
// 检查视频文件是否打开成功
if (!cap.isOpened()) {
qWarning("无法打开视频文件!");
return;
}
// 启动定时器,每 30ms 更新一帧(大约 33 FPS)
connect(timer, &QTimer::timeout, this, &Widget::updateFrame);
timer->start(30);
}
Widget::~Widget()
{
cap.release(); // 释放 OpenCV 资源
delete timer;
delete ui;
}
void Widget::updateFrame()
{
if (!isPlaying) return; // 如果暂停,则不更新帧
cv::Mat frame;
cap >> frame; // 读取一帧
if (frame.empty()) {
qWarning("视频播放结束!");
timer->stop(); // 停止定时器
return;
}
// OpenCV 默认是 BGR 颜色格式,转换为 RGB
cv::cvtColor(frame, frame, cv::COLOR_BGR2RGB);
// 将 Mat 转换为 QImage
QImage img(frame.data, frame.cols, frame.rows, frame.step, QImage::Format_RGB888);
// 显示图像,并适配 QLabel 尺寸
label->setPixmap(QPixmap::fromImage(img).scaled(label->size(), Qt::KeepAspectRatio));
}
void Widget::togglePlayback()
{
isPlaying = !isPlaying;
btnPlayPause->setText(isPlaying ? "暂停" : "播放"); // 更新按钮文本
}
#ifndef WIDGET_H
#define WIDGET_H
#include
#include
#include
#include
#include
QT_BEGIN_NAMESPACE
namespace Ui {
class Widget;
}
QT_END_NAMESPACE
class Widget : public QWidget
{
Q_OBJECT
public:
Widget(QWidget *parent = nullptr);
~Widget();
private slots:
void updateFrame(); // 更新视频帧
void togglePlayback(); // 切换播放/暂停状态
private:
Ui::Widget *ui;
QLabel *label; // 用于显示视频的QLabel
QPushButton *btnPlayPause; // 播放/暂停按钮
cv::VideoCapture cap; // OpenCV视频捕获对象
QTimer *timer; // 用于定时刷新视频帧
bool isPlaying; // 播放状态标记
};
#endif // WIDGET_H