Gain#

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

增加增益会增大图像的所有像素值。

要自动调整增益值，请使用 Gain Auto 功能。

该功能的使用#

配置增益设置#

1. 将 GainAuto 参数设置为 Off。
2. 如果可用，请设置 GainSelector 参数设置为以下值：
   • AnalogAll：选择模拟增益控制。
   • DigitalAll：选择数字增益控制。
3. 将 Gain 参数设置为所需值。
   最小和最大参数值因相机型号、所选像素格式和 Binning 设置而异。

“原始”和绝对增益值#

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

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

模拟和数字增益#

在将来自相机传感器的信号转换为数字值之前，将应用模拟增益。在转换之后应用数字增益，即，它基本上是数字化值的乘积。

根据您的相机型号，控制模拟和数字增益的机制可能有所不同：

• 对于部分相机，增益控制为模拟式，并且达到一定阈值。高于阈值时，增益控制为数字式。
• For some cameras, gain control is entirely digital or analog.
• 对于部分相机，您可以使用 GainSelector 参数在模拟和数字增益之间手动切换。

附加参数#

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).

详情#

增益属性#

显示所有相机型号

增益值#

显示所有相机型号

示例代码#

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

其他相机#

// 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();
// 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);

// 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 */
/* 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);

# 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 轻松设置参数。