项目场景

Baumer工业相机堡盟相机是一种高性能、高质量的工业相机，可用于各种应用场景，如物体检测、计数和识别、运动分析和图像处理。

Baumer的万兆网相机拥有出色的图像处理性能，可以实时传输高分辨率图像。此外，该相机还具有快速数据传输、低功耗、易于集成以及高度可扩展性等特点。

相机的自动曝光功能可以使得在光照条件不断变化的应用中也能轻松实现相机集成

技术背景

工业相机的自动曝光功能通常依赖于硬件和软件功能的结合。

在硬件方面，相机通常使用光电二极管等传感器来检测场景中的光线水平。它们还可能利用具有可变光圈的镜头，从而可以更好地控制进入相机的光量。

在软件方面，自动曝光算法通常使用反馈回路来调整相机设置，如快门速度、光圈和ISO灵敏度，以应对光线的变化。这些算法还可能考虑到一些因素，如所需的图像对比度，被拍摄场景的动态范围，以及相机的曝光测光模式（如点测，平均测，或矩阵测）。

总的来说，工业相机自动曝光的目标是确保以最佳的亮度和对比度拍摄图像，同时最大限度地减少由曝光过度或曝光不足引起的噪音和其他图像伪影。

代码分析

Baumer工业相机堡盟相机SDK示例中021_BrightnessAuto.cpp详细介绍了如何配置相机BrightnessAuto功能。

软件SDK示例地址如下所示：Baumer_GAPI_SDK_2.12.0_win_x86_64_cpp\examples\src\0_Common\021_BrightnessAuto\021_BrightnessAuto.cpp

代码整体结构相对简单，在相机初始化后进行相机的BrightnessAuto功能使用，部分核心代码如下：

std::cout << std::endl;
std::cout << "CONFIGURE BRIGHTNESSAUTO" << std::endl;
std::cout << "########################" << std::endl << std::endl;

try 
{
    std::cout << "  Limit exposure max to 500ms" << std::endl;
    pDevice->brightness_auto.SetExposureMaxValue(500000);

    std::cout << "  Start BrightnessAuto ONCE mode" << std::endl;
    pDevice->brightness_auto.SetMode(BGAPI2::BrightnessAuto::ONCE);
    std::cout << std::endl;

    DisplayBrightnessAutoSettings(&pDevice->brightness_auto);
}
catch (BGAPI2::Exceptions::IException& ex) {
    returncode = (returncode == 0) ? 1 : returncode;
    std::cout << "ExceptionType:    " << ex.GetType() << std::endl;
    std::cout << "ErrorDescription: " << ex.GetErrorDescription() << std::endl;
    std::cout << "in function:      " << ex.GetFunctionName() << std::endl;
}




std::cout << "CONFIGURE BRIGHTNESSAUTO" << std::endl;
std::cout << "########################" << std::endl << std::endl;

try 
{
    std::cout << "default: " << std::endl;
    std::cout << "  Algorithm: "
        << GetBrightnessAutoAlgorithm(pDevice->brightness_auto.GetAlgorithm()) << std::endl;
    std::cout << "  ControlFeature: "
        << GetBrightnessAutoControlFeature(pDevice->brightness_auto.GetControlFeature()) << std::endl;
    std::cout << std::endl;

    std::cout << "  Reset all parameters to default" << std::endl;
    pDevice->brightness_auto.Default();

    std::cout << "  Set nominal value to 75%" << std::endl;
    pDevice->brightness_auto.SetNominalValue(75.0);

    if (CheckCorrectPayloadType(pDevice)) 
	{
        std::cout << "  Start CONTINUOUS mode with EXPOSURE_ONLY and SOFTWARE algorithm"
                    << std::endl;
        pDevice->brightness_auto.SetMode(
            BGAPI2::BrightnessAuto::CONTINUOUS,
            BGAPI2::BrightnessAuto::EXPOSURE_ONLY,
            BGAPI2::BrightnessAuto::SOFTWARE);
    } else {
        std::cout << "  Start CONTINUOUS mode with EXPOSURE_ONLY and HARDWARE algorithm,"
                    " because camera is in JPEG mode" << std::endl;
        pDevice->brightness_auto.SetMode(
            BGAPI2::BrightnessAuto::CONTINUOUS,
            BGAPI2::BrightnessAuto::EXPOSURE_ONLY,
            BGAPI2::BrightnessAuto::HARDWARE);
    }
    std::cout << std::endl;

    DisplayBrightnessAutoSettings(&pDevice->brightness_auto);
}
catch (BGAPI2::Exceptions::IException& ex) {
    returncode = (returncode == 0) ? 1 : returncode;
    std::cout << "ExceptionType:    " << ex.GetType() << std::endl;
    std::cout << "ErrorDescription: " << ex.GetErrorDescription() << std::endl;
    std::cout << "in function:      " << ex.GetFunctionName() << std::endl;
}