`cv::Mat::convertTo()` 是 OpenCV 中非常重要的一个成员函数，用于将矩阵（图像）从一种数据类型转换为另一种数据类型，同时可以进行可选的缩放和平移操作。 --- ### 函数原型 ```cpp void cv::Mat::convertTo(OutputArray m, int rtype, double alpha = 1.0, double beta = 0.0) const; ``` #### 参数说明： | 参数 | 说明 | |------|------| | `m` | 输出矩阵（结果） | | `rtype` | 目标数据类型，例如 `CV_32F`, `CV_8U` 等。如果包含通道数，如 `CV_32FC3`，也可以使用。 | | `alpha` | 缩放因子（乘法项），默认为 1.0 | | `beta` | 平移因子（加法项），默认为 0.0 | 该函数执行的操作是： ``` m(x,y) = alpha * this(x,y) + beta ``` 然后将结果转换为目标数据类型。 --- ### 常见用途 1. **类型转换**：比如将 `float` 图像转为 `uchar` 用于显示。 2. **归一化像素值**：比如将 [0,1] 范围的浮点图像扩展到 [0,255] 显示。 3. **准备模型输入/输出**：深度学习中常见 float32 输入，需要从 uint8 归一化。 --- ### 示例代码 #### 示例 1：将 `CV_8UC1` 图像转为 `CV_32F` 并归一化到 [0,1] ```cpp #include <opencv2/opencv.hpp> using namespace cv; int main() { // 读取灰度图像（0~255） Mat img_8u = imread("image.jpg", IMREAD_GRAYSCALE); // 转换为 float 类型，像素值变为 [0.0, 1.0] Mat img_float; img_8u.convertTo(img_float, CV_32F, 1.0 / 255.0, 0.0); // 现在 img_float 中每个像素值在 [0.0, 1.0] 之间 imshow("Original", img_8u); imshow("Float [0,1]", img_float); waitKey(0); return 0; } ``` > ✅ 这常用于深度学习推理前的数据预处理。 --- #### 示例 2：将浮点图像恢复为 `uint8` 显示 ```cpp // 假设你有一个 [0,1] 范围的浮点图像 Mat processed_float; // 已处理的 float 图像 // 转回 uint8，范围 [0,255] Mat result_8u; processed_float.convertTo(result_8u, CV_8U, 255.0, 0.0); imshow("Result", result_8u); waitKey(0); ``` > ⚠️ 注意：OpenCV 的 `imshow` 对 `float` 图像要求值域为 [0,1]，否则会显示异常（全白或全黑）。 --- #### 示例 3：带偏移的类型转换（类似线性变换） ```cpp // 将图像做变换：new_val = 2.0 * old_val + 10 Mat dst; img_8u.convertTo(dst, CV_16S, 2.0, 10.0); // 转为有符号 short ``` 这在某些算法中用于防止溢出或中间计算。 --- ### 数据类型说明（常用） | 类型名 | 含义 | |-------|------| | `CV_8U` | 8-bit 无符号整数（0 ~ 255） | | `CV_8S` | 8-bit 有符号整数（-128 ~ 127） | | `CV_16U` | 16-bit 无符号整数 | | `CV_16S` | 16-bit 有符号整数（常用中间计算） | | `CV_32F` | 32-bit 浮点数（最常用的 float） | | `CV_64F` | 64-bit 双精度浮点数 | --- ### 注意事项 1. **避免溢出**：转换时确保目标类型能容纳 `alpha * src + beta` 的结果。 - 比如将 `255` 的 `uchar` 直接乘以 `2.0` 得到 `510`，若转成 `CV_8U` 会截断为 `255`。 2. **深度学习预处理常用模式**： ```cpp img.convertTo(float_img, CV_32F, 1.0 / 255.0); // [0,255] -> [0,1] ``` 3. 如果 `rtype` 只指定类型（如 `CV_32F`），通道数自动继承源图像。 --- ### 总结 `convertTo` 是 OpenCV 中实现**数据类型转换 + 线性变换**的核心函数，语法简洁但功能强大，广泛应用于图像预处理、数值计算和可视化等场景。 ---