Gain#

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

Increasing the gain increases all pixel values of the images.

機能を使用する#

アナログ／デジタルGain#

The gain is an amplification factor applied to all pixel values of the acquired images. There are different types of gains:

• Analog gain is applied before the signal from the camera sensor is converted into digital values.
• Digital gain is applied after the conversion, i.e., it is basically a multiplication of the digitized values.

Depending on your camera model, the mechanisms to control the gain can vary:

• 一部のカメラでは、ゲイン制御は特定のしきい値までアナログです。しきい値を超えると、ゲイン制御はデジタルになります。
• 一部のカメラでは、ゲイン制御は完全にデジタルまたはアナログです。
• For some cameras, you can use the GainSelector parameter to manually switch between analog and digital gain.

Choosing the Gain Type#

On some camera models, the GainSelector parameter is available. This parameter allows you to apply a universal gain, which can be analog, digital, or both, depending on your camera model and the sensor used. The GainSelector parameter also allows you to manually switch between analog and digital gain (if available).

On racer 2 L cameras, the GainSelector parameter can be used to apply the gain to a specific sensor line if the camera is operated in Dual or Quad Line sensor acquisition mode.

You can set the GainSelector parameter to one of the following values, if available:

• All: A universal gain is applied.
• AnalogAll: An analog gain is applied.
• DigitalAll: A digital gain is applied.
• Line1, Line2, Line3, Line4: A digital gain is applied to line 1, 2, 3, or 4.

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

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

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

追加パラメーター#

On boA13440-17cm cameras, the BslGainTopLeft, BslGainTopRight, BslGainBottomLeft, and BslGainBottomRight parameters are available. You can use these parameters to increase the brightness individually in each of the four quadrants of the image. This can be useful to compensate for differences in the image brightness.

The brightness in each quadrant can be increased linearly by up to 5 % (digital gain).

Setting the Gain#

1. Gain AutoパラメーターをOffに設定します。
2. If available, set the GainSelector parameter to the desired gain type, e.g., All.
3. Gainパラメーターを目的の値に設定します。
   最小および最大パラメーター値は、カメラモデル、選択したピクセルフォーマット、および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を使用して、パラメーターを簡単に設定することもできます。