1. MERLIC工程环境搭建
MERLIC 是 MVTec 面向机器视觉应用的图形化集成开发环境，它的核心思想是让工程师通过“工具（Tool）”的拖拽与连线完成图像处理流程，而不必从零编写底层算法代码。要开始一个 MERLIC 项目，第一步不是急着写流程，而是把运行环境、相机采集链路和工程文件结构这三件事理顺。本章围绕“装好、连上、跑通、看懂”四个目标展开，帮助你完成从零到第一个图像采集流程的完整闭环。
一、安装 MERLIC 与授权准备
MERLIC 的安装包通常以版本号命名，例如 MERLIC_5.x.x_win64.exe。安装前需要确认三件事：操作系统为 64 位 Windows 10/11 或对应版本的 Windows Server；显卡驱动支持 DirectX 11 以上；磁盘预留至少 10 GB 空间用于运行时、示例图像和工程缓存。安装过程中会提示选择组件，建议至少勾选 MERLIC Creator（流程编辑与运行主程序）、MERLIC Communicator（与外部程序通信的接口组件）以及 Camera 驱动支持。若使用 GigE Vision 或 USB3 Vision 工业相机，还需确认是否安装了对应厂商的 GenICam 传输层（如 MVTec GigE Vision 或相机厂商自带的 SDK）。
授权方面，MERLIC 采用加密狗或软授权方式。未授权时软件可进入演示模式，但部分工具和保存功能受限。安装完成后首次启动，建议在 File → Preferences → License 中确认授权状态，避免后续流程保存失败。安装路径建议保持默认，因为部分相机驱动和示例工程会按默认路径查找依赖。
二、配置相机与采集卡
MERLIC 支持多种图像来源：GigE Vision、USB3 Vision、DirectShow 相机、图像文件夹以及视频文件。对于工业检测场景，最常用的是 GigE Vision 相机配合独立网卡（采集卡）。配置顺序如下：
- 物理连接：相机通过网线接入采集卡对应网口，若相机支持 PoE，可由采集卡直接供电；否则需外接电源。
- 网卡设置：在 Windows 网络适配器中，将采集卡网口设为固定 IP，例如
192.168.1.100，子网掩码255.255.255.0，关闭防火墙对该网口的干扰。相机出厂 IP 常为192.168.1.10或通过 DHCP 获取，需保证与网卡同网段。 - 相机发现：打开 MERLIC Creator，进入
Image Source配置界面，点击 Scan，软件会通过 GenICam 协议枚举在线相机。若未发现，检查网卡是否被其他软件占用、相机是否处于同一子网。 - 参数初调：选中相机后，可设置曝光时间（如
5000 μs）、增益（如0 dB）、像素格式（如Mono8或BayerRG8）。这些参数会直接影响后续图像质量，建议先以“能看清目标”为准，不必一次调到最优。
三、创建首个图像采集流程
MERLIC 的流程由“图像源 → 工具 → 结果”构成。创建首个采集流程的步骤如下：
- 新建工程：
File → New Project，选择保存路径，工程文件扩展名为.mvtc。 - 在流程编辑区拖入 Image Source 工具，选择已配置的相机，点击 Live 可预览实时图像。
- 拖入 Acquire Image 工具，将其输入端口与 Image Source 的输出端口连接。该工具负责触发一次采集并输出单帧图像。
- 拖入 Display Image 工具，连接 Acquire Image 的图像输出，用于在运行界面显示结果。
- 点击 Run，观察是否成功采集到一帧图像。若图像全黑，检查镜头盖、曝光时间和光源；若报错“无法连接相机”，回到 Image Source 重新扫描。
这个最小流程虽然简单，但它已经包含了 MERLIC 工程的基本骨架：图像输入、处理工具、结果输出。后续所有检测逻辑，都是在这个骨架上不断插入工具、扩展分支。
四、理解 MERLIC 界面与工程文件结构
MERLIC Creator 的主界面可分为五个区域：顶部菜单与工具栏、左侧工具库（Tool Library）、中部流程编辑区（Flow Editor）、右侧参数与结果面板、底部消息与日志区。工具库按功能分类，如 Image Acquisition、Image Processing、Measurement、Inspection 等；流程编辑区以节点和连线的方式展示数据流；右侧面板显示当前选中工具的输入参数和输出结果。
工程文件结构方面，一个 MERLIC 工程通常包含：
- 工程文件（.mvtc）：保存流程拓扑、工具参数和界面配置。
- 图像资源文件夹：若使用图像文件夹作为图像源，需将图片放在工程目录下的指定子文件夹中。
- 配置文件：相机参数、通信设置等可能以独立配置文件形式存在，便于在不同机器间迁移。
- 日志与缓存：运行过程中生成的临时文件和日志，用于排查问题。
理解这些结构后，迁移工程时只需拷贝整个工程目录，并在新机器上重新配置相机 IP 和授权，即可快速恢复运行。
五、常见问题与排查思路
首次搭建环境时，最容易卡在“相机扫不到”和“图像全黑”两个问题上。相机扫不到时，按以下顺序排查：网卡 IP 是否与相机同网段、防火墙是否拦截、相机是否被其他软件占用、GenICam 传输层是否安装。图像全黑时，先检查镜头盖和光圈，再检查曝光时间是否过短、增益是否为零、光源是否开启。若图像偏色，检查像素格式是否与相机实际输出一致，例如彩色相机误设为 Mono8 会丢失颜色信息。