sensor_manual_gain_control.py

# 本作品采用MIT许可证授权。
# 版权所有 (c) 2013-2023 OpenMV LLC。保留所有权利。
# https://github.com/openmv/openmv/blob/master/LICENSE
#
# 传感器手动增益控制
#
# 此示例展示了如何控制相机传感器的
# 手动增益与自动增益控制运行。

# 增益控制和曝光控制有什么区别？
#
# 通过增加图像的曝光时间，您可以获得更多
# 相机上的光线。这为您提供了最佳的信噪比。
# 通常总是希望优先增加曝光时间...但是，当您
# 增加曝光时间时，最大可达帧率会降低，
# 而且若图像中有物体移动，曝光时间越长，
# 模糊就越明显。增益控制允许您通过模拟和数字乘法器
# 提高每个像素的输出...但它同时也会放大
# 噪声。因此，最好先让曝光尽可能增加，
# 然后再用增益控制来弥补剩余的差距。

import csi
import time

# 更改此值以调整增益。尝试10.0/0/0.1等。
GAIN_SCALE = 1.0

csi0 = csi.CSI()
csi0.reset()  # 重置并初始化传感器。
csi0.pixformat(csi.RGB565)  # 将像素格式设置为RGB565 (or GRAYSCALE)
csi0.framesize(csi.QVGA)  # 将帧大小设置为QVGA (320x240)

# 打印初始增益以进行比较。
print("Initial gain == %f db" % csi0.gain_db())

csi0.snapshot(time=2000)  # 等待设置生效。
clock = time.clock()  # 创建一个时钟对象来跟踪FPS。

# 你必须关闭自动曝光控制和自动白平衡
# 否则它们会改变图像曝光以撤销任何增益设置
# 你所设定的...
csi0.auto_exposure(False)
csi0.auto_whitebal(False)
# 需要让上述设置生效...
csi0.snapshot(time=500)

current_gain_in_decibels = csi0.gain_db()
print("Current Gain == %f db" % current_gain_in_decibels)

# 自动增益控制 (AGC) 默认启用。调用以下函数
# 禁用传感器自动增益控制。额外的 "gain_db"
# 参数在 AGC 禁用后覆盖自动增益值。
csi0.auto_gain(False, gain_db=current_gain_in_decibels * GAIN_SCALE)

print("New gain == %f db" % csi0.gain_db())
# csi0.gain_db()返回相机传感器的精确增益分贝值。
# 然而，这可能与命令的值不同，因为
# 传感器代码将增益转换为小增益值和大增益值
# 无法接受所有可能的值...

# 如果想重新开启自动增益，请执行：csi0.auto_gain(True)
# 请注意，相机传感器将根据需要更改增益。

# 执行：csi0.auto_gain(False)
# 只是禁用增益值更新，但不会改变增益
# 相机传感器确定的值是好的。

while True:
    clock.tick()  # 更新FPS时钟。
    img = csi0.snapshot()  # 拍照并返回图像。
    print(clock.fps())  # 注意：OpenMV摄像头在连接至IDE时运行速度会降低约一半。
    # 断开连接后，帧率应会提升。