Gain#

透過 Gain camera feature，您可以增加相機輸出影像的亮度。

增加增益會提高影像的所有像素值。

使用功能#

類比與數位增益#

增益是套用於所擷取影像所有像素值的放大倍率。增益類型分為以下幾種：

• 類比增益 (Analog gain) 會在相機感光元件的訊號轉換為數位值之前套用。
• 數位增益 (Digital gain) 會在轉換之後套用，亦即它基本上是對數位化數值的相乘。

根據您的相機型號，控制增益的機制可能會有所不同：

• 對於某些相機，在達到特定閾值（含）之前，增益控制為類比方式。超過該閾值後，增益控制則為數位方式。
• 對於某些相機，增益控制完全是數位或類比的。
• 對於某些相機，您可以使用 GainSelector 參數來手動切換類比和數位增益。

選擇增益類型#

在某些相機型號上，提供有 GainSelector 參數。此參數允許您套用通用增益（Universal gain），根據您的相機型號與所使用的感光元件，此增益可以是類比、數位或兩者兼具。 GainSelector 參數也允許您手動切換類比和數位增益（若適用）。

開啟 racer 2 L 相機， GainSelector 參數可用於在相機以 Dual 或 Quad Line 運作時，將增益套用於特定的感光元件行 感測器擷取模式.

您可以設定 GainSelector 參數設為下列其中一個值（若適用）：

• All：套用通用增益。
• AnalogAll：套用類比增益。
• DigitalAll：套用數位增益。
• Line1, Line2, Line3, Line4：將數位增益套用於第 1、2、3 或 4 行。

「原始」與絕對增益值#

在某些相機型號上，必須以整數刻度的「原始 (raw)」值輸入增益。相機需要此原始值來進行內部處理機制。不過，原始值與以分貝 (dB) 表示的實際增益值並不相同。

在相機專屬的增益屬性 (Gain Properties) 表格中，您可以找到從原始增益值計算絕對增益 (以 dB 為單位) 的公式。

其他參數#

在 boA13440-17cm 相機上， BslGainTopLeft, BslGainTopRight, BslGainBottomLeft以及 BslGainBottomRight 參數可用。您可以使用這些參數來個別增加影像四個象限中每一個象限的亮度。這對於補償影像亮度的差異非常有用。

每個象限的亮度可以線性增加高達 5% (數位增益)。

設定增益#

1. 將相機中的 GainAuto 參數設為 Off.
2. 如果可用，請將 GainSelector 參數設定為所需的增益類型，例如： All.
3. 將相機中的 Gain 參數設定為所需的數值。
   參數的最小值和最大值 會根據相機型號、所選的 Pixel Format 以及 Binning 設定而有所不同。

詳細資料#

增益屬性#

顯示所有相機型號

增益值#

顯示所有相機型號

範例程式碼#

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

您也可以 use the pylon Viewer 來輕鬆設定參數。