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.
• 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ウェブサイトからダウンロードします.
• 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

選択した光源の設定が最適化されます。

一部のカメラモデルでは、カメラで調整する機能を選択できます。

Separate Processing#

一部のカメラモデルでは、光源の初期値を選択したとき、カメラは上記の機能に対する変更を個別に処理します。つまり、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.

これには、光源の初期値を変更しても、カラー補正機能の設定が失われないという利点があります。独自の設定は、光源の初期値の調整の影響を受けません。

No Separate Processing#

一部のカメラモデルでは、光源の初期値を選択したとき、カメラは機能の変更を個別に処理しません。代わりに、カメラは、対応するパラメーター値を直接調整します。

例： 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 Feature Selector#

その 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を繰り返します。

外部リンク#

• 色温度（Wikipedia）

特性#

すべてのカメラモデルを表示します

サンプルコード#

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を使用して、パラメーターを簡単に設定することもできます。