UC3DStudio 传感器参数保存与 XSShow3D 互通
按 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)路径保留为内部回退。 - 左侧「传感器设置 → 设备连接」面板的同名按钮行为与传感器管理面板一致。
⚠️ 改动前请确认设备已连接;保存 / 加载参数期间请勿切换数据格式。
这份文档对您有帮助吗?
发现错误、表述不清或缺少内容?请告诉我们,我们会尽快补充。
您可以通过以下方式反馈: 发送邮件至 service@catchbest.com