Light Source Preset#

The Light Source Preset camera feature allows you to correct color shifts caused by certain light sources.

Depending on its specific color temperature, the light used for image acquisition can cause color shifts in the image. You can correct these color shifts by selecting the related light source preset.

Using the Feature#

Selecting a Light Source Preset#

To select a light source preset, set the LightSourceSelector parameter to one of the following values (if available):

• Daylight: The camera corrects color shifts caused by daylight lighting that has a color temperature of about 5 000 K.
• Daylight6500K: The camera corrects color shifts caused by daylight lighting that has a color temperature of about 6 500 K.
• FactoryLED6000K: The camera corrects color shifts caused by LED lighting that has a color temperature of about 6 000 K.
• Fluorescent4000K: The camera corrects color shifts caused by fluorescent lighting that has a color temperature of about 4 000 K.
• MicroscopeLED4500K: The camera corrects color shifts caused by microscope LED lighting that has a color temperature of about 4 500 K.
• MicroscopeLED5500K: The camera corrects color shifts caused by microscope LED lighting that has a color temperature of about 5 500 K.
• MicroscopeLED6000K: The camera corrects color shifts caused by microscope LED lighting that has a color temperature of about 6 000 K.
• Tungsten: The camera corrects color shifts caused by tungsten lighting that has a color temperature of about 2 500 to 3 000 K.
• LineScanLED5500K: The camera corrects color shifts caused by LED lighting that has a color temperature of about 5 500 K. This preset is for line scan applications. This preset is adapted to Basler partner LED lights that work perfectly together with Basler line scan cameras.
  To find the right LED light for your application, visit the Basler website.
• Off: No light source preset is selected.
• Custom: Selecting this preset enables the Color Transformation feature which allows you to customize the light source settings. You should only select this preset if you are thoroughly familiar with matrix color transformations. The camera also adjusts the Balance White and Color Adjustment settings so that they have neutral values that do not change the appearance of the colors.

The default light source preset varies by camera model.

Impact on Other Features#

When you select a light source preset, the camera adjusts the settings of the following color enhancement features:

• Balance White
• Color Adjustment
• Color Transformation

The settings will be optimized for the selected light source.

On some camera models, you can choose which features you want the camera to adjust.

Separate Processing#

On some camera models, when you select a light source preset, the camera processes the changes to the features listed above separately. This means that the values of the corresponding parameters visible in the pylon API and the pylon Viewer are not changed.

Example: If you select the Daylight6500K light source preset, the camera adjusts the white balance, but the values of the BalanceRatioAbs parameter don't change.

This has the advantage that you don't lose your color enhancement feature settings when you change the light source preset. Your own settings are independent from the light source preset adjustments.

No Separate Processing#

On some camera models, when you select a light source preset, the camera doesn't process the feature changes separately. Instead, the camera directly adjusts the corresponding parameter values.

Example: If you select the Daylight6500K light source preset, the values of the BalanceRatioAbs parameter change. You can see the changes in the pylon Viewer or by accessing the parameter via the pylon API.

This means if you set up the color enhancement features and then change the light source preset, your settings will be overwritten.

Light Source Preset Feature Selector#

On some camera models, the BslLightSourcePresetFeatureSelector parameter is available.

If the parameter is available, you can select which features you want the camera to adjust when you select a light source preset.

By default, the camera adjusts all features.

To enable or disable adjustment of a specific feature:

1. Set the BslLightSourcePresetFeatureSelector parameter to the desired feature, e.g., ColorAdjustment.
2. Set the BslLightSourcePresetFeatureEnable parameter to true (feature enabled) or false (feature disabled).
3. Repeat steps 1 and 2 for all features that you want to enable or disable.

External Links#

• Color temperature (Wikipedia)

Specifics#

Show only your camera model

Sample Code#

ace 2, boost, and dart R Cameras#

// Disable light source presets (no correction)
camera.BslLightSourcePreset.SetValue(BslLightSourcePreset_Off);
// Set the light source preset for daylight (at about 5000K)
camera.BslLightSourcePreset.SetValue(BslLightSourcePreset_Daylight5000K);
// Set the light source preset for tungsten lighting
camera.BslLightSourcePreset.SetValue(BslLightSourcePreset_Tungsten2800K);
// Disable adjustment of a specific feature
camera.BslLightSourcePresetFeatureSelector.SetValue(BslLightSourcePresetFeatureSelector_ColorAdjustment);
camera.BslLightSourcePresetFeatureEnable.SetValue(false);

INodeMap& nodemap = camera.GetNodeMap();
// Disable light source presets (no correction)
CEnumParameter(nodemap, "BslLightSourcePreset").SetValue("Off");
// Set the light source preset for daylight (at about 5000K)
CEnumParameter(nodemap, "BslLightSourcePreset").SetValue("Daylight5000K");
// Set the light source preset for tungsten lighting
CEnumParameter(nodemap, "BslLightSourcePreset").SetValue("Tungsten2800K");
// Disable adjustment of a specific feature
CEnumParameter(nodemap, "BslLightSourcePresetFeatureSelector").SetValue("ColorAdjustment");
CBooleanParameter(nodemap, "BslLightSourcePresetFeatureEnable").SetValue(false);

// Disable light source presets (no correction)
camera.Parameters[PLCamera.BslLightSourcePreset].SetValue(PLCamera.BslLightSourcePreset.Off);
// Set the light source preset for daylight (at about 5000K)
camera.Parameters[PLCamera.BslLightSourcePreset].SetValue(PLCamera.BslLightSourcePreset.Daylight5000K);
// Set the light source preset for tungsten lighting
camera.Parameters[PLCamera.BslLightSourcePreset].SetValue(PLCamera.BslLightSourcePreset.Tungsten2800K);
// Disable adjustment of a specific feature
camera.Parameters[PLCamera.BslLightSourcePresetFeatureSelector].SetValue(PLCamera.BslLightSourcePresetFeatureSelector.ColorAdjustment);
camera.Parameters[PLCamera.BslLightSourcePresetFeatureEnable].SetValue(false);

/* 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 */
/* Disable light source presets (no correction) */
errRes = PylonDeviceFeatureFromString(hdev, "BslLightSourcePreset", "Off");
CHECK(errRes);
/* Set the light source preset for daylight (at about 5000K) */
errRes = PylonDeviceFeatureFromString(hdev, "BslLightSourcePreset", "Daylight5000K");
CHECK(errRes);
/* Set the light source preset for tungsten lighting */
errRes = PylonDeviceFeatureFromString(hdev, "BslLightSourcePreset", "Tungsten2800K");
CHECK(errRes);
/* Disable adjustment of a specific feature */
errRes = PylonDeviceFeatureFromString(hdev, "BslLightSourcePresetFeatureSelector", "ColorAdjustment");
CHECK(errRes);
errRes = PylonDeviceSetBooleanFeature(hdev, "BslLightSourcePresetFeatureEnable", 0);
CHECK(errRes);

# Disable light source presets (no correction)
camera.BslLightSourcePreset.Value = "Off"
# Set the light source preset for daylight (at about 5000K)
camera.BslLightSourcePreset.Value = "Daylight5000K"
# Set the light source preset for tungsten lighting
camera.BslLightSourcePreset.Value = "Tungsten2800K"
# Disable adjustment of a specific feature
camera.BslLightSourcePresetFeatureSelector.Value = "ColorAdjustment"
camera.BslLightSourcePresetFeatureEnable.Value = False

ace Classic/U/L GigE Cameras#

// Disable light source presets (no correction)
camera.LightSourceSelector.SetValue(LightSourceSelector_Off);
// Set the light source preset for daylight (at about 5000K)
camera.LightSourceSelector.SetValue(LightSourceSelector_Daylight);
// Set the light source preset for tungsten lighting
camera.LightSourceSelector.SetValue(LightSourceSelector_Tungsten);

INodeMap& nodemap = camera.GetNodeMap();
// Disable light source presets (no correction)
CEnumParameter(nodemap, "LightSourceSelector").SetValue("Off");
// Set the light source preset for daylight (at about 5000K)
CEnumParameter(nodemap, "LightSourceSelector").SetValue("Daylight");
// Set the light source preset for tungsten lighting
CEnumParameter(nodemap, "LightSourceSelector").SetValue("Tungsten");

// Disable light source presets (no correction)
camera.Parameters[PLCamera.LightSourceSelector].SetValue(PLCamera.LightSourceSelector.Off);
// Set the light source preset for daylight (at about 5000K)
camera.Parameters[PLCamera.LightSourceSelector].SetValue(PLCamera.LightSourceSelector.Daylight);
// Set the light source preset for tungsten lighting
camera.Parameters[PLCamera.LightSourceSelector].SetValue(PLCamera.LightSourceSelector.Tungsten);

/* 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 */
/* Disable light source presets (no correction) */
errRes = PylonDeviceFeatureFromString(hdev, "LightSourceSelector", "Off");
CHECK(errRes);
/* Set the light source preset for daylight (at about 5000K) */
errRes = PylonDeviceFeatureFromString(hdev, "LightSourceSelector", "Daylight");
CHECK(errRes);
/* Set the light source preset for tungsten lighting */
errRes = PylonDeviceFeatureFromString(hdev, "LightSourceSelector", "Tungsten");
CHECK(errRes);

# Disable light source presets (no correction)
camera.LightSourceSelector.Value = "Off"
# Set the light source preset for daylight (at about 5000K)
camera.LightSourceSelector.Value = "Daylight"
# Set the light source preset for tungsten lighting
camera.LightSourceSelector.Value = "Tungsten"

Other Cameras#

// Disable light source presets (no correction)
camera.LightSourcePreset.SetValue(LightSourcePreset_Off);
// Set the light source preset for daylight (at about 5000K)
camera.LightSourcePreset.SetValue(LightSourcePreset_Daylight5000K);
// Set the light source preset for tungsten lighting
camera.LightSourcePreset.SetValue(LightSourcePreset_Tungsten2800K);

INodeMap& nodemap = camera.GetNodeMap();
// Disable light source presets (no correction)
CEnumParameter(nodemap, "LightSourcePreset").SetValue("Off");
// Set the light source preset for daylight (at about 5000K)
CEnumParameter(nodemap, "LightSourcePreset").SetValue("Daylight5000K");
// Set the light source preset for tungsten lighting
CEnumParameter(nodemap, "LightSourcePreset").SetValue("Tungsten2800K");

// Disable light source presets (no correction)
camera.Parameters[PLCamera.LightSourcePreset].SetValue(PLCamera.LightSourcePreset.Off);
// Set the light source preset for daylight (at about 5000K)
camera.Parameters[PLCamera.LightSourcePreset].SetValue(PLCamera.LightSourcePreset.Daylight5000K);
// Set the light source preset for tungsten lighting
camera.Parameters[PLCamera.LightSourcePreset].SetValue(PLCamera.LightSourcePreset.Tungsten2800K);

/* 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 */
/* Disable light source presets (no correction) */
errRes = PylonDeviceFeatureFromString(hdev, "LightSourcePreset", "Off");
CHECK(errRes);
/* Set the light source preset for daylight (at about 5000K) */
errRes = PylonDeviceFeatureFromString(hdev, "LightSourcePreset", "Daylight5000K");
CHECK(errRes);
/* Set the light source preset for tungsten lighting */
errRes = PylonDeviceFeatureFromString(hdev, "LightSourcePreset", "Tungsten2800K");
CHECK(errRes);

# Disable light source presets (no correction)
camera.LightSourcePreset.Value = "Off"
# Set the light source preset for daylight (at about 5000K)
camera.LightSourcePreset.Value = "Daylight5000K"
# Set the light source preset for tungsten lighting
camera.LightSourcePreset.Value = "Tungsten2800K"

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