[C++] opencv - imwrite函数介绍和使用场景

一、函数介绍

OpenCV 是一个开源的计算机视觉库，它包含了许多用于图像处理和计算机视觉任务的函数。其中，imsave() 函数是 OpenCV 中的一个非常有用的函数，它可以让程序将处理后的图像数据保存到指定的文件中。

二、函数原型

bool imwrite(const String& filename, InputArray image, const std::vector& params);

其中，
filename 参数表示要保存的文件名
image 参数表示要保存的图像数据
params 可选参数表示保存图像使用的参数

params 使用说明：
该参数需要按照参数id+参数值成对出现，可以出现多对参数值(比如 (paramId_1, paramValue_1, paramId_2, paramValue_2, ...))，但必须保证这些参数对是相关的,比如保存JPG图像时，只能使用和JPEG相关的参数ID进行组合使用。

可以使用的参数Id可以参考cv::ImwriteFlags。

cv::ImwriteFlags是一个枚举类型，用于指定图像写入时的压缩和质量选项。它包含了以下几个成员：

cv::IMWRITE_JPEG_QUALITY:设置JPEG图像的质量，范围为0到100,数值越高质量越好，但文件大小也会相应增加。
cv::IMWRITE_PNG_COMPRESSION:设置PNG图像的压缩级别，范围为0(无压缩)到9(最大压缩),数值越小压缩率越高，但文件大小也会相应增加。
cv::IMWRITE_PXM_BINARY:将PXM图像保存为二进制格式，不进行任何压缩。
cv::IMWRITE_PXM_FORMAT:设置PXM图像的格式，可以是ASCII或二进制。
cv::IMWRITE_UNCHANGED:如果图像已经是原始格式(如BGR),则不进行任何转换。
cv::IMWRITE_ANYDEPTH:如果图像具有不同的深度(例如，一个是8位深度，另一个是16位深度),则将其视为具有相同深度的图像。
cv::IMWRITE_ANY_COLOR:如果图像具有不同的颜色空间(例如，一个是BGR,另一个是HSV),则将其视为具有相同颜色空间的图像。
cv::IMWRITE_ANY_MASK:如果图像具有不同的掩码(例如，一个是3通道，另一个是4通道),则将其视为具有相同掩码的图像。
cv::IMWRITE_ANY_DEPTH:如果图像具有不同的深度(例如，一个是8位深度，另一个是16位深度),则将其视为具有相同深度的图像。
cv::IMWRITE_ANY_INTERPOLATION:如果图像具有不同的插值方法(例如，一个是线性插值，另一个是双线性插值),则将其视为具有相同插值方法的图像。
cv::IMWRITE_ANY_BILINEAR:如果图像具有不同的双线性插值方法(例如，一个是普通双线性插值，另一个是超级双线性插值),则将其视为具有相同双线性插值方法的图像。
cv::IMWRITE_ANY_HALF:如果图像具有不同的半精度浮点数表示方法(例如，一个是16位浮点数，另一个是32位浮点数),则将其视为具有相同半精度浮点数表示方法的图像。
cv::IMWRITE_ANY_VECTOR:如果图像具有不同的向量表示方法(例如，一个是整数向量，另一个是浮点向量),则将其视为具有相同向量表示方法的图像。
cv::IMWRITE_ANY_RGB:如果图像具有不同的RGB分量顺序(例如，一个是BGR,另一个是RGB),则将其视为具有相同RGB分量顺序的图像。
cv::IMWRITE_ANY_STREAM:如果图像具有不同的数据流格式(例如，一个是内存流，另一个是文件流),则将其视为具有相同数据流格式的图像。

三、函数使用的场景

保存图像到本地文件系统

使用 imwrite() 函数可以将处理后的图像数据保存到本地文件系统中。例如，可以使用 imwrite() 函数将一张 JPG 或 PNG 格式的图片保存到本地文件系统中：

Mat image = ...; // 处理后的图像数据
string filename = "test.jpg"; // 要保存的文件名
imwrite(filename, image); // 将图像数据保存到本地文件系统中

保存图像时通过params设置来控制图像质量

下是一些使用OpenCV的imwrite函数的params参数的案例：

保存为JPEG格式的图片，质量为90(默认值为75):

std::vector params = {cv::IMWRITE_JPEG_QUALITY, 90};
cv::imwrite("image.jpg", image, params);

保存为PNG格式的图片，压缩级别为6(默认值为-1):

std::vector params = {cv::IMWRITE_PNG_COMPRESSION, 6};
cv::imwrite("image.png", image, params);

保存图像到内存缓冲区

有时候，需要将图像数据保存到内存缓冲区中进行进一步处理。这时，可以使用 imencode() 函数将图像数据编码为字节流，然后再使用 imdecode() 函数将字节流解码为 Mat 对象：

vector buffer; // 存储图像数据的缓冲区
Mat image = ...; // 处理后的图像数据
imencode(".jpg", image, buffer); // 将图像数据编码为字节流
imdecode(buffer, IMREAD_COLOR); // 将字节流解码为 Mat 对象

四、完整代码实例

下面是一个完整的代码示例，演示了如何使用 imwrite() 函数将处理后的图像数据保存到本地文件系统中：

#include 
using namespace cv;

int main() {
    Mat image = imread("test.jpg"); // 读取本地文件中的图像数据
    if (image.empty()) {
        cout << "Failed to open image file!" << endl;
        return -1;
    }

    string filename = "output.jpg"; // 要保存的文件名
    bool result = imwrite(filename, image); // 将图像数据保存到本地文件系统中
    if (result) {
        cout << "Image saved successfully!" << endl;
    } else {
        cout << "Failed to save image!" << endl;
    }

    return 0;
}

五、总结

通过本文的介绍，我们了解了 OpenCV 中的 imwrite() 函数的基本用法和应用场景。该函数可以帮助我们方便地将处理后的图像数据保存到本地文件系统中，或者将其保存到内存缓冲区中进行进一步处理。在实际开发中，我们可以根据具体需求灵活运用该函数，提高开发效率。