SelectROI 算子

Operator Library: Base

SelectROI 算子从输入链接的帧中提取矩形感兴趣区域(ROI)。 ROI 通过 4 个参数 X_Offset、X_Length、Y_Offset 和 Y_Length 来指定。 X 参数的单位为像素。 Y 参数的单位为行。

如果需要使用输入链接而不是参数来设置 ROI 坐标,则必须使用 DynamicROI 算子。

一旦 ROI 完成,算子将立即完成输出图像的生成。如果 ROI 小于输入图像, 这可能会导致输出图像的完成时间早于输入图像的完成时间。 这与必须等待最后一行 / 最后一个像素的 RemoveLine 或 RemovePixel 算子形成对比。

算子限制

X_Offset 和 X_Length 参数之和不得超过最大链接图像宽度。 Y_Offset 和 Y_Length 参数之和不得超过最大链接图像高度。

仅当进程(即采集)停止时,才允许更改动态 ROI 参数。 在采集运行期间进行更改将对 ROI 无效。 这可避免在更改参数时出现无效的 ROI。

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

  • 在 VisualApplets 中,要求一行中的像素数(即行宽)始终是 Parallelism 的倍数。 当 X_Length 不能被链接 Parallelism 整除时,算子将插入虚拟像素以 Fill 最后一个并行字, 例如,如果链接 Parallelism 为 2,X_Offset 为 0,X_Length 为 5,则算子将输出 6 个像素,其中最后一个像素是虚拟像素。 该虚拟像素的值未定义。 在 VA 仿真中,虚拟像素将设置为零以便于观察。

  • 当输入帧小于指定的 ROI 时,算子将仅输出 ROI 的可用部分。

  • 在 1D 模式下使用算子时,Y 参数对算子没有影响。 算子将仅在 X 方向上裁剪 ROI。

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 as I
Max. Img Height any as I

1

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

参数

X_Offset
键入 静态/动态读写参数
默认 0
范围 [0, MaxImgWidth - X_Length]

此参数值(与 X_Offset 一起)以像素为单位定义 ROI 左边缘的位置。

Y_Offset
键入 静态/动态读写参数
默认 0
范围 [0, MaxImgHeight - Y_Length]

此参数值(与 Y_Offset 一起)以像素为单位定义 ROI 上边缘的位置。

X_Length
键入 静态/动态读写参数
默认 1024
范围 [1, MaxImgWidth - X_Offset]

该参数定义了 ROI 的宽度。

Y_Length
键入 静态/动态读写参数
默认 1024
范围 [1, MaxImgHeight - Y_Offset]

该参数定义了 ROI 的高度。

使用示例

以下示例展示了 SelectROI 算子的使用方法: