视觉算子概述
Darra RT IDE 内置视觉编程工作台,用于编辑视觉流程、配置相机、预览图像、查看结果和检查部署条件。拖拽图与视觉 SCL 编辑同一个视觉程序:图形修改会更新文本;视觉 SCL 编译成功后会更新图形。编译失败时,上一次有效程序保持不变。
数据集、标注、训练、验证和导出属于独立产品 Darra AI Studio。本页只说明 PLC 视觉运行时如何消费已交付的推理工件。视觉作业在扫描周期外执行,PLC scan 不等待相机或推理。
核心能力
- 相机绑定 — 在项目中填写相机、视觉程序、最大帧尺寸和像素格式,并显式确认
- 拖拽图 — 放置算子或 ACTION,连接类型化端口,在属性面板编辑参数
- 视觉 SCL — 用视觉 SCL 表达同一程序中的条件、循环和事件逻辑
- 本地预览 — 打开一张图像,在 IDE 中运行当前流程并查看结果与诊断
- 模型消费 — 在视觉算子中引用 AI Studio 已交付的推理工件;运行时只使用已准备的 inference-only 会话
- PLC 集成 — PLC 扫描不等待相机或推理;完整结果在扫描边界一次提交
公开编辑流程
- 从顶部 视觉编程 页或项目树打开工作台。
- 在 流程 中放置节点、连接端口并编辑参数或 ACTION。
- 需要文本逻辑时,编辑视觉 SCL,然后点击 应用视觉 SCL。
- 打开本地图像并执行 本地预览,查看结果、测量、文本和诊断。
- 保存
.dplc项目;需要文本副本时,用 保存定义 导出.vscl或.scl。 - 现场使用前,在 相机 中确认帧配置,再到 部署 中重新校验。
本地预览、部署校验和现场运行是三个不同状态。本地预览成功不表示已连接现场 Runtime;部署校验通过也不表示已经部署。
当前状态
| 能力 | 状态 | 说明 |
|---|---|---|
| 拖拽图编辑 | 可用 | 支持节点、端口、连线、属性、ACTION、撤销重做和布局工具 |
| 视觉 SCL 编辑 | 可用 | 编译成功后更新拖拽图 |
| IDE 本地预览 | 可用 | 处理已打开图像,不代表现场 Runtime 已连接 |
| 本地图像 / Windows UVC 采集 | 可用 | 相机与驱动仍需在目标设备验证 |
| USB3 Vision / GigE Vision | 可用,需适配器 | 安装对应适配器后,还需在目标设备验证 |
| GenTL 厂商插件 | 推进中 | 当前不要按已支持能力选型 |
| 多相机同步 | 推进中 | 当前不要按已支持能力选型 |
| 模型消费 | 可用 | 引用已交付推理工件;scan 外推理,scan 边界提交结果 |
| 数据集 / 训练 / 导出 | 不在本产品 | 见 Darra AI Studio |
| 内置自动推理标注 | 不在本产品 | 标注工作在 AI Studio 完成 |
视觉程序的部署页会显示校验和批准状态;是否能批准取决于当前环境。本地预览或部署校验通过,都不等于现场已装入该模型。
硬件与模型
- 相机的分辨率、帧率和像素格式以设备能力及项目中确认的帧配置为准。
- 模型格式、输入尺寸和可用执行设备以 AI Studio 导出的推理工件及现场 Runtime 准备结果为准。验证通过不能替代现场准备与部署。
- 不能把开发电脑上的本地预览结果当作现场性能或兼容性结论。
- 推理期只能消费已 Prepared 的 inference-only 会话;不得隐式创建会话、临时懒加载或在现场训练。
与 PLC 的集成
视觉程序通过有界异步作业与 PLC 交换数据:
- PLC 在扫描边界取得本次视觉作业需要的输入快照
- 视觉作业在扫描周期之外执行,PLC 不等待相机或推理
- 作业成功后,完整结果等待下一次扫描边界提交
- 作业失败、取消或超时时,不提交不完整结果
这项合同保证视觉处理不会把相机或模型等待时间带入 PLC 扫描周期。
两种编辑方式,一个视觉程序
- 拖拽图 — 编辑节点、端口、连线、参数和 ACTION
- 视觉 SCL — 用视觉 SCL 编辑同一流程和事件逻辑
- 同步规则 — 编译成功后两种视图同步;编译失败时显示诊断,并保留上一次有效程序
- 运行规则 — 本地预览与现场运行状态明确分开;只有连接现场 Runtime 后,在线状态才有意义
ACTION 是拖拽图中的事件节点,不是第三种编辑模式。旧 C# 风格 Vision Script 不是视觉 SCL,只允许显式、fail-closed 的单向迁移,不得再导出或作为新运行合同。项目以 .dplc 保存;保存定义只导出视觉 SCL 文本副本,不能单独部署。
API 参考
左侧视觉算子 API按用途列出当前发布的算子。每个分类页给出名称、参数、默认值、返回值和可用状态;本文只说明工作流与能力边界。模型引用与运行时准备见 模型消费,作业时序见 视觉运行时。