跳转到内容

Decimation#

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

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

信息

  • 使用采样时(水平和/或垂直),Scaling 功能不可用。
  • 使用水平采样系数时,水平像素合并不可用。
  • 使用垂直采样系数时,垂直像素合并不可用。

该功能的使用#

运作原理#

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

垂直采样#

如果启用垂直采样,则适用以下条件:

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

    单色相机上以 2 为系数的垂直采样

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

    彩色相机上以 2 为系数的垂直采样

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

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

水平采样#

如果启用水平采样,则适用以下条件:

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

    单色相机上以 2 为系数的水平采样

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

    彩色相机上以 2 为系数的水平采样

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

水平采样会提高(或者仅在极低程度上提高)相机的帧速率

配置 Decimation#

要配置采样:

  1. 确保相机空闲,即未在捕获图像。
  2. 禁用像素合并(如果可用)。
  3. 通过将缩放系数设置为 1 来禁用缩放(如果可用)。
  4. 要配置垂直采样,请为 DecimationVertical 参数输入一个值。
  5. 要配置水平采样,请为 DecimationHorizontal 参数输入一个值。

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

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

例如,将 DecimationHorizontal 设置为 3 可启用系数为 3 的水平采样。

信息

如果启用了采样并将参数中的一个或两个都重新设置为 1,则则图像 ROI 大小可能小于可能的最大值。在这种情况下,您必须手动将图像 ROI 参数恢复为最大值。

Decimation 使用注意事项#

对 ROI 设置的影响

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

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

分辨率降低

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

可能出现图像失真

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

详情#

显示所有相机型号

相机型号 水平采样系数 垂直采样系数
a2A1920-51gcBAS 不支持 Decimation 功能 不支持 Decimation 功能
a2A1920-51gcPRO 不支持 Decimation 功能 不支持 Decimation 功能
a2A1920-51gmBAS 不支持 Decimation 功能 不支持 Decimation 功能
a2A1920-51gmPRO 不支持 Decimation 功能 不支持 Decimation 功能
a2A1920-160ucBAS 不支持 Decimation 功能 不支持 Decimation 功能
a2A1920-160ucPRO 不支持 Decimation 功能 不支持 Decimation 功能
a2A1920-160umBAS 不支持 Decimation 功能 不支持 Decimation 功能
a2A1920-160umPRO 不支持 Decimation 功能 不支持 Decimation 功能
a2A2590-22gcBAS 不支持 Decimation 功能 不支持 Decimation 功能
a2A2590-22gcPRO 不支持 Decimation 功能 不支持 Decimation 功能
a2A2590-22gmBAS 不支持 Decimation 功能 不支持 Decimation 功能
a2A2590-22gmPRO 不支持 Decimation 功能 不支持 Decimation 功能
a2A2590-60ucBAS 不支持 Decimation 功能 不支持 Decimation 功能
a2A2590-60ucPRO 不支持 Decimation 功能 不支持 Decimation 功能
a2A2590-60umBAS 不支持 Decimation 功能 不支持 Decimation 功能
a2A2590-60umPRO 不支持 Decimation 功能 不支持 Decimation 功能
a2A3840-13gcBAS 不支持 Decimation 功能 不支持 Decimation 功能
a2A3840-13gcPRO 不支持 Decimation 功能 不支持 Decimation 功能
a2A3840-13gmBAS 不支持 Decimation 功能 不支持 Decimation 功能
a2A3840-13gmPRO 不支持 Decimation 功能 不支持 Decimation 功能
a2A3840-45ucBAS 不支持 Decimation 功能 不支持 Decimation 功能
a2A3840-45ucPRO 不支持 Decimation 功能 不支持 Decimation 功能
a2A3840-45umBAS 不支持 Decimation 功能 不支持 Decimation 功能
a2A3840-45umPRO 不支持 Decimation 功能 不支持 Decimation 功能
acA640-90gc 不支持 Decimation 功能 不支持 Decimation 功能
acA640-90gm 不支持 Decimation 功能 不支持 Decimation 功能
acA640-90uc 不支持 Decimation 功能 不支持 Decimation 功能
acA640-90um 不支持 Decimation 功能 不支持 Decimation 功能
acA640-120gc 不支持 Decimation 功能 不支持 Decimation 功能
acA640-120gm 不支持 Decimation 功能 不支持 Decimation 功能
acA640-120uc 不支持 Decimation 功能 不支持 Decimation 功能
acA640-120um 不支持 Decimation 功能 不支持 Decimation 功能
acA640-121gm 不支持 Decimation 功能 不支持 Decimation 功能
acA640-300gc 不支持 Decimation 功能 不支持 Decimation 功能
acA640-300gm 不支持 Decimation 功能 不支持 Decimation 功能
acA640-750uc 不支持 Decimation 功能 不支持 Decimation 功能
acA640-750um 不支持 Decimation 功能 不支持 Decimation 功能
acA720-290gc 不支持 Decimation 功能 不支持 Decimation 功能
acA720-290gm 不支持 Decimation 功能 不支持 Decimation 功能
acA720-520uc 不支持 Decimation 功能 不支持 Decimation 功能
acA720-520um 不支持 Decimation 功能 不支持 Decimation 功能
acA780-75gc 不支持 Decimation 功能 不支持 Decimation 功能
acA780-75gm 不支持 Decimation 功能 不支持 Decimation 功能
acA800-200gc 不支持 Decimation 功能 不支持 Decimation 功能
acA800-200gm 不支持 Decimation 功能 不支持 Decimation 功能
acA800-510uc 不支持 Decimation 功能 不支持 Decimation 功能
acA800-510um 不支持 Decimation 功能 不支持 Decimation 功能
acA1280-60gc 1, 2, 3, …, 32 1, 2, 3, …, 32
acA1280-60gm 1, 2, 3, …, 32 1, 2, 3, …, 32
acA1300-22gc 不支持 Decimation 功能 不支持 Decimation 功能
acA1300-22gm 不支持 Decimation 功能 不支持 Decimation 功能
acA1300-30gc 不支持 Decimation 功能 不支持 Decimation 功能
acA1300-30gm 不支持 Decimation 功能 不支持 Decimation 功能
acA1300-30uc 不支持 Decimation 功能 不支持 Decimation 功能
acA1300-30um 不支持 Decimation 功能 不支持 Decimation 功能
acA1300-60gc 1, 2, 3, …, 32 1, 2, 3, …, 32
acA1300-60gm 1, 2, 3, …, 32 1, 2, 3, …, 32
acA1300-60gmNIR 1, 2, 3, …, 32 1, 2, 3, …, 32
acA1300-75gc 不支持 Decimation 功能 不支持 Decimation 功能
acA1300-75gm 不支持 Decimation 功能 不支持 Decimation 功能
acA1300-200uc 不支持 Decimation 功能 不支持 Decimation 功能
acA1300-200um 不支持 Decimation 功能 不支持 Decimation 功能
acA1440-73gc 不支持 Decimation 功能 不支持 Decimation 功能
acA1440-73gm 不支持 Decimation 功能 不支持 Decimation 功能
acA1440-220uc 不支持 Decimation 功能 不支持 Decimation 功能
acA1440-220um 不支持 Decimation 功能 不支持 Decimation 功能
acA1600-20gc 不支持 Decimation 功能 不支持 Decimation 功能
acA1600-20gm 不支持 Decimation 功能 不支持 Decimation 功能
acA1600-20uc 不支持 Decimation 功能 不支持 Decimation 功能
acA1600-20um 不支持 Decimation 功能 不支持 Decimation 功能
acA1600-60gc 1, 2, 3, …, 32 1, 2, 3, …, 32
acA1600-60gm 1, 2, 3, …, 32 1, 2, 3, …, 32
acA1920-25gc 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-25gm 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-25uc 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-25um 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-40gc 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-40gm 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-40uc 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-40ucMED 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-40um 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-40umMED 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-48gc 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-48gm 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-50gc 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-50gm 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-150uc 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-150um 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-155uc 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-155ucMED 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-155um 不支持 Decimation 功能 不支持 Decimation 功能
acA1920-155umMED 不支持 Decimation 功能 不支持 Decimation 功能
acA2000-50gc 不支持 1, 2, 3, …, 542
acA2000-50gm 不支持 1, 2, 3, …, 1087
acA2000-50gmNIR 不支持 1, 2, 3, …, 1087
acA2000-165uc 不支持 Decimation 功能 不支持 Decimation 功能
acA2000-165um 不支持 Decimation 功能 不支持 Decimation 功能
acA2000-165umNIR 不支持 Decimation 功能 不支持 Decimation 功能
acA2040-25gc 不支持 1, 2, 3, …, 1022
acA2040-25gm 不支持 1, 2, 3, …, 2047
acA2040-25gmNIR 不支持 1, 2, 3, …, 2047
acA2040-35gc 不支持 Decimation 功能 不支持 Decimation 功能
acA2040-35gm 不支持 Decimation 功能 不支持 Decimation 功能
acA2040-55uc 不支持 Decimation 功能 不支持 Decimation 功能
acA2040-55um 不支持 Decimation 功能 不支持 Decimation 功能
acA2040-90uc 不支持 Decimation 功能 不支持 Decimation 功能
acA2040-90um 不支持 Decimation 功能 不支持 Decimation 功能
acA2040-90umNIR 不支持 Decimation 功能 不支持 Decimation 功能
acA2040-120uc 不支持 Decimation 功能 不支持 Decimation 功能
acA2040-120um 不支持 Decimation 功能 不支持 Decimation 功能
acA2440-20gc 不支持 Decimation 功能 不支持 Decimation 功能
acA2440-20gm 不支持 Decimation 功能 不支持 Decimation 功能
acA2440-35uc 不支持 Decimation 功能 不支持 Decimation 功能
acA2440-35ucMED 不支持 Decimation 功能 不支持 Decimation 功能
acA2440-35um 不支持 Decimation 功能 不支持 Decimation 功能
acA2440-35umMED 不支持 Decimation 功能 不支持 Decimation 功能
acA2440-75uc 不支持 Decimation 功能 不支持 Decimation 功能
acA2440-75ucMED 不支持 Decimation 功能 不支持 Decimation 功能
acA2440-75um 不支持 Decimation 功能 不支持 Decimation 功能
acA2440-75umMED 不支持 Decimation 功能 不支持 Decimation 功能
acA2500-14gc 不支持 Decimation 功能 不支持 Decimation 功能
acA2500-14gm 不支持 Decimation 功能 不支持 Decimation 功能
acA2500-14uc 不支持 Decimation 功能 不支持 Decimation 功能
acA2500-14um 不支持 Decimation 功能 不支持 Decimation 功能
acA2500-20gc 不支持 Decimation 功能 不支持 Decimation 功能
acA2500-20gcMED 不支持 Decimation 功能 不支持 Decimation 功能
acA2500-20gm 不支持 Decimation 功能 不支持 Decimation 功能
acA2500-20gmMED 不支持 Decimation 功能 不支持 Decimation 功能
acA2500-60uc 不支持 Decimation 功能 不支持 Decimation 功能
acA2500-60um 不支持 Decimation 功能 不支持 Decimation 功能
acA3088-16gc 不支持 Decimation 功能 不支持 Decimation 功能
acA3088-16gm 不支持 Decimation 功能 不支持 Decimation 功能
acA3088-57uc 不支持 Decimation 功能 不支持 Decimation 功能
acA3088-57um 不支持 Decimation 功能 不支持 Decimation 功能
acA3800-10gc 1, 2, 4 1, 2, 4
acA3800-10gm 1, 2, 4 1, 2, 4
acA3800-14uc 1, 2, 4 1, 2, 4
acA3800-14um 1, 2, 4 1, 2, 4
acA4024-8gc 不支持 Decimation 功能 不支持 Decimation 功能
acA4024-8gm 不支持 Decimation 功能 不支持 Decimation 功能
acA4024-29uc 不支持 Decimation 功能 不支持 Decimation 功能
acA4024-29um 不支持 Decimation 功能 不支持 Decimation 功能
acA4096-11gc 不支持 Decimation 功能 不支持 Decimation 功能
acA4096-11gm 不支持 Decimation 功能 不支持 Decimation 功能
acA4096-30uc 不支持 Decimation 功能 不支持 Decimation 功能
acA4096-30ucMED 不支持 Decimation 功能 不支持 Decimation 功能
acA4096-30um 不支持 Decimation 功能 不支持 Decimation 功能
acA4096-30umMED 不支持 Decimation 功能 不支持 Decimation 功能
acA4096-40uc 不支持 Decimation 功能 不支持 Decimation 功能
acA4096-40ucMED 不支持 Decimation 功能 不支持 Decimation 功能
acA4096-40um 不支持 Decimation 功能 不支持 Decimation 功能
acA4096-40umMED 不支持 Decimation 功能 不支持 Decimation 功能
acA4112-8gc 不支持 Decimation 功能 不支持 Decimation 功能
acA4112-8gm 不支持 Decimation 功能 不支持 Decimation 功能
acA4112-20uc 不支持 Decimation 功能 不支持 Decimation 功能
acA4112-20ucMED 不支持 Decimation 功能 不支持 Decimation 功能
acA4112-20um 不支持 Decimation 功能 不支持 Decimation 功能
acA4112-20umMED 不支持 Decimation 功能 不支持 Decimation 功能
acA4112-30uc 不支持 Decimation 功能 不支持 Decimation 功能
acA4112-30ucMED 不支持 Decimation 功能 不支持 Decimation 功能
acA4112-30um 不支持 Decimation 功能 不支持 Decimation 功能
acA4112-30umMED 不支持 Decimation 功能 不支持 Decimation 功能
acA4600-7gc 1, 2, 4 1, 2, 4
acA4600-10uc 1, 2, 4 1, 2, 4
acA5472-5gc 不支持 Decimation 功能 不支持 Decimation 功能
acA5472-5gm 不支持 Decimation 功能 不支持 Decimation 功能
acA5472-17uc 不支持 Decimation 功能 不支持 Decimation 功能
acA5472-17ucMED 不支持 Decimation 功能 不支持 Decimation 功能
acA5472-17um 不支持 Decimation 功能 不支持 Decimation 功能
boA4096-93cc 不支持 Decimation 功能 不支持 Decimation 功能
boA4096-93cm 不支持 Decimation 功能 不支持 Decimation 功能
boA4112-68cc 不支持 Decimation 功能 不支持 Decimation 功能
boA4112-68cm 不支持 Decimation 功能 不支持 Decimation 功能
daA1280-54lc 不支持 Decimation 功能 不支持 Decimation 功能
daA1280-54lm 不支持 Decimation 功能 不支持 Decimation 功能
daA1280-54uc 不支持 Decimation 功能 不支持 Decimation 功能
daA1280-54um 不支持 Decimation 功能 不支持 Decimation 功能
daA1600-60lc 不支持 Decimation 功能 不支持 Decimation 功能
daA1600-60lm 不支持 Decimation 功能 不支持 Decimation 功能
daA1600-60uc 不支持 Decimation 功能 不支持 Decimation 功能
daA1600-60um 不支持 Decimation 功能 不支持 Decimation 功能
daA1920-15um 不支持 Decimation 功能 不支持 Decimation 功能
daA1920-30uc 不支持 Decimation 功能 不支持 Decimation 功能
daA1920-30um 不支持 Decimation 功能 不支持 Decimation 功能
daA2500-14lc 不支持 Decimation 功能 不支持 Decimation 功能
daA2500-14lm 不支持 Decimation 功能 不支持 Decimation 功能
daA2500-14uc 不支持 Decimation 功能 不支持 Decimation 功能
daA2500-14um 不支持 Decimation 功能 不支持 Decimation 功能
daA2500-60mc 不支持 Decimation 功能 不支持 Decimation 功能
daA2500-60mci 不支持 Decimation 功能 不支持 Decimation 功能
daA4200-30mci 不支持 Decimation 功能 不支持 Decimation 功能
puA1280-54uc 不支持 Decimation 功能 不支持 Decimation 功能
puA1280-54um 不支持 Decimation 功能 不支持 Decimation 功能
puA1600-60uc 不支持 Decimation 功能 不支持 Decimation 功能
puA1600-60um 不支持 Decimation 功能 不支持 Decimation 功能
puA1920-30uc 不支持 Decimation 功能 不支持 Decimation 功能
puA1920-30um 不支持 Decimation 功能 不支持 Decimation 功能
puA2500-14uc 不支持 Decimation 功能 不支持 Decimation 功能
puA2500-14um 不支持 Decimation 功能 不支持 Decimation 功能

示例代码#

// 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
CIntegerPtr(nodemap.GetNode("DecimationHorizontal"))->SetValue(2);
// Enable vertical decimation by 2
CIntegerPtr(nodemap.GetNode("DecimationVertical"))->SetValue(2);
// Disable horizontal decimation
CIntegerPtr(nodemap.GetNode("DecimationHorizontal"))->SetValue(1);
// Disable vertical decimation
CIntegerPtr(nodemap.GetNode("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);
// Enable horizontal decimation by 2
Pylon.DeviceSetIntegerFeature(hdev, "DecimationHorizontal", 2);
// Enable vertical decimation by 2
Pylon.DeviceSetIntegerFeature(hdev, "DecimationVertical", 2);
// Disable horizontal decimation
Pylon.DeviceSetIntegerFeature(hdev, "DecimationHorizontal", 1);
// Disable vertical decimation
Pylon.DeviceSetIntegerFeature(hdev, "DecimationVertical", 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);

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