Operator SampleDn

Operator Library: Base

SampleDn 算子通过对输入图像进行下采样来减小图像尺寸。 图像尺寸下采样因子可以针对宽度和高度分别进行定义，使用最大达 128 的任意正整数。 此下采样因子使用 XSampleDown 和 YSampleDown 参数进行定义。 输出像素通过对相邻像素求平均值来计算。

该算子仅在矩形图像（即各行长度相等的图像）上正常运行。 在同一幅图像中行长度可变的图像会导致错误的结果。

如果下采样参数设置的值超过了输入图像的宽度/高度，则生成的图像将为空图像。

如果实际图像宽度/高度不能被对应的下采样参数值整除， 算子将丢弃剩余的像素。有关解释，请参见下图。

如果输入图像的宽度除以 XSampleDown 不是 Parallelism 的倍数， 且小于输出计算出的最大图像宽度，则通过附加虚拟像素来扩展图像行， 从而使生成的行长度是 Parallelism 的倍数。 插入的虚拟像素的值未定义。

算子限制

  • 每个输入图像的行必须具有相同的长度。因此，不允许使用行长度可变的图像。

  • 对于彩色像素，每个颜色分量均单独处理。

  • 如果实际图像宽度小于 XSampleDown，则输出空图像。

  • 如果实际图像高度小于 YSampleDown，则输出空图像。

I/O Property

Property 值
Operator Type P
Input Link I，数据输入
Output Link O，数据输出

Supported Link Format

Link Parameter Input Link I Output Link O
Bit Width [1, 64]1 as I
Arithmetic {unsigned, signed} as I
Parallelism any as I
Kernel Columns any as I
Kernel Rows any as I
Img Protocol {VALT_IMAGE2D, VALT_LINE1D} as I
Color Format any as I
Color Flavor any as I
Max. Img Width any auto2
Max. Img Height any auto3

1

无符号值的输入 Bit Width 范围为 [1, 64]。 对于有符号输入，范围为 [2, 64]。 对于无符号彩色输入，范围为 [3, 63]；对于有符号彩色输入，范围为 [6, 63]。

2 3

输出端最大图像尺寸根据以下公式自动确定：

参数

XSampleDown
键入 static 参数
默认 1
范围 [1, 128]

此参数定义图像宽度的下采样因子。

下采样限制为

YSampleDown
键入 static 参数
默认 1
范围 [1, 128]

此参数定义图像高度的下采样因子。

下采样限制为

使用示例

SampleDn 算子的使用方法如下例所示：

  • '下采样'

    示例 - 输入图像经过下采样，即尺寸缩小了 4x4。

  • '3x3 下采样'

    示例 - 在不使用 SampleDn 算子的前提下按 3x3 因子进行下采样。

  上一页     上一层     下一步  
内容 顶部 主页