Black Level#
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 toOff
resets all internal correction values used for black level compensation.
Specifics#
Black Level Settings#
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 |
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#
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 |
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 |
-
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
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);
/* 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
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);
/* 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.