UC3DStudio 常见问题（FAQ）

数据来源：《UC3DStudio 用户说明书》V1.38 §15「常见问题（FAQ）」与《终端用户快速指南》v1.0.29。

启动与连接

Q1. 双击软件无反应？
检查是否已有实例在运行（软件禁止多开）；检查杀毒软件是否拦截（右键 exe → 属性 → 解除锁定）。若提示「已在运行中」，说明已打开，勿重复启动。

Q2. 搜索不到传感器？
确认 USB 连接与供电；确认驱动（KSJXS SDK）已安装；连接状态下需先断开再重新搜索。软件启动不自动枚举设备，需通过 设备 → 传感器管理 → 搜索设备。

Q3. 软件启动默认是最大化 / 全屏？
是。启动默认为窗口最大化（保留标题栏与边框）；从最大化恢复后的默认 / 最小尺寸由 1600×900 / 最小 1320×720 控制。

Q4. 工具栏「传感器设置」与「设备 → 传感器管理」有什么区别？
「传感器设置」按钮是一键显示 / 隐藏左侧「传感器设置 / 滤波设置 / 补正设置」三个参数面板的总开关；「设备 → 传感器管理...」才是弹出设备连接对话框。

采集与显示

Q5. 采集看不到轮廓曲线？
确认数据格式选了「原始-3D数据」或「均匀X-3D数据」（不是「原图」），且中央在「轮廓」页签。

Q6. 原图显示上下颠倒 / 缩放后模糊？
上下翻转是默认行为（Y=0 在底部，与 3D 轮廓坐标一致），属正常显示；原图采用最近邻渲染，缩放不应模糊。

Q7. 趋势图曲线不真实 / 呈针状？
当前趋势图为逐点真实值折线（不降采样），离散档位测量的阶梯 / 平台为真实形态，属正常；曲线严格 1fps 重绘，高频采样不再抖动刷屏。

Q8. 连续测量数据与采集次数对不上？
趋势图 X 轴按采集维度推进（无数据帧也占一格），窗口默认 1000 次（可在「系统设置 → 趋势图 X轴默认宽度」调整）。各检测项仅在有数据帧才累加「次数」，故 X 最大值 ≥ 统计次数，差值即无数据帧数。

Q9. 中央视图比实际慢好几秒？
采集帧率远高于测量消费时会有积压：把「系统设置 → 图像 → 显示优先模式」切为「优先实时显示」（默认），曲线延迟 ≈1 帧；切为「优先标注同帧」时曲线随测量结果刷新、与标注严格同帧。状态栏会显示「积压 N 帧」辅助判断。

Q10. 状态栏「检测耗时」是什么？
单个工件（帧）的测量耗时，每完成一个重新计时；亚秒级显示毫秒（如 12.345ms）。

Q11. 遮住镜头后曲线一直不消失 / 空跑时统计不动？
v1.0.28 后续已修复：整帧无有效数据（未采集 / 激光未出光）只记「无数据」，不计入 OK / NG 与统计次数，也不保存轮廓；连续约 3 个显示周期无效才清空曲线并显示「无有效数据」。

Q12. 外触发模式点「开始采集」后提示「无有效数据」？
v1.0.29 后续已修复：等待触发信号期间不返回帧，不再提示「无有效数据」（只有真实返回了轮廓帧却取不到有效点才提示）。

Q13. 工具栏按钮太多 / 想换顺序？
编辑软件目录里的 config.ini，在 [Toolbar] 的 Buttons 按顺序列出要显示的按钮 key，未列出的即隐藏（改完重启软件）。详见「界面总览与工具栏配置」一篇。

ROI 与定位关联

Q14. 轮廓图上按住左键拖不出 ROI 框了？
绘制必须由右键菜单发起：在空白处右键 → 添加矩形ROI / 添加圆形ROI，画布左上角出现蓝色提示横幅后，再按左键拖拽落笔。按 Esc 取消。这样设计是为了避免拖动视图时误建 ROI。

Q15. 加载项目（或开机自动加载）后 ROI 不对？
加载时预填面板，连接设备后按 800ms × 至多 8 轮回读设备真值校验并自动重下发。排查步骤：① 确认只运行了一个 UC3DStudio 实例；② 手动点一次「应用ROI」；③ 开启「系统设置 → 调试日志」，看 log/debug_*.log。

另注：切换数据格式会触发传感器内部重配置并可能重置像素 ROI，切完格式后如 ROI 变全幅，重新「应用ROI」即可。

Q16. 开了定位关联（跟随），ROI 越跟越偏？
先排查：① 源 ROI 是否太窄 —— 源值只在源 ROI 的捕获范围内有效，工件漂移出界后源值不会报错而是静默输出错误位置；② 限位 / 死区是否设置合理；③ 跟随延迟为 1 帧属正常。把源 ROI 加宽到大于工件可能漂移的范围。

Q17. 先创建检测工具再绘制 ROI，ROI 列表不更新？
特定创建顺序下列表可能不刷新。规避方法：先绘制 ROI 再创建工具，或切换页面后返回。

测量与调参

Q18. 拐点定位在连续采集时逐帧跳动？
这是相对阈值（判定强度% × 本帧最大弯折量）随帧自适应导致的漂移。在对应点源的提取参数行开启「去趋势」（如 61）并设「弯折阈值」（如 0.6 mm⁻¹），改用绝对阈值判定，跨帧稳定。

Q19. 宽度测量有「点到点 / 外轮廓 / 开口检测」三种检测方式？
「点到点」按左右点源算两点距离；「外轮廓」取 ROI 内实体最外侧 X 跨距（横向工件整体宽度）；「开口检测」自动识别深槽 / 空隙型开口宽度。后两种可调「弧形容差」。

Q20. 「位置检测」测量类型怎么用？
复用宽度测量的点源提取算法（峰值 / 谷值 / 边缘 / 手动 / 最左点 / 平均点 / 最右点 / 拐点），在检测区内提取一个特征点并输出其 X/Z 坐标。

边缘点源（第 N 个交点）：轮廓与参考线可能相交多次，由两个参数决定取哪一个——

• 交点序号（1~20，默认 1）：取编号方向上的第 N 个交点；序号超过实际交点总数时回退到第 1 个（不判 NG）；
• 编号方向（正向 = 左→右 / 反向 = 右→左）：与拐点点源共用，决定交点按 X 递增还是递减编号。

配置面板在选中边缘点源后会显示实测提示「当前轮廓与参考线共 N 个交点」，便于确认序号是否越界。

Q21. 直径测量（圆拟合）结果偏大 / 逐帧跳动，怎么调？
先判断误差来源，再对应调参：

详见「直径测量与抗端部误差参数」一篇。

Q22. 多台传感器拼接后，圆的直径只拟合了一段弧？
2026-09-30 起直径测量会自动识别多段圆弧并联合拟合出一个圆（无需任何参数）；叠加层顶部与配置面板「实测:」提示会显示「轮廓 N 段（联合拟合）」。

Q23. 多台拼接后开了默认滤波，点云只剩很少几个点？
这是同一 X 处多层点交错导致滑窗滤波器混层（2026-09-29 前的老问题）。现在软件会自动按 Z 层聚类、在层内分别滤波再按 X 归并，无需手工调整。

Q24. 改了测量参数但图上没反应？
位置 / 高度 / 角度 / 平面度 / 直径 / 宽度等类型都带调参可视化叠加层：选中检测项进入配置面板，图上会画出 ROI、拟合线 / 圆、阈值线、候选点与被剔除点。若整片空白，先点一次「测量」把当前面板参数下发。

Q25. 整帧报「无数据」？
激光未出光 / 无料 / 全无效点（-1000）。此口径不计次数 / OK / NG，先查采集与触发，不是测量参数问题。

滤波、补正与项目文件

Q26. 补偿 / 滤波开关时偶见一帧乱点？
已修复：数据重置与时间轴历史清理已处理；若仍偶发请更新到最新版本。

Q27. 启动 / 新建项目后滤波器列表是空的？
2026-10-13 起为正常设计：启动默认与新建项目都不预置任何滤波项（列表空 = 不做任何滤波，原始轮廓直通）。需要轻度降噪时点「重置默认」按钮，或从「+ 添加」手动加；加载工程 / 导入参数文件会按文件恢复滤波链。

Q28. 保存的参数文件里 ROI 是 0？
已在 2026-10-12 修复（设备 ROI 读取失败会自动回落到面板值并在日志留痕）；若仍出现请开「系统设置 → 调试日志」，把日志与 XML 一并发回。

Q29. 加载参数后滤波好像没变化？
已在 2026-10-12 修复：导入时会按文件里的滤波项与顺序重建滤波链并立即生效。

Q30. 换了台传感器 / 想让 XSShow3D 和本软件用同一套设置？
「传感器管理 → 保存参数」会导出一份 XSShow3D 格式的参数文件（param_<型号>.xml，含传感器参数 + 滤波配置 + 平面补正矩阵），直接拿给 XSShow3D 用；拿到对方的参数文件后点「加载参数」即可导入。详见「传感器参数保存与 XSShow3D 互通」一篇。

Q31. 我的项目文件（.uc3dproj）怎么只有一份，而且不在项目文件夹里？
2026-09-30 起项目文件采用唯一化布局：.uc3dproj 只保留一份、固定在项目文件夹的上级目录（projects/<项目名>.uc3dproj）。

Q32. 关闭软件时没有提示保存，是不是没生效？
提示只在改动了会写入项目文件的内容时出现（ROI / 检测项 / 滤波 / 补正 / 系统设置）。传感器硬件参数（曝光、增益、激光模式、触发、分辨率、相机像素 ROI）与通讯配置不保存在项目文件里，改动它们不会弹窗。

Q33. 新建项目后 PCD 路径、传感器连接记录会丢吗？
不会丢。「新建项目」会把中央视图清空，同时把当前 PCD 文件路径与传感器管理槽位记录（序列号 / 配置文件）写进新项目文件，下次打开该项目时「打开PCD文件」与「传感器管理」对话框自动预填；但新建后数据源是在线（连传感器），要离线看旧点云请手动「打开PCD文件」。

Q34. 连续测量停了又测，数据没清零？
正常设计：点「重置统计」才清零。

授权、通讯与高级模块

Q35. 通道 / 圆度 / 板型面板不见了？
这些是授权功能：板型检测（视图 → 板型检测 Ctrl+6）、圆度测量（Ctrl+8）、多相机拼接、通讯输出（Ctrl+7）。未授权时面板不显示；导入含对应功能键的 license.dat 后即时解锁，无需重启。

Q36. 导入 license.dat 提示「未知错误」？
已修复（覆盖导入），请更新软件后再试；若提示「机器码不一致」，说明授权文件绑定的是另一台机器。

Q37. 通讯输出（Modbus / TCP Client）收不到数据？
通讯输出为授权功能，需导入含 comm 的 license（未授权时面板不显示）。授权后，检测结果（检测流程 / 单次 / 连续各路径）均会自动推送，无需手动触发。

Q38. 通讯发了 STR，为什么相机没出图？
STR / STP 只控制检测流程，不控制传感器采集。要采集与测量同时运行，需依次下发 CS（开始采集）→ STR（开始连续测量）；反过来 CE 不会停止测量、STP 也不会停止采集。

Q39. 板型检测采样数值与轮廓显示不一致？
箔材采样已接入与显示一致的滤波 + 补正管线，平均的是「滤波 + 补正后的真实物理帧」。若仍不一致，请重新采样。

Q40. 加载 PCD 后想一帧一帧仔细看？
工具栏有「上一帧」「下一帧」「帧 N + 跳转」三件套（加载 PCD 后才出现）：点一下看一帧，输入帧号按回车或点「跳转」直达。播放中按它会先自动停止播放再停在该帧。

Q41. 没打开 PCD 时工具栏找不到「上一帧 / 下一帧 / 跳转」？
正常现象：「上一帧 / 下一帧 / 帧号框 / 跳转」只在加载 PCD 后才会出现在工具栏上，退出 PCD 回放后自动隐藏，避免工具栏留下一排点不动的灰按钮。

Q42. 点「连续测量」是不是也要先点「开始采集」？
不用。v1.37 起「连续测量」已自动关联：点它就会先开始采集、再开始连续检测；再点一次则先停采集、再停检测（保证最后一帧不丢）。没添加检测项时只弹提示、不会启动采集。