### 如何使用 OpenCV 的 `imwrite` 函数保存图像 #### 加载库与初始化环境 为了能够调用 `imwrite()` 函数，程序需要先引入必要的头文件，并创建一个矩阵对象来存储要保存的图像数据。 ```cpp #include <opencv2/opencv.hpp> using namespace cv; ``` 这段代码展示了如何包含 OpenCV 头文件以及命名空间声明[^3]。 #### 图像加载 接着，在执行任何操作之前，应该确保已经成功地从指定路径加载了目标图像： ```cpp Mat src_image = imread("path_to_input_image"); if (src_image.empty()) { std::cout << "Could not open or find the image!" << std::endl; return -1; } ``` 此部分代码用于验证输入图片是否存在并且可以被正确读取。 #### 调用 `imwrite` 进行图像保存 一旦获得了有效的图像数据，就可以通过简单的函数调用来实现图像的保存功能。下面是一个基本的例子，它会按照原始格式将图像保存至新的位置： ```cpp bool success = imwrite("output_path/image_name.jpg", src_image); if (!success) { std::cerr << "Failed to write the file." << std::endl; } else { std::cout << "Image successfully saved as output_path/image_name.jpg" << std::endl; } ``` 这里定义了一个布尔变量 `success` 来接收返回的结果状态；如果失败，则打印错误消息；反之则确认已成功完成保存过程。 #### 修改编码参数（可选） 对于更高级的应用场景来说，可能还需要调整一些额外选项比如压缩级别等。这可以通过传递第三个参数给 `imwrite()` 实现——即一组由整数组成的向量列表，其中包含了特定于所选格式的各种设置项。 ```cpp std::vector<int> compression_params; compression_params.push_back(IMWRITE_JPEG_QUALITY); // JPEG quality flag. compression_params.push_back(95); // Set desired value between 0 and 100. // Save with custom parameters. imwrite("high_quality_output.jpg", src_image, compression_params); ``` 上述片段说明了怎样设定JPEG质量因子为95%，从而获得更高品质但体积较大的输出文件[^1]。 #### 完整示例代码 最后给出完整的C++源码作为参考： ```cpp #include <opencv2/opencv.hpp> #include <iostream> int main() { // Load an image from a given path. Mat src_image = imread("input_image_path"); if (src_image.empty()) { std::cout << "Error loading image."; return EXIT_FAILURE; } // Optionally set up encoding parameters here... // Write out the loaded image into another location/file name. bool result = imwrite("destination_file_path", src_image); if (!result){ std::cerr << "Saving failed!"; } waitKey(); return 0; } ```