📚 课程目录第3章 XG-X软件环境

3. XG-X软件环境

XG-X Vision Editor 是基恩士 XG-X 系列图像处理控制器的上位机开发环境，所有相机参数、检测流程、判定逻辑和通信配置都在这里完成。它并不是一个“打开就能跑”的通用软件，而是与控制器固件版本、相机型号、授权许可强绑定的工程化工具。理解它的安装约束、界面分区和工程组织方式，是后续所有检测逻辑开发的前提。

安装前的版本与许可确认

安装前需要先确认三件事：控制器型号（如 XG-X2000、XG-X8000 系列）、固件版本，以及 Vision Editor 的版本号。三者必须匹配，否则可能出现“能连上但无法下载工程”或“部分功能灰显”的情况。安装包通常来自随机附带的光盘或基恩士官网下载，安装过程中会要求输入许可证密钥（License Key），该密钥与控制器序列号绑定，用于解锁多相机、多任务等高级功能。

安装路径建议保持默认，避免中文目录和空格，因为部分驱动和日志模块对路径字符敏感。安装完成后，首次启动会提示选择“在线（Online）”或“离线（Offline）”模式：在线模式直接与控制器通信，离线模式用于无硬件时练习工程搭建。若使用 USB 或以太网连接，还需确认 PC 的网段与控制器一致，例如控制器默认 IP 为 192.168.0.10，则 PC 应设为 192.168.0.x。

界面布局：五个核心区域

Vision Editor 的主界面可以划分为五个功能区，理解它们的分工比记住菜单位置更重要：

工程树（Project Tree）：左侧，管理相机、任务、单元和流程的层级结构，是工程的“骨架”。
工具面板（Tool Palette）：中部偏左，按类别列出可用的检测工具，如边缘检测、斑点分析、图案匹配、测量等。
编辑画布（Edit Canvas）：中央主区域，显示相机图像和已放置的工具，工具之间的数据流以连线表示。
属性窗口（Property）：右侧，显示当前选中工具或节点的参数，如阈值、ROI 范围、判定上下限。
图像显示与结果区：下方或浮动窗口，显示实时图像、处理结果、OK/NG 判定和测量数值。

这五个区域不是孤立的：在工程树中选中一个任务，画布会切换到该任务的流程；在画布中点击某个工具，属性窗口才会显示对应参数。因此实际操作时，视线会在“树—画布—属性”之间来回切换，形成“选节点、调参数、看结果”的循环。

工程创建：从 New Project 到可运行流程

新建工程的入口是 File → New Project，随后进入一个向导式配置。这里的关键不是“点下一步”，而是每一步决定了后续能做什么：

选择控制器型号：必须与实际硬件一致。若选错，工程下载时会被拒绝，或相机数量上限不符。
设置相机数量与分辨率：例如 2 台 500 万像素相机，则工程树中会自动生成 Camera 0 和 Camera 1 两个分支。
创建任务（Task）：一个任务对应一次完整的检测触发。多工位或多品种产线通常建立多个 Task，通过外部信号切换。
创建单元（Unit）与流程（Flow）：Unit 是任务内的逻辑分组，Flow 是实际执行的处理链。一个 Task 可以包含多个 Unit，每个 Unit 内可并行或串行多个 Flow。

工程创建完成后，建议先保存为独立文件（.xgx 或对应格式），并记录控制器 IP、相机型号、镜头焦距和光源类型。这些信息在后续调试和换型时是排查问题的第一手依据。

基本操作：把工具变成可运行的检测逻辑

以“测量工件宽度并判定 OK/NG”为例，基本操作链路如下：

在工程树中选中目标 Flow，画布进入该流程的编辑状态。
从工具面板拖入“边缘检测”工具，在画布上框选 ROI 区域，覆盖工件左右两侧边缘。
在属性窗口设置边缘阈值（示例：128）、边缘方向（从亮到暗或从暗到亮）和滤波次数（示例：2）。
再拖入“尺寸测量”工具，将两个边缘检测结果作为输入，计算左右边缘之间的距离。
拖入“判定”工具，设置上限 10.50 mm、下限 9.50 mm，输出 OK 或 NG。
点击“连续运行”或“触发一次”，在结果区观察测量值和判定标记。若边缘不稳定，回到属性窗口调整阈值或 ROI 位置。

调试时建议先使用“单次触发”而非连续运行，便于逐帧观察每个工具的中间结果。确认稳定后再切换连续运行，并记录处理时间是否满足产线节拍。

工程保存、下载与版本管理

Vision Editor 中的工程分为“PC 侧工程文件”和“控制器内工程”两份。编辑完成后需要执行“下载到控制器（Download）”，控制器才会按新逻辑运行。下载前应确认控制器处于停止状态，避免产线误动作。若现场有多台同型号设备，建议在工程文件名中标注设备编号、日期和版本号，例如 XGX2000_LINE3_20240612_v1.2.xgx，避免用“最终版”“最新版”这类无法追溯的命名。

不要直接覆盖控制器内正在运行的工程。正确做法是先“上传”当前控制器工程作为备份，再下载新工程。一旦新工程逻辑有误，可快速回退到备份版本。

掌握安装约束、五个界面分区、工程层级和“拖工具—调参数—看结果”的基本循环之后，后续的相机标定、工具参数深入和通信配置才有稳定的操作基础。建议在离线模式下先完整走一遍上述宽度测量示例，熟悉工程树与画布之间的联动关系，再连接实际控制器进行在线调试。