OpenCV视频I/O(14）创建和写入视频文件的类:VideoWriter介绍

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

算法描述

视频写入器类。
该类提供了用于写入视频文件或图像序列的 C++ API。

cv::VideoWriter 类是 OpenCV 库中用于创建和写入视频文件的一个类。它提供了用于设置视频编码器、帧率、文件路径等参数的方法，并允许用户将图像帧序列写入到视频文件中。

构造函数原型1

默认构造函数。

这些构造函数/函数初始化视频写入器。

• 在 Linux 上使用 FFMPEG 来写入视频；
• 在 Windows 上使用 FFMPEG 或 MSWF 或 DSHOW；
• 在 MacOSX 上使用 AVFoundation。

cv::VideoWriter::VideoWriter()	

构造函数原型2

这是一个重载的成员函数，提供方便之用。它与上述函数的区别仅在于所接受的参数不同。

cv::VideoWriter::VideoWriter
(
	const String & 	filename,
	int 	fourcc,
	double 	fps,
	Size 	frameSize,
	bool 	isColor = true 
)		

参数2

• 参数filename 输出视频文件的名称。
• 参数fourcc 用于压缩帧的编解码器的4字符代码。例如，VideoWriter::fourcc(‘P’, ‘I’, ‘M’, ‘1’) 是一个 MPEG-1 编码器，VideoWriter::fourcc(‘M’, ‘J’, ‘P’, ‘G’) 是一个运动 JPEG 编码器等。代码列表可以在 MSDN 页面或 fourcc 站点的这个页面上获得，以获取更完整的列表。FFMPEG 后端与 MP4 容器原生使用其他值作为 fourcc 代码：参见 ObjectType，因此您可能会收到 OpenCV 关于 fourcc 代码转换的警告消息。
• 参数fps 创建的视频流的帧率。
• 参数frameSize 视频帧的大小。
• 参数isColor 如果不为零，编码器将期望并编码彩色帧，否则将处理灰度帧。

提示：

在某些后端中，fourcc = -1 会弹出系统中的编解码器选择对话框。
要保存图像序列，请使用适当的文件名（例如 img_%02d.jpg）并设置 fourcc = 0 或者 fps = 0。使用无压缩的图像格式（例如 img_%02d.BMP）来保存原始帧。
大多数编解码器都是有损的。如果你想创建无损视频文件，你需要使用无损编解码器（例如 FFMPEG FFV1、Huffman HFYU、Lagarith LAGS 等）。
如果启用了 FFMPEG，使用 codec = 0；fps = 0；你可以创建一个无压缩（原始）视频文件。
如果使用 FFMPEG，我们允许奇数宽度或高度的帧，但在这种情况下我们会截断最右侧的一列/最底部的一行。可能这应该处理得更优雅一些，但 FFMPEG swscale 中的一些内部函数需要偶数宽度/高度。

构造函数原型3

这是一个重载的成员函数，提供方便之用。它与上述函数的不同之处仅在于所接受的参数。apiPreference 参数允许指定要使用的 API 后端。如果存在多个可用的读取器实现，可以用来强制使用某个特定的实现：例如 cv::CAP_FFMPEG 或 cv::CAP_GSTREAMER。

cv::VideoWriter::VideoWriter	
(
	const String & 	filename,
	int 	apiPreference,
	int 	fourcc,
	double 	fps,
	Size 	frameSize,
	bool 	isColor = true 
)		

参数3

• 参数filename：输出视频文件的名称。
• 参数apiPreference：指定要使用的 API 后端。如果存在多个可用的后端，可以用来强制使用某个特定的实现。例如 cv::CAP_FFMPEG 或 cv::CAP_GSTREAMER。
• 参数fourcc：用于压缩帧的编解码器的4字符代码。例如，VideoWriter::fourcc(‘X’, ‘V’, ‘I’, ‘D’) 表示 XVID 编码器。
• 参数fps：创建的视频流的帧率（每秒帧数）。
• 参数frameSize：视频帧的大小（宽度和高度）。
• 参数isColor：如果为 true，则编码器将期望并编码彩色帧；如果为 false，则编码器将处理灰度帧。默认值为 true。

构造函数原型4

这是一个重载的成员函数，提供方便之用。它与上述函数的不同之处仅在于所接受的参数。params 参数允许指定额外的编码器参数，这些参数是以成对的形式编码的（paramId_1, paramValue_1, paramId_2, paramValue_2, …）。参见 cv::VideoWriterProperties。

cv::VideoWriter::VideoWriter	
(
	const String & 	filename,
	int 	fourcc,
	double 	fps,
	const Size & 	frameSize,
	const std::vector< int > & 	params 
)		

参数4

• 参数filename：输出视频文件的名称。
• 参数fourcc：用于压缩帧的编解码器的4字符代码。例如，VideoWriter::fourcc(‘X’, ‘V’, ‘I’, ‘D’) 表示 XVID 编码器。
• 参数fps：创建的视频流的帧率（每秒帧数）。
• 参数frameSize：视频帧的大小（宽度和高度）。
• 参数params：额外的编码器参数，存储在一个 std::vector 中。这些参数可以根据具体的编解码器进行配置。

构造函数5

这是一个重载的成员函数，提供方便之用。它与上述函数的不同之处仅在于所接受的参数。

cv::VideoWriter::VideoWriter
(
	const String & 	filename,
	int 	apiPreference,
	int 	fourcc,
	double 	fps,
	const Size & 	frameSize,
	const std::vector< int > & 	params 
)	

参数5

• 参数filename：输出视频文件的名称。
• 参数apiPreference：指定要使用的 API 后端。如果存在多个可用的后端，可以用来强制使用某个特定的实现。例如 cv::CAP_FFMPEG 或 cv::CAP_GSTREAMER。
• 参数fourcc：用于压缩帧的编解码器的4字符代码。例如，VideoWriter::fourcc(‘X’, ‘V’, ‘I’, ‘D’) 表示 XVID 编码器。
• 参数fps：创建的视频流的帧率（每秒帧数）。
• 参数frameSize：视频帧的大小（宽度和高度）。
• 参数params：额外的编码器参数，存储在一个 std::vector 中。这些参数可以根据具体的编解码器进行配置

代码示例

#include <opencv2/opencv.hpp>
#include <iostream>

int main()
{
    // 创建 VideoCapture 对象来捕获视频帧
    cv::VideoCapture cap( 0 );  // 使用默认摄像头

    // 检查摄像头是否成功打开
    if ( !cap.isOpened() )
    {
        std::cerr << "Failed to open the camera." << std::endl;
        return -1;
    }

    // 根据操作系统选择视频编码器的 FourCC 代码
    int fourcc;
#if defined( _WIN32 ) || defined( _WIN64 )
    // Windows 平台
    fourcc = cv::VideoWriter::fourcc( 'M', 'S', 'W', 'F' );  // 使用 MSWF 编码器
#elif defined( __APPLE__ )
    // macOS 平台
    fourcc = cv::VideoWriter::fourcc( 'a', 'v', 'c', '1' );  // 使用 avc1 (H.264) 编码器
#else
    // Linux 或其他 Unix-like 系统
    fourcc = cv::VideoWriter::fourcc( 'X', '2', '6', '4' );  // 使用 X264 编码器
#endif

    // 创建 VideoWriter 对象
    cv::VideoWriter writer;

    // 打开视频文件用于写入
    bool success = writer.open( "output.mp4",                                                                           // 输出视频文件名
                                fourcc,                                                                                 // 视频编码器的 FourCC 代码
                                25,                                                                                     // 帧率（每秒帧数）
                                cv::Size( cap.get( cv::CAP_PROP_FRAME_WIDTH ), cap.get( cv::CAP_PROP_FRAME_HEIGHT ) ),  // 帧大小
                                true                                                                                    // 是否为彩色视频
    );

    if ( !success )
    {
        std::cerr << "Failed to initialize the video writer." << std::endl;
        return -1;
    }

    // 捕获并写入视频帧
    cv::Mat frame;
    while ( true )
    {
        // 从摄像头读取一帧
        if ( !cap.read( frame ) )
        {
            std::cout << "No frame grabbed." << std::endl;
            break;
        }

        // 写入帧到视频文件
        writer.write( frame );

        // 显示当前帧
        cv::imshow( "Live Camera", frame );

        // 按 'q' 键退出循环
        if ( cv::waitKey( 1 ) == 'q' )
        {
            break;
        }
    }

    // 释放资源
    cap.release();
    writer.release();
    cv::destroyAllWindows();

    return 0;
}

运行结果