[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