OpenCV设置CAP_PROP_WB_TEMPERATURE无生效问题技术咨询

问题核心原因 #

• 你使用的DFM 27UR0135-ML相机的官方驱动对OpenCV的CAP_PROP_AUTO_WB参数的取值逻辑和通用0/1开关不一致，和你查到的自动曝光参数规则类似，该参数的生效阈值是厂商自定义的。
• 你设置的CAP_PROP_WB_TEMPERATURE取值10超出了该相机支持的色温范围，常规工业相机的色温可调区间是2000K~10000K，最小取值不会低于2000，设置超出范围的数值会被驱动直接丢弃。
• 部分OpenCV编译版本默认用的后端不支持直接写入色温参数，需要先切换到对应厂商兼容的后端。

可直接落地的修改步骤 #

1. 首先修改CAP_PROP_AUTO_WB的赋值，针对该型号相机，关闭自动白平衡需要传入1而不是0，部分驱动版本需传入0.25，可以两个值都测试：

// Linux下用CAP_V4L2后端，Windows下换成CAP_DSHOW
cap.open(0, CAP_V4L2);
// 关闭自动白平衡，优先测试传入1，无效再试0.25
cap.set(CAP_PROP_AUTO_WB, 1); 
// cap.set(CAP_PROP_AUTO_WB, 0.25); // 上一行无效再取消注释这行

2. 调整色温取值到合法区间，从2000~10000的范围内逐级测试，数值越低画面越偏暖黄，数值越高画面越偏冷蓝，比如先设4500看画面变化：

cap.set(CAP_PROP_WB_TEMPERATURE, 4500);

3. 如果上面的方法依然无效，可以直接调整RGB通道的增益参数手动实现白平衡，该方法兼容性远高于直接设置色温：

// 关闭自动白平衡后直接设置红、蓝通道增益，绿通道作为基准一般不动
cap.set(CAP_PROP_WHITE_BALANCE_RED_V, 1.2); // 数值越高画面越偏红
cap.set(CAP_PROP_WHITE_BALANCE_BLUE_U, 0.8); // 数值越高画面越偏蓝

4. 可以在设置完所有参数后读取cap.set()的返回值确认是否生效，返回值为true才代表参数被驱动正常接收：

bool setSuccess = cap.set(CAP_PROP_WB_TEMPERATURE, 4500);
if (!setSuccess) {
    // 说明参数写入失败，优先检查自动白平衡是否成功关闭
}

补充说明 #

你之前用xphoto模块的自动白平衡是对已经采集到的内存帧做软件后处理，和直接修改相机硬件的白平衡参数属于两条完全独立的链路，所以之前的软件白平衡能生效不代表硬件参数写入逻辑正确。

内容的提问来源于stack exchange，提问作者noobie