VisionPower 2.0 用户手册

版本：V2.0 适用对象：现场操作员、调试工程师、产线维护人员

第1章 前言

1.1 文档目的

本手册帮助现场操作员快速掌握 VisionPower 2.0 的日常使用，包括方案搭建、调试运行、参数调整、结果查看与常见问题处理。

1.2 阅读对象

• 现场操作员

• 产线调试人员

• 设备维护人员

1.3 使用建议

• 第一次使用：建议依次阅读 第2章 ~ 第6章

• 日常工具使用：可直接查阅 第7章 工具说明

• 异常排查：参见 第10章 常见问题

第2章 软件界面总览

打开软件后，主界面分为以下几个区域。

[主界面总览 ]

2.1 顶部菜单与工具栏

[顶部菜单]

常用按钮：

• 新建项目 / 打开项目 / 保存项目

• 新建作业 / 删除作业

• 切换运行模式（在线 / 离线）

• 全局变量 / 全局相机 / 全局触发 / 全局网络

2.2 作业页签

[作业页签]

• 每个作业是一条独立的视觉流程

• 页签前的“设置图标”用于配置该作业的显示项

• 点击页签可切换当前作业

第3章 操作准备

3.1 选择运行模式

• 离线模式：使用本地图像或文件夹中的图像进行调试，无需相机

• 在线模式：连接相机进行实时采集与运行，也可使用tcp触发本地图像的作业

调试参数建议先在离线模式完成，再切换到在线模式联调硬件。

3.2 配置相机

在“全局相机”窗口中：

1. 选择品牌与设备

2. 设置曝光、增益、触发方式

3. 测试取流

3.3 配置全局变量

在“全局变量”窗口中可统一管理跨作业共享的参数（如批次号、阈值、目标尺寸等）。

[全局变量]

3.4 配置触发

在“全局触发”窗口中设置自动运行触发方式：

• 定时触发

• 外部信号触发

• 条件触发

3.5 配置网络通信

在“全局通讯”中维护与上位机、机器人、PLC 的 TCP 连接，分别可设置服务端与客户端，主要用于配置与机器人的通讯用于字符串的发送，配置后启动即可，点击发送可发送数据给连接上的客户端/服务端，也可在通讯记录中查看通讯的数据信息。

第4章 快速上手：搭建第一个作业

4.1 新建项目与作业

1. 点击“新建项目”

2. 点击“新建作业”并命名

3. 系统会自动打开作业页签

4.2 添加工具

• 从左侧工具箱中找到需要的工具

• 用鼠标拖拽到流程编辑区

• 默认每个作业必须以“图像源”工具开头

4.3 连接工具

• 鼠标从上一工具底部连接点拉到下一工具顶部连接点，注意出现“十”字标志的时候才是连接点。

• 连线箭头表示数据流向

4.4 配置工具参数

• 双击工具节点，打开该工具的配置窗口

• 修改参数后点击“确定”保存

• 配置完成后在工具内点执行工具，或退出工具页面，在主作业页面单击工具可立即执行到该工具并查看效果

4.5 运行作业

• 单击工具：执行到该工具并显示结果

• 工具栏“运行”按钮：执行一次完整作业

• 工具栏“连续运行”按钮：进入循环执行，再次点击停止

• 点击空白处会显示配置的图像与图形信息，单击作业名称前方的“🔧”图标可进入配置页面：

显示设置必须有默认的输出图像作为显示的基准图，未配置显示设置的时候，会默认显示当前作业选中的工具对应的输出图像信息，如果既没有配置图像显示也没有选中作业，那么会默认显示图像源中的图像信息

4.6 查看结果

• 主图像显示区：显示图像、ROI、检测框等图形信息

• 结果数据区：显示工具输出的数值结果

• 日志区：显示执行过程信息

4.7 保存项目

完成调试后，点击“保存项目”。下次打开可直接恢复所有配置，如果需要默认为在线，需要在保证设置为在线模式下点击保存按钮，这样下次启动程序就会默认为在线模式，保证流程作业被自动触发。

第5章 流程编辑区使用技巧

• 单击工具：执行到该工具

• 双击工具：打开配置窗口（自动执行到上一个工具便于调参）

• 拖拽工具：移动位置

• 选中连线后按 Delete：删除连线

• 选中工具后按 Delete：删除工具

• 右键工具：禁用 / 启用 / 删除

• 框选多个工具：批量移动或删除

• 空白处单击：取消当前选中

• 鼠标滚轮：流程区域滚动

第6章 图像显示与缩略图

6.1 主图像显示区

显示内容由当前选中工具或“作业显示设置”决定。

• 鼠标滚轮：缩放

• 鼠标拖动：平移

• 右键菜单：保存原始图像

6.2 作业显示设置

点击作业页签前的“🔧”设置图标打开“作业显示设置”窗口，可订阅多个工具的输出来组合显示。

操作步骤：

1. 点击“添加”选择要显示的输出（图像 / ROI / 文本 / 检测结果）

2. 在“订阅关系”中选择对应工具的输出字段

3. 点击“执行”“连续执行”或“确定”

4. 设置会随项目一起保存

5. 默认必须有图像作为图形叠加显示的基础

6.3 缩略图区

仅在以下情况下显示缩略图区：

• 当前作业已添加“图像源”工具

• 点击了该“图像源”工具

非图像源工具被点击时，缩略图区保留，但添加/删除/自动切换等操作按钮隐藏，避免误操作。

切换缩略图中任意图像会自动执行作业并刷新显示。

第7章 工具说明

下面按功能分组介绍当前版本启用的工具。每个工具包含：用途、参数表、输出、使用要点。

7.1 采集类

7.1.1 图像源

用途：所有作业的入口，提供本张待处理图像。

输出：原始图像（彩色或灰度）。

使用要点：

• 文件夹模式下，缩略图区可手动切图或开启自动切换

• 切换运行模式或新建作业后建议重新点击本工具刷新缩略图

• 相机模式下需先在「全局相机」中配置好设备，保存后可在此选择绑定的全局相机

7.1.2 图像保存

用途：将当前图像按规则保存到磁盘，便于追溯 OK / NG 原图。

输出：保存的文件路径。

使用要点：

• 保存路径必须存在且可写入

• 与「条件检测」工具组合可实现仅 NG 时保存

• 注意磁盘空间阈值，避免占满磁盘

7.2 图像处理类

7.2.1 图像增强

用途：调节亮度、对比度、Gamma 等，改善图像质量。

输出：增强后的图像。

使用要点：

• γ < 1 提亮暗区，γ > 1 压暗亮区

• 增益和补偿可叠加使用

• 修改参数后单击工具可立即看到效果

7.2.2 图像二值化

用途：将灰度图按阈值转为黑白二值图。

输出：二值图像（0 或 255）。

使用要点：

• 高阈值必须大于低阈值

• 自适应阈值自动计算阈值，手动阈值无效

• 二值化效果直接决定后续 Blob 等检测的稳定性

7.2.3 几何变换

用途：对图像进行旋转、缩放、平移、仿射变换。

输出：变换后的图像。

使用要点：

• 旋转/缩放会导致边缘出现黑边

7.3 定位与检测类

7.3.1 高精度模板匹配

用途：在图像中找出与模板相似的位置，输出坐标和角度，支持旋转、缩放搜索。

工具主页：

模板设计页面：

效果图：

输出：匹配点列表（X、Y、角度、分数）、匹配数量、标注图像。

使用要点：

• 配套「图像掩膜」可屏蔽模板中无效区域

• 「模板设计」中调好模板范围与中心点

• 分数阈值过低会误检，过高会漏检

• 「创建匹配中心」可创建非默认匹配输出的中心位置

7.3.2 Blob 分析

用途：检测连通域并按面积、外形等条件过滤。

效果图：

输出：Blob 列表（坐标、面积、宽高等）、显示文本（每个 Blob 面积明细）。

使用要点：

• 上游建议先做图像二值化或形态学预处理

• 面积/宽高等范围按实际目标设置，避免过宽过窄

• 与「位置修正」配合可使 ROI 自动跟随基准

7.3.3 位置修正

用途：以基准位置为参照，校正后续工具的 ROI 位置与角度。

效果图：

输出：修正后的坐标、角度，以及修正矩阵。

使用要点：

• 配置后先点「创建基准」记录一次基准

• 运行点通常来自模板匹配、查找圆等定位工具

• 修正结果可被后续工具的 ROI 自动跟随

7.3.4 目标检测

用途：基于 yolo模型检测图像中的目标，输出类别与位置。

输出：检测框列表（X、Y、宽、高、类别、置信度）、检测数量。

使用要点：

• 模型文件需与训练框架兼容

• 置信度过高会漏检，过低会误检

7.3.5 图像分割

用途：基于 yolo 模型对图像做像素级分割，输出掩膜图。

输出：分割掩膜图、各类别面积。

使用要点：

• 适合纹理复杂或不规则目标

7.3.6 OBB

用途：检测带角度的旋转矩形目标。

效果图：

输出：旋转框列表（中心X、中心Y、宽、高、角度、类别、置信度）。

使用要点：

• 适用于倾斜放置的工件

• 交集过滤适用于机器人使用夹爪而不是吸盘的情况

7.4 逻辑控制类

7.4.1 组合模块

用途：把一段子流程封装成可复用模块，支持循环累加显示与对外发布输出。

工具页面：

分别包含了输入设置、输出设置、显示设置、循环设置

输入设置可选择当前作业中，组合模块工具前的工具输出信息作为输入；

输出设置：

输出设置中可配置组合模块内输出的信息，主要是字段信息，不包含图像、图形的输出

显示设置：

设置用于输出当前工具的图像与图形信息，设置后，在外部作业中点击此工具时，可显示当前设置的图形信息，【累计】表示是否启用累加当前组合模块循环过程中的结果图形叠加

循环设置：

设置是否启用组合模块内的循环，通常结合配置的输入信息使用，用于设置循环的次数，循环间隔默认1ms

输出：对外发布的图像、文本、检测结果等。

使用要点：

• 子流程内可使用大多数普通工具

• 显示设置中订阅的字段可被外部作业引用

• 适合多检测点重复使用的场景

• 配置的显示设置中的图形可在外部作业的【设置图形显示】中调用

7.4.2 条件检测

用途：组合多个条件判断综合结果（如 OK / NG）。

输出：综合判定结果（Pass / Fail）。

使用要点：

• 适合做结果收集的前置条件判定

• 与「条件分支」配合可走不同后续流程

7.4.3 条件分支

用途：根据条件走不同的分支流程。

输出：当前走向的分支结果。

使用要点：

• 与「条件检测」组合实现 OK 走输出、NG 走报警

• 复杂分支可串联多个本工具

7.4.4 矩形框筛选

用途：对上游检测到的矩形框按位置、尺寸、角度过滤。

输出：过滤后的框列表。

使用要点：

• 常用于剔除目标检测输出中明显异常的框

7.4.5 数据收集

用途：累积多次运行结果，便于批次分析或导出。

输出：累计数据列表。

使用要点：

• 配合机器人格式以及条件检测使用，满足条件时进行数据收集，收集完成后可在机器人格式中配置输入直接转换为金刚可以直接使用的数据格式

7.5 数据与通信类

7.5.1 数据发送

用途：通过网络（TCP/UDP）将结果发送至机器人。

输出：发送结果（成功 / 失败）。

使用要点：

• 必须先在「全局网络」配好对端 IP/端口

• 数据优先使用机器人文本工具组合后再发送

• 通讯断开时本工具会报错，便于排查

7.5.2 格式化

用途：按指定模板把多个字段拼成一条字符串，常用于机器人报文输出。

输出：组装后的字符串，可在预览区查看效果。

使用要点：

• 按对端约定的协议设置分隔符与结束符

• 输出结果可直接交给「数据发送」

• 此项主要用于当机器人文本工具不满足条件的情况下使用，进行自定义格式化数据字符串组合

7.5.3 机器人文本

用途：按机器人通信约定格式输出文本。

输出：机器人可识别的字符串。

使用要点：

• 各字段长度必须一致

• 推荐与「数据收集」、「数据发送」联合使用，先使用数据收集工具收集信息，再使用机器人文本组合数据，最后通过数据发送将标准文本发送给机器人

7.6 脚本类

7.6.1 执行脚本

用途：通过脚本实现内置工具未覆盖的自定义逻辑。

输出：脚本中定义的输出字段。

使用要点：

• 适合复杂规则、非标计算

• 调试时建议先用少量数据验证

• 出错信息会显示在日志区

• 非必要调试人员尽量不要修改此项中的数据

第8章 页面控件说明

本章对常用页面中可见控件进行说明，便于操作员快速理解每个按钮、输入框的作用。

8.1 主界面

用途：软件主窗口，承载菜单、作业页签、流程区、主图像区与日志区。

操作要点：

• 双击作业页签可重命名

• 拖动面板分隔条可调整区域大小

• 关闭软件前会自动提示保存项目

8.2 作业页签工具栏

8.3 作业显示设置

用途：配置该作业主显示区显示哪些工具的哪些输出。

操作要点：

• 设置随项目保存，下次打开自动恢复

• 至少包含「输出图像」一项可保证主显示区有内容

• 字段类型需与显示类型匹配

8.4 主图像显示与缩略图

操作要点：

• 切换缩略图会自动执行作业并刷新主显示

• 非图像源工具被选中时操作按钮自动隐藏，避免误操作

• 鼠标滚轮缩放，按住拖动平移

8.5 全局相机

用途：管理与软件连接的相机设备。

操作要点：

• 添加相机前先安装好相机驱动

• 自动模式下手动参数不生效

• 修改分辨率会重新初始化相机

8.6 全局变量

用途：定义跨作业、跨工具共享的变量。

操作要点：

• 变量名建议英文 + 数字，便于在工具中选择

• 修改后必须点击「保存变量」才会持久化

• 脚本工具可直接读写全局变量

8.7 全局触发

用途：配置外部信号或定时器触发作业。

操作要点：

• 触发需先在全局通讯配置tcp通讯列表

• 定时tcp触发适合无外部信号场景做节拍测试

8.8 全局通讯

用途：配置 TCP/UDP 通讯。

操作要点：

• 同一端口不能重复占用

• 客户端模式下需保证对端先启动

• 断线后可在此页面手动重连

8.9 运行模式

用途：选择作业的运行策略与主界面布局。

操作要点：

• 在设置中，将画面与作业绑定，没有绑定作业不会显示图像信息

8.10 日志

用途：查看运行日志，定位异常。

操作要点：

• 异常排查优先看「错误」级别

• 长时间运行建议定期导出日志归档

• 日志本地存储在程序所在目录下的Logs文件夹中

第9章 运行与发布

8.1 调试期使用建议

• 单击工具逐步验证每一步参数

• 用“作业显示设置”检查关键中间结果

• 用“缩略图”逐张图像验证稳定性

8.2 生产期使用建议

• 锁定方案文件，避免现场误改

• 配置“全局相机”线触发实现自动运行

• 配合“条件检测”“条件分支”做 OK / NG 输出

• 配合“数据发送”与机器人/PLC 联机

8.3 启动顺序建议

1. 打开软件

2. 加载方案

3. 检查相机、网络、I/O 状态

4. 切换到在线模式

5. 关闭程序前，如果需要下次启动程序自动运行，需在「在线模式」下保存项目

第10章 日志与提示

• 普通信息：用于追踪流程执行步骤

• 警告：参数不合理或边界情况

• 错误：工具执行失败或通讯等异常

排查问题的基本顺序：

1. 看日志最近一条错误

2. 单击对应工具看输入是否正常

3. 双击工具检查参数

4. 重新单击工具运行验证

第11章 常见问题

10.1 缩略图问题

• 现象：新建作业后还能看到旧缩略图

处理：切换页签或重新点击图像源工具

• 现象：点击空白处缩略图变灰

处理：单击图像源工具即可恢复

10.2 图像不显示

• 检查是否选中了某个工具

• 检查上游工具是否执行成功

• 检查“作业显示设置”中是否订阅了有效字段

10.3 检测结果为空

• 检查 ROI 是否正确覆盖目标区域

• 检查模板/阈值/颜色范围是否合理

• 用“图像滤波”“图像增强”预处理后再检测

10.4 通信无数据

• 确认网络已连接

• 确认对端 IP 与端口正确

• 确认“数据发送”工具被流程实际执行到

10.5 工具拖拽无效

• 确认未处于循环执行中（先停止运行）

• 确认当前作业页签为可编辑状态

第12章 维护建议

• 项目方案文件按日期归档备份

• 重要批次保留原图与对应结果文件

• 模型文件（yolo工具使用）独立备份

• 升级前先做完整备份

• 现场无法处理的问题保留日志后联系技术支持

附录A 工具速查表