Light Source Preset#

相机的 Light Source Preset 功能可让您纠正部分光源引起的色彩偏移。

根据其特定的色温，用于图像采集的光源会导致图像中的色彩偏移。您可以通过选择相关的光源预设来纠正这些色彩偏移。

该功能的使用#

选择一种 Light Source Preset#

To select a light source preset, set the LightSourcePreset 参数为以下值（如果可用）：

• Daylight5000K: 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.
• Tungsten2800K: The camera corrects color shifts caused by tungsten lighting that has a color temperature of about 2 500 to 3 000 K.
• LineLED5500K: 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 网站.
• 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.

默认光源预设因相机型号而异。

对其他功能的影响#

选择光源预设时，相机会调整以下色彩增强功能的设置：

• Balance White
• Color Adjustment
• Color Transformation

设置将针对所选光源进行优化。

在部分相机机型上，您可以选择想要相机调整的功能。

单独处理#

在部分相机机型上，当您选择光源预设时，相机将单独处理对以上功能的更改。这意味着相应参数的值在 pylon API 和 pylon Viewer 中没有改变。

示例： If you select the Daylight6500K light source preset, the camera adjusts the white balance, but the values of the BalanceRatio parameter don't change.

这样做的好处是，在更改光源预设时，您的色彩增强功能设置不会丢失。您自己的设置将独立于光源预设调整。

无单独处理#

在部分相机机型上，当您选择光源预设时，相机不会单独处理功能更改。而是由相机直接调整相应的参数值。

示例： If you select the Daylight6500K light source preset, the values of the BalanceRatio parameter change. You can see the changes in the pylon Viewer or by accessing the parameter via the pylon API.

这意味着如果您设置色彩增强功能，然后更改光源预设，您的设置将被覆盖。

Light Source Preset 功能选择器#

在 some camera models, the BslLightSourcePresetFeatureSelector parameter is available.

如果该参数可用，则可以在选择光源预设时选择希望相机调整的功能。

默认情况下，相机会调整所有功能。

要启用或禁用对特定功能的调整：

1. 设置 BslLightSourcePresetFeatureSelector parameter to the desired feature, e.g., ColorAdjustment.
2. 设置 BslLightSourcePresetFeatureEnable parameter to true (feature enabled) or false (feature disabled).
3. 对要启用或禁用的所有功能重复步骤 1 和 2。

外部链接#

• 色温（维基百科）

详情#

显示所有相机型号

示例代码#

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 相机#

// 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"

其他相机#

// 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"

您也可以使用 pylon Viewer 轻松设置参数。