CommonLibraries/docs/PROGRESS.md

1.5 KiB

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 实机联调覆盖)。