Skip to content

Black Level#

The Black Level camera feature allows you to change the overall brightness of an image. All gray values of the pixels are changed by a specified amount.

For example, you can increase the gray value of each pixel in the image by 3.

Using the Feature#

Adjusting the Black Level#

To adjust the black level, enter a value for the BlackLevel parameter.

The minimum black level setting is 0. The maximum setting depends on the camera model.

The change in the gray value resulting from the BlackLevel parameter value also depends on the camera model.

Info

Basler recommends setting the black level to 0 before using any of the color enhancement features, e.g., Balance White, Color Transformation, or Gamma. After the color enhancements have been applied, you can change the black level as desired. However, increasing the black level will decrease the color accuracy.

Black Level Compensation#

Dark current can have a negative impact on image quality. Some imaging sensors can compensate for this by automatically adjusting the black level.

On some camera models, you can manually enable or disable this automatic adjustment using the BslBlackLevelCompensationMode parameter.

To do so, set the BslBlackLevelCompensationMode parameter to one of the following values:

  • Sensor: Black level compensation is performed by the imaging sensor. The sensor tries to compensate for thermally generated voltages that would affect the signals (dark current).
  • Off: Black level compensation is disabled. This is useful, e.g., for quantitative analysis of weak light signals or if you need raw image data without dark current correction.
    Setting the compensation mode to Off resets all internal correction values used for black level compensation.

Specifics#

Black Level Settings#

Show all camera models

Camera Model Maximum Black Level [DN] BslBlackLevelCompensationMode Parameter Available
a2A1920-51gcBAS Sensor Bit Depth set to Bpp8: 63.75
Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A1920-51gcPRO Sensor Bit Depth set to Bpp8: 63.75
Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A1920-51gmBAS Sensor Bit Depth set to Bpp8: 63.75
Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A1920-51gmPRO Sensor Bit Depth set to Bpp8: 63.75
Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A1920-160ucBAS Sensor Bit Depth set to Bpp8: 63.75
Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A1920-160ucPRO Sensor Bit Depth set to Bpp8: 63.75
Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A1920-160umBAS Sensor Bit Depth set to Bpp8: 63.75
Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A1920-160umPRO Sensor Bit Depth set to Bpp8: 63.75
Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A2590-22gcBAS Sensor Bit Depth set to Bpp12: 4092 No
a2A2590-22gcPRO Sensor Bit Depth set to Bpp12: 4092 No
a2A2590-22gmBAS Sensor Bit Depth set to Bpp12: 4092 No
a2A2590-22gmPRO Sensor Bit Depth set to Bpp12: 4092 No
a2A2590-60ucBAS Sensor Bit Depth set to Bpp12: 4092 No
a2A2590-60ucPRO Sensor Bit Depth set to Bpp12: 4092 No
a2A2590-60umBAS Sensor Bit Depth set to Bpp12: 4092 No
a2A2590-60umPRO Sensor Bit Depth set to Bpp12: 4092 No
a2A3840-13gcBAS Sensor Bit Depth set to Bpp12: 4092 No
a2A3840-13gcPRO Sensor Bit Depth set to Bpp12: 4092 No
a2A3840-13gmBAS Sensor Bit Depth set to Bpp12: 4092 No
a2A3840-13gmPRO Sensor Bit Depth set to Bpp12: 4092 No
a2A3840-45ucBAS Sensor Bit Depth set to Bpp12: 4092 No
a2A3840-45ucPRO Sensor Bit Depth set to Bpp12: 4092 No
a2A3840-45umBAS Sensor Bit Depth set to Bpp12: 4092 No
a2A3840-45umPRO Sensor Bit Depth set to Bpp12: 4092 No
a2A4504-5gcBAS Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A4504-5gcPRO Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A4504-5gmBAS Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A4504-5gmPRO Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A4504-18ucBAS Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A4504-18ucPRO Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A4504-18umBAS Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A4504-18umPRO Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5320-7gcBAS Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5320-7gcPRO Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5320-7gmBAS Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5320-7gmPRO Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5320-23ucBAS Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5320-23ucPRO Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5320-23umBAS Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5320-23umPRO Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5328-4gcBAS Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5328-4gcPRO Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5328-4gmBAS Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5328-4gmPRO Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5328-15ucBAS Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5328-15ucPRO Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5328-15umBAS Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
a2A5328-15umPRO Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
acA640-90gc 1023 No
acA640-90gm 1023 No
acA640-90uc 8-bit pixel format: 15.98438
10-bit or 12-bit pixel format: 255.75
No
acA640-90um 8-bit pixel format: 15.98438
10-bit or 12-bit pixel format: 255.75
No
acA640-120gc 1023 No
acA640-120gm 1023 No
acA640-120uc 8-bit pixel format: 15.98438
10-bit or 12-bit pixel format: 255.75
No
acA640-120um 8-bit pixel format: 15.98438
10-bit or 12-bit pixel format: 255.75
No
acA640-121gm 511 No
acA640-300gc 255 No
acA640-300gm 255 No
acA640-750uc 8-bit pixel format: 63.75
10-bit or 12-bit pixel format: 255
No
acA640-750um 8-bit pixel format: 63.75
10-bit or 12-bit pixel format: 255
No
acA720-290gc 511 No
acA720-290gm 511 No
acA720-520uc 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA720-520um 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA780-75gc 1023 No
acA780-75gm 1023 No
acA800-200gc 255 No
acA800-200gm 255 No
acA800-510uc 8-bit pixel format: 63.75
10-bit or 12-bit pixel format: 255
No
acA800-510um 8-bit pixel format: 63.75
10-bit or 12-bit pixel format: 255
No
acA1280-60gc 80 No
acA1280-60gm 80 No
acA1300-22gc 1023 No
acA1300-22gm 1023 No
acA1300-30gc 1023 No
acA1300-30gm 1023 No
acA1300-30uc 8-bit pixel format: 63.75
10-bit or 12-bit pixel format: 255
No
acA1300-30um 8-bit pixel format: 15.98438
10-bit or 12-bit pixel format: 511
No
acA1300-60gc 80 No
acA1300-60gm 80 No
acA1300-60gmNIR 80 No
acA1300-75gc 255 No
acA1300-75gm 255 No
acA1300-200uc 8-bit pixel format: 63.75
10-bit or 12-bit pixel format: 255
No
acA1300-200um 8-bit pixel format: 63.75
10-bit or 12-bit pixel format: 255
No
acA1440-73gc 511 No
acA1440-73gm 511 No
acA1440-220uc 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA1440-220um 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA1600-20gc 1023 No
acA1600-20gm 1023 No
acA1600-20uc 8-bit pixel format: 15.98438
10-bit or 12-bit pixel format: 255.75
No
acA1600-20um 8-bit pixel format: 15.98438
10-bit or 12-bit pixel format: 255.75
No
acA1600-60gc 127 No
acA1600-60gm 127 No
acA1920-25gc 63 No
acA1920-25gm 63 No
acA1920-25uc 8-bit pixel format: 15.9375
10-bit or 12-bit pixel format: 255
No
acA1920-25um 8-bit pixel format: 15.9375
10-bit or 12-bit pixel format: 255
No
acA1920-40gc 511 No
acA1920-40gm 511 No
acA1920-40uc 8-bit pixel formats: 31.9375
10-bit or 12-bit pixel formats: 511
No
acA1920-40ucMED 8-bit pixel formats: 31.9375
10-bit or 12-bit pixel formats: 511
No
acA1920-40um 8-bit pixel formats: 31.9375
10-bit or 12-bit pixel formats: 511
No
acA1920-40umMED 8-bit pixel formats: 31.9375
10-bit or 12-bit pixel formats: 511
No
acA1920-48gc 255 No
acA1920-48gm 255 No
acA1920-50gc 511 No
acA1920-50gm 511 No
acA1920-150uc 8-bit pixel formats: 63.75
10-bit or 12-bit pixel formats: 255
No
acA1920-150um 8-bit pixel formats: 63.75
10-bit or 12-bit pixel formats: 255
No
acA1920-155uc 8-bit pixel formats: 31.9375
10-bit or 12-bit pixel formats: 511
No
acA1920-155ucMED 8-bit pixel formats: 31.9375
10-bit or 12-bit pixel formats: 511
No
acA1920-155um 8-bit pixel formats: 63.75
10-bit or 12-bit pixel formats: 255
No
acA1920-155umMED 8-bit pixel formats: 31.9375
10-bit or 12-bit pixel formats: 511
No
acA2000-50gc 255 No
acA2000-50gm 255 No
acA2000-50gmNIR 255 No
acA2000-165uc 8-bit pixel formats: 15.9375
10-bit or 12-bit pixel formats: 255
No
acA2000-165um 8-bit pixel formats: 15.9375
10-bit or 12-bit pixel formats: 255
No
acA2000-165umNIR 8-bit pixel formats: 15.9375
10-bit or 12-bit pixel formats: 255
No
acA2040-25gc 255 No
acA2040-25gm 255 No
acA2040-25gmNIR 255 No
acA2040-35gc 511 No
acA2040-35gm 511 No
acA2040-55uc 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA2040-55um 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA2040-90uc 8-bit pixel format: 15.9375
10-bit or 12-bit pixel format: 255
No
acA2040-90um 8-bit pixel format: 15.9375
10-bit or 12-bit pixel format: 255
No
acA2040-90umNIR 8-bit pixel format: 15.9375
10-bit or 12-bit pixel format: 255
No
acA2040-120uc 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA2040-120um 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA2440-20gc 511 No
acA2440-20gm 511 No
acA2440-35uc 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA2440-35ucMED 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA2440-35um 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA2440-35umMED 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA2440-75uc 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA2440-75ucMED 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA2440-75um 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA2440-75umMED 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA2500-14gc 63 No
acA2500-14gm 63 No
acA2500-14uc 8-bit pixel format: 15.9375
10-bit or 12-bit pixel format: 255
No
acA2500-14um 8-bit pixel format: 15.9375
10-bit or 12-bit pixel format: 255
No
acA2500-20gc 255 No
acA2500-20gcMED 255 No
acA2500-20gm 255 No
acA2500-20gmMED 255 No
acA2500-60uc 8-bit pixel format: 63.75
10-bit or 12-bit pixel format: 255
No
acA2500-60um 8-bit pixel format: 63.75
10-bit or 12-bit pixel format: 255
No
acA3088-16gc 8-bit pixel format: 504
Other pixel formats: 511
No
acA3088-16gm 8-bit pixel format: 504
Other pixel formats: 511
No
acA3088-57uc 8-bit pixel format: 504
Other pixel formats: 511
No
acA3088-57ucMED 8-bit pixel format: 504
Other pixel formats: 511
Yes
acA3088-57um 8-bit pixel format: 504
Other pixel formats: 511
No
acA3088-57umMED 8-bit pixel format: 504
Other pixel formats: 511
Yes
acA3800-10gc 1023 No
acA3800-10gm 1023 No
acA3800-14uc 8-bit pixel format: 63.9375
10-bit or 12-bit pixel format: 1023
No
acA3800-14um 8-bit pixel format: 63.9375
10-bit or 12-bit pixel format: 1023
No
acA4024-8gc 255 No
acA4024-8gm 255 No
acA4024-29uc 1020 No
acA4024-29um 1020 No
acA4096-11gc 511 No
acA4096-11gm 511 No
acA4096-30uc 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4096-30ucMED 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4096-30um 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4096-30umMED 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4096-40uc 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4096-40ucMED 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4096-40um 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4096-40umMED 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4112-8gc 511 No
acA4112-8gm 511 No
acA4112-20uc 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4112-20ucMED 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4112-20um 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4112-20umMED 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4112-30uc 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4112-30ucMED 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4112-30um 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4112-30umMED 8-bit pixel format: 31.9375
10-bit or 12-bit pixel format: 511
No
acA4600-7gc 1023 No
acA4600-10uc 8-bit pixel format: 63.9375
10-bit or 12-bit pixel format: 1023
No
acA5472-5gc 63 No
acA5472-5gm 63 No
acA5472-17uc 8-bit pixel format: 63
Other pixel formats: 1020
No
acA5472-17ucMED 8-bit pixel format: 63
Other pixel formats: 1020
No
acA5472-17um 8-bit pixel format: 63
Other pixel formats: 1020
No
acA5472-17umMED 8-bit pixel format: 63
Other pixel formats: 1020
No
boA4096-93cc Sensor Bit Depth set to Bpp8: 255
Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
boA4096-93cm Sensor Bit Depth set to Bpp8: 255
Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
boA4112-68cc Sensor Bit Depth set to Bpp8: 255
Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
boA4112-68cm Sensor Bit Depth set to Bpp8: 255
Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
No
boA6500-36cm Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
Yes
boA8100-16cm Sensor Bit Depth set to Bpp10: 1023
Sensor Bit Depth set to Bpp12: 4095
Yes
daA1280-54lc 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA1280-54lm 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA1280-54uc 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA1280-54um 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA1600-60lc 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA1600-60lm 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA1600-60uc 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA1600-60um 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA1920-15um 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA1920-30uc 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA1920-30um 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA1920-160uc Sensor Bit Depth set to Bpp8: 63
Sensor Bit Depth set to Bpp10 or Bpp12: 255
No
daA1920-160um Sensor Bit Depth set to Bpp8: 63
Sensor Bit Depth set to Bpp10 or Bpp12: 255
No
daA2500-14lc 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA2500-14lm 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA2500-14uc 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA2500-14um 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
daA2500-60mc Black Level feature not supported No
daA2500-60mci Black Level feature not supported No
daA4200-30mci Black Level feature not supported No
puA1280-54uc 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
puA1280-54um 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
puA1600-60uc 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
puA1600-60um 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
puA1920-30uc 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
puA1920-30um 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
puA2500-14uc 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No
puA2500-14um 8-bit pixel format: 32
10-bit or 12-bit pixel format: 512
No

Black Level Effect#

Show all camera models

Camera Model Change in BlackLevel Parameter Value Resulting Change in Gray Value
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
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
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
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
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
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
acA640-90gc 8-bit pixel formats: ± 64
12-bit pixel formats: ± 4
± 1
acA640-90gm 8-bit pixel formats: ± 64
12-bit pixel formats: ± 4
± 1
acA640-90uc ± 1 ± 1
acA640-90um ± 1 ± 1
acA640-120gc 8-bit pixel formats: ± 64
12-bit pixel formats: ± 4
± 1
acA640-120gm 8-bit pixel formats: ± 64
12-bit pixel formats: ± 4
± 1
acA640-120uc ± 1 ± 1
acA640-120um ± 1 ± 1
acA640-121gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA640-300gc 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA640-300gm 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA640-750uc ± 1 ± 1
acA640-750um ± 1 ± 1
acA720-290gc 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA720-290gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA720-520uc ± 1 ± 1
acA720-520um ± 1 ± 1
acA780-75gc 8-bit pixel formats: ± 64
12-bit pixel formats: ± 4
± 1
acA780-75gm 8-bit pixel formats: ± 64
12-bit pixel formats: ± 4
± 1
acA800-200gc 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA800-200gm 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA800-510uc ± 1 ± 1
acA800-510um ± 1 ± 1
acA1280-60gc 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA1280-60gm 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA1300-22gc 8-bit pixel formats: ± 64
12-bit pixel formats: ± 4
± 1
acA1300-22gm 8-bit pixel formats: ± 64
12-bit pixel formats: ± 4
± 1
acA1300-30gc 8-bit pixel formats: ± 64
12-bit pixel formats: ± 4
± 1
acA1300-30gm 8-bit pixel formats: ± 64
12-bit pixel formats: ± 4
± 1
acA1300-30uc ± 1 ± 1
acA1300-30um ± 1 ± 1
acA1300-60gc 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA1300-60gm 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA1300-60gmNIR 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA1300-75gc 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA1300-75gm 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA1300-200uc ± 1 ± 1
acA1300-200um ± 1 ± 1
acA1440-73gc 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA1440-73gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA1440-220uc ± 1 ± 1
acA1440-220um ± 1 ± 1
acA1600-20gc 8-bit pixel formats: ± 64
12-bit pixel formats: ± 4
± 1
acA1600-20gm 8-bit pixel formats: ± 64
12-bit pixel formats: ± 4
± 1
acA1600-20uc ± 1 ± 1
acA1600-20um ± 1 ± 1
acA1600-60gc 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA1600-60gm 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA1920-25gc 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA1920-25gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA1920-25uc ± 1 ± 1
acA1920-25um ± 1 ± 1
acA1920-40gc 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA1920-40gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA1920-40uc ± 1 ± 1
acA1920-40ucMED ± 1 ± 1
acA1920-40um ± 1 ± 1
acA1920-40umMED ± 1 ± 1
acA1920-48gc 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA1920-48gm 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA1920-50gc 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA1920-50gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± 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-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA2000-50gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA2000-50gmNIR 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA2000-165uc ± 1 ± 1
acA2000-165um ± 1 ± 1
acA2000-165umNIR ± 1 ± 1
acA2040-25gc 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA2040-25gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA2040-25gmNIR 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA2040-35gc 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA2040-35gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± 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-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA2440-20gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± 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-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA2500-14gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA2500-14uc ± 1 ± 1
acA2500-14um ± 1 ± 1
acA2500-20gc 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA2500-20gcMED 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA2500-20gm 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA2500-20gmMED 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA2500-60uc ± 1 ± 1
acA2500-60um ± 1 ± 1
acA3088-16gc 8-bit pixel formats: ± 16
12-bit pixel formats: ± approx. 1
± 1
acA3088-16gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± approx. 1
± 1
acA3088-57uc ± 1 ± approx. 1
acA3088-57ucMED ± 1 ± approx. 1
acA3088-57um ± 1 ± approx. 1
acA3088-57umMED ± 1 ± approx. 1
acA3800-10gc 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA3800-10gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA3800-14uc ± 1 ± 1
acA3800-14um ± 1 ± 1
acA4024-8gc 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA4024-8gm 8-bit pixel formats: ± 4
10-bit pixel formats: ± 1
12-bit pixel formats: ± 1
± 1
acA4024-29uc ± 1 ± approx. 1
acA4024-29um ± 1 ± approx. 1
acA4096-11gc 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA4096-11gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± 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-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA4112-8gm 8-bit pixel formats: ± 16
12-bit pixel formats: ± 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
acA4600-7gc 8-bit pixel formats: ± 16
12-bit pixel formats: ± 1
± 1
acA4600-10uc ± 1 ± 1
acA5472-5gc ± 1 8-bit pixel formats: ± 1
12-bit pixel formats: ± 4
acA5472-5gm ± 1 8-bit pixel formats: ± 1
12-bit pixel formats: ± 4
acA5472-17uc ± 1 8-bit pixel formats: ± 1
12-bit pixel formats: ± 4
acA5472-17ucMED ± 1 8-bit pixel formats: ± 1
12-bit pixel formats: ± 4
acA5472-17um ± 1 8-bit pixel formats: ± 1
12-bit pixel formats: ± 4
acA5472-17umMED ± 1 8-bit pixel formats: ± 1
12-bit pixel formats: ± 4
boA4096-93cc ± 1 ± 1
boA4096-93cm ± 1 ± 1
boA4112-68cc ± 1 ± 1
boA4112-68cm ± 1 ± 1
boA6500-36cm 8-bit pixel formats: ± 16
10-bit pixel formats: ± 4
12-bit pixel formats: ± 1
± 1
boA8100-16cm 8-bit pixel formats: ± 16
10-bit pixel formats: ± 4
12-bit pixel formats: ± 1
± 1
daA1280-54lc ± 1a ± 1
daA1280-54lm ± 1a ± 1
daA1280-54uc ± 1a ± 1
daA1280-54um ± 1a ± 1
daA1600-60lc ± 1a ± 1
daA1600-60lm ± 1a ± 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
daA2500-14lc ± 1a ± 1
daA2500-14lm ± 1a ± 1
daA2500-14uc ± 1a ± 1
daA2500-14um ± 1a ± 1
daA2500-60mc Black Level feature not supported Black Level feature not supported
daA2500-60mci Black Level feature not supported Black Level feature not supported
daA4200-30mci Black Level feature not supported Black Level feature not supported
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. On daA1280-54um/uc, daA1280-54lm/uc, and puA1280-54um/uc cameras, the black level settings are applied to the pixel data after the gain settings. On all other dart and pulse cameras, the black level settings are applied before the gain settings.

Sample Code#

ace classic/U/L GigE Cameras#

// Set the black level to 32
camera.BlackLevelRaw.SetValue(32);
// 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
CIntegerPtr(nodemap.GetNode("BlackLevelRaw"))->SetValue(32);
// Disable black level compensation
// Note: Available on selected camera models only
CEnumerationPtr(nodemap.GetNode("BslBlackLevelCompensationMode"))->FromString("Off");
INodeMap& nodemap = camera.GetNodeMap();
// Set the black level to 32
CIntegerParameter(nodemap, "BlackLevelRaw").SetValue(32);
// 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);
// Disable black level compensation
// Note: Available on selected camera models only
camera.Parameters[PLCamera.BslBlackLevelCompensationMode].SetValue(PLCamera.BslBlackLevelCompensationMode.Off);
// Set the black level to 32
Pylon.DeviceSetIntegerFeature(hdev, "BlackLevelRaw", 32);
// Disable black level compensation
// Note: Available on selected camera models only
Pylon.DeviceFeatureFromString(hdev, "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 = PylonDeviceSetIntegerFeature(hdev, "BlackLevelRaw", 32);
CHECK(errRes);
/* Disable black level compensation */
/* Note: Available on selected camera models only */
errRes = PylonDeviceFeatureFromString(hdev, "BslBlackLevelCompensationMode", "Off");
CHECK(errRes);

Other Cameras#

// Set the black level to 32
camera.BlackLevel.SetValue(32);
// 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
CIntegerPtr(nodemap.GetNode("BlackLevel"))->SetValue(32);
// Disable black level compensation
// Note: Available on selected camera models only
CEnumerationPtr(nodemap.GetNode("BslBlackLevelCompensationMode"))->FromString("Off");
INodeMap& nodemap = camera.GetNodeMap();
// Set the black level to 32
CIntegerParameter(nodemap, "BlackLevel").SetValue(32);
// 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);
// Disable black level compensation
// Note: Available on selected camera models only
camera.Parameters[PLCamera.BslBlackLevelCompensationMode].SetValue(PLCamera.BslBlackLevelCompensationMode.Off);
// Set the black level to 32
Pylon.DeviceSetIntegerFeature(hdev, "BlackLevel", 32);
// Disable black level compensation
// Note: Available on selected camera models only
Pylon.DeviceFeatureFromString(hdev, "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 = PylonDeviceSetIntegerFeature(hdev, "BlackLevel", 32);
CHECK(errRes);
/* Disable black level compensation */
/* Note: Available on selected camera models only */
errRes = PylonDeviceFeatureFromString(hdev, "BslBlackLevelCompensationMode", "Off");
CHECK(errRes);

You can also use the pylon Viewer to easily set the parameters.