2026-07-05 20:56:20 -07:00
|
|
|
|
# VizumCameraKit — 伟景(Vizum)结构光相机封装模块
|
|
|
|
|
|
|
|
|
|
|
|
从 Mark3DCalibration 抽出的可复用相机封装(2026-07-05 毕业为独立模块),
|
|
|
|
|
|
供多个项目共同引用,**本仓库是该封装的唯一正本**。
|
|
|
|
|
|
|
|
|
|
|
|
## 提供什么
|
|
|
|
|
|
|
|
|
|
|
|
- `StructuredLight::VizumCamera`(实现 `IStructuredLightCamera` 接口):
|
|
|
|
|
|
设备扫描 `SearchCameras` / 连接 `Connect(ip)` / 左右目图像 `GetLeftImage` /
|
|
|
|
|
|
摆镜点云 `CapturePointCloudWithAutoDetect` / 曝光增益 `Set/GetFloatParam("ExposureTime"/"Gain")` /
|
|
|
|
|
|
内参畸变 `GetCameraMatrix` `GetDistortionCoeffs`
|
|
|
|
|
|
- **`SetCalibROIEnabled(true)`**(本模块新增):启用后 `GetLeftImage` 返回 SDK **矫正图**
|
2026-08-26 16:13:44 +08:00
|
|
|
|
- 使用共享 VzNL SDK `E:/02_Modules/10_Projects/Active/GrabBag/Device/SDK/VzNLSDK`
|
|
|
|
|
|
(当前版本 `3.6.20.116`)，仓库内不再保存旧 SDK；header-only `spdlog` 仍在 `external`
|
2026-07-05 20:56:20 -07:00
|
|
|
|
- 日志宏与 Mark3DCalibration 一致(LOG_INFO 等),但**不依赖 Qt**
|
|
|
|
|
|
|
|
|
|
|
|
## 使用方式(CMake)
|
|
|
|
|
|
|
|
|
|
|
|
```cmake
|
|
|
|
|
|
add_subdirectory(path/to/VizumCameraKit) # 或 FetchContent/子模块
|
|
|
|
|
|
target_link_libraries(your_app PRIVATE VizumCameraKit)
|
|
|
|
|
|
# 运行时 DLL:从 ${VIZUMKIT_DLL_DIR} POST_BUILD copy_if_different 到你的输出目录
|
2026-08-26 16:13:44 +08:00
|
|
|
|
# 可用 -DVIZUMKIT_VZNLSDK_DIR=... 覆盖共享 SDK 根目录
|
2026-07-05 20:56:20 -07:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 已知使用方
|
|
|
|
|
|
|
|
|
|
|
|
| 项目 | 状态 |
|
|
|
|
|
|
|---|---|
|
|
|
|
|
|
| MatchVerify(海瑞马 电机转子钢芯) | 使用中 |
|
|
|
|
|
|
| Mark3DCalibration | 原始出处,尚未切换到本模块(其内部副本仍在用) |
|
|
|
|
|
|
|
|
|
|
|
|
## 冒烟测试
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
cmake -B build -G "Visual Studio 17 2022" -A x64
|
|
|
|
|
|
cmake --build build --config Release
|
|
|
|
|
|
build/Release/kit_smoke.exe # 无相机时打印 found 0 device(s) 即为正常
|
|
|
|
|
|
```
|
