跳转到内容
STAGING SERVER
DEVELOPMENT SERVER

ROI Creator vTool#

ROI Creator vTool 允许您在图像中定义矩形感兴趣区域 (ROI)。

通过定义感兴趣区域,您可以缩小图像处理工作流中的下一个 vTool 使用的图像区域。这允许您仅在预期的目标区域上运行图像处理。这样做可以帮助您避免错误的结果或减少处理时间。

ROI Creator vTool 通过图像输入引脚接受图像,并通过 ROI 输出引脚输出感兴趣的矩形区域的大小、方向和位置。

Download the pylon Software Suite to use the ROI Creator vTool.

ROI Creator vTool

运作原理#

要使用 ROI Creator,您需要将其图像输入引脚连接到另一个 vTool 的图像输出引脚。

在 ROI Creator 的设置对话框中,您随后可以定义所需的感兴趣区域。您不需要为此打开图像。如果您知道感兴趣区域的大小、方向和位置,则可以使用 ROI 设置区域中的输入框。

或者,抓取或打开图像。表示感兴趣区域的矩形将显示在图像中。您可以使用控件或使用 ROI 设置区域中的输入框,移动、调整和旋转感兴趣区域。

If you load a different image, the ROI you have specified previously is preserved. If the new image is much smaller or larger, the ROI may not cover a meaningful part of the image. It may even lie outside the image. Instead of having to resize and reposition it manually, you can click Restore Default. This restores the region of interest to the default (85 % of the image and centered).

提示

创建感兴趣区域的另一种方法是使用输出区域的 vTools 之一。这些 vTools 如下所示:

您可以将这些 vTools 的单个区域/多个区域输出引脚连接到其他 vTools 的 ROI 输入引脚。支持数据类型 RectangleF、RectangleF 数组、区域和区域数组。

RectangleF 和 RectangleF 数组数据类型逐像素转换为区域。如果是数组,各个矩形或区域会在内部合并以创建单个区域。

如下图所示,在图像源之间添加 ROI Creator vTool(例如 Camera vTool)及图像处理工具(例如 Template Matching vTool)。Image 输出引脚必须与两个 Image 输入引脚相连,而且 ROI 输出引脚必须与 Roi 输入引脚相连。

ROI Creator vTool 工作流

常见用例#

减少 Matching vTools 的 ROI#

假设有一项打印检查任务,您要确保某个徽标已打印出来。通常情况下,您会训练 Template Matching vTool 熟悉所需的徽标。但是,标签经常包含其他类似的徽标或字符串,这可能会导致不希望出现的结果。

下图显示了突出显示所需徽标的模板图像。理想情况下,被检查的图像看起来与几乎相同位置的徽标相似。

突出显示所需徽标的模板图像

如果对整个检查图像执行 Template Matching,则会找到另外两个匹配项。相邻的徽标相似,分数也很高。如果您希望在 Template Matching 过程中允许一定程度的打印质量下降,则常见的最低匹配分数为 0.6 到 0.7。因此,分数不足以区分三个不同的徽标。

找到三个匹配项的检查图像

要解决此问题,请使用 ROI Creator vTool。在设置对话框中,将徽标的中心部分定义为感兴趣区域。这样,只会找到模板中心位于感兴趣区域内的匹配项。

定义了感兴趣区域的设置对话框

信息

如果您使用感兴趣区域将图像处理或多或少精确地限制在某个位置,则要检查的对象必须位于完全相同的位置。如果对象定位存在变化,请使用 Image Alignment vTool 作为前面的步骤。

减少用于分割的 ROI#

您还可以使用 ROI Creator vTool 以不同的方式解决上述打印检查任务。

首先,定义一个感兴趣区域,该区域覆盖要检查的整个徽标加上一定的容差。接下来,使用阈值处理 vTool,例如 Auto Thresholding vTool。最后,使用 Region Feature Extraction vTool 计算包含深色徽标的区域的面积。指定区域的最小阈值,以区分打印的好坏。

使用感兴趣区域进行分割

配置 vTool#

要配置 ROI Creator vTool:

ROI Creator vTool 设置

  1. 图像输入引脚连接到另一个 vTool 的图像输出引脚。
  2. vTool 设置区域的配方管理窗格中,单击打开设置或双击 vTool。
    ROI Creator 对话框即打开。
  3. 拍摄或打开图像。
  4. ROI 设置区域中,手动定义感兴趣区域。
    或者,您可以使用图像中显示的矩形的控件,根据需要移动、调整和旋转感兴趣区域。

输入#

图像#

直接从 Camera vTool 或从输出图像的 vTool(例如 Image Format Converter vTool)接受图像。

  • 数据类型:图像
  • 图像格式:8 位到 16 位单色或彩色图像。彩色图像在内部转换为单色图像。

输出#

ROI#

返回感兴趣区域。

  • 数据类型:RectangleF

典型前置项#

典型后置项#