Black Level#

Black Levelカメラ機能を使用すると、画像の全体的な明るさを変更できます。カメラの黒レベルを調整すると、カメラから出力されるピクセルのグレー値がオフセットされます。

例えば、画像の各画素のグレー値を3ずつ増やすことができます。

機能を使用する#

Setting the Black Level#

1. 利用可能な場合、を設定 BlackLevelSelector parameter to the desired value, e.g., All.

2. Enter a value for the BlackLevel parameter.

   • The change in the gray value resulting from the BlackLevel parameter value depends on the camera model.
   • Specifying a black level value of 0 effectively disables the respective adjustment.

Black Level Selector#

On racer 2 L camera models, the BlackLevelSelector parameter is available. This parameter allows you to apply the black level universally or to a specific line if the camera is operated in Dual or Quad Line センサー取得モード.

You can set the BlackLevelSelector パラメーターを次のいずれかの値に設定します。

• All: The black level is applied universally.
• Line1, Line2, Line3, Line4: The black level is applied to line 1, 2, 3, or 4.

Black Level補正#

暗電流は、画質に悪影響を与える可能性があります。一部のイメージセンサーは、黒レベルを自動的に調整することで暗電流を補正できます。

On some camera models, you can manually enable or disable this automatic adjustment using the BslBlackLevelCompensationMode parameter.

To do so, set the BslBlackLevelCompensationMode パラメーターを次のいずれかの値に設定します。

• Sensor: Black level compensation is performed by the image sensor. The sensor tries to compensate for thermally generated voltages that would affect the signals (dark current).
• Off: Black level compensation is disabled. This is useful, e.g., for quantitative analysis of weak light signals or if you need raw image data without dark current correction.
  Setting the compensation mode to Off resets all internal correction values used for black level compensation.

特性#

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

サンプルコード#

ace Classic/U/L GigEカメラ#

// Set the black level to 32
camera.BlackLevelRaw.SetValue(32.0);
// Disable black level compensation
// Note: Available on selected camera models only
camera.BslBlackLevelCompensationMode.SetValue(BslBlackLevelCompensationMode_Off);

INodeMap& nodemap = camera.GetNodeMap();
// Set the black level to 32
CFloatParameter(nodemap, "BlackLevelRaw").SetValue(32.0);
// Disable black level compensation
// Note: Available on selected camera models only
CEnumParameter(nodemap, "BslBlackLevelCompensationMode").SetValue("Off");

// Set the black level to 32
camera.Parameters[PLCamera.BlackLevelRaw].SetValue(32.0);
// Disable black level compensation
// Note: Available on selected camera models only
camera.Parameters[PLCamera.BslBlackLevelCompensationMode].SetValue(PLCamera.BslBlackLevelCompensationMode.Off);

/* 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 = PylonDeviceSetFloatFeature(hdev, "BlackLevelRaw", 32.0);
CHECK(errRes);
/* Disable black level compensation */
/* Note: Available on selected camera models only */
errRes = PylonDeviceFeatureFromString(hdev, "BslBlackLevelCompensationMode", "Off");
CHECK(errRes);

# Set the black level to 32
camera.BlackLevelRaw.Value = 32.0
# Disable black level compensation
# Note: Available on selected camera models only
camera.BslBlackLevelCompensationMode.Value = "Off"

その他のカメラ#

// Enable a black level adjustment for line 2
// Note: Available on racer 2 L camera models only
camera.BlackLevelSelector.SetValue(BlackLevelSelector_Line2);
// Set the black level to 32
camera.BlackLevel.SetValue(32.0);
// Disable black level compensation
// Note: Available on selected camera models only
camera.BslBlackLevelCompensationMode.SetValue(BslBlackLevelCompensationMode_Off);

INodeMap& nodemap = camera.GetNodeMap();
// Enable a black level adjustment for line 2
// Note: Available on racer 2 L camera models only
CEnumParameter(nodemap, "BlackLevelSelector").SetValue("Line2");
// Set the black level to 32
CFloatParameter(nodemap, "BlackLevel").SetValue(32.0);
// Disable black level compensation
// Note: Available on selected camera models only
CEnumParameter(nodemap, "BslBlackLevelCompensationMode").SetValue("Off");

// Enable a black level adjustment for line 2
// Note: Available on racer 2 L camera models only
camera.Parameters[PLCamera.BlackLevelSelector].SetValue(PLCamera.BlackLevelSelector.Line2);
// Set the black level to 32
camera.Parameters[PLCamera.BlackLevel].SetValue(32.0);
// Disable black level compensation
// Note: Available on selected camera models only
camera.Parameters[PLCamera.BslBlackLevelCompensationMode].SetValue(PLCamera.BslBlackLevelCompensationMode.Off);

/* 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 */
/* Enable a black level adjustment for line 2 */
/* Note: Available on racer 2 L camera models only */
errRes = PylonDeviceFeatureFromString(hdev, "BlackLevelSelector", "Line2");
CHECK(errRes);
/* Set the black level to 32 */
errRes = PylonDeviceSetFloatFeature(hdev, "BlackLevel", 32.0);
CHECK(errRes);
/* Disable black level compensation */
/* Note: Available on selected camera models only */
errRes = PylonDeviceFeatureFromString(hdev, "BslBlackLevelCompensationMode", "Off");
CHECK(errRes);

# Enable a black level adjustment for line 2
# Note: Available on racer 2 L camera models only
camera.BlackLevelSelector.Value = "Line2"
# Set the black level to 32
camera.BlackLevel.Value = 32.0
# Disable black level compensation
# Note: Available on selected camera models only
camera.BslBlackLevelCompensationMode.Value = "Off"

pylon Viewerを使用して、パラメーターを簡単に設定することもできます。