AI 驱动文档
您想了解什么?
第三步:感兴趣区域 (ROI)
现在您的对齐已正常工作,是时候告诉相机在哪里查看了。您可以通过绘制感兴趣区域 (ROI) 来实现这一点:图像上的矩形定义了 AI 将分析的区域。
对齐器会动态移动您的检测框,以跟踪零件的偏移和旋转。这意味着您无需为 ROI 添加额外的填充以适应零件移动。您可以紧贴特征绘制,这样可以为 AI 提供更清晰、更聚焦的视图,并且所需的训练数据更少。如果您的 ROI 看起来过大或 AI 表现不佳,请先返回检查您的对齐设置。
关键术语
- 检测类型 (Inspection Type): 共享数据集和类别集合的类别。例如:"Screws",包含 "present" 和 "absent" 类别
- 感兴趣区域 (ROI): 零件上的特定位置。例如:"Screw_1"、"Screw_2"、"Screw_3",全部共享 "Screws" 检测类型
您可以在一张图像上设置多个检测类型。例如:"Screws"(10 个 ROI)和 "Connectors"(2 个 ROI),每个都有各自的类别和训练数据。
为什么 ROI 尺寸很重要
这是仅次于对齐的第二大客户困扰来源。让我们解释一下原因。
512x512 像素限制
每个 ROI 都会从完整图像中裁剪出来,并单独送入 AI 模型。AI 模型接受的最大尺寸为 512 x 512 像素。如果您的 ROI 大于此尺寸,相机会将其缩小以适配,您将永久丢失细节。
这就像把一张高分辨率照片缩小为缩略图。精细的细节会消失。
越小越好,原因如下
假设您正在查找一个缺失的螺钉。您可以绘制一个覆盖整块板子的巨大 ROI,或者绘制一个仅覆盖螺钉区域的小 ROI。
使用小 ROI 时:
- 螺钉在裁剪图中占主导地位,因此 AI 很容易识别您要查找的目标
- 您需要更少的训练图像(信噪比高)
- 处理速度更快
- 如果 ROI 小于 512x512,则不会丢失任何信息
使用大 ROI 时:
- 螺钉只是大量背景中的一个微小细节
- AI 需要更多数据才能学习什么是关键
- 如果 ROI 超过 512x512,裁剪图会被缩小,螺钉会变得更小
- 处理时间更长
全图检测的网格技术
如果您需要检测整张图像中的小缺陷(例如表面的划痕),该怎么办?不要使用一个巨大的 ROI。而应以网格模式平铺多个小 ROI:
每个小 ROI 都保留完整分辨率。如果任何一个 ROI 失败,整个检测就会失败。这样可以两全其美:全面覆盖且保留完整细节。
设置 ROI
OV20i Web 界面在 v2026.5 中进行了重新设计。在相机 UI 的右上角查看您的软件版本,并选择匹配的选项卡。您的选择将贯穿此设置流程中的所有页面。
- 旧版本
- v2026.5 及更高版本
在程序编辑器中导航到 Inspection Setup,然后在零件上绘制您的区域。

1. 创建检测类型。 将 "Inspection Type 1" 重命名为有意义的名称,例如 "Screws"、"Surface_Quality" 或 "Connector_Check"。此名称很重要,因为它会出现在您的输出数据和 Node-RED 流程中。
2. 绘制您的 ROI。
点击 + Add Region of Interest (ROI)。图像上会出现一个黄色矩形。将其拖动到位,通过拖动角点调整大小,使其刚好足够大以包含特征,并将其从 "New ROI" 重命名为描述性的名称(例如 "Screw_Top_Left")。
3. 为每个位置重复操作。 如果您要检测 10 个螺钉,则创建 10 个 ROI,每个螺钉位置一个。它们全部共享相同的检测类型和数据集。
将第一个 ROI 命名为 "Connector 1" 并点击复制。它会自动创建 "Connector 2"、"Connector 3" 等具有自动递增名称的 ROI。比从头创建每个 ROI 要快得多。
在添加每个 ROI 时为其命名,并使每个名称都是唯一的,而不仅仅是描述性的:"Screw_Top_Left" 和 "Screw_Bottom_Right",绝不要有两个都叫 "Screw" 的区域。唯一名称是您在结果、保存的输出数据和 Node-RED 流程中区分区域的方式,因此当某个 ROI 失败时,您可以确切知道要检查哪个位置。
4. 使用实时预览进行验证。 切换到实时预览模式,确认所有 ROI 正确位于零件上、随对齐移动、完全包含您要检测的特征,并且没有超过所需大小。
在程序编辑器中,打开第三步:感兴趣区域 (ROI)。它分为五个子选项卡:About、Inspection Types、Classes、ROIs 和 Live Preview。从左到右依次完成。
关于
概念回顾。本节说明检测类型(用于存放数据集、类别和模型的容器)、其类别以及共享它们的 ROI 如何协同工作,并阐明黄金法则:裁切越紧凑,效果越好。

检测类型
检测类型将类别、数据集和模型捆绑在一起。分配给它的每个 ROI 都会共享这三者。点击添加检测类型以创建一个,并使用编辑图标重命名(例如 "Screws"、"Surface_Quality" 或 "Connector_Check")。该名称会出现在您的输出数据和 Node-RED 流中。表格显示每种类型分配了多少个 ROI。

类别
为每个检测类型定义模型可以预测的类别。点击添加类别并为每个类别命名和指定颜色。对于简单的通过/失败检查,可以是绿色的 Pass 和红色的 Fail;对于分拣可能是 Good / Scratched / Cracked。这些是您在第 4 步训练时将应用于每个 ROI 的标签。

对于分割器,每个类别是您想要查找和定位的缺陷或特征,例如 Hole、Scratch 或 Stain。您以相同的方式添加它们,并为每个选择一种颜色。在第 4 步标注时,该颜色就成为您绘制时使用的画笔。

ROIs
这是您在参考捕获图像上绘制和排布区域的地方:
- 添加 ROI 会在图像上放置一个新的区域。将其拖动到位置并通过四角调整大小。ROI 表格中的每一行都有自己的编辑(重命名并分配检测类型)、删除和锁定控件,全部删除则可一次性清除所有 ROI。
- 添加网格用大小相等的 ROI 网格自动填充图像。选择图块大小(Small (128px)、Medium (256px) 或 Large (512px)),设置重叠百分比,可选择开启替换现有 ROI,然后点击生成。这是构建上述用于全表面检测的图块网格的最快方法。
- 点击忽略区域,然后在检测应完全跳过的区域上绘制。
- 变换面板提供对所选 ROI 的高度 (H)、宽度 (W)、位置 (X/Y) 和角度的精确数值控制,并带有对齐和分布工具来整理 ROI 行。顶部的边界框和 ROI 标签切换按钮可显示或隐藏图像上的叠加层。


对于全表面检测,使用 Large (512px) 的添加网格一键即可生成最大分辨率 ROI 的完整网格,比手动放置每个图块快得多,并且每个图块都保持在 512x512 限制内。
在添加 ROI 时,请在 ROI 表格中为每个 ROI 指定唯一的描述性名称(使用编辑图标),例如 "Screw_Top_Left" 和 "Screw_Bottom_Right",绝不要将两个区域都命名为 "Screw"。唯一名称是您在结果、已保存的输出数据和 Node-RED 流中区分各区域的方式,因此当某个 ROI 失败时,您能准确知道要检查哪个位置。
实时预览
切换实时预览以在实时画面中观察 ROI 跟踪零件。确认每个 ROI 都位于正确的特征上、随对齐移动、完整包含您要检查的内容,并且不超过所需的大小。
ROI 尺寸指南
| ROI 用途 | 尺寸建议 |
|---|---|
| 单个特征(螺丝、连接器、标签) | 刚好能容纳该特征并留有少量边距 |
| 缺陷检测的表面区域 | 由小块组成的网格,每块小于 512x512 像素 |
| 需要细节的大型特征 | 改用分割器而非分类器 |
| 有无检查 | 较小;特征要么存在要么不存在 |
何时使用多个 ROI
不要害怕使用大量 ROI。您可以使用数十甚至数百个。优势:
- 共享训练数据。 同一检查类型的所有 ROI 共享一个数据集。10 个螺丝 ROI 意味着每次捕获可获得 10 倍的训练数据。
- 更快的处理速度。 多个小裁剪比一个大裁剪处理得更快。
- 更高的准确度。 每个小裁剪具有较高的信噪比。
- 细粒度的报告。 您可以确切看到哪个 ROI 失败。
何时 ROI 需要较大
如果您确实需要较大的 ROI 来发现小缺陷(例如在大表面上的微小划痕),请考虑使用分割器而非分类器。分割器专为像素级检测设计,能更好地处理大面积区域。
感兴趣区域 (ROI) 检查清单
在继续之前,请确认:
- 已使用有意义的名称创建检查类型
- 已绘制 ROI,且刚好能容纳该特征
- ROI 命名具有描述性(例如,"Screw_Top_Left")
- 所有 ROI 在实时预览中都能随对齐正确移动
- 没有 ROI 超过 512x512 像素(检查降采样警告)
准备好训练 AI 了吗?前往第 4 步:训练您的 AI。