UC3DStudio 传感器参数保存与 XSShow3D 互通

版本 1.0 · 更新于 2026-10-21 · 阅读 0

按 XSShow3D 原生格式导出/导入参数文件(含传感器参数、滤波链、平面补正矩阵),实现两套软件参数互通(说明书 V1.38 §5.4)。

数据来源:《UC3DStudio 用户说明书》V1.38 §5.4「参数保存」。

传感器管理面板提供 保存参数 / 加载参数 按钮,按 XSShow3D 原生参数文件格式(param_<型号>_<时间戳>.xml)导出 / 导入,与 XSShow3D 双向互通。

文件结构(多根伪 XML,含三段)

节点 承载内容
<CameraParam> 传感器参数:像素 ROI(X/Y/W/H)、曝光 ExpTime、增益 Gain、亮度阈值 Threshold / ThresholdLow / ThresholdWidth、多峰模式、数据格式 DataFormat、轮廓数 ProfileNum、起始 / 数据触发(模式、滤波、延迟、分频、内部频率、编码器方向与反向)、激光模式与功率、均匀X分辨率 UniformXRes、UxZ 阈值、图像超时等
<UC3DAlg> 算法配置:<Filter><FilterList> 下恒写出全部 9 个滤波节点(均值、中值、形状保持、高斯、低通、高通、异常值去除、时间轴、轮廓补点);每个节点第一个子元素为 <Enabled>0 或 1</Enabled>(0 = 不生效,1 = 生效);节点排列顺序 = 「滤波器执行顺序」列表的顺序,列表未包含的滤波按标准执行顺序追加在后
<Convert><Matrix> 平面补正 4×4 齐次变换矩阵(行优先、7 位小数);<TYPE> 为启用位(0 = 不启用)

保存参数

读取当前设备参数 + 当前滤波链(取面板实时值)+ 当前平面补正矩阵,一次性写出上述格式;文件名默认 param_<型号>_<时间戳>.xml。

加载参数

解析文件后:

  • 传感器参数逐条下发设备(下发顺序由内部保证:数据格式 → 均匀X分辨率 → 像素 ROI → 其余);
  • 滤波链与平面补正矩阵回填软件;
  • 导入时按文件里的滤波项与顺序重建滤波链并立即生效(未出现的一律关闭)。

设计要点与兼容性

  • 滤波链落盘口径(2026-10-13 修订):文件固定包含全部 9 个滤波节点,排列顺序与「滤波器执行顺序」列表一致,每项用 <Enabled>1 / 0</Enabled> 标注是否生效。
  • <ROI> 不会写出全零(2026-10-12 修复):设备侧 ROI 读取在部分状态(采集中 / ROI 读上下文未建立)会失败,此前会静默跳过 ROI 四项导致文件缺项,现改为失败时回落到面板值并在日志留痕。
  • 写出格式与 XSShow3D 样例逐字节对齐(2026-10-12):矩阵第 4 行末值紧跟结束标签(中间无空格 / 换行);曝光、分辨率等数值统一 9 位有效数字。
  • 其余厂商专有节点(APIParam、ZMap 范围、SavePath、图像预处理等)原样透传,保证「导入厂商文件 → 再导出」不丢配置。
  • 旧版 SDK 原生参数文件(KSJXS_Save/LoadParamToFile)路径保留为内部回退。
  • 左侧「传感器设置 → 设备连接」面板的同名按钮行为与传感器管理面板一致。

⚠️ 改动前请确认设备已连接;保存 / 加载参数期间请勿切换数据格式。