Balance White Auto (dart E)#

Balance White Autoカメラ機能は、取得した画像のカラーシフトを自動的に補正します。

カラーシフトを手動で修正するには、Balance White機能を使用します。

機能を使用する#

Balance White Autoの有効化／無効化#

Balance White Auto自動機能を有効または無効にするには、以下を設定します。 BalanceWhiteAuto パラメーターを次のいずれかの動作モードに設定します。

• Continuous: カメラは、画像の取得中、継続的にホワイトバランスを調整します。
• Off: Balance White Auto自動機能を無効にします。 BalanceRatio パラメータは、前回の自動調整または手動調整の結果得られた値のままになります。

仕組み#

自動ホワイトバランス調整は、2段階のプロセスで構成されます。

1. カメラは、赤、緑、青のピクセルの平均グレー値を比較します。平均グレー値が最も高い（つまり最も明るい）色を特定し、以下を設定します。 BalanceRatio パラメータ この色の値は1になります。
2. カメラは自動的に調整を行います。 BalanceRatio 赤、緑、青の平均グレー値が同一になるまで、他の2つの色のパラメータ値を調整します。

その結果、 BalanceRatio パラメータは1つの色に対しては1に設定され、他の2つの色に対しては1から≈15.98の間の値に設定されます。

例： 画像の緑色のピクセルの平均グレー値が最も高いと仮定します。Balance White Auto自動機能を有効にすると、カメラは次のように設定します。 BalanceRatio 緑のパラメータ値を1に設定します。その後、カメラは赤、緑、青の平均グレー値が一致するまで、赤と青の BalanceRatio パラメータ値を自動的に調整します。新しいバランス比は、たとえば緑 = 1、赤 = 1.08789、青 = 2.19678 などになります。

サンプルコード#

// Enable Balance White Auto by setting the operating mode to Continuous
camera.BalanceWhiteAuto.SetValue(BalanceWhiteAuto_Continuous);

INodeMap& nodemap = camera.GetNodeMap();
// Enable Balance White Auto by setting the operating mode to Continuous
CEnumParameter(nodemap, "BalanceWhiteAuto").SetValue("Continuous");

// Enable Balance White Auto by setting the operating mode to Continuous
camera.Parameters[PLCamera.BalanceWhiteAuto].SetValue(PLCamera.BalanceWhiteAuto.Continuous);

/* 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 Balance White Auto by setting the operating mode to Continuous */
errRes = PylonDeviceFeatureFromString(hdev, "BalanceWhiteAuto", "Continuous");
CHECK(errRes);

# Enable Balance White Auto by setting the operating mode to Continuous
camera.BalanceWhiteAuto.Value = "Continuous"

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