跳转到内容

Black Level#

Black Level 相机功能允许您更改图像的整体亮度。调整相机的黑电平会导致相机输出的像素灰度值发生偏移。

例如，您可以将图像中每个像素的灰度值增加 3。

该功能的使用#

调整 Black Level#

信息

  • Basler 建议您在使用任何色彩增强功能之前将黑电平设置为 0，例如，Balance White、Color Transformation 或 Gamma。应用色彩增强后，您可以根据需要更改黑电平。但是，增加黑电平会降低颜色精确度。

要调整黑电平，请为 BlackLevel 参数输入一个值。

BlackLevel 参数值导致的灰度值变化取决于相机型号。

Black Level 补偿#

暗电流可能会对图像质量产生负面影响。某些成像传感器可以通过自动调整黑电平来对此进行补偿。

在某些型号的相机上，您可以使用 BslBlackLevelCompensationMode 参数手动启用或禁用此自动调整。

为此，请将 BslBlackLevelCompensationMode 参数设置为以下值：

  • 传感器：黑电平补偿由成像传感器执行。传感器试图补偿会影响信号的热生电压（暗电流）。
  • Off：禁用黑电平补偿。例如，对于弱光信号的定量分析，或者需要未经暗电流校正的原始图像数据时，此功能非常有用。
    将补偿模式设置为 Off 可重置用于黑电平补偿的所有内部校正值。

详情#

显示所有相机型号

相机型号 BslBlackLevelCompensationMode 参数可用 BlackLevel 参数值的更改 导致的灰度值变化
a2A640-240gmSWIR 无 ± 1 ± 1
a2A640-240umSWIR 无 ± 1 ± 1
a2A1280-80gmSWIR 无 ± 1 ± 1
a2A1280-125umSWIR 无 ± 1 ± 1
a2A1920-51gcBAS 无 ± 1 ± 1
a2A1920-51gcPRO 无 ± 1 ± 1
a2A1920-51gmBAS 无 ± 1 ± 1
a2A1920-51gmPRO 无 ± 1 ± 1
a2A1920-160ucBAS 无 ± 1 ± 1
a2A1920-160ucPRO 无 ± 1 ± 1
a2A1920-160umBAS 无 ± 1 ± 1
a2A1920-160umPRO 无 ± 1 ± 1
a2A1920-165g5cBAS 无 ± 1 ± 1
a2A1920-165g5mBAS 无 ± 1 ± 1
a2A2440-98g5cBAS 无 ± 1 ± 1
a2A2440-98g5mBAS 无 ± 1 ± 1
a2A2448-23gcBAS 无 ± 1 ± 1
a2A2448-23gcPRO 无 ± 1 ± 1
a2A2448-23gmBAS 无 ± 1 ± 1
a2A2448-23gmPRO 无 ± 1 ± 1
a2A2448-75ucBAS 无 ± 1 ± 1
a2A2448-75ucPRO 无 ± 1 ± 1
a2A2448-75umBAS 无 ± 1 ± 1
a2A2448-75umPRO 无 ± 1 ± 1
a2A2448-105g5cBAS 无 ± 1 ± 1
a2A2448-105g5mBAS 无 ± 1 ± 1
a2A2590-22gcBAS 无 ± 1 ± 0.0625
a2A2590-22gcPRO 无 ± 1 ± 0.0625
a2A2590-22gmBAS 无 ± 1 ± 0.0625
a2A2590-22gmPRO 无 ± 1 ± 0.0625
a2A2590-60ucBAS 无 ± 1 ± 0.0625
a2A2590-60ucPRO 无 ± 1 ± 0.0625
a2A2590-60umBAS 无 ± 1 ± 0.0625
a2A2590-60umPRO 无 ± 1 ± 0.0625
a2A2600-20gcBAS 无 ± 1 ± 1
a2A2600-20gcPRO 无 ± 1 ± 1
a2A2600-20gmBAS 无 ± 1 ± 1
a2A2600-20gmPRO 无 ± 1 ± 1
a2A2600-64ucBAS 无 ± 1 ± 1
a2A2600-64ucPRO 无 ± 1 ± 1
a2A2600-64umBAS 无 ± 1 ± 1
a2A2600-64umPRO 无 ± 1 ± 1
a2A2840-14gcBAS 无 ± 1 ± 1
a2A2840-14gcPRO 无 ± 1 ± 1
a2A2840-14gmBAS 无 ± 1 ± 1
a2A2840-14gmPRO 无 ± 1 ± 1
a2A2840-48ucBAS 无 ± 1 ± 1
a2A2840-48ucPRO 无 ± 1 ± 1
a2A2840-48umBAS 无 ± 1 ± 1
a2A2840-48umPRO 无 ± 1 ± 1
a2A2840-67g5cBAS 无 ± 1 ± 1
a2A2840-67g5mBAS 无 ± 1 ± 1
a2A3840-13gcBAS 无 ± 1 ± 0.0625
a2A3840-13gcPRO 无 ± 1 ± 0.0625
a2A3840-13gmBAS 无 ± 1 ± 0.0625
a2A3840-13gmPRO 无 ± 1 ± 0.0625
a2A3840-45ucBAS 无 ± 1 ± 0.0625
a2A3840-45ucPRO 无 ± 1 ± 0.0625
a2A3840-45umBAS 无 ± 1 ± 0.0625
a2A3840-45umPRO 无 ± 1 ± 0.0625
a2A4096-9gcBAS 无 ± 1 ± 1
a2A4096-9gcPRO 无 ± 1 ± 1
a2A4096-9gmBAS 无 ± 1 ± 1
a2A4096-9gmPRO 无 ± 1 ± 1
a2A4096-30ucBAS 无 ± 1 ± 1
a2A4096-30ucPRO 无 ± 1 ± 1
a2A4096-30umBAS 无 ± 1 ± 1
a2A4096-30umPRO 无 ± 1 ± 1
a2A4096-44g5cBAS 无 ± 1 ± 1
a2A4096-44g5mBAS 无 ± 1 ± 1
a2A4200-12gcBAS 无 ± 1 ± 1
a2A4200-12gcPRO 无 ± 1 ± 1
a2A4200-12gmBAS 无 ± 1 ± 1
a2A4200-12gmPRO 无 ± 1 ± 1
a2A4200-40ucBAS 无 ± 1 ± 1
a2A4200-40ucPRO 无 ± 1 ± 1
a2A4200-40umBAS 无 ± 1 ± 1
a2A4200-40umPRO 无 ± 1 ± 1
a2A4504-5gcBAS 无 ± 1 ± 1
a2A4504-5gcPRO 无 ± 1 ± 1
a2A4504-5gmBAS 无 ± 1 ± 1
a2A4504-5gmPRO 无 ± 1 ± 1
a2A4504-18ucBAS 无 ± 1 ± 1
a2A4504-18ucPRO 无 ± 1 ± 1
a2A4504-18umBAS 无 ± 1 ± 1
a2A4504-18umPRO 无 ± 1 ± 1
a2A4504-27g5cBAS 无 ± 1 ± 1
a2A4504-27g5mBAS 无 ± 1 ± 1
a2A4508-6gcBAS 无 ± 1 ± 1
a2A4508-6gcPRO 无 ± 1 ± 1
a2A4508-6gmBAS 无 ± 1 ± 1
a2A4508-6gmPRO 无 ± 1 ± 1
a2A4508-20ucBAS 无 ± 1 ± 1
a2A4508-20ucPRO 无 ± 1 ± 1
a2A4508-20umBAS 无 ± 1 ± 1
a2A4508-20umPRO 无 ± 1 ± 1
a2A5320-7gcBAS 无 ± 1 ± 1
a2A5320-7gcPRO 无 ± 1 ± 1
a2A5320-7gmBAS 无 ± 1 ± 1
a2A5320-7gmPRO 无 ± 1 ± 1
a2A5320-23ucBAS 无 ± 1 ± 1
a2A5320-23ucPRO 无 ± 1 ± 1
a2A5320-23umBAS 无 ± 1 ± 1
a2A5320-23umPRO 无 ± 1 ± 1
a2A5320-34g5cBAS 无 ± 1 ± 1
a2A5320-34g5mBAS 无 ± 1 ± 1
a2A5328-4gcBAS 无 ± 1 ± 1
a2A5328-4gcPRO 无 ± 1 ± 1
a2A5328-4gmBAS 无 ± 1 ± 1
a2A5328-4gmPRO 无 ± 1 ± 1
a2A5328-15ucBAS 无 ± 1 ± 1
a2A5328-15ucPRO 无 ± 1 ± 1
a2A5328-15umBAS 无 ± 1 ± 1
a2A5328-15umPRO 无 ± 1 ± 1
a2A5328-22g5cBAS 无 ± 1 ± 1
a2A5328-22g5mBAS 无 ± 1 ± 1
acA640-121gm 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA640-300gc 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA640-300gm 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA640-750uc 无 ± 1 ± 1
acA640-750um 无 ± 1 ± 1
acA720-290gc 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA720-290gm 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA720-520uc 无 ± 1 ± 1
acA720-520um 无 ± 1 ± 1
acA800-200gc 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA800-200gm 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA800-510uc 无 ± 1 ± 1
acA800-510um 无 ± 1 ± 1
acA1280-60gc 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA1280-60gm 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA1300-60gc 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA1300-60gm 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA1300-60gmNIR 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA1300-75gc 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA1300-75gm 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA1300-200uc 无 ± 1 ± 1
acA1300-200um 无 ± 1 ± 1
acA1440-73gc 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA1440-73gm 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA1440-220uc 无 ± 1 ± 1
acA1440-220um 无 ± 1 ± 1
acA1600-20gc 无 8 位像素格式：±64
12 位像素格式：±4		 ± 1
acA1600-20uc 无 ± 1 ± 1
acA1600-60gc 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA1600-60gm 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA1920-25gc 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA1920-25gm 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA1920-25uc 无 ± 1 ± 1
acA1920-25um 无 ± 1 ± 1
acA1920-40gc 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA1920-40gm 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA1920-40uc 无 ± 1 ± 1
acA1920-40ucMED 无 ± 1 ± 1
acA1920-40um 无 ± 1 ± 1
acA1920-40umMED 无 ± 1 ± 1
acA1920-48gc 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA1920-48gm 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA1920-50gc 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA1920-50gm 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA1920-150uc 无 ± 1 ± 1
acA1920-150um 无 ± 1 ± 1
acA1920-155uc 无 ± 1 ± 1
acA1920-155ucMED 无 ± 1 ± 1
acA1920-155um 无 ± 1 ± 1
acA1920-155umMED 无 ± 1 ± 1
acA2000-50gc 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA2000-50gm 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA2000-165uc 无 ± 1 ± 1
acA2000-165um 无 ± 1 ± 1
acA2040-25gc 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA2040-25gm 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA2040-25gmNIR 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA2040-35gc 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA2040-35gm 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA2040-55uc 无 ± 1 ± 1
acA2040-55um 无 ± 1 ± 1
acA2040-90uc 无 ± 1 ± 1
acA2040-90um 无 ± 1 ± 1
acA2040-90umNIR 无 ± 1 ± 1
acA2040-120uc 无 ± 1 ± 1
acA2040-120um 无 ± 1 ± 1
acA2440-20gc 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA2440-20gm 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA2440-35uc 无 ± 1 ± 1
acA2440-35ucMED 无 ± 1 ± 1
acA2440-35um 无 ± 1 ± 1
acA2440-35umMED 无 ± 1 ± 1
acA2440-75uc 无 ± 1 ± 1
acA2440-75ucMED 无 ± 1 ± 1
acA2440-75um 无 ± 1 ± 1
acA2440-75umMED 无 ± 1 ± 1
acA2500-14gc 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA2500-14gm 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA2500-14uc 无 ± 1 ± 1
acA2500-14um 无 ± 1 ± 1
acA2500-20gc 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA2500-20gcMED 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA2500-20gm 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA2500-20gmMED 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA2500-60uc 无 ± 1 ± 1
acA2500-60um 无 ± 1 ± 1
acA3088-16gc 无 8 位像素格式：±16
12 位像素格式：大约 ±1		 ± 1
acA3088-16gm 无 8 位像素格式：±16
12 位像素格式：大约 ±1		 ± 1
acA3088-57uc 无 ± 1 大约 ±1
acA3088-57ucMED 是 ± 1 大约 ±1
acA3088-57um 无 ± 1 大约 ±1
acA3088-57umMED 是 ± 1 大约 ±1
acA3800-10gc 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA3800-10gm 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA3800-14uc 无 ± 1 ± 1
acA3800-14um 无 ± 1 ± 1
acA4024-8gc 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA4024-8gm 无 8 位像素格式：±4
10 位像素格式：±1
12 位像素格式：±1		 ± 1
acA4024-29uc 无 ± 1 大约 ±1
acA4024-29um 无 ± 1 大约 ±1
acA4096-11gc 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA4096-11gm 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA4096-30uc 无 ± 1 ± 1
acA4096-30ucMED 无 ± 1 ± 1
acA4096-30um 无 ± 1 ± 1
acA4096-30umMED 无 ± 1 ± 1
acA4096-40uc 无 ± 1 ± 1
acA4096-40ucMED 无 ± 1 ± 1
acA4096-40um 无 ± 1 ± 1
acA4096-40umMED 无 ± 1 ± 1
acA4112-8gc 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA4112-8gm 无 8 位像素格式：±16
12 位像素格式：±1		 ± 1
acA4112-20uc 无 ± 1 ± 1
acA4112-20ucMED 无 ± 1 ± 1
acA4112-20um 无 ± 1 ± 1
acA4112-20umMED 无 ± 1 ± 1
acA4112-30uc 无 ± 1 ± 1
acA4112-30ucMED 无 ± 1 ± 1
acA4112-30um 无 ± 1 ± 1
acA4112-30umMED 无 ± 1 ± 1
acA5472-5gc 无 ± 1 8 位像素格式：±1
12 位像素格式：±4
acA5472-5gm 无 ± 1 8 位像素格式：±1
12 位像素格式：±4
acA5472-17uc 无 ± 1 8 位像素格式：±1
12 位像素格式：±4
acA5472-17ucMED 无 ± 1 8 位像素格式：±1
12 位像素格式：±4
acA5472-17um 无 ± 1 8 位像素格式：±1
12 位像素格式：±4
acA5472-17umMED 无 ± 1 8 位像素格式：±1
12 位像素格式：±4
boA1936-400cc 无 ± 1 ± 1
boA1936-400cm 无 ± 1 ± 1
boA2448-250cc 无 ± 1 ± 1
bo2448-250cm 无 ± 1 ± 1
boA2832-190cc 无 ± 1 ± 1
bo2832-190cm 无 ± 1 ± 1
boA4096-93cc 无 ± 1 ± 1
boA4096-93cm 无 ± 1 ± 1
boA4096-180cc 无 ± 1 ± 1
bo4096-180cm 无 ± 1 ± 1
boA4112-68cc 无 ± 1 ± 1
boA4112-68cm 无 ± 1 ± 1
boA4500-45cc 无 ± 1 ± 1
boA4500-45cm 是 ± 1 ± 1
boA4504-100cc 无 ± 1 ± 1
boA4504-100cm 无 ± 1 ± 1
boA5120-150cc 无 ± 1 ± 1
boA5120-150cm 无 ± 1 ± 1
boA5120-230cc 无 ± 1 ± 1
boA5120-230cm 无 ± 1 ± 1
boA5320-150cc 无 ± 1 ± 1
boA5320-150cm 无 ± 1 ± 1
boA5328-100cc 无 ± 1 ± 1
boA5328-100cm 无 ± 1 ± 1
boA6500-36cc 无 ± 1 ± 1
boA6500-36cm 是 ± 1 ± 1
boA8100-16cc 无 ± 1 ± 1
boA8100-16cm 是 ± 1 ± 1
boA9344-30cc 无 ± 1 ± 1
boA9344-30cm 无 ± 1 ± 1
boA9344-70cc 无 ± 1 ± 1
boA9344-70cm 无 ± 1 ± 1
daA720-520uc 是 ± 1 ± 1
daA720-520um 是 ± 1 ± 1
daA1280-54uc 无 ± 1a ± 1
daA1280-54um 无 ± 1a ± 1
daA1440-220uc 是 ± 1 ± 1
daA1440-220um 是 ± 1 ± 1
daA1600-60uc 无 ± 1a ± 1
daA1600-60um 无 ± 1a ± 1
daA1920-15um 无 ± 1a ± 1
daA1920-30uc 无 ± 1a ± 1
daA1920-30um 无 ± 1a ± 1
daA1920-160uc 无 ± 1 ± 1
daA1920-160um 无 ± 1 ± 1
daA2448-70uc 无 ± 1 ± 1
daA2448-70um 无 ± 1 ± 1
daA2500-14uc 无 ± 1a ± 1
daA2500-14um 无 ± 1a ± 1
daA3840-45uc 无 ± 1 ± 0.0625
daA3840-45um 无 ± 1 ± 0.0625
puA1280-54uc 无 ± 1a ± 1
puA1280-54um 无 ± 1a ± 1
puA1600-60uc 无 ± 1a ± 1
puA1600-60um 无 ± 1a ± 1
puA1920-30uc 无 ± 1a ± 1
puA1920-30um 无 ± 1a ± 1
puA2500-14uc 无 ± 1a ± 1
puA2500-14um 无 ± 1a ± 1

  1. 在 daA1280-54um/uc、daA1280-54lm/uc 和 puA1280-54um/uc 相机上，在增益设置之后将黑电平设置应用于像素数据。在其他所有 dart 和 pulse 相机上，在增益设置之前应用黑电平设置。

示例代码#

ace Classic/U/L GigE 相机#
// Set the black level to 32
camera.BlackLevelRaw.SetValue(32.0);
// Disable black level compensation
// Note: Available on selected camera models only
camera.BslBlackLevelCompensationMode.SetValue(BslBlackLevelCompensationMode_Off);

INodeMap& nodemap = camera.GetNodeMap();
// Set the black level to 32
CFloatParameter(nodemap, "BlackLevelRaw").SetValue(32.0);
// Disable black level compensation
// Note: Available on selected camera models only
CEnumParameter(nodemap, "BslBlackLevelCompensationMode").SetValue("Off");

// Set the black level to 32
camera.Parameters[PLCamera.BlackLevelRaw].SetValue(32.0);
// Disable black level compensation
// Note: Available on selected camera models only
camera.Parameters[PLCamera.BslBlackLevelCompensationMode].SetValue(PLCamera.BslBlackLevelCompensationMode.Off);

/* 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 black level to 32 */
errRes = PylonDeviceSetFloatFeature(hdev, "BlackLevelRaw", 32.0);
CHECK(errRes);
/* Disable black level compensation */
/* Note: Available on selected camera models only */
errRes = PylonDeviceFeatureFromString(hdev, "BslBlackLevelCompensationMode", "Off");
CHECK(errRes);

# Set the black level to 32
camera.BlackLevelRaw.Value = 32.0
# Disable black level compensation
# Note: Available on selected camera models only
camera.BslBlackLevelCompensationMode.Value = "Off"
其他相机#
// Set the black level to 32
camera.BlackLevel.SetValue(32.0);
// Disable black level compensation
// Note: Available on selected camera models only
camera.BslBlackLevelCompensationMode.SetValue(BslBlackLevelCompensationMode_Off);

INodeMap& nodemap = camera.GetNodeMap();
// Set the black level to 32
CFloatParameter(nodemap, "BlackLevel").SetValue(32.0);
// Disable black level compensation
// Note: Available on selected camera models only
CEnumParameter(nodemap, "BslBlackLevelCompensationMode").SetValue("Off");

// Set the black level to 32
camera.Parameters[PLCamera.BlackLevel].SetValue(32.0);
// Disable black level compensation
// Note: Available on selected camera models only
camera.Parameters[PLCamera.BslBlackLevelCompensationMode].SetValue(PLCamera.BslBlackLevelCompensationMode.Off);

/* 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 black level to 32 */
errRes = PylonDeviceSetFloatFeature(hdev, "BlackLevel", 32.0);
CHECK(errRes);
/* Disable black level compensation */
/* Note: Available on selected camera models only */
errRes = PylonDeviceFeatureFromString(hdev, "BslBlackLevelCompensationMode", "Off");
CHECK(errRes);

# Set the black level to 32
camera.BlackLevel.Value = 32.0
# Disable black level compensation
# Note: Available on selected camera models only
camera.BslBlackLevelCompensationMode.Value = "Off"

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