CommonLibraries/README.md

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

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

提供什么

• StructuredLight::VizumCamera(实现 IStructuredLightCamera 接口): 设备扫描 SearchCameras / 连接 Connect(ip) / 左右目图像 GetLeftImage / 摆镜点云 CapturePointCloudWithAutoDetect / 曝光增益 Set/GetFloatParam("ExposureTime"/"Gain") / 内参畸变 GetCameraMatrix GetDistortionCoeffs
• SetCalibROIEnabled(true)(本模块新增):启用后 GetLeftImage 返回 SDK 矫正图
• 自带 external/VzNLSDK(含 lib 与运行时 DLL)与 header-only spdlog
• 日志宏与 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 到你的输出目录

已知使用方

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