Python + 迈德威视工业相机图像发绿/偏色问题解决：自定义白平衡配置文件加载详解
一、问题背景
在使用迈德威视（MindVision）工业相机进行 Python 二次开发时，经常会遇到一个问题：
相机 SDK 能正常采集图像，但是 OpenCV 获取到的图片颜色明显异常，例如：
- 整体偏绿色
- 白色物体变成青绿色
- 红色、蓝色颜色失真
- 相机自带软件显示正常，但是代码采集异常
本次遇到的问题表现如下：
- 相机通过 SDK 获取图像；
cv2.imwrite()保存图片后查看颜色也是错误；- 排查发现不是 Qt 显示导致，也不是 BGR/RGB 转换问题；
设置：
mvsdk.CameraSetIspOutFormat(self.hCamera,mvsdk.CAMERA_MEDIA_TYPE_MONO8)之后出现：
- 图像变成三张拼接；
- 出现黑色区域；
- 图像格式异常。
最终定位：
相机 Bayer 原始数据没有正确进行白平衡校正。
解决方法：
使用迈德威视官方软件完成自定义白平衡，然后导出 config 配置文件，在代码初始化相机时加载该配置。
二、问题分析
1. 为什么相机出来会发绿？
工业彩色相机大多数采用 Bayer Sensor。例如：
RGGB Bayer 排列：
R G R G G B G B R G R G G B G B传感器实际采集的是红色通道、绿色通道、蓝色通道的灰度信息。但是传感器本身不知道颜色。
需要 ISP（Image Signal Processor）进行：
- Bayer 插值
- 白平衡
- 色彩校正
- Gamma
- 饱和度调整
流程：
Sensor RAW数据 | ↓ Bayer解码 | ↓ 白平衡校正 | ↓ 颜色矩阵转换 | ↓ RGB/BGR图像如果白平衡参数错误，例如：
- R增益 = 1.0
- G增益 = 1.0
- B增益 = 1.0
而实际光源绿色通道响应更强，最终G > R > B，图片自然偏绿。
三、错误排查过程
1. 排除 OpenCV 颜色转换问题
很多人第一反应是不是cv2.cvtColor()导致，例如：
img_rgb=cv2.cvtColor(img,cv2.COLOR_BGR2RGB)但是测试：
cv2.imwrite("test.bmp",frame)发现保存图片依然发绿。说明图像进入 OpenCV 前已经错误。
2. 排查是否是黑白模式设置
尝试：
mvsdk.CameraSetIspOutFormat(self.hCamera,mvsdk.CAMERA_MEDIA_TYPE_MONO8)结果图片异常：三幅拼接、黑色区域、尺寸异常。
原因：
当前相机cap.sIspCapacity.bMonoSensor输出为0，说明不是黑白 Sensor，而是彩色 Bayer Sensor，不能直接设置 MONO8。
四、正确解决方法：使用迈德威视软件校准白平衡
1. 打开迈德威视官方工具
进入设备管理 -> 相机设置，找到白平衡，选择自定义白平衡。
2. 准备标准白色区域
例如白纸、白色陶瓷板、标准白板。让相机看到均匀白色区域，然后执行自动白平衡。相机会计算 R Gain、G Gain、B Gain，例如：
- R = 1.35
- G = 1.00
- B = 1.52
3. 保存配置文件
点击“保存参数到文件”，生成camera.config。
Config/ └── camera.config五、代码加载配置文件
初始化相机原代码：
self.hCamera=mvsdk.CameraInitEx2(self.cam_name)后面增加：
mvsdk.CameraReadParameterFromFile(self.hCamera,"Config/camera.config")完整代码：
self.hCamera=mvsdk.CameraInitEx2(self.cam_name)mvsdk.CameraReadParameterFromFile(self.hCamera,os.path.join(pwd,"Config/camera.config"))这样启动相机时，会自动加载白平衡、曝光、增益、Gamma、ISP 参数。
六、为什么不推荐代码里面手动调白平衡？
很多人会尝试CameraSetGain()或者CameraSetAnalogGain()，但是增益 ≠ 白平衡。
增加红色不是整体亮度增加，而是 R 通道增益提高，需要 R Gain、G Gain、B Gain 三个独立参数。而迈德威视软件自动计算更加准确。
七、补充：如何判断是否加载成功？
可以打印：
cap=mvsdk.CameraGetCapability(self.hCamera)print(cap.sIspCapacity.bMonoSensor)- 彩色：
0 - 黑白：
1
彩色相机不要强制CAMERA_MEDIA_TYPE_MONO8，否则 Bayer 数据无法正确转换。
八、工业视觉项目推荐流程
实际工业项目中建议：
相机安装 | ↓ 调整曝光 | ↓ 固定光源 | ↓ 白平衡校准 | ↓ 保存config | ↓ 程序启动加载config | ↓ OpenCV算法处理不要：
程序启动 | ↓ 自动白平衡 | ↓ 开始检测因为自动白平衡会随着产品颜色、背景、光照不断变化。对于机器视觉，颜色稳定比颜色准确更加重要。
九、总结
本次偏绿问题最终原因：
- ❌ 不是 Qt 显示问题
- ❌ 不是 OpenCV BGR/RGB 转换问题
- ❌ 不是保存图片问题
- ❌ 不是相机坏了
真正原因：
- ✅ 彩色 Bayer 相机 ISP 白平衡参数未校准
正确方案：
- 使用迈德威视官方软件；
- 对白色目标执行自定义白平衡；
- 导出 config 文件；
- Python 初始化相机时，通过
mvsdk.CameraReadParameterFromFile()加载配置。
这是工业视觉项目中非常常见的相机初始化流程，尤其是在 工业 检测、SMT 检测、机器视觉定位、OCR 识别、缺陷检测中，相机参数固化是保证算法稳定性的关键步骤。