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)

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) 即为正常