# VizumCameraKit 进度

### 2026-07-05 模块建立(从 Mark3DCalibration 毕业)

Scope:
- 从 Mark3DCalibration 抽出最小集:`VizumCamera.h/.cpp`(src/modules/device/vizum)、
  `IStructuredLightCamera.h`、`core/StructuredLightTypes.h`(均零修改拷入,
  保持与原工程可对照);`external/VzNLSDK`(98MB 全量)与 header-only spdlog 一并拷入。
- `utils/Logger.h` 重写为无 Qt 版本(仅去掉 QString fmt 特化,宏接口与原版一致),
  使 VizumCamera.cpp 无需任何改动即可编译。
- 新增 `VizumCamera::SetCalibROIEnabled(bool)`:封装 VzNL_EnableCalibROI,
  启用后 GetLeftImage 返回 SDK 矫正图(MatchVerify 需求)。这是本模块相对
  Mark3DCalibration 原版的唯一功能性差异。
- CMake:静态库 VizumCameraKit(PUBLIC 传递 include/ENABLE_VIZUM_CAMERA/链接)、
  VIZUMKIT_DLL_DIR 缓存变量供使用方拷 DLL、kit_smoke 冒烟测试目标。

Verification:
```
cmake + VS2022 x64 Release 编译 -> VizumCameraKit.lib / kit_smoke.exe 生成
kit_smoke.exe(无相机) -> SDK initialized -> SearchCameras found 0 -> SDK destroyed,退出码0
VzNL 运行时 DLL 由 POST_BUILD 自动拷入输出目录(VzKernel/VzLog/VzNLDetect/VzNLGraphics 等)
```

Limits / Deferred:
- Mark3DCalibration 尚未切换到本模块(其内部副本仍在用),两份代码暂时并存;
  切换迁移放到 MatchVerify 交付后单独做,避免影响其在途 WIP。
- 无远程仓库,待用户提供 Gitee/内网 git 地址后推送。
- SearchCameras/Connect/采集链路未连真机验证(S2 实机联调覆盖)。