2. 开发环境搭建与项目创建
VisionPro 是康耐视机器视觉软件的核心平台，机器人定位与引导开发的第一步，就是把它的运行环境、开发工具和相机链路全部打通。本章围绕三件事展开：VisionPro 的安装与授权配置、QuickBuild 与脚本环境的建立、相机连接与图像采集基础。这三者构成后续所有标定、定位和引导作业的物理与软件底座，任何一环没打通，后面的工具链都无法稳定运行。
一、VisionPro 安装与授权配置
VisionPro 的安装包通常包含运行时（Runtime）、开发环境（VisionPro Developer）以及配套的驱动与工具集。安装前需要确认三件事：操作系统版本与位数、是否具备管理员权限、以及是否已安装对应版本的 .NET 运行库。VisionPro 对系统环境较敏感，建议在专用工控机或干净的开发机上安装，避免与其它视觉软件（如 Halcon、OpenCV 的某些驱动）产生 DLL 冲突。
安装过程本身是向导式的，真正需要关注的是授权。VisionPro 采用加密狗（Dongle）或软授权（License File）两种方式。加密狗方式即插即用，适合现场部署；软授权需要将授权文件放到指定目录，并通过 VisionPro License Manager 激活。安装完成后，务必打开 License Manager 确认以下信息：
- 授权类型：Developer 还是 Runtime；
- 可用模块：是否包含 PatMax、Caliper、Blob 等定位与引导常用工具；
- 有效期与节点数：确认没有过期或超出授权节点。
安装完成后，建议立即做一次最小验证：打开 VisionPro 自带的示例工程，运行一次图像加载与工具执行，确认运行时无报错。这一步能提前暴露授权、DLL 或显卡驱动问题，避免在项目中途才发现环境不完整。
二、QuickBuild 与脚本环境
QuickBuild 是 VisionPro 的图形化作业编辑环境，也是机器人引导项目的主要开发界面。它的核心价值在于：把图像采集、工具处理、结果输出组织成一条可视化的作业流（Job），并支持在关键节点插入脚本（Script）做逻辑扩展。
一个典型的 QuickBuild 作业结构如下：
Job
├─ Image Source（相机 / 图像文件）
├─ ToolGroup
│ ├─ CogPMAlignTool（模板匹配定位）
│ ├─ CogCaliperTool（边缘测量）
│ └─ CogBlobTool（斑点分析）
├─ Script（结果计算 / 坐标转换）
└─ Output（结果输出 / 通信）脚本环境是 QuickBuild 的扩展核心。VisionPro 支持 C# 脚本，脚本可以访问作业中的工具对象、读取结果、执行坐标变换，甚至调用外部通信接口。对于机器人引导，脚本通常承担三件事：把像素坐标转换为机器人坐标、计算抓取位姿、把结果写入通信缓冲区。
脚本编辑时需要注意：脚本运行在作业线程中，不要在其中做长时间阻塞操作；所有工具结果应在脚本执行前完成更新，否则会读到旧值。建议在脚本开头先调用一次工具结果刷新，再读取 Results 属性。
System.Diagnostics.Debug.WriteLine()，并在 Visual Studio 的输出窗口中查看，而不是依赖弹窗。三、相机连接与图像采集基础
相机连接是环境搭建中最容易出问题的一环。VisionPro 支持 GigE Vision、USB3 Vision、Camera Link 等多种接口，机器人引导项目中最常见的是 GigE 工业相机。连接前需要确认：相机供电正常、网卡已配置为与相机同网段、防火墙未拦截 GigE Vision 的 UDP 端口。
在 QuickBuild 中添加相机时，通常通过 CogAcqFifoTool 或 CogFrameGrabber 完成。以 GigE 相机为例，基本流程是：
- 在工具面板中选择图像采集工具，打开相机选择对话框；
- 在可用设备列表中找到目标相机，确认其 IP 与网卡同网段；
- 设置采集参数：曝光时间、增益、触发模式（自由运行或硬触发）；
- 点击 “Live” 预览，确认图像清晰、无丢帧、无过曝；
- 保存采集配置，供后续作业调用。
采集参数中，曝光时间与增益需要配合光源一起调。曝光时间过长会导致运动模糊，过短则图像偏暗、信噪比下降。对于机器人引导场景，通常建议使用硬触发，让相机在机器人到达拍照位时被触发，保证图像与位姿同步。
图像采集完成后，需要检查几个关键指标：帧率是否稳定、是否有丢帧计数、图像是否出现横纹或暗角。如果出现丢帧，优先检查网卡的巨帧（Jumbo Frame）设置和带宽占用；如果图像偏暗，先调光源再调增益，避免增益过高引入噪声。
把这三层串起来看，环境搭建的本质是建立一条从“相机光子”到“机器人坐标”的可信链路。安装与授权保证软件能跑，QuickBuild 与脚本保证逻辑能写，相机与采集保证数据能进来。三者都验证通过后，才具备进入标定与定位开发的条件。
四、环境验证清单
在正式进入项目开发前，建议按下面这份清单逐项确认。它不是形式化的流程，而是把前面三节的关键检查点固化下来，避免带着隐患进入标定阶段。
| 检查项 | 确认内容 | 通过标准 |
|---|---|---|
| 授权状态 | License Manager 显示 Developer 授权有效 | 无过期、无节点超限 |
| 运行时验证 | 示例工程可正常加载并执行 | 无 DLL 缺失或报错 |
| QuickBuild 作业 | Job 可保存、可重新打开 | 工具链完整、脚本可编译 |
| 相机连接 | 设备列表可识别、IP 同网段 | Live 预览正常 |
| 采集参数 | 曝光、增益、触发模式已设置 | 图像清晰、无丢帧 |
| 脚本环境 | C# 脚本可读写工具结果 | 调试输出可见 |
完成以上验证后，开发环境即具备进入下一阶段的条件。后续的相机标定、手眼标定和机器人引导作业，都将建立在这条已经验证过的采集与处理链路上。