算子 API
左侧每个算子分类页列出该分类当前公开的算子名称、用途和可用状态。完整签名、参数、返回、限制和错误码以 api-reference/vision 各分类页为准。分类页不得把未在 API 参考中出现的名称写成可调用。
分类页规则
每个算子条目应给出:
| 内容 | 要求 |
|---|---|
| 名称 | 中文名称和稳定调用名称,且必须出现在对应 API 分类页 |
| 签名 | 与 API 参考一致的输入、输出和调用形式 |
| 参数 | 类型、必填性、默认值、范围和单位;细节以 API 分类页为准 |
| 返回 | 结果类型、标量摘要和富结果说明 |
| 失败 | 参数错误、资源不足和运行故障的明确语义 |
| 限制 | 输入格式、尺寸、资源和确定性边界 |
| 可用性 | 可执行或不可执行,以及所需运行条件 |
不得为未发布能力编写参数表或示例。只列编造名称、数量或“查看详情”链接的页面不是分类说明页。
当前公开可用
以下口径以 Windows 硬实时版、以及 api-reference/vision 已生成分类为准:
| 分类 | 当前公开能力 |
|---|---|
| 图像采集 | Input、Output;GigE Vision、USB3 Vision 需适配器并在目标设备验证 |
| 滤波 | 50 个滤波 API,全部可执行 |
| 图像处理 | 色彩空间、增强、白平衡、通道混合与伪彩色 |
| 几何变换 | 缩放、裁剪、旋转、仿射、透视及平面几何计算 |
| 图像变换 | 直角旋转、转置、重映射、多轴翻转和金字塔 |
| 形态学 | 阈值、连通域、骨架和区域运算 |
| 分割 | 前景、超像素、区域生长和聚类 |
| 轮廓 | Canny、轮廓提取、筛选、拟合和剖面 |
| 标定 | 针孔、鱼眼、手眼标定,棋盘格/圆点检测,畸变校正 |
| 匹配 | 模板、特征、形状和 ECC 配准 |
| 识别 | 模板、ArUco、Haar、配准和参考图差分 |
| 测量 | 47 个二维卡尺、拟合、距离和角度算子 |
| 一维码 / 二维码 | Code 128、EAN-13、UPC-A、QR、PDF417、Data Matrix、Aztec、MaxiCode |
| 缺陷检测 | 斑点、边缘、颗粒、表面和裂纹;参考图缺陷暂不可执行 |
| 光流 | Farneback、稀疏光流、运动历史和时序块匹配 |
| 统计 | 直方图、清晰度、局部统计和质量指标 |
| 霍夫 | 直线和圆检测 |
算子还必须通过目标运行环境的准入检查。编辑器能显示或编译参数合同,不等于现场运行环境一定可执行。
当前不可用
以下名称不得写成已交付:
- ONNX / AI 分类、检测、分割、异常检测运行时算子。
- OCR、深度学习 OCR 和文字训练引擎。
- 光度立体、从明暗/对焦恢复形状。
- 结构光解码、飞行时间和通用点云处理。
- 3D 表面匹配和抓取规划。
- 双目
StereoCalibrate、StereoBM、RectifyStereo(仅保留兼容合同)。 DisOpticalFlow。TEMPLATEDEFECT(参考图参数未进入公开合同)。- 双图像算术与逻辑(
Add、Subtract、AbsDiff等)作为独立视觉算子。 - GenTL 厂商插件和多相机同步。
- 图像拼接。
- 运行时模型训练、权重修改、模型保存或临时加载。
目录中出现名称、参数合同或编辑器节点,只能说明该条目可被识别;没有真实执行、资源准入和验证证据时,状态仍是不可用。未在 api-reference/vision 分类页出现的扩展名称,不能对外宣称可用。
图形与视觉 SCL
拖拽图和视觉 SCL 使用同一份算子语义:
- 图形节点和文本调用使用相同名称、参数和类型。
- 两种编辑方式编译到同一视觉程序,不维护两套行为。
- ACTION 是事件代码,不是图像算子分类。
- 模型导入、验证和审批属于模型工作台;本分类页没有已发布的 AI 推理算子。
运行条件
- 算子在对应 API 分类页标为可执行。
- 输入图像格式、尺寸、通道数和参数范围通过校验。
- 目标运行环境允许该算子并有足够资源。
- 运行时发生缺少资源、参数非法或后端不可用时明确失败,不返回原图、空结果或零值冒充成功。