跳到主要内容

卡片图编辑器

卡片图是视觉程序的拖拽图编辑方式。它与视觉 SCL 编辑同一个视觉程序:图形修改会更新文本,视觉 SCL 编译成功后也会更新图形。标准流程可以只用拖拽完成;条件和事件逻辑可放在 ACTION 节点中。

编辑器界面​

卡片图编辑器由以下几个区域组成:

┌────────────────────────────────────────────────────────────┐
│ 工具箱 │ 拖拽图画布 │ 图像与结果 │
│ │ [输入] ──→ [处理] ──→ [输出] │ 原图/结果 │
│ │ │ 属性/ACTION│
│ │ │ 相机/诊断 │
├────────┴───────────────────────────────────────┴────────────┤
│ 视觉 SCL 编辑器 │
├────────────────────────────────────────────────────────────┤
│ 状态栏:本地预览、编译诊断和 Runtime 连接状态 │
└────────────────────────────────────────────────────────────┘
区域说明
工具箱搜索并添加当前可用的视觉算子或 ACTION
拖拽图画布放置节点、连接端口、框选和调整布局
图像与结果查看原图、结果图、测量、文本、属性、相机和诊断
视觉 SCL用视觉 SCL 编辑同一个视觉程序
状态栏明确区分本地预览、编译结果和现场 Runtime 状态

推荐编辑顺序​

  1. 从工具箱拖入节点。
  2. 从输出端口连接到兼容的输入端口。
  3. 在属性面板填写参数;条件和事件逻辑放在 ACTION 中。
  4. 修正诊断中的第一条错误。
  5. 需要文本修改时,点击 应用视觉 SCL,编译成功后再检查图形。
  6. 打开图像执行 本地预览,最后保存项目并执行部署校验。

本地预览和推理都在扫描周期外执行。PLC scan 不等待图上的相机或模型节点。

节点与可用状态​

工具箱按采集、预处理、检测、测量、识别、输出等用途分组。节点是否可用,以当前 IDE 工具箱和 算子参考 为准。

  • 只有当前工具箱列出的节点可用于编辑。
  • 推理节点引用 Darra AI Studio 已交付的模型。运行时只消费已准备的 inference-only 会话,不在图上训练或下载模型。
  • GenTL 厂商插件、多相机同步、实例分割和异常检测仍在推进。
  • ACTION 是事件逻辑节点,不是可绕过算子校验的任意脚本入口。

端口标签会显示数据类型。常见类型包括图像、二值掩码、数值、文本、几何结果和结果列表。连接时只需遵守界面显示的类型;类型不兼容时,编辑器会拒绝连线。

卡片连接与数据流​

连接规则​

卡片之间的连接线表示数据流,遵循以下规则:

  1. 单向连接:从输出端口连到输入端口
  2. 精确端口:每条线保存明确的源端口和目标端口
  3. 类型匹配:两端类型必须兼容
  4. 结构有效:自连接、重复连接和环路会被拒绝

数据流类型​

端口名称旁会显示当前类型。图像只能连接图像输入,数值、文本和几何结果也必须连接到兼容输入。不要按节点名称猜测类型。

数据流示例​

[图像输入] ──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
  • 预览检查:打开测试图像后运行本地预览,查看结果和诊断

校验错误显示在诊断区。修正第一条错误后重新编译。只有编译成功的版本才能保存、预览或进入部署检查。