Decimation#

相机的 Decimation 功能允许您减少相机传输的传感器像素列或行的数量。

此过程也称为“二次采样”，减少了要传输的数据量，并可能提高相机的帧速率。

该功能的使用#

运作原理#

您可以在水平和垂直采样之间选择。

垂直采样#

如果启用垂直采样，则适用以下条件：

• 在单色相机上，如果您指定的垂直采样系数为 n，则相机仅传输第 行。例如，当您将垂直采样系数指定为 2 时，相机将传输第 1 行，跳过第 2 行，再传输第 3 行，依此类推：

  

• 在彩色相机上，如果您指定的垂直采样系数为 n，则相机仅传输第 行。例如，当您将垂直采样系数指定为 2 时，相机将传输第 1 行和第 2 行，跳过第 3 行和第 4 行，再传输第 5 行和第 6 行，依此类推：

  

这会导致图像高度减小。例如，启用系数为 2 的垂直采样将使图像高度减半。相机会自动调节图像 ROI 设置。

垂直采样大大提高了相机的帧速率。

水平采样#

如果启用水平采样，则适用以下条件：

• 在单色相机上，如果您指定的水平采样系数为 n，则相机仅传输第 列。例如，当您将水平采样系数指定为 2 时，相机将传输第 1 列，跳过第 2 列，再传输第 3 列，依此类推：

  

• 在彩色 相机上，如果您指定的水平采样系数为 n，则相机仅传输第 列对。例如，当您将水平采样系数指定为 2 时，相机将传输第 1 列和第 2 列，跳过第 3 列和第 4 列，随后传输第 5 列和第 6 列，依此类推：

  

这会导致图像宽度减小。例如，启用系数为 2 的水平采样将使图像宽度减半。相机会自动调节图像 ROI 设置。

水平采样不会提高（或者仅在极低程度上提高）相机的帧速率。

配置 Decimation#

要配置采样：

1. 确保相机空闲，即未在捕获图像。
2. 禁用像素合并（如果可用）。
3. 通过将缩放系数设置为 1 来禁用缩放（如果可用）。
4. To configure vertical decimation, enter a value for the DecimationVertical parameter.
5. To configure horizontal decimation, enter a value for the DecimationHorizontal parameter.

参数的值定义了采样系数。根据您的相机型号不同，可以使用以下值：

• 1：禁用采样。
• 2、3、4、…：启用系数为 2、3、4 等的采样。

For example, setting DecimationHorizontal to 3 enables horizontal decimation by 3.

Decimation 使用注意事项#

对 ROI 设置的影响

使用采样时，图像 ROI和自动功能 ROI 的设置是指所获得的行数和列数。

例如，假设您使用的相机带有 1280 x 960 传感器。启用系数为 2 的水平采样和系数为 2 的垂直采样。在这种情况下，最大 ROI 宽度为 640，最大 ROI 高度为 480。

分辨率降低

使用降采样功能可以有效降低相机成像传感器的分辨率。例如，如果将具有 1280 x 960 传感器的相机设置为使用系数为 2 的水平降采样和系数为 2 的垂直降采样，则传感器的有效分辨率将降低为 640 x 480。

可能出现图像失真

只有在垂直采样系数和水平采样系数相等时，对象在图像中才会显示为不失真。使用所有其他组合时，对象都会失真。例如，如果将系数为 2 的垂直采样与系数为 4 的水平采样相结合，则目标对象将被压缩。

详情#

显示所有相机型号

示例代码#

// Enable horizontal decimation by 2
camera.DecimationHorizontal.SetValue(2);
// Enable vertical decimation by 2
camera.DecimationVertical.SetValue(2);
// Disable horizontal decimation
camera.DecimationHorizontal.SetValue(1);
// Disable vertical decimation
camera.DecimationVertical.SetValue(1);

INodeMap& nodemap = camera.GetNodeMap();
// Enable horizontal decimation by 2
CIntegerParameter(nodemap, "DecimationHorizontal").SetValue(2);
// Enable vertical decimation by 2
CIntegerParameter(nodemap, "DecimationVertical").SetValue(2);
// Disable horizontal decimation
CIntegerParameter(nodemap, "DecimationHorizontal").SetValue(1);
// Disable vertical decimation
CIntegerParameter(nodemap, "DecimationVertical").SetValue(1);

// Enable horizontal decimation by 2
camera.Parameters[PLCamera.DecimationHorizontal].SetValue(2);
// Enable vertical decimation by 2
camera.Parameters[PLCamera.DecimationVertical].SetValue(2);
// Disable horizontal decimation
camera.Parameters[PLCamera.DecimationHorizontal].SetValue(1);
// Disable vertical decimation
camera.Parameters[PLCamera.DecimationVertical].SetValue(1);

/* 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 */
/* Enable horizontal decimation by 2 */
errRes = PylonDeviceSetIntegerFeature(hdev, "DecimationHorizontal", 2);
CHECK(errRes);
/* Enable vertical decimation by 2 */
errRes = PylonDeviceSetIntegerFeature(hdev, "DecimationVertical", 2);
CHECK(errRes);
/* Disable horizontal decimation */
errRes = PylonDeviceSetIntegerFeature(hdev, "DecimationHorizontal", 1);
CHECK(errRes);
/* Disable vertical decimation */
errRes = PylonDeviceSetIntegerFeature(hdev, "DecimationVertical", 1);
CHECK(errRes);

# Enable horizontal decimation by 2
camera.DecimationHorizontal.Value = 2
# Enable vertical decimation by 2
camera.DecimationVertical.Value = 2
# Disable horizontal decimation
camera.DecimationHorizontal.Value = 1
# Disable vertical decimation
camera.DecimationVertical.Value = 1

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