Gain#

Gainカメラ機能を使用すると、カメラから出力される画像の明るさを上げることができます。

ゲインを上げると、画像のすべてのピクセル値が増加します。

機能を使用する#

アナログ／デジタルGain#

ゲインとは、取得した画像のすべてのピクセル値に適用される増幅係数です。ゲインにはいくつかの種類があります：

• アナログゲインは、カメラセンサーからの信号がデジタル値に変換される前に適用されます。
• デジタルゲインは、変換の後に適用されます。つまり、基本的にはデジタル化された値の乗算です。

お使いのカメラモデルに応じて、ゲインを制御するメカニズムが異なります：

• 一部のカメラでは、ゲイン制御は特定のしきい値までアナログです。しきい値を超えると、ゲイン制御はデジタルになります。
• 一部のカメラでは、ゲイン制御は完全にデジタルまたはアナログです。
• 一部のカメラでは、次のパラメータを使用できます。 GainSelector パラメータを使用して、アナログゲインとデジタルゲインを手動で切り替えます。

ゲインタイプの選択#

一部のカメラモデルでは、 GainSelector パラメータを利用できます。このパラメータを使用すると、カメラモデルや使用するセンサーに応じて、アナログ、デジタル、またはその両方となる汎用ゲインを適用できます。 GainSelector パラメータを使用すると、アナログゲインとデジタルゲインを手動で切り替えることもできます（利用可能な場合）。

On racer 2 L カメラの場合、 GainSelector パラメータを使用すると、カメラがデュアルまたはクアッドラインで動作している場合に、特定のセンサーラインにゲインを適用できます。 センサー取得モード.

利用可能な場合、 GainSelector パラメータを次のいずれかの値に設定できます：

• All: 汎用ゲインが適用されます。
• AnalogAll: アナログゲインが適用されます。
• DigitalAll: デジタルゲインが適用されます。
• Line1, Line2, Line3, Line4: ライン 1、2、3、または 4 にデジタルゲインが適用されます。

「Raw」および絶対値のGain値#

一部のカメラモデルでは、ゲインは整数スケールの「raw」値として入力する必要があります。そのようなカメラでは、カメラの内部処理メカニズムにraw値が必要です。ただし、raw値は実際のゲイン値と同一ではなく、デシベル（dB）で表されます。

カメラ固有のGain Properties表には、rawゲイン値から絶対ゲイン値（dB）を計算する式があります。

追加パラメーター#

boA13440-17cm カメラの場合、 BslGainTopLeft, BslGainTopRight, BslGainBottomLeftおよび BslGainBottomRight のパラメータを使用できます。これらのパラメータを使用することで、画像の4つの象限それぞれで輝度を個別に高めることができます。これは、画像の輝度の違いを補正する際に役立ちます。

各象限の輝度は、最大5%まで線形に増加させることができます（デジタルゲイン）。

ゲインの設定#

1. パラメーターを GainAuto パラメータを Off.
2. 利用可能な場合、を設定 GainSelector パラメータを希望のゲインタイプに設定します（例： All.
3. パラメーターを Gain パラメータを希望の値に設定します。
   最小パラメータ値および最大パラメータ値は、 カメラモデル、選択した Pixel Format、および Binning の設定によって異なります。

特性#

Gainプロパティ#

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

Gain値#

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

サンプルコード#

ace Classic/U/L GigEカメラ#

// Set the "raw" gain value to 400
// If you want to know the resulting gain in dB, use the formula given in this topic
camera.GainRaw.SetValue(400);

INodeMap& nodemap = camera.GetNodeMap();
// Set the "raw" gain value to 400
// If you want to know the resulting gain in dB, use the formula given in this topic
CIntegerParameter(nodemap, "GainRaw").SetValue(400);

// Set the "raw" gain value to 400
// If you want to know the resulting gain in dB, use the formula given in this topic
camera.Parameters[PLCamera.GainRaw].SetValue(400);

/* 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 "raw" gain value to 400 */
/* If you want to know the resulting gain in dB, use the formula given in this topic */
errRes = PylonDeviceSetIntegerFeature(hdev, "GainRaw", 400);
CHECK(errRes);

# Set the "raw" gain value to 400
# If you want to know the resulting gain in dB, use the formula given in this topic
camera.GainRaw.Value = 400

その他のカメラ#

// Select the type of gain
camera.GainSelector.SetValue(GainSelector_All);
// Set the gain to 4.2 dB
camera.Gain.SetValue(4.2);
// Increase the gain in the top-left quadrant of the image by 3 %
// Note: Available on boA13440-17cm cameras only
camera.BslGainTopLeft.SetValue(1.03);

INodeMap& nodemap = camera.GetNodeMap();
// Select the type of gain
CEnumParameter(nodemap, "GainSelector").SetValue("All");
// Set the gain to 4.2 dB
CFloatParameter(nodemap, "Gain").SetValue(4.2);
// Increase the gain in the top-left quadrant of the image by 3 %
// Note: Available on boA13440-17cm cameras only
CFloatParameter(nodemap, "BslGainTopLeft").SetValue(1.03);

// Select the type of gain
camera.Parameters[PLCamera.GainSelector].SetValue(PLCamera.GainSelector.All);
// Set the gain to 4.2 dB
camera.Parameters[PLCamera.Gain].SetValue(4.2);
// Increase the gain in the top-left quadrant of the image by 3 %
// Note: Available on boA13440-17cm cameras only
camera.Parameters[PLCamera.BslGainTopLeft].SetValue(1.03);

/* 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 */
/* Select the type of gain */
errRes = PylonDeviceFeatureFromString(hdev, "GainSelector", "All");
CHECK(errRes);
/* Set the gain to 4.2 dB */
errRes = PylonDeviceSetFloatFeature(hdev, "Gain", 4.2);
CHECK(errRes);
/* Increase the gain in the top-left quadrant of the image by 3 % */
/* Note: Available on boA13440-17cm cameras only */
errRes = PylonDeviceSetFloatFeature(hdev, "BslGainTopLeft", 1.03);
CHECK(errRes);

# Select the type of gain
camera.GainSelector.Value = "All"
# Set the gain to 4.2 dB
camera.Gain.Value = 4.2
# Increase the gain in the top-left quadrant of the image by 3 %
# Note: Available on boA13440-17cm cameras only
camera.BslGainTopLeft.Value = 1.03

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