docs: define VisionGuide online demo
This commit is contained in:
@@ -0,0 +1,30 @@
|
||||
# VisionGuide 在线相机测试 Demo
|
||||
|
||||
## 目标
|
||||
|
||||
在 `E:/QTCode/ssp/demo` 创建独立的 qmake/C++17 控制台程序,通过 VisionGuideSDK 2.0 的纯 C ABI 验证真实双目相机、光源控制器、视觉资源和一次在线测量流程。Demo 不链接宿主 Qt,避免与 SDK 自带 Qt 运行库冲突。
|
||||
|
||||
## 范围
|
||||
|
||||
- 使用本机 Qt 套件附带的 MinGW 64 位工具链;SDK 调用边界只使用公开 C ABI。
|
||||
- 启动时检查 SDK API 版本、运行资源路径和初始化分项状态。
|
||||
- 无参数时在线初始化并连接左右相机,只完成初始化诊断;使用 `--measure` 才执行测量。
|
||||
- 使用 `--measure` 执行一次同步测量,输出 `VG_MeasurementResult` 的状态、类别、置信度、相机位姿和机器人位姿有效标志。
|
||||
- 使用 `--gold` 或 `--non-gold` 固定目标类别;默认使用任意类别仅用于诊断。
|
||||
- 测量成功时保存标注图和 JSON 结果到当前工作目录或 `--output-dir` 指定目录。
|
||||
- SDK 句柄只在主线程串行使用,退出时先断开相机/关闭光源,再销毁句柄。
|
||||
- 相机序列号和光源端口使用交付资料中的默认值:左 `GCQ25060290`、右 `GCQ25060284`、光源 `COM6`。
|
||||
|
||||
## 非目标
|
||||
|
||||
- 不修改主项目 `ssp.pro` 或 PLC/Modbus 流程。
|
||||
- 不实现生产判定、数据库落库、PLC 回写、OPC UA 或手眼标定流程。
|
||||
- 不补造缺失的 `.sm3` 3D 模型;资源缺失时明确输出诊断信息。
|
||||
|
||||
## 验收
|
||||
|
||||
1. MinGW 64 位 qmake 工具链能生成并链接 Demo,输出文件为 PE x86-64,导入表不包含宿主 Qt DLL。
|
||||
2. SDK 运行库完整时,`--version` 能输出 SDK API 版本。
|
||||
3. 无相机时,无参数运行能输出逐项初始化状态和错误文本,不崩溃。
|
||||
4. 连接真实硬件且资源完整时,`--measure` 能执行一次测量并输出结果文件。
|
||||
5. 初始化、测量或结果保存失败时返回非零退出码,并输出 SDK 返回码和 `VG_GetLastError`;结果结构提供消息时一并输出。
|
||||
Reference in New Issue
Block a user