跳到主要内容

视觉 SCL 编程

视觉 SCL 是视觉程序的文本编辑方式,与 PLC 的 SCL 同一语言族。它与拖拽图编辑同一个程序,不是另一份文件,也不能单独部署。

本页只说明图文切换、ACTION 和保存流程。算子名称、参数、返回值和状态请查各算子参考页。旧 C# 风格 Vision Script 不是视觉 SCL,只允许显式、fail-closed 的单向迁移,不得再导出或作为新运行合同。

先理解两种编辑投影​

关注点拖拽图视觉 SCL
主要操作放置节点、连接端口、编辑属性编辑条件、循环和 ACTION
适合场景搭建与检查主数据流精确编辑事件和结果逻辑
保存结果同一个视觉程序同一个视觉程序
同步规则有效修改会更新文本编译成功后更新图形

任一视图中的修改都必须通过编译。编译失败时显示诊断,并保留上一次有效程序。

教程目标​

本页用一条最小流程说明完整工作方法:

相机帧源 → 灰度转换 → 结果预览

完成后你将能够:

  1. 在拖拽图中创建并校验数据流。
  2. 切换到视觉 SCL,阅读同一程序的文本。
  3. 在 ACTION 中添加条件逻辑。
  4. 编译并返回拖拽图,确认节点和连线未丢失。

第一步:在拖拽图中搭建流程​

  1. 新建视觉程序,打开 拖拽图 视图。
  2. 从工具箱放置 相机帧源、灰度转换 和 结果预览。
  3. 将上游 Image 输出端口连接到下游 Image 输入端口。
  4. 在属性面板填写设备与节点参数;不要在节点名称中编码参数。
  5. 执行 校验。端口未连接、类型不匹配或参数越界时,不进入下一步。
[相机帧源]
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 上等待模型。

第四步:返回拖拽图​

  1. 点击 应用视觉 SCL。
  2. 修复诊断区中的第一条错误,直到编译成功。
  3. 切回 拖拽图。
  4. 确认三个节点和两条连接仍然存在。
  5. 打开 OnFrame ACTION,确认条件逻辑与文本一致。
  6. 保存 .dplc 项目。需要文本副本时,可用 保存定义 导出 .vscl 或 .scl;导出文件不能单独部署。

如果文本引用不存在的节点、端口类型不匹配、形成环路或使用不可用算子,编译会失败,图形和已保存程序保持不变。

图文同步规则​

拖拽图与视觉 SCL 始终指向同一个视觉程序:

拖拽图 ─┐
├─→ 编译与校验 ─→ 当前有效视觉程序
视觉 SCL ┘
  • 在图中新增、删除或连接节点后,文本随有效程序更新。
  • 点击 应用视觉 SCL 且编译成功后,图形更新。
  • 只移动节点不会改变处理顺序。
  • 节点、参数、连线或 ACTION 的变化会改变程序行为。
  • 项目保存到 .dplc;保存定义只生成文本副本。

语言边界​

视觉 SCL 表达视觉流程,但不是通用编程环境。

可以使用不可使用或需先验证
字段、赋值和常用运算符操作系统、网络或任意外部代码
if、switch 和有上限的循环无上限循环和递归
当前工具箱中的视觉算子当前版本未开放的算子
项目中已配置的 PLC 数据绑定直接修改过程映像
已交付模型的推理结果字段在 ACTION 内训练、下载或装载模型

部署到另一台现场机前,应重新执行部署检查。工具箱中可编辑不代表目标设备已满足相机、模型和算力条件。

运行与状态​

视觉处理在 PLC 扫描周期之外执行:

  1. PLC 在扫描边界提交本次作业需要的输入。
  2. 视觉作业执行相机、算子和模型处理,PLC 不等待。
  3. 作业成功后,完整结果在后续扫描边界一次提交。
  4. 作业失败、取消或超时时,不提交不完整结果。

本地预览只处理 IDE 中打开的图像。只有连接现场 Runtime 后,在线作业和运行资源状态才有效。模型由 Darra AI Studio 导出,现场只消费已准备的 inference-only 会话。

常见诊断​

现象检查项
切回图后连接缺失检查节点、端口名、方向和数据类型
节点被拒绝检查算子是否在当前工具箱中,以及参数是否有效
PLC 数据绑定被拒绝从项目变量选择器重新绑定,并核对数据类型
循环被拒绝给循环设置明确上限
修改未保存查看第一条编译诊断;编译失败时不会替换有效程序
本地预览无结果确认已打开图像,并查看结果与诊断页
在线状态不可用先连接现场 Runtime;本地预览不产生在线状态
推理节点失败确认模型已交付且会话已准备;不要在 PLC IDE 内训练

算子参数在哪里查​

本页不重复算子签名。名称、参数、输入输出和状态码请查 算子总览 及各分类参考页。图形操作见 卡片图编辑器,运行与部署边界见 视觉运行时,模型引用见 模型消费。