Brightness and Contrast#

相机的 Brightness and Contrast 功能可让您调整图像的色调值。

亮度和对比度始终作为通用亮度/对比度数学函数的一部分一起处理。

该功能的使用#

调整对比度和对比模式#

调整对比度：

1. 设置 BslContrastMode 参数为以下值（如果可用）：
   • Linear
   • SCurve
2. Enter a value for the BslContrast parameter. The parameter's value range is from -1 to 1. By default, the parameter is set to 0 which means that the contrast remains unchanged.

调整亮度#

To adjust the brightness, enter a value for the BslBrightness parameter. The parameter's value range is from -1 to 1. By default, the parameter is set to 0 which means that the brightness remains unchanged.

运作原理#

对比度#

调整对比度会更改图像中明暗区域之间的差异程度。应用的对比度越高，差异就越明显。

如何应用对比度取决于您选择的对比模式。

线性对比模式#

如果选择此对比度模式，相机将使用线性函数来调整对比度。增大或减小对比度，可增大或减小线性函数的梯度。

如果对比度设置大于 0，则更多的输出像素值将被设置为全黑 (0) 或全白（最大像素值）。

如果将对比度设置为 0.3（请参见第二张图），则将 0 到大约 50 的输入值设置为全黑，而将大约 205 到 255 的输入值设置为全白。这意味着色调值的总范围（即图像的动态范围）缩小了。图像的最暗和最亮区域将显示为全黑色或全白色，而其他区域则显示得更加清晰。

降低对比度会产生相反的效果。

S 曲线对比模式#

如果选择此对比模式，相机将使用 S 曲线函数来调整对比度。

这使您可以改进感知对比度，同时保留图像的动态范围。

对比度增加得越多，该函数的图形将越趋向于 S 形：

上图显示，在 S 曲线模式下提高对比度具有以下效果：

• S 曲线的起点和终点变平、中心变陡。结果，图像明暗区域的对比度降低，并且中间色调的对比度提高。
• 低输入像素值降低，高输入像素值提高。这压缩了图像的极暗和极亮区域，从而进一步提高了可感知的对比度。
• 由于曲线始终从 (0,0) 开始，到 (X_max,Y_max) 结束，因此图像的动态范围得以保留。

在 S 曲线模式下，低于 0 的对比度设置将导致 S 曲线反转，产生相反的效果。

亮度#

调节亮度可以通过增加或减小图像的色调值来使图像变亮或变暗。

调整亮度时会移动亮度/对比度函数的轴心点：

• 增加亮度会使轴心点向左上方移动。这意味着图像将显得更亮。
• 降低亮度会将轴心点移到右下角。这意味着图像将显得更暗。

下图显示了选择 S 曲线对比模式时的示例。

附加参数#

If available, the BslBrightnessRaw and BslContrastRaw parameters allow you to enter integer values instead of float values for the brightness and contrast parameters. Normally, you don't need to set these parameters.

详情#

显示所有相机型号

示例代码#

// Set the Brightness parameter to 0.5
camera.BslBrightness.SetValue(0.5);
// Set the contrast mode to Linear
camera.BslContrastMode.SetValue(BslContrastMode_Linear);
// Set the Contrast parameter to 1.2
camera.BslContrast.SetValue(1.2);

INodeMap& nodemap = camera.GetNodeMap();
// Set the Brightness parameter to 0.5
CFloatParameter(nodemap, "BslBrightness").SetValue(0.5);
// Set the contrast mode to Linear
CEnumParameter(nodemap, "BslContrastMode").SetValue("Linear");
// Set the Contrast parameter to 1.2
CFloatParameter(nodemap, "BslContrast").SetValue(1.2);

// Set the Brightness parameter to 0.5
camera.Parameters[PLCamera.BslBrightness].SetValue(0.5);
// Set the contrast mode to Linear
camera.Parameters[PLCamera.BslContrastMode].SetValue(PLCamera.BslContrastMode.Linear);
// Set the Contrast parameter to 1.2
camera.Parameters[PLCamera.BslContrast].SetValue(1.2);

/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* Set the Brightness parameter to 0.5 */
errRes = PylonDeviceSetFloatFeature(hdev, "BslBrightness", 0.5);
CHECK(errRes);
/* Set the contrast mode to Linear */
errRes = PylonDeviceFeatureFromString(hdev, "BslContrastMode", "Linear");
CHECK(errRes);
/* Set the Contrast parameter to 1.2 */
errRes = PylonDeviceSetFloatFeature(hdev, "BslContrast", 1.2);
CHECK(errRes);

# Set the Brightness parameter to 0.5
camera.BslBrightness.Value = 0.5
# Set the contrast mode to Linear
camera.BslContrastMode.Value = "Linear"
# Set the Contrast parameter to 1.2
camera.BslContrast.Value = 1.2

您也可以使用 pylon Viewer 轻松设置参数。