VisualApplets
Operator Reference

该算子通过多种方式简化了缓冲区内容的编程。对于每种方式，都必须在综合过程之后、在运行时使用小程序的时刻对缓冲区进行编程。

一旦算子的 frame grabber RAM (DRAM) 使用图像数据进行初始化，它就会读出多个感兴趣区 (ROI)。您可以使用以下参数定义 ROI：

MaxNumRoI 参数指定可读取的最大 ROI 数量。每个 ROI 坐标 参数字段 XLength、 YLength、XOffset 和 YOffset 均有 MaxNumRoI 个条目。

参数 NumRoI 指定运算符在输出端提供的实际 ROI 数量。如果 NumRoI 设置为 dynamic，其值不能超过 MaxNumRoI 的值。如果设置为 dynamic， NumRoI 可以在图像采集期间进行更新。 在采集运行期间，运算符会循环读取指定数量 的 ROI。运算符会等待 ROI cycle 结束， 直到其更改为 NumRoI。

所有 ROI 均按顺序读取，并作为单独的图像在运算符输出端提供：ROI 0、ROI 1、ROI 2...直至 ROI N-1。其中 N 是由参数 NumRoI 指定的当前读取的 ROI 数量。参数字段 XOffset、XLength、 YOffset 和 YLength 指定了一组 ROI。您可以将这些参数设置为 dynamic 或 static，这指定了您是否可以在运行时调整该参数。当设置了一个 ROI 参数的参数类型时，所有 ROI 参数的参数类型都会自动调整。了解如何配置字段 参数，请参见 'Parameter Editing'。

只要不超过最大输出帧尺寸，支持将所有可能的矩形区域用作 ROI 定义，即可以将单像素、单行、单列、矩形区域 或完整帧定义为 ROI。

不同的 ROI 不需要具有相同的 尺寸。

每个 ROI 都可以单独定义。

ROI 可以重叠，也可以重复。

X 坐标参数 XOffset 和 XLength 必须为输出 parallelism 的步长倍数。

通过将 XLength 或 YLength 设置为 零，您可以定义空的 ROI。然后，运算符会在其输出端提供一个空图像（或链接类型为 VALT_LINE1D 的行）。空图像不包含任何像素。链接类型为 VALT_PIXEL0D 的空 ROI 将导致根本无输出 。

如果运算符使用的图像协议为 VALT_LINE1D 或 VALT_PIXEL0D，则是相对于初始化文件来定义 ROI 的，该文件始终被视为二维 图像。系统会读取二维 ROI，但根据链接类型的不同，输出 是一系列 ROI 帧、行或像素。

对于链接类型 VALT_LINE1D，输出是无限的行序列，其中单独定义的 ROI 之间不存在 分隔。类似地，对于链接类型 VALT_PIXEL0D，运算符提供无限的像素序列， 其中单独的 ROI 甚至 ROI 行之间不存在任何分隔。

一旦采集开始且运算符的输出未被后续运算符阻塞，运算符就会在其输出端提供 ROI 数据。 有关运算符延迟的信息，请参阅 Table 46, 'Individual Latencies of the Operators in Library Memory'。

如果 ROI 参数类型设置为 dynamic，您可以动态更新所有 ROI。 但是，更新后的 ROI 只有在当前的“ROI cycle”完成且读取了所有 NumRoI ROI 后才会生效。

以下限制适用于 CoefficientBufferMultiRoi 运算符：

为了获得最佳性能，所使用的数据位数应尽可能与模块参数 RamDataWidth 中提供的位数相匹配。如果位宽、内核大小和 parallelism 的乘积等于内部 RAM 端口宽度 RamDataWidth，则达到流经运算符的最大带宽。 请注意，内部位宽可以通过使用内核来增加，但完整的内核仍将作为 单个像素寻址。