视觉 SCL 编程
视觉 SCL 是视觉程序的文本编辑方式,与 PLC 的 SCL 同一语言族。它与拖拽图编辑同一个程序,不是另一份文件,也不能单独部署。
本页只说明图文切换、ACTION 和保存流程。算子名称、参数、返回值和状态请查各算子参考页。旧 C# 风格 Vision Script 不是视觉 SCL,只允许显式、fail-closed 的单向迁移,不得再导出或作为新运行合同。
先理解两种编辑投影
| 关注点 | 拖拽图 | 视觉 SCL |
|---|---|---|
| 主要操作 | 放置节点、连接端口、编辑属性 | 编辑条件、循环和 ACTION |
| 适合场景 | 搭建与检查主数据流 | 精确编辑事件和结果逻辑 |
| 保存结果 | 同一个视觉程序 | 同一个视觉程序 |
| 同步规则 | 有效修改会更新文本 | 编译成功后更新图形 |
任一视图中的修改都必须通过编译。编译失败时显示诊断,并保留上一次有效程序。
教程目标
本页用一条最小流程说明完整工作方法:
相机帧源 → 灰度转换 → 结果预览
完成后你将能够:
- 在拖拽图中创建并校验数据流。
- 切换到视觉 SCL,阅读同一程序的文本。
- 在 ACTION 中添加条件逻辑。
- 编译并返回拖拽图,确认节点和连线未丢失。
第一步:在拖拽图中搭建流程
- 新建视觉程序,打开 拖拽图 视图。
- 从工具箱放置 相机帧源、灰度转换 和 结果预览。
- 将上游
Image输出端口连接到下游Image输入端口。 - 在属性面板填写设备与节点参数;不要在节点名称中编码参数。
- 执行 校验。端口未连接、类型不匹配或参数越界时,不进入下一步。
[相机帧源]
out: Image
│
▼
[灰度转换]
out: Image
│
▼
[结果预览]
此时已经有一份可编译的视觉程序。下方视觉 SCL 编辑器显示同一程序的文本。
第二步:阅读视觉 SCL
从图切到 视觉 SCL 后,可以看到同一流程的文本。下面示例表达“输入 → 灰度转换 → 输出”;算子参数以当前 算子参考 为准。
int threshold = 100;
int result = 0;
void OnFrame()
{
var image = Input();
var gray = Grayscale(image);
Output(gray);
result = threshold > 100 ? threshold + 1 : 0;
}
| 文本元素 | 含义 |
|---|---|
| 字段 | 当前程序使用的输入、输出或临时值 |
| OnFrame() | 每帧事件中的处理逻辑 |
| Input()、Grayscale()、Output() | 与拖拽图节点对应的算子调用 |
| if、条件表达式 | ACTION 中的判断与结果整理 |
视觉 SCL 只支持文档明确列出的视觉算子和语言功能,不是通用宿主。
第三步:在 ACTION 中写受控逻辑
图负责表达算子拓扑,ACTION 负责条件、循环和结果整理。把上例中的两条赋值替换为:
if (threshold > 100)
{
result = threshold + 1;
}
else
{
result = 0;
}
保存或预览时,IDE 会先编译当前程序。成功后,图与文本一起更新;失败时,诊断会定位到文本行或图节点,项目继续保留上一次有效定义。
ACTION 支持 else if、switch、for 和 while。保存前会检查循环边界、代码规模和所用算子。循环必须有明确上限,不能递归,也不能调用未在当前版本开放的功能。
可用事件包括 OnTrigger、OnFrame、OnInferenceCompleted、OnFault 和 OnTimeout。同一程序中,每种事件最多定义一次。
推理完成事件只整理已返回的标量结果。PLC scan 不会停在 OnInferenceCompleted 上等待模型。
第四步:返回拖拽图
- 点击 应用视觉 SCL。
- 修复诊断区中的第一条错误,直到编译成功。
- 切回 拖拽图。
- 确认三个节点和两条连接仍然存在。
- 打开
OnFrameACTION,确认条件逻辑与文本一致。 - 保存
.dplc项目。需要文本副本时,可用 保存定义 导出.vscl或.scl;导出文件不能单独部署。
如果文本引用不存在的节点、端口类型不匹配、形成环路或使用不可用算子,编译会失败,图形和已保存程序保持不变。
图文同步规则
拖拽图与视觉 SCL 始终指向同一个视觉程序:
拖拽图 ─┐
├─→ 编译与校验 ─→ 当前有效视觉程序
视觉 SCL ┘
- 在图中新增、删除或连接节点后,文本随有效程序更新。
- 点击 应用视觉 SCL 且编译成功后,图形更新。
- 只移动节点不会改变处理顺序。
- 节点、参数、连线或 ACTION 的变化会改变程序行为。
- 项目保存到
.dplc;保存定义只生成文本副本。
语言边界
视觉 SCL 表达视觉流程,但不是通用编程环境。
| 可以使用 | 不可使用或需先验证 |
|---|---|
| 字段、赋值和常用运算符 | 操作系统、网络或任意外部代码 |
| if、switch 和有上限的循环 | 无上限循环和递归 |
| 当前工具箱中的视觉算子 | 当前版本未开放的算子 |
| 项目中已配置的 PLC 数据绑定 | 直接修改过程映像 |
| 已交付模型的推理结果字段 | 在 ACTION 内训练、下载或装载模型 |
部署到另一台现场机前,应重新执行部署检查。工具箱中可编辑不代表目标设备已满足相机、模型和算力条件。
运行与状态
视觉处理在 PLC 扫描周期之外执行:
- PLC 在扫描边界提交本次作业需要的输入。
- 视觉作业执行相机、算子和模型处理,PLC 不等待。
- 作业成功后,完整结果在后续扫描边界一次提交。
- 作业失败、取消或超时时,不提交不完整结果。
本地预览只处理 IDE 中打开的图像。只有连接现场 Runtime 后,在线作业和运行资源状态才有效。模型由 Darra AI Studio 导出,现场只消费已准备的 inference-only 会话。
常见诊断
| 现象 | 检查项 |
|---|---|
| 切回图后连接缺失 | 检查节点、端口名、方向和数据类型 |
| 节点被拒绝 | 检查算子是否在当前工具箱中,以及参数是否有效 |
| PLC 数据绑定被拒绝 | 从项目变量选择器重新绑定,并核对数据类型 |
| 循环被拒绝 | 给循环设置明确上限 |
| 修改未保存 | 查看第一条编译诊断;编译失败时不会替换有效程序 |
| 本地预览无结果 | 确认已打开图像,并查看结果与诊断页 |
| 在线状态不可用 | 先连接现场 Runtime;本地预览不产生在线状态 |
| 推理节点失败 | 确认模型已交付且会话已准备;不要在 PLC IDE 内训练 |
算子参数在哪里查
本页不重复算子签名。名称、参数、输入输出和状态码请查 算子总览 及各分类参考页。图形操作见 卡片图编辑器,运行与部署边界见 视觉运行时,模型引用见 模型消费。