# VizumCameraKit — 伟景(Vizum)结构光相机封装模块

从 Mark3DCalibration 抽出的可复用相机封装(2026-07-05 毕业为独立模块),
供多个项目共同引用,**本仓库是该封装的唯一正本**。

## 提供什么

- `StructuredLight::VizumCamera`(实现 `IStructuredLightCamera` 接口):
  设备扫描 `SearchCameras` / 连接 `Connect(ip)` / 左右目图像 `GetLeftImage` /
  摆镜点云 `CapturePointCloudWithAutoDetect` / 曝光增益 `Set/GetFloatParam("ExposureTime"/"Gain")` /
  内参畸变 `GetCameraMatrix` `GetDistortionCoeffs`
- **`SetCalibROIEnabled(true)`**(本模块新增):启用后 `GetLeftImage` 返回 SDK **矫正图**
- 使用共享 VzNL SDK `E:/02_Modules/10_Projects/Active/GrabBag/Device/SDK/VzNLSDK`
  (当前版本 `3.6.20.116`)，仓库内不再保存旧 SDK；header-only `spdlog` 仍在 `external`
- 日志宏与 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 到你的输出目录
# 可用 -DVIZUMKIT_VZNLSDK_DIR=... 覆盖共享 SDK 根目录
```

## 已知使用方

| 项目 | 状态 |
|---|---|
| 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) 即为正常
```