For example, if you set a black level that results in a gray value increase of 3, the gray value of each pixel in the image is increased by 3.
In this topic Hide
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.
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 Parameter Range
Camera Model | Maximum Black Level [DN] |
---|---|
a2A1920-51gmBAS |
|
a2A1920-51gcBAS |
|
a2A1920-160umBAS |
|
a2A1920-160ucBAS |
|
acA640-90gm | 1023 |
acA640-90gc | 1023 |
acA640-120gm | 1023 |
acA640-120gc | 1023 |
acA640-121gm | 511 |
acA640-300gm | 255 |
acA640-300gc | 255 |
acA720-290gm | 511 |
acA720-290gc | 511 |
acA780-75gm | 1023 |
acA780-75gc | 1023 |
acA800-200gm | 255 |
acA800-200gc | 255 |
acA1280-60gm | 80 |
acA1280-60gc | 80 |
acA1300-22gm | 1023 |
acA1300-22gc | 1023 |
acA1300-30gm | 1023 |
acA1300-30gc | 1023 |
acA1300-60gm | 80 |
acA1300-60gmNIR | 80 |
acA1300-60gc | 80 |
acA1300-75gm | 255 |
acA1300-75gc | 255 |
acA1440-73gm | 511 |
acA1440-73gc | 511 |
acA1600-20gm | 1023 |
acA1600-20gc | 1023 |
acA1600-60gm | 80 |
acA1600-60gc | 80 |
acA1920-25gm | 63 |
acA1920-25gc | 63 |
acA1920-40gm | 511 |
acA1920-40gc | 511 |
acA1920-48gm | 255 |
acA1920-48gc | 255 |
acA1920-50gm | 511 |
acA1920-50gc | 511 |
acA2000-50gm | 255 |
acA2000-50gmNIR | 255 |
acA2000-50gc | 255 |
acA2040-25gm | 255 |
acA2040-25gmNIR | 255 |
acA2040-25gc | 255 |
acA2040-35gm | 511 |
acA2040-35gc | 511 |
acA2440-20gm | 511 |
acA2440-20gc | 511 |
acA2500-14gm | 63 |
acA2500-14gc | 63 |
acA2500-20gm | 255 |
acA2500-20gc | 255 |
acA2500-20gmMED | 255 |
acA2500-20gcMED | 255 |
acA3088-16gm |
|
acA3088-16gc |
|
acA3800-10gm | 1023 |
acA3800-10gc | 1023 |
acA4024-8gm | 255 |
acA4024-8gc | 255 |
acA4096-11gm | 511 |
acA4096-11gc | 511 |
acA4112-8gm | 511 |
acA4112-8gc | 511 |
acA4600-7gc | 1023 |
acA5472-5gm | 63 |
acA5472-5gc | 63 |
acA640-750um |
|
acA640-750uc |
|
acA640-90um |
|
acA640-90uc |
|
acA640-120um |
|
acA640-120uc |
|
acA720-520um |
|
acA720-520uc |
|
acA800-510um |
|
acA800-510uc |
|
acA1300-200um |
|
acA1300-200uc |
|
acA1300-30um |
|
acA1300-30uc |
|
acA1440-220um |
|
acA1440-220uc |
|
acA1600-20um |
|
acA1600-20uc |
|
acA1920-25um |
|
acA1920-25uc |
|
acA1920-40um |
|
acA1920-40uc |
|
acA1920-40umMED |
|
acA1920-40ucMED |
|
acA1920-150um |
|
acA1920-150uc |
|
acA1920-155um |
|
acA1920-155uc |
|
acA1920-155umMED |
|
acA1920-155ucMED |
|
acA2040-90um |
|
acA2040-90umNIR |
|
acA2040-90uc |
|
acA2000-165um |
|
acA2000-165umNIR |
|
acA2000-165uc |
|
acA2040-55um |
|
acA2040-55uc |
|
acA2040-120um |
|
acA2040-120uc |
|
acA2440-35um |
|
acA2440-35uc |
|
acA2440-35umMED |
|
acA2440-35ucMED |
|
acA2440-75um |
|
acA2440-75uc |
|
acA2440-75umMED |
|
acA2440-75ucMED |
|
acA2500-14um |
|
acA2500-14uc |
|
acA2500-60um |
|
acA2500-60uc |
|
acA3088-57um |
|
acA3088-57uc |
|
acA3800-14um |
|
acA3800-14uc |
|
acA4024-29um | 1020 |
acA4024-29uc | 1020 |
acA4096-30um |
|
acA4096-30uc |
|
acA4096-30umMED |
|
acA4096-30ucMED |
|
acA4096-40um |
|
acA4096-40uc |
|
acA4096-40umMED |
|
acA4096-40ucMED |
|
acA4112-20um |
|
acA4112-20uc |
|
acA4112-20umMED |
|
acA4112-20ucMED |
|
acA4112-30um |
|
acA4112-30uc |
|
acA4112-30umMED |
|
acA4112-30ucMED |
|
acA4600-10uc |
|
acA5472-17um |
|
acA5472-17uc |
|
boA4096-93cm | tbd |
boA4096-93cc | tbd |
boA4112-68cm | tbd |
boA4112-68cc | tbd |
All dart BCON for LVDS camera models |
|
All dart BCON for MIPI cameras models | Black Level feature not supported |
All dart USB 3.0 camera models |
|
All pulse USB 3.0 camera models |
|
Black Level Effect
Camera Model | Change in BlackLevel Parameter Value | Resulting Change in Gray Value |
---|---|---|
a2A1920-51gmBAS | +/- 1 | +/- 1 |
a2A1920-51gcBAS | +/- 1 | +/- 1 |
a2A1920-160umBAS | +/- 1 | +/- 1 |
a2A1920-160ucBAS | +/- 1 | +/- 1 |
acA640-90gm | 8-bit pixel
format: +/- 64
12-bit pixel format: +/- 4 |
+/- 1 |
acA640-90gc | 8-bit pixel
format: +/- 64
12-bit pixel format: +/- 4 |
+/- 1 |
acA640-120gm | 8-bit pixel
format: +/- 64
12-bit pixel format: +/- 4 |
+/- 1 |
acA640-120gc | 8-bit pixel
format: +/- 64
12-bit pixel format: +/- 4 |
+/- 1 |
acA640-121gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA640-300gm | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA640-300gc | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA720-290gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA720-290gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA780-75gm | 8-bit pixel
format: +/- 64
12-bit pixel format: +/- 4 |
+/- 1 |
acA780-75gc | 8-bit pixel
format: +/- 64
12-bit pixel format: +/- 4 |
+/- 1 |
acA800-200gm | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA800-200gc | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA1280-60gm | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA1280-60gc | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA1300-22gm | 8-bit pixel
format: +/- 64
12-bit pixel format: +/- 4 |
+/- 1 |
acA1300-22gc | 8-bit pixel
format: +/- 64
12-bit pixel format: +/- 4 |
+/- 1 |
acA1300-30gm | 8-bit pixel
format: +/- 64
12-bit pixel format: +/- 4 |
+/- 1 |
acA1300-30gc | 8-bit pixel
format: +/- 64
12-bit pixel format: +/- 4 |
+/- 1 |
acA1300-60gm | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA1300-60gc | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA1300-60gmNIR | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA1300-75gm | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA1300-75gc | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA1440-73gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA1440-73gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA1600-20gm | 8-bit pixel
format: +/- 64
12-bit pixel format: +/- 4 |
+/- 1 |
acA1600-20gc | 8-bit pixel
format: +/- 64
12-bit pixel format: +/- 4 |
+/- 1 |
acA1600-60gm | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA1600-60gc | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA1920-25gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA1920-25gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA1920-40gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA1920-40gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA1920-48gm | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA1920-48gc | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA1920-50gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA1920-50gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA2000-50gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA2000-50gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA2000-50gmNIR | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA2040-25gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA2040-25gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA2040-25gmNIR | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA2040-35gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA2040-35gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA2440-20gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA2440-20gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA2500-14gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA2500-14gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA2500-20gm | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA2500-20gc | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA2500-20gmMED | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA2500-20gcMED | 8-bit pixel
format: +/- 4
10-bit pixel format: +/- 1 12-bit pixel format: +/- 1 |
+/- 1 |
acA3088-16gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- approx. 1 |
acA3088-16gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- approx. 1 |
acA3800-10gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA3800-10gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA4024-8gm | 8-bit pixel
format: +/- 4
12-bit pixel format: +/- 0.25 |
+/- 1 |
acA4024-8gc | 8-bit pixel
format: +/- 4
12-bit pixel format: +/- 0.25 |
+/- 1 |
acA4096-11gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA4096-11gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA4112-8gm | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA4112-8gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA4600-7gc | 8-bit pixel
format: +/- 16
12-bit pixel format: +/- 1 |
+/- 1 |
acA5472-5gm | +/- 1 | 8-bit pixel
format: +/- 1
12-bit pixel format: +/- 4 |
acA5472-5gc | +/- 1 | 8-bit pixel
format: +/- 1
12-bit pixel format: +/- 4 |
acA640-750um | +/- 1 | +/- 1 |
acA640-750uc | +/- 1 | +/- 1 |
acA640-90um | +/- 1 | +/- 1 |
acA640-90uc | +/- 1 | +/- 1 |
acA640-120um | +/- 1 | +/- 1 |
acA640-120uc | +/- 1 | +/- 1 |
acA720-520um | +/- 1 | +/- 1 |
acA720-520uc | +/- 1 | +/- 1 |
acA800-510um | +/- 1 | +/- 1 |
acA800-510uc | +/- 1 | +/- 1 |
acA1300-200um | +/- 1 | +/- 1 |
acA1300-200uc | +/- 1 | +/- 1 |
acA1300-30um | +/- 1 | +/- 1 |
acA1300-30uc | +/- 1 | +/- 1 |
acA1440-220um | +/- 1 | +/- 1 |
acA1440-220uc | +/- 1 | +/- 1 |
acA1600-20um | +/- 1 | +/- 1 |
acA1600-20uc | +/- 1 | +/- 1 |
acA1920-25um | +/- 1 | +/- 1 |
acA1920-25uc | +/- 1 | +/- 1 |
acA1920-40um | +/- 1 | +/- 1 |
acA1920-40uc | +/- 1 | +/- 1 |
acA1920-40umMED | +/- 1 | +/- 1 |
acA1920-40ucMED | +/- 1 | +/- 1 |
acA1920-150um | +/- 1 | +/- 1 |
acA1920-150uc | +/- 1 | +/- 1 |
acA1920-155um | +/- 1 | +/- 1 |
acA1920-155uc | +/- 1 | +/- 1 |
acA1920-155umMED | +/- 1 | +/- 1 |
acA1920-155ucMED | +/- 1 | +/- 1 |
acA2040-90um | +/- 1 | +/- 1 |
acA2040-90uc | +/- 1 | +/- 1 |
acA2040-90umNIR | +/- 1 | +/- 1 |
acA2000-165um | +/- 1 | +/- 1 |
acA2000-165uc | +/- 1 | +/- 1 |
acA2000-165umNIR | +/- 1 | +/- 1 |
acA2040-55um | +/- 1 | +/- 1 |
acA2040-55uc | +/- 1 | +/- 1 |
acA2040-120um | +/- 1 | +/- 1 |
acA2040-120uc | +/- 1 | +/- 1 |
acA2440-35um | +/- 1 | +/- 1 |
acA2440-35uc | +/- 1 | +/- 1 |
acA2440-35umMED | +/- 1 | +/- 1 |
acA2440-35ucMED | +/- 1 | +/- 1 |
acA2440-75um | +/- 1 | +/- 1 |
acA2440-75uc | +/- 1 | +/- 1 |
acA2440-75umMED | +/- 1 | +/- 1 |
acA2440-75ucMED | +/- 1 | +/- 1 |
acA2500-14um | +/- 1 | +/- 1 |
acA2500-14uc | +/- 1 | +/- 1 |
acA2500-60um | +/- 1 | +/- 1 |
acA2500-60uc | +/- 1 | +/- 1 |
acA3088-57um | +/- 1 | +/- approx. 1 |
acA3088-57uc | +/- 1 | +/- approx. 1 |
acA3800-14um | +/- 1 | +/- 1 |
acA3800-14uc | +/- 1 | +/- 1 |
acA4024-29um | 8-bit pixel
format: +/- 4
12-bit pixel format: +/- 0.25 |
+/- approx. 1 |
acA4024-29uc | 8-bit pixel
format: +/- 4
12-bit pixel format: +/- 0.25 |
+/- approx. 1 |
acA4096-30um | +/- 1 | +/- 1 |
acA4096-30uc | +/- 1 | +/- 1 |
acA4096-30umMED | +/- 1 | +/- 1 |
acA4096-30ucMED | +/- 1 | +/- 1 |
acA4096-40um | +/- 1 | +/- 1 |
acA4096-40uc | +/- 1 | +/- 1 |
acA4096-40umMED | +/- 1 | +/- 1 |
acA4096-40ucMED | +/- 1 | +/- 1 |
acA4112-20um | +/- 1 | +/- 1 |
acA4112-20uc | +/- 1 | +/- 1 |
acA4112-20umMED | +/- 1 | +/- 1 |
acA4112-20ucMED | +/- 1 | +/- 1 |
acA4112-30um | +/- 1 | +/- 1 |
acA4112-30uc | +/- 1 | +/- 1 |
acA4112-30umMED | +/- 1 | +/- 1 |
acA4112-30ucMED | +/- 1 | +/- 1 |
acA4600-10uc | +/- 1 | +/- 1 |
acA5472-17um | +/- 1 | 8-bit pixel
format: +/- 1
12-bit pixel format: +/- 4 |
acA5472-17uc | +/- 1 | 8-bit pixel
format: +/- 1
12-bit pixel format: +/- 4 |
boA4096-93cm | tbd | tbd |
boA4096-93cc | tbd | tbd |
boA4112-68cm | tbd | tbd |
boA4112-68cc | tbd | tbd |
All dart BCON for LVDS camera models | +/- 1a | +/- 1 |
All dart BCON for MIPI cameras models | Black Level feature not supported | Black Level feature not supported |
All dart USB 3.0 camera models | +/- 1a | +/- 1 |
All pulse USB 3.0 camera models | +/- 1a | +/- 1 |
aOn 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.
// Set the black level to 32
camera.BlackLevelRaw.SetValue(32);
// Set the black level to 3
camera.BlackLevel.SetValue(3);
INodeMap& nodemap = camera.GetNodeMap();
// Set the black level to 32
CIntegerPtr(nodemap.GetNode("BlackLevelRaw"))->SetValue(32);
// Set the black level to 3
CIntegerPtr(nodemap.GetNode("BlackLevel"))->SetValue(3);
// Set the black level to 32
camera.Parameters[PLCamera.BlackLevelRaw].SetValue(32);
// Set the black level to 3
camera.Parameters[PLCamera.BlackLevel].SetValue(3);
// Set the black level to 32
Pylon.DeviceSetIntegerFeature(hdev, "BlackLevelRaw", 32);
// Set the black level to 3
Pylon.DeviceSetIntegerFeature(hdev, "BlackLevel", 3);
/* 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);
/* Set the black level to 3 */
errRes = PylonDeviceSetIntegerFeature(hdev, "BlackLevel", 3);
CHECK(errRes);
You can also use the pylon Viewer to easily set the parameters.