使用OpenCV通过键盘输入调整CAP_PROP_EXPOSURE参数的问题咨询

故障原因梳理 #

• 画面静止：你使用的cv2.waitKey(0)入参为0时会永久阻塞等待键盘输入，只有收到按键事件才会执行后续逻辑，帧读取、画面刷新全都会被卡住，自然看起来是静止状态。
• E/D按键无效：按键读取变量key2定义在主循环外，只会在程序启动时读取1次，后续循环内的按键输入存在key变量里，你判断的还是最初的key2值，自然不会响应E/D按键操作。
• 曝光调整失效的隐藏问题：绝大多数USB摄像头默认开启自动曝光，这种状态下手动修改CAP_PROP_EXPOSURE参数会被自动曝光逻辑覆盖，必须先手动关闭自动曝光功能。

CAP_PROP_EXPOSURE动态调整说明 #

CAP_PROP_EXPOSURE本身完全支持动态调整，只要你的摄像头符合UVC（USB视频类）协议，几乎都支持运行时修改该参数，不需要重启摄像头或者重新初始化VideoCapture对象。

修正后可运行代码 #

import cv2

# 连接IMX291摄像头
captureDevice = cv2.VideoCapture(1, cv2.CAP_DSHOW)
# 关闭自动曝光：不同摄像头有效值可能不同，常见为0/1，部分设备为-4/3，不生效可尝试换值
captureDevice.set(cv2.CAP_PROP_AUTO_EXPOSURE, 0)
# 初始曝光值
exposure = 0
captureDevice.set(cv2.CAP_PROP_EXPOSURE, exposure)
# 增益设置
captureDevice.set(cv2.CAP_PROP_GAIN, 1)
# 分辨率设置
captureDevice.set(cv2.CAP_PROP_FRAME_WIDTH, 480)
captureDevice.set(cv2.CAP_PROP_FRAME_HEIGHT, 480)

while captureDevice.isOpened(): 
    ret, frame = captureDevice.read()
    if not ret:
        break

    # 显示画面
    cv2.imshow('Webcam', frame)

    # waitKey入参改为1，代表最多等待1ms按键事件，不阻塞帧刷新
    key = cv2.waitKey(1) & 0xFF
    if key == ord('q'): 
        break
    # 响应按键调整曝光，增加边界限制避免超出设备支持范围
    if key == ord('e'):
        exposure += 0.5
        exposure = min(exposure, 20)
        captureDevice.set(cv2.CAP_PROP_EXPOSURE, exposure)
    if key == ord('d'):
        exposure -= 0.5
        exposure = max(exposure, -10)
        captureDevice.set(cv2.CAP_PROP_EXPOSURE, exposure)

# 释放资源
captureDevice.release()
cv2.destroyAllWindows()

补充注意事项 #

如果关闭自动曝光后设置曝光仍不生效，可以尝试修改CAP_PROP_AUTO_EXPOSURE的设置值为1、-4、3等，不同厂商的摄像头对该参数的有效值定义存在差异。不同摄像头支持的曝光值范围不同，调整时如果碰到某个阈值后继续修改参数画面无变化，说明已经到了设备支持的上下限。

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