跳转到内容

Brightness and Contrast#

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

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

该功能的使用#

调整对比度和对比模式#

调整对比度:

  1. 设置 BslContrastMode 参数为以下值(如果可用):
  2. 输入 BslContrast 参数的值。该参数值的范围是 -1 至 1。默认情况下,参数设置为 0,这意味着对比度保持不变。

调整亮度#

要调整亮度,请输入 BslBrightness 参数的值。该参数值的范围是 -1 至 1。默认情况下,该参数设置为 0,表示亮度保持不变。

运作原理#

对比度#

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

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

线性对比模式#

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

对比度 = 0,亮度 = 0,线性对比模式

对比度 = 0.3,亮度 = 0,线性对比模式

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

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

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

S 曲线对比模式#

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

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

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

对比度 = 0.3,亮度 = 0,S 曲线对比模式

对比度 = 0.5,亮度 = 0,S 曲线对比模式

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

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

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

亮度#

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

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

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

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

对比度 = 0.3,亮度 = 0,S 曲线对比模式

对比度 = 0.3,亮度 = 0.3,S 曲线对比模式

附加参数#

如果可用,则 BslBrightnessRawBslContrastRaw 参数允许您为亮度和对比度参数输入整数值,而不是浮点值。通常您不需要设置这些参数。

详情#

显示所有相机型号

相机型号 可用的对比度模式
a2A1920-51gcBAS 线性
S 曲线
a2A1920-51gcPRO 线性
S 曲线
a2A1920-51gmBAS 线性
S 曲线
a2A1920-51gmPRO 线性
S 曲线
a2A1920-160ucBAS 线性
S 曲线
a2A1920-160ucPRO 线性
S 曲线
a2A1920-160umBAS 线性
S 曲线
a2A1920-160umPRO 线性
S 曲线
a2A2590-22gcBAS 线性
S 曲线
a2A2590-22gcPRO 线性
S 曲线
a2A2590-22gmBAS 线性
S 曲线
a2A2590-22gmPRO 线性
S 曲线
a2A2590-60ucBAS 线性
S 曲线
a2A2590-60ucPRO 线性
S 曲线
a2A2590-60umBAS 线性
S 曲线
a2A2590-60umPRO 线性
S 曲线
a2A3840-13gcBAS 线性
S 曲线
a2A3840-13gcPRO 线性
S 曲线
a2A3840-13gmBAS 线性
S 曲线
a2A3840-13gmPRO 线性
S 曲线
a2A3840-45ucBAS 线性
S 曲线
a2A3840-45ucPRO 线性
S 曲线
a2A3840-45umBAS 线性
S 曲线
a2A3840-45umPRO 线性
S 曲线
a2A4504-5gcBAS 线性
S 曲线
a2A4504-5gcPRO 线性
S 曲线
a2A4504-5gmBAS 线性
S 曲线
a2A4504-5gmPRO 线性
S 曲线
a2A4504-18ucBAS 线性
S 曲线
a2A4504-18ucPRO 线性
S 曲线
a2A4504-18umBAS 线性
S 曲线
a2A4504-18umPRO 线性
S 曲线
a2A5320-7gcBAS 线性
S 曲线
a2A5320-7gcPRO 线性
S 曲线
a2A5320-7gmBAS 线性
S 曲线
a2A5320-7gmPRO 线性
S 曲线
a2A5320-23ucBAS 线性
S 曲线
a2A5320-23ucPRO 线性
S 曲线
a2A5320-23umBAS 线性
S 曲线
a2A5320-23umPRO 线性
S 曲线
a2A5328-4gcBAS 线性
S 曲线
a2A5328-4gcPRO 线性
S 曲线
a2A5328-4gmBAS 线性
S 曲线
a2A5328-4gmPRO 线性
S 曲线
a2A5328-15ucBAS 线性
S 曲线
a2A5328-15ucPRO 线性
S 曲线
a2A5328-15umBAS 线性
S 曲线
a2A5328-15umPRO 线性
S 曲线
acA640-90gc 不支持 Brightness and Contrast 功能
acA640-90gm 不支持 Brightness and Contrast 功能
acA640-90uc 不支持 Brightness and Contrast 功能
acA640-90um 不支持 Brightness and Contrast 功能
acA640-120gc 不支持 Brightness and Contrast 功能
acA640-120gm 不支持 Brightness and Contrast 功能
acA640-120uc 不支持 Brightness and Contrast 功能
acA640-120um 不支持 Brightness and Contrast 功能
acA640-121gm 不支持 Brightness and Contrast 功能
acA640-300gc 不支持 Brightness and Contrast 功能
acA640-300gm 不支持 Brightness and Contrast 功能
acA640-750uc 不支持 Brightness and Contrast 功能
acA640-750um 不支持 Brightness and Contrast 功能
acA720-290gc 不支持 Brightness and Contrast 功能
acA720-290gm 不支持 Brightness and Contrast 功能
acA720-520uc 不支持 Brightness and Contrast 功能
acA720-520um 不支持 Brightness and Contrast 功能
acA780-75gc 不支持 Brightness and Contrast 功能
acA780-75gm 不支持 Brightness and Contrast 功能
acA800-200gc 不支持 Brightness and Contrast 功能
acA800-200gm 不支持 Brightness and Contrast 功能
acA800-510uc 不支持 Brightness and Contrast 功能
acA800-510um 不支持 Brightness and Contrast 功能
acA1280-60gc 不支持 Brightness and Contrast 功能
acA1280-60gm 不支持 Brightness and Contrast 功能
acA1300-22gc 不支持 Brightness and Contrast 功能
acA1300-22gm 不支持 Brightness and Contrast 功能
acA1300-30gc 不支持 Brightness and Contrast 功能
acA1300-30gm 不支持 Brightness and Contrast 功能
acA1300-30uc 不支持 Brightness and Contrast 功能
acA1300-30um 不支持 Brightness and Contrast 功能
acA1300-60gc 不支持 Brightness and Contrast 功能
acA1300-60gm 不支持 Brightness and Contrast 功能
acA1300-60gmNIR 不支持 Brightness and Contrast 功能
acA1300-75gc 不支持 Brightness and Contrast 功能
acA1300-75gm 不支持 Brightness and Contrast 功能
acA1300-200uc 不支持 Brightness and Contrast 功能
acA1300-200um 不支持 Brightness and Contrast 功能
acA1440-73gc 不支持 Brightness and Contrast 功能
acA1440-73gm 不支持 Brightness and Contrast 功能
acA1440-220uc 不支持 Brightness and Contrast 功能
acA1440-220um 不支持 Brightness and Contrast 功能
acA1600-20gc 不支持 Brightness and Contrast 功能
acA1600-20gm 不支持 Brightness and Contrast 功能
acA1600-20uc 不支持 Brightness and Contrast 功能
acA1600-20um 不支持 Brightness and Contrast 功能
acA1600-60gc 不支持 Brightness and Contrast 功能
acA1600-60gm 不支持 Brightness and Contrast 功能
acA1920-25gc 不支持 Brightness and Contrast 功能
acA1920-25gm 不支持 Brightness and Contrast 功能
acA1920-25uc 不支持 Brightness and Contrast 功能
acA1920-25um 不支持 Brightness and Contrast 功能
acA1920-40gc 不支持 Brightness and Contrast 功能
acA1920-40gm 不支持 Brightness and Contrast 功能
acA1920-40uc 不支持 Brightness and Contrast 功能
acA1920-40ucMED 线性
S 曲线
acA1920-40um 不支持 Brightness and Contrast 功能
acA1920-40umMED 线性
S 曲线
acA1920-48gc 不支持 Brightness and Contrast 功能
acA1920-48gm 不支持 Brightness and Contrast 功能
acA1920-50gc 不支持 Brightness and Contrast 功能
acA1920-50gm 不支持 Brightness and Contrast 功能
acA1920-150uc 不支持 Brightness and Contrast 功能
acA1920-150um 不支持 Brightness and Contrast 功能
acA1920-155uc 不支持 Brightness and Contrast 功能
acA1920-155ucMED 线性
S 曲线
acA1920-155um 不支持 Brightness and Contrast 功能
acA1920-155umMED 线性
S 曲线
acA2000-50gc 不支持 Brightness and Contrast 功能
acA2000-50gm 不支持 Brightness and Contrast 功能
acA2000-50gmNIR 不支持 Brightness and Contrast 功能
acA2000-165uc 不支持 Brightness and Contrast 功能
acA2000-165um 不支持 Brightness and Contrast 功能
acA2000-165umNIR 不支持 Brightness and Contrast 功能
acA2040-25gc 不支持 Brightness and Contrast 功能
acA2040-25gm 不支持 Brightness and Contrast 功能
acA2040-25gmNIR 不支持 Brightness and Contrast 功能
acA2040-35gc 不支持 Brightness and Contrast 功能
acA2040-35gm 不支持 Brightness and Contrast 功能
acA2040-55uc 不支持 Brightness and Contrast 功能
acA2040-55um 不支持 Brightness and Contrast 功能
acA2040-90uc 不支持 Brightness and Contrast 功能
acA2040-90um 不支持 Brightness and Contrast 功能
acA2040-90umNIR 不支持 Brightness and Contrast 功能
acA2040-120uc 不支持 Brightness and Contrast 功能
acA2040-120um 不支持 Brightness and Contrast 功能
acA2440-20gc 不支持 Brightness and Contrast 功能
acA2440-20gm 不支持 Brightness and Contrast 功能
acA2440-35uc 不支持 Brightness and Contrast 功能
acA2440-35ucMED 线性
S 曲线
acA2440-35um 不支持 Brightness and Contrast 功能
acA2440-35umMED 线性
S 曲线
acA2440-75uc 不支持 Brightness and Contrast 功能
acA2440-75ucMED 线性
S 曲线
acA2440-75um 不支持 Brightness and Contrast 功能
acA2440-75umMED 线性
S 曲线
acA2500-14gc 不支持 Brightness and Contrast 功能
acA2500-14gm 不支持 Brightness and Contrast 功能
acA2500-14uc 不支持 Brightness and Contrast 功能
acA2500-14um 不支持 Brightness and Contrast 功能
acA2500-20gc 不支持 Brightness and Contrast 功能
acA2500-20gcMED 线性
S 曲线
acA2500-20gm 不支持 Brightness and Contrast 功能
acA2500-20gmMED 线性
S 曲线
acA2500-60uc 不支持 Brightness and Contrast 功能
acA2500-60um 不支持 Brightness and Contrast 功能
acA3088-16gc 不支持 Brightness and Contrast 功能
acA3088-16gm 不支持 Brightness and Contrast 功能
acA3088-57uc 不支持 Brightness and Contrast 功能
acA3088-57ucMED 线性
S 曲线
acA3088-57um 不支持 Brightness and Contrast 功能
acA3088-57umMED 线性
S 曲线
acA3800-10gc 不支持 Brightness and Contrast 功能
acA3800-10gm 不支持 Brightness and Contrast 功能
acA3800-14uc 不支持 Brightness and Contrast 功能
acA3800-14um 不支持 Brightness and Contrast 功能
acA4024-8gc 不支持 Brightness and Contrast 功能
acA4024-8gm 不支持 Brightness and Contrast 功能
acA4024-29uc 不支持 Brightness and Contrast 功能
acA4024-29um 不支持 Brightness and Contrast 功能
acA4096-11gc 不支持 Brightness and Contrast 功能
acA4096-11gm 不支持 Brightness and Contrast 功能
acA4096-30uc 不支持 Brightness and Contrast 功能
acA4096-30ucMED 线性
S 曲线
acA4096-30um 不支持 Brightness and Contrast 功能
acA4096-30umMED 线性
S 曲线
acA4096-40uc 不支持 Brightness and Contrast 功能
acA4096-40ucMED 线性
S 曲线
acA4096-40um 不支持 Brightness and Contrast 功能
acA4096-40umMED 线性
S 曲线
acA4112-8gc 不支持 Brightness and Contrast 功能
acA4112-8gm 不支持 Brightness and Contrast 功能
acA4112-20uc 不支持 Brightness and Contrast 功能
acA4112-20ucMED 线性
S 曲线
acA4112-20um 不支持 Brightness and Contrast 功能
acA4112-20umMED 线性
S 曲线
acA4112-30uc 不支持 Brightness and Contrast 功能
acA4112-30ucMED 线性
S 曲线
acA4112-30um 不支持 Brightness and Contrast 功能
acA4112-30umMED 线性
S 曲线
acA4600-7gc 不支持 Brightness and Contrast 功能
acA4600-10uc 不支持 Brightness and Contrast 功能
acA5472-5gc 不支持 Brightness and Contrast 功能
acA5472-5gm 不支持 Brightness and Contrast 功能
acA5472-17uc 不支持 Brightness and Contrast 功能
acA5472-17ucMED 线性
S 曲线
acA5472-17um 不支持 Brightness and Contrast 功能
acA5472-17umMED 线性
S 曲线
boA4096-93cc 线性
S 曲线
boA4096-93cm 线性
S 曲线
boA4112-68cc 线性
S 曲线
boA4112-68cm 线性
S 曲线
boA4500-45cc 线性
S 曲线
boA4500-45cm 线性
S 曲线
boA6500-36cc 线性
S 曲线
boA6500-36cm 线性
S 曲线
boA8100-16cc 线性
S 曲线
boA8100-16cm 线性
S 曲线
daA1280-54lc 线性
S 曲线
daA1280-54lm 线性
S 曲线
daA1280-54uc 线性
S 曲线
daA1280-54um 线性
S 曲线
daA1600-60lc 线性
S 曲线
daA1600-60lm 线性
S 曲线
daA1600-60uc 线性
S 曲线
daA1600-60um 线性
S 曲线
daA1920-15um 线性
S 曲线
daA1920-30uc 线性
S 曲线
daA1920-30um 线性
S 曲线
daA1920-160uc 线性
S 曲线
daA1920-160um 线性
S 曲线
daA2500-14lc 线性
S 曲线
daA2500-14lm 线性
S 曲线
daA2500-14uc 线性
S 曲线
daA2500-14um 线性
S 曲线
daA3840-45uc 线性
S 曲线
daA3840-45um 线性
S 曲线
puA1280-54uc 线性
S 曲线
puA1280-54um 线性
S 曲线
puA1600-60uc 线性
S 曲线
puA1600-60um 线性
S 曲线
puA1920-30uc 线性
S 曲线
puA1920-30um 线性
S 曲线
puA2500-14uc 线性
S 曲线
puA2500-14um 线性
S 曲线

示例代码#

// 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);

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