Gain#

「增益」相機功能可讓您提高相機輸出的影像亮度。

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

使用功能#

類比與數位增益#

增益是套用至所有擷取影像像素值的放大係數。增益有以下幾種類型：

• 在將相機感測器的訊號轉換為數位值之前，會先施加類比增益。
• 數位增益是在轉換之後施加的，也就是說，它基本上是對數位化值的乘法運算。

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

• 對於某些攝影機而言，增益控制在達到某個閾值之前（含該閾值）為類比控制；超過該閾值後，則改為數位控制。
• 對於某些攝影機而言，增益控制完全是數位式的，或是類比式的。
• 對於某些相機，您可以使用 GainSelector 用於手動在類比增益與數位增益之間切換的參數。

選擇增益類型#

在某些相機型號上，該 GainSelector 此參數已啟用。此參數可讓您套用通用增益，其形式可為類比、數位，或兩者兼具，具體取決於您的相機型號及所使用的感光元件。該 GainSelector 此參數還可讓您手動在類比增益與數位增益之間切換（若支援此功能）。

開啟 racer 2 L 相機、該 GainSelector 若相機處於「雙線」或「四線」模式，可使用此參數將增益套用至特定的感測器線路 感測器擷取模式.

您可以設定 GainSelector 若可用，請將該參數設定為以下其中一個值：

• All: 已套用一個通用增益。
• AnalogAll: 已套用類比增益。
• DigitalAll: 已施加數位增益。
• Line1, Line2, Line3, Line4: 對第 1、2、3 或 4 條線路施加數位增益。

「原始」與絕對增益值#

在某些相機型號中，增益必須以整數範圍內的「原始」數值輸入。相機需要此原始數值以供其內部處理機制使用。然而，此原始數值與實際以分貝（dB）為單位表示的增益值並不相同。

在相機專用的「增益屬性」表格中，您可以找到一個公式，用以根據原始增益值計算出絕對增益（單位為 dB）。

其他參數#

在 boA13440-17cm 相機上，該 BslGainTopLeft, BslGainTopRight, BslGainBottomLeft以及 BslGainBottomRight 提供相關參數。您可以利用這些參數，分別提高影像中四個象限的亮度。此功能有助於補償影像亮度的差異。

每個象限的亮度可線性增加，最高可達 5 %（數位增益）。

設定增益#

1. 將相機中的 GainAuto 參數設為 Off.
2. 如有提供，請設定 GainSelector 將參數設定為所需的增益類型，例如： All.
3. 將相機中的 Gain 參數設定為所需的數值。
   參數的最小值與最大值 視相機型號而異、所選的像素格式，以及「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 來輕鬆設定參數。