卡片图编辑器
卡片图是视觉程序的拖拽图编辑方式。它与视觉 SCL 编辑同一个视觉程序:图形修改会更新文本,视觉 SCL 编译成功后也会更新图形。标准流程可以只用拖拽完成;条件和事件逻辑可放在 ACTION 节点中。
编辑器界面
卡片图编辑器由以下几个区域组成:
┌────────────────────────────────────────────────────────────┐
│ 工具箱 │ 拖拽图画布 │ 图像与结果 │
│ │ [输入] ──→ [处理] ──→ [输出] │ 原图/结果 │
│ │ │ 属性/ACTION│
│ │ │ 相机/诊断 │
├────────┴───────────────────────────────────────┴────────────┤
│ 视觉 SCL 编辑器 │
├────────────────────────────────────────────────────────────┤
│ 状态栏:本地预览、编译诊断和 Runtime 连接状态 │
└────────────────────────────────────────────────────────────┘
| 区域 | 说明 |
|---|---|
| 工具箱 | 搜索并添加当前可用的视觉算子或 ACTION |
| 拖拽图画布 | 放置节点、连接端口、框选和调整布局 |
| 图像与结果 | 查看原图、结果图、测量、文本、属性、相机和诊断 |
| 视觉 SCL | 用视觉 SCL 编辑同一个视觉程序 |
| 状态栏 | 明确区分本地预览、编译结果和现场 Runtime 状态 |
推荐编辑顺序
- 从工具箱拖入节点。
- 从输出端口连接到兼容的输入端口。
- 在属性面板填写参数;条件和事件逻辑放在 ACTION 中。
- 修正诊断中的第一条错误。
- 需要文本修改时,点击 应用视觉 SCL,编译成功后再检查图形。
- 打开图像执行 本地预览,最后保存项目并执行部署校验。
本地预览和推理都在扫描周期外执行。PLC scan 不等待图上的相机或模型节点。
节点与可用状态
工具箱按采集、预处理、检测、测量、识别、输出等用途分组。节点是否可用,以当前 IDE 工具箱和 算子参考 为准。
- 只有当前工具箱列出的节点可用于编辑。
- 推理节点引用 Darra AI Studio 已交付的模型。运行时只消费已准备的 inference-only 会话,不在图上训练或下载模型。
- GenTL 厂商插件、多相机同步、实例分割和异常检测仍在推进。
- ACTION 是事件逻辑节点,不是可绕过算子校验的任意脚本入口。
端口标签会显示数据类型。常见类型包括图像、二值掩码、数值、文本、几何结果和结果列表。连接时只需遵守界面显示的类型;类型不兼容时,编辑器会拒绝连线。
卡片连接与数据流
连接规则
卡片之间的连接线表示数据流,遵循以下规则:
- 单向连接:从输出端口连到输入端口
- 精确端口:每条线保存明确的源端口和目标端口
- 类型匹配:两端类型必须兼容
- 结构有效:自连接、重复连接和环路会被拒绝
数据流类型
端口名称旁会显示当前类型。图像只能连接图像输入,数值、文本和几何结果也必须连接到兼容输入。不要按节点名称猜测类型。
数据流示例
[图像输入] ──Image──→ [灰度] ──Image──→ [阈值] ──Image──→ [结果输出]
参数配置
卡片属性编辑
双击卡片或选中卡片后在属性面板中配置参数:
参数类型:
| 控件类型 | 说明 | 示例 |
|---|---|---|
| 数值输入 | 设置数值参数 | 阈值 0.5 |
| 下拉选择 | 从预定义列表选择 | 滤波类型: 高斯 |
| 文件选择 | 选择项目中的图像或标定文件 | 参考图像 |
| 颜色选择 | 选择颜色 | 标注颜色: 绿色 |
| 变量绑定 | 绑定 PLC 变量 | 输出变量: VIS_RESULT |
| 模型引用 | 引用已交付推理工件 | 模型标识与版本 |
| 表达式 | 输入简单表达式 | ROI: (x:100, y:100, w:400, h:400) |
模型引用只填写已交付工件的标识、版本和输入合同。不要把数据集路径或训练超参写进节点。
参数验证
配置参数时编辑器实时验证:
- 数值范围检查(如置信度必须在 0~1)
- 文件、设备和模型引用检查
- 类型兼容性检查(连接线类型匹配)
- 必填项检查(标记为红色的参数必须填写)
编辑与布局
- 选择与框选:点击节点,或在空白处拖动框选多个节点
- 撤销与重做:使用工具栏或
Ctrl+Z/Ctrl+Y - 复制与粘贴:复制选中节点,粘贴后再连接所需端口
- 删除:删除选中节点或选中的精确连线
- 自动布局:按数据流方向整理当前图
- 对齐与分布:对多个选中节点进行水平、垂直对齐或等距分布
- 网格吸附:减少手工排列偏差
- 适合画布与导航图:用于查看较大的流程
ACTION 事件
从工具箱添加 ACTION 后,在 属性 / ACTION 中选择事件并编辑视觉 SCL。ACTION 适合条件判断、循环和结果整理;算子处理仍由拖拽图节点表达。
编译失败时,诊断会指出文本或节点问题,失败修改不会替换上一次有效程序。旧 C# 风格 Vision Script 不能作为新 ACTION 合同。
保存方式
- 保存
.dplc项目,保留项目中的视觉程序。 - 保存定义会导出
.vscl或.scl文本副本;它不能单独部署。 - 视觉 SCL 有修改时,先点击 应用视觉 SCL。编译成功后再保存。
校验与编译
卡片图编辑完成后,需要进行校验:
- 连线检查:确认端口存在、方向正确且类型兼容
- 参数检查:确认必填参数、取值范围、相机和模型引用有效
- 编译:生成可保存的视觉程序,并同步视觉 SCL
- 预览检查:打开测试图像后运行本地预览,查看结果和诊断
校验错误显示在诊断区。修正第一条错误后重新编译。只有编译成功的版本才能保存、预览或进入部署检查。