Gain#

相机的 Gain 功能可让您增加相机输出图像的亮度。

增加增益会提高图像中所有像素的值。

该功能的使用#

模拟和数字增益#

增益是应用于所采集图像所有像素值的放大系数。增益类型包括：

• 模拟增益在相机传感器的信号被转换为数字值之前应用。
• 数字增益在转换之后应用，即基本上是对数字化后的值进行相乘。

根据您的相机型号，控制增益的机制可能会有所不同：

• 对于部分相机，增益控制为模拟式，并且达到一定阈值。高于阈值时，增益控制为数字式。
• 对于某些相机，增益控制完全是数字的或模拟的。
• 对于某些相机，您可以使用 GainSelector 参数来手动切换模拟增益和数字增益。

选择 Gain Type#

在某些相机型号上，提供 GainSelector 参数。该参数允许您应用通用增益，根据您的相机型号和所使用的传感器，该增益可以是模拟增益、数字增益或两者兼有。 GainSelector 参数还允许您手动切换模拟增益和数字增益（如果可用）。

在 racer 2 L 相机， GainSelector 参数可用于将增益应用于特定的传感器行（如果相机运行在 Dual Line 或 Quad Line 传感器采集模式.

您可以设置 GainSelector 参数设置为以下值之一（如果可用）：

• All：应用通用增益。
• AnalogAll：应用模拟增益。
• DigitalAll：应用数字增益。
• Line1, Line2, Line3, Line4：将数字增益应用于第 1、2、3 或 4 行。

“原始”和绝对增益值#

在部分相机机型上，必须以整数比例将增益输入为“原始”值。相机需要其内部处理机制的原始值。但是，原始值与实际增益值不同，实际增益值以分贝 (dB) 表示。

在特定于相机的 Gain Properties 表中，您可以找到一个公式，可以根据原始增益值计算绝对增益（以 dB 为单位）。

附加参数#

指定的增益值的总和。 BslGainTopLeft, BslGainTopRight, BslGainBottomLeft和 BslGainBottomRight 参数可用。您可以使用这些参数单独提高图像四个象限中每个象限的亮度。这有助于补偿图像亮度上的差异。

每个象限中的亮度可以线性提高最多 5%（数字增益）。

设置 Gain#

1. 设置 GainAuto 参数至 Off.
2. 如果可用，请设置 GainSelector 将 parameter 设置所需的增益类型，例如： 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

您也可以使用 pylon Viewer 轻松设置参数。