This website is being translated through machine translation by a third-party service. Basler does not warrant the accuracy, reliability or timeliness of any information translated by this system and will not accept liability for loss or damage incurred as a result. Content that has not yet been translated appears in English. Switch to English version
Parameter names may not apply to your camera model.
To display appropriate parameter names, select a camera model:
a2A1280-125umSWIR
a2A1280-80gmSWIR
a2A1920-160ucBAS
a2A1920-160ucPRO
a2A1920-160umBAS
a2A1920-160umPRO
a2A1920-165g5cBAS
a2A1920-165g5mBAS
a2A1920-51gcBAS
a2A1920-51gcPRO
a2A1920-51gmBAS
a2A1920-51gmPRO
a2A2048-110umSWIR
a2A2048-114g5cBAS
a2A2048-114g5mBAS
a2A2048-114ucBAS
a2A2048-114ucPRO
a2A2048-114umBAS
a2A2048-114umPRO
a2A2048-35gmSWIR
a2A2048-37gcBAS
a2A2048-37gcPRO
a2A2048-37gmBAS
a2A2048-37gmPRO
a2A2440-98g5cBAS
a2A2440-98g5mBAS
a2A2448-105g5cBAS
a2A2448-105g5mBAS
a2A2448-120cc
a2A2448-120cm
a2A2448-210cc
a2A2448-210cm
a2A2448-23gcBAS
a2A2448-23gcPRO
a2A2448-23gmBAS
a2A2448-23gmPRO
a2A2448-75ucBAS
a2A2448-75ucPRO
a2A2448-75umBAS
a2A2448-75umPRO
a2A2560-20gmSWIR
a2A2560-70umSWIR
a2A2590-22gcBAS
a2A2590-22gcPRO
a2A2590-22gmBAS
a2A2590-22gmPRO
a2A2590-60ucBAS
a2A2590-60ucPRO
a2A2590-60umBAS
a2A2590-60umPRO
a2A2600-20gcBAS
a2A2600-20gcPRO
a2A2600-20gmBAS
a2A2600-20gmPRO
a2A2600-64ucBAS
a2A2600-64ucPRO
a2A2600-64umBAS
a2A2600-64umPRO
a2A2840-14gcBAS
a2A2840-14gcPRO
a2A2840-14gmBAS
a2A2840-14gmPRO
a2A2840-14gmUV
a2A2840-48ucBAS
a2A2840-48ucPRO
a2A2840-48umBAS
a2A2840-48umPRO
a2A2840-48umUV
a2A2840-67g5cBAS
a2A2840-67g5mBAS
a2A2840-67g5mUV
a2A2840-86cc
a2A2840-86cm
a2A3536-31ucBAS
a2A3536-31ucPRO
a2A3536-31umBAS
a2A3536-31umPRO
a2A3536-42g5cBAS
a2A3536-42g5mBAS
a2A3536-9gcBAS
a2A3536-9gcPRO
a2A3536-9gmBAS
a2A3536-9gmPRO
a2A3840-13gcBAS
a2A3840-13gcPRO
a2A3840-13gmBAS
a2A3840-13gmPRO
a2A3840-45ucBAS
a2A3840-45ucPRO
a2A3840-45umBAS
a2A3840-45umPRO
a2A4096-30ucBAS
a2A4096-30ucPRO
a2A4096-30umBAS
a2A4096-30umPRO
a2A4096-44g5cBAS
a2A4096-44g5mBAS
a2A4096-67cc
a2A4096-67cm
a2A4096-9gcBAS
a2A4096-9gcPRO
a2A4096-9gmBAS
a2A4096-9gmPRO
a2A4200-12gcBAS
a2A4200-12gcPRO
a2A4200-12gmBAS
a2A4200-12gmPRO
a2A4200-40ucBAS
a2A4200-40ucPRO
a2A4200-40umBAS
a2A4200-40umPRO
a2A4504-18ucBAS
a2A4504-18ucPRO
a2A4504-18umBAS
a2A4504-18umPRO
a2A4504-27g5cBAS
a2A4504-27g5mBAS
a2A4504-42cc
a2A4504-42cm
a2A4504-5gcBAS
a2A4504-5gcPRO
a2A4504-5gmBAS
a2A4504-5gmPRO
a2A4508-20ucBAS
a2A4508-20ucPRO
a2A4508-20umBAS
a2A4508-20umPRO
a2A4508-6gcBAS
a2A4508-6gcPRO
a2A4508-6gmBAS
a2A4508-6gmPRO
a2A5060-15ucBAS
a2A5060-15umBAS
a2A5060-21g5cBAS
a2A5060-21g5mBAS
a2A5060-4gcBAS
a2A5060-4gmBAS
a2A5320-23ucBAS
a2A5320-23ucPRO
a2A5320-23umBAS
a2A5320-23umPRO
a2A5320-34g5cBAS
a2A5320-34g5mBAS
a2A5320-52cc
a2A5320-52cm
a2A5320-7gcBAS
a2A5320-7gcPRO
a2A5320-7gmBAS
a2A5320-7gmPRO
a2A5328-15ucBAS
a2A5328-15ucPRO
a2A5328-15umBAS
a2A5328-15umPRO
a2A5328-22g5cBAS
a2A5328-22g5mBAS
a2A5328-35cc
a2A5328-35cm
a2A5328-4gcBAS
a2A5328-4gcPRO
a2A5328-4gmBAS
a2A5328-4gmPRO
a2A640-240gmSWIR
a2A640-240umSWIR
acA1280-60gc
acA1280-60gm
acA1300-200uc
acA1300-200um
acA1300-60gc
acA1300-60gm
acA1300-60gmNIR
acA1300-75gc
acA1300-75gm
acA1440-220uc
acA1440-220um
acA1440-73gc
acA1440-73gm
acA1600-20gc
acA1600-20uc
acA1600-60gc
acA1600-60gm
acA1920-150uc
acA1920-150um
acA1920-155uc
acA1920-155ucMED
acA1920-155um
acA1920-155umMED
acA1920-25gc
acA1920-25gm
acA1920-25uc
acA1920-25um
acA1920-40gc
acA1920-40gm
acA1920-40uc
acA1920-40ucMED
acA1920-40um
acA1920-40umMED
acA1920-48gc
acA1920-48gm
acA1920-50gc
acA1920-50gm
acA2000-165uc
acA2000-165um
acA2000-50gc
acA2000-50gm
acA2040-120uc
acA2040-120um
acA2040-25gc
acA2040-25gm
acA2040-25gmNIR
acA2040-35gc
acA2040-35gm
acA2040-55uc
acA2040-55um
acA2040-90uc
acA2040-90um
acA2040-90umNIR
acA2440-20gc
acA2440-20gm
acA2440-35uc
acA2440-35ucMED
acA2440-35um
acA2440-35umMED
acA2440-75uc
acA2440-75ucMED
acA2440-75um
acA2440-75umMED
acA2500-14gc
acA2500-14gm
acA2500-14uc
acA2500-14um
acA2500-20gc
acA2500-20gcMED
acA2500-20gm
acA2500-20gmMED
acA2500-60uc
acA2500-60um
acA3088-16gc
acA3088-16gm
acA3088-57uc
acA3088-57ucMED
acA3088-57um
acA3088-57umMED
acA3800-10gc
acA3800-10gm
acA3800-14uc
acA3800-14um
acA4024-29uc
acA4024-29um
acA4024-8gc
acA4024-8gm
acA4096-11gc
acA4096-11gm
acA4096-30uc
acA4096-30ucMED
acA4096-30um
acA4096-30umMED
acA4096-40uc
acA4096-40ucMED
acA4096-40um
acA4096-40umMED
acA4112-20uc
acA4112-20ucMED
acA4112-20um
acA4112-20umMED
acA4112-30uc
acA4112-30ucMED
acA4112-30um
acA4112-30umMED
acA4112-8gc
acA4112-8gm
acA5472-17uc
acA5472-17ucMED
acA5472-17um
acA5472-17umMED
acA5472-5gc
acA5472-5gm
acA640-121gm
acA640-300gc
acA640-300gm
acA640-750uc
acA640-750um
acA720-290gc
acA720-290gm
acA720-520uc
acA720-520um
acA800-200gc
acA800-200gm
acA800-510uc
acA800-510um
blaze-101
blaze-102
boA13440-17cm
boA1936-400cc
boA1936-400cm
boA2448-250cc
boA2448-250cm
boA2832-190cc
boA2832-190cm
boA4096-180cc
boA4096-180cm
boA4096-93cc
boA4096-93cm
boA4112-68cc
boA4112-68cm
boA4500-45cc
boA4500-45cm
boA4504-100cc
boA4504-100cm
boA5120-150cc
boA5120-150cm
boA5120-230cc
boA5120-230cm
boA5320-150cc
boA5320-150cm
boA5328-100cc
boA5328-100cm
boA6500-36cc
boA6500-36cm
boA8100-16cc
boA8100-16cm
boA9344-30cc
boA9344-30cm
boA9344-70cc
boA9344-70cm
daA1280-54uc
daA1280-54um
daA1440-220uc
daA1440-220um
daA1600-60uc
daA1600-60um
daA1920-15um
daA1920-160uc
daA1920-160um
daA1920-30uc
daA1920-30um
daA2448-70uc
daA2448-70um
daA2500-14uc
daA2500-14um
daA2500-60mc
daA2500-60mci
daA3840-30mc
daA3840-45uc
daA3840-45um
daA4200-30mci
daA720-520uc
daA720-520um
dmA1440-73gc
dmA1440-73gm
dmA1920-51gc
dmA1920-51gm
dmA2448-23gc
dmA2448-23gm
dmA2840-14gc
dmA2840-14gm
dmA3536-9gc
dmA3536-9gm
dmA4096-9gc
dmA4096-9gm
dmA720-290gc
dmA720-290gm
puA1280-54uc
puA1280-54um
puA1600-60uc
puA1600-60um
puA1920-30uc
puA1920-30um
puA2500-14uc
puA2500-14um
r2L16384-120cm
r2L2048-172cm
r2L2048-172g5m
r2L2048-29gc
r2L2048-58gm
r2L2048-62cc
r2L2048-62g5c
r2L4096-14gc
r2L4096-29gm
r2L4096-42cc
r2L4096-42g5c
r2L4096-84cm
r2L4096-84g5m
r2L8192-200cm
The information in this topic does not apply to your camera model.
The parameters of the auto function are preset to values that deliver good results in most scenarios.
To adjust the contrast or color or both using the default settings:
Make sure the camera already produces good images, with only issues like low contrast or shifted colors remaining. Tonal range operations should only be performed on images that already have a good image quality. When optimizing the image quality, follow the sequence given below.
Assign at least one auto function ROI to the Tonal Range Auto auto function. Make sure the auto function ROI overlaps the image ROI, either partially or completely.
If you are using a color camera:
If you want to adjust contrast and color in a single step, set the AutoTonalRangeModeSelector parameter to ColorAndContrast.
If you only want to adjust the contrast, set the AutoTonalRangeModeSelector parameter to Contrast.
If you only want to correct color shifts, set the AutoTonalRangeModeSelector parameter to Color. (If you are using a mono camera, only contrast adjustment is available. The AutoTonalRangeModeSelector parameter is preset to Contrast and can't be changed.)
Set the TonalRangeAuto parameter to Once. With the next image acquisition, the camera adjusts contrast or color or both using the default settings. When the adjustment is complete, the camera sets the auto function to Off and applies the adjustment to all subsequent images.
If you want to fine-tune the adjustments, use the Tonal Range feature.
To adjust the contrast or color or both using custom settings:
If you are using a color camera:
If you want to adjust contrast and color in a single step, set the AutoTonalRangeModeSelector parameter to ColorAndContrast.
If you only want to adjust the contrast, set the AutoTonalRangeModeSelector parameter to Contrast.
If you only want to correct color shifts, set the AutoTonalRangeModeSelector parameter to Color. (If you are using a mono camera, only contrast adjustment is available. The AutoTonalRangeModeSelector parameter is preset to Contrast and can't be changed.)
Set the AutoTonalRangeAdjustmentSelector parameter to one of the following values:
BrightAndDark (default): Automatic adjustments are applied to dark and bright parts of your images.
Dark: Automatic adjustments are applied to dark parts of your images only.
Bright: Automatic adjustments are applied to bright parts of your images only.
Specify the dark threshold value using the AutoTonalRangeThresholdDark parameter.
Specify the bright threshold value using the AutoTonalRangeThresholdBright parameter.
If the AutoTonalRangeModeSelector parameter is set to ColorAndContrast or Contrast:
Set the AutoTonalRangeTargetDark parameter to the dark target value.
Set the AutoTonalRangeTargetBright parameter to the bright target value.
Set the TonalRangeAuto parameter to Once. With the next image acquisition, the camera adjusts contrast or color or both using the default settings. When the adjustment is complete, the camera sets the auto function to Off and applies the adjustment to all subsequent simages.
If you want to fine-tune the adjustments, use the Tonal Range feature.
Tonal range operations are best understood by looking at a graphical representation of the tonal distribution in your images, i.e., an image histogram.
The Basler pylon Viewer provides the Histogram pane, which can be very helpful when performing tonal range operations.
Info
Depending on which other features are enabled on your camera, the Histogram pane in the pylon Viewer may not display the data that the auto function actually uses. For example, the Gamma feature is processed after tonal range operations. As a result, gamma correction is included in the histograms displayed in the pylon Viewer, but not in the data that the auto function uses.
What's different is how the camera determines the source and target values:
The camera determines the dark and bright source values by calculating the threshold values.
The camera determines the dark and bright target values as follows:
For contrast adjustments, the camera reads the value of the AutoTonalRangeTargetDark and AutoTonalRangeTargetBright parameters.
For color adjustments, the camera automatically determines target values that will properly align the RGB histograms.
Once the camera has determined the source and target values, the camera performs contrast and color adjustments exactly as described in the Tonal Range topic.
During automatic tonal range adjustments, the source values are calculated automatically based on threshold values.
You must specify the threshold values using the AutoTonalRangeThresholdDark and AutoTonalRangeThresholdBright parameters. The parameters are expressed as percentages of all pixels in your image.
Info
In this section, it is assumed that the assigned auto function ROI and the image ROI are identical, which is the default setting. if you changed your auto function ROI settings, the percentages refer to the pixels in the areas of overlap between the assigned auto function ROI and the image ROI.
From the percentages, the camera calculates the following:
The dark threshold value, which is the value in the histogram where the specified amount of pixels have a pixel value lower than or equal to the threshold value.
The bright threshold value, which is the value in the histogram where the specified amount of pixels have a pixel value greater than or equal to the threshold value.
The area between both thresholds defines your mid-tones, i.e., the pixel values you consider essential for the image.
Example: Assume you set the AutoTonalRangeThresholdDark parameter to 0.3 and the AutoTonalRangeThresholdBright parameter to 0.4. The camera detects that 0.3 % of the pixels in your image have a pixel value lower than or equal to 52, and 0.4 % of the pixels in your image have a pixel value greater than or equal to 204. Therefore, the dark threshold value is 52, and the bright threshold value is 204.
// Enable contrast adjustments onlycamera.AutoTonalRangeModeSelector.SetValue(AutoTonalRangeModeSelector_Contrast);// Specify that both ends of the tonal range are to be adjusted automaticallycamera.AutoTonalRangeAdjustmentSelector.SetValue(AutoTonalRangeAdjustmentSelector_BrightAndDark);// Set the percentage of pixels that is used to calculate the dark thresholdcamera.AutoTonalRangeThresholdDark.SetValue(0.3);// Set the percentage of pixels that is used to calculate the bright thresholdcamera.AutoTonalRangeThresholdBright.SetValue(0.4);// Set the dark target valuecamera.AutoTonalRangeTargetDark.SetValue(0);// Set the bright target valuecamera.AutoTonalRangeTargetBright.SetValue(255);// Enable the Tonal Range Auto auto functioncamera.TonalRangeAuto.SetValue(TonalRangeAuto_Once);
INodeMap&nodemap=camera.GetNodeMap();// Enable contrast adjustments onlyCEnumParameter(nodemap,"AutoTonalRangeModeSelector").SetValue("Contrast");// Specify that both ends of the tonal range are to be adjusted automaticallyCEnumParameter(nodemap,"AutoTonalRangeAdjustmentSelector").SetValue("BrightAndDark");// Set the percentage of pixels that is used to calculate the dark thresholdCFloatParameter(nodemap,"AutoTonalRangeThresholdDark").SetValue(0.3);// Set the percentage of pixels that is used to calculate the bright thresholdCFloatParameter(nodemap,"AutoTonalRangeThresholdBright").SetValue(0.4);// Set the dark target valueCIntegerParameter(nodemap,"AutoTonalRangeTargetDark").SetValue(0);// Set the bright target valueCIntegerParameter(nodemap,"AutoTonalRangeTargetBright").SetValue(255);// Enable the Tonal Range Auto auto functionCEnumParameter(nodemap,"TonalRangeAuto").SetValue("Once");
// Enable contrast adjustments onlycamera.Parameters[PLCamera.AutoTonalRangeModeSelector].SetValue(PLCamera.AutoTonalRangeModeSelector.Contrast);// Specify that both ends of the tonal range are to be adjusted automaticallycamera.Parameters[PLCamera.AutoTonalRangeAdjustmentSelector].SetValue(PLCamera.AutoTonalRangeAdjustmentSelector.BrightAndDark);// Set the percentage of pixels that is used to calculate the dark thresholdcamera.Parameters[PLCamera.AutoTonalRangeThresholdDark].SetValue(0.3);// Set the percentage of pixels that is used to calculate the bright thresholdcamera.Parameters[PLCamera.AutoTonalRangeThresholdBright].SetValue(0.4);// Set the dark target valuecamera.Parameters[PLCamera.AutoTonalRangeTargetDark].SetValue(0);// Set the bright target valuecamera.Parameters[PLCamera.AutoTonalRangeTargetBright].SetValue(255);// Enable the Tonal Range Auto auto functioncamera.Parameters[PLCamera.TonalRangeAuto].SetValue(PLCamera.TonalRangeAuto.Once);
/* Macro to check for errors */#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)GENAPIC_RESULTerrRes=GENAPI_E_OK;/* Return value of pylon methods *//* Enable contrast adjustments only */errRes=PylonDeviceFeatureFromString(hdev,"AutoTonalRangeModeSelector","Contrast");CHECK(errRes);/* Specify that both ends of the tonal range are to be adjusted automatically */errRes=PylonDeviceFeatureFromString(hdev,"AutoTonalRangeAdjustmentSelector","BrightAndDark");CHECK(errRes);/* Set the percentage of pixels that is used to calculate the dark threshold */errRes=PylonDeviceSetFloatFeature(hdev,"AutoTonalRangeThresholdDark",0.3);CHECK(errRes);/* Set the percentage of pixels that is used to calculate the bright threshold */errRes=PylonDeviceSetFloatFeature(hdev,"AutoTonalRangeThresholdBright",0.4);CHECK(errRes);/* Set the dark target value */errRes=PylonDeviceSetIntegerFeature(hdev,"AutoTonalRangeTargetDark",0);CHECK(errRes);/* Set the bright target value */errRes=PylonDeviceSetIntegerFeature(hdev,"AutoTonalRangeTargetBright",255);CHECK(errRes);/* Enable the Tonal Range Auto auto function */errRes=PylonDeviceFeatureFromString(hdev,"TonalRangeAuto","Once");CHECK(errRes);
# Enable contrast adjustments onlycamera.AutoTonalRangeModeSelector.Value="Contrast"# Specify that both ends of the tonal range are to be adjusted automaticallycamera.AutoTonalRangeAdjustmentSelector.Value="BrightAndDark"# Set the percentage of pixels that is used to calculate the dark thresholdcamera.AutoTonalRangeThresholdDark.Value=0.3# Set the percentage of pixels that is used to calculate the bright thresholdcamera.AutoTonalRangeThresholdBright.Value=0.4# Set the dark target valuecamera.AutoTonalRangeTargetDark.Value=0# Set the bright target valuecamera.AutoTonalRangeTargetBright.Value=255# Enable the Tonal Range Auto auto functioncamera.TonalRangeAuto.Value="Once"