凯视佳产品文档 产品文档与技术支持

UC3DStudio 系统设置与数据归档

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

系统设置 7 组配置项、数据保存与项目归档目录、自动保存 OK/NG 轮廓、免费与授权导出项一览（说明书 V1.38 §14）。

数据来源：《UC3DStudio 用户说明书》V1.38 §14「系统设置」与导出 / 归档章节。

菜单 系统 → 系统设置。设置对话框分 7 组，所有设置即时生效并持久化（QSettings），修改设置不会中断正在进行的采集 / 测量。

7 组设置项

分组 设置项 说明
测量结果显示设置 长度单位 微米(μm) / 毫米(mm) / 厘米(cm) / 米(m)，影响测量值与趋势图显示
数值精度 结果小数位（0-9 位，默认 3）
图像显示设置 轮廓点大小 1-5（轮廓曲线绘制点尺寸）
轮廓显示模式 连线 / 点
图像刷新频率 1-60 Hz（默认 30），即时改变显示定时器间隔
显示优先模式 优先实时显示（默认）：检测运行期曲线由显示定时器用最新帧驱动，中央视图延迟 ≈1 帧；优先标注同帧：曲线随测量结果刷新（标注与曲线严格同帧），高帧率积压时中央视图延迟增大
测量结果 CSV 保存 启用测量结果保存 开关；开启后连续测量自动落盘 CSV；检测运行中勾选会立即创建文件并开始记录（状态栏提示路径），取消勾选即收尾关闭
保存路径 结果 CSV 目录；已打开项目时实际写入 <项目目录>/Result（保存项目优先）
文件名格式 YYYYMMDD_HHmmss.csv
单个文件最大容量 1-1024 MB，超限自动新建文件
轮廓 / 点云保存 保存路径 PCD / 点云保存目录（默认 软件目录 data）；已打开项目时实际写入 <项目目录>/DATA
自动保存 OK 轮廓 开关（默认关）；连续检测整帧判定 OK 时把当前单帧轮廓写入 <项目目录>/DATA/OK
自动保存 NG 轮廓 开关（默认关）；同上写入 DATA/NG；空数据帧计入 NG 但带防抖（一次丢数事件只落 1 帧）
累计统计数量 趋势图单系列历史容量 默认 10000，范围 100–10000000 条；限制趋势曲线 / 直方图保留的测量点数，超限滚动丢弃最早数据。只影响数据保留量，不改变 X 轴显示宽度
趋势图 X轴默认宽度 趋势图 X 轴默认显示的测量点数（默认 1000，范围 1–200000）
调试日志 启用调试日志 开关（默认关）；开启后记录运行日志到 log/debug_*.log（单文件 ≤10MB 自动轮转）
启用通讯调试日志 开关（默认关）；记录通讯模块收发追踪到 log/comm_debug_*.log
数据处理模式 处理模式 同步处理 / 异步队列处理
缓冲区大小 异步环形缓冲 1-65535 帧（默认 1024）
队列满时 丢弃旧帧（保最新）/ 丢弃新帧（保顺序）
批处理大小 1-65535 帧（默认 1024；1 = 实时，>1 批量提高吞吐）
处理线程数 0 = 自动（按 CPU 核心）/ 1-16 手动
同步帧缓冲 16-65535（同步模式环形缓冲深度）
  • 趋势图单位 / 精度、轮廓点大小 / 显示模式 / 刷新频率、异步队列配置、调试日志、累计统计数量均在点「应用」或「确定」后即时热生效，无需重启。
  • 显示优先模式：高帧率积压时状态栏显示「积压 N 帧(延迟≈X 秒)」辅助判断。

术语说明：启用趋势图 / 直方图统计

不需要趋势图 / 直方图时，可在「累计统计数量」分组中取消勾选「启用趋势图 / 直方图统计」（默认勾选）：

  • 关闭后不再累计与绘制曲线、不再重算直方图 / CPK；
  • 适合只看实时轮廓 + 统计、或高帧率连续检测时降低 CPU 占用；
  • 统计次数 / OK / NG、结果表、CSV 与轮廓显示不受影响；
  • 重新勾选后趋势数据从零重新累计（不补禁用期间的历史）。

数据保存位置与项目归档

状态 保存位置
已打开项目 点云存 <项目文件夹>/DATA；测量结果与导出存 <项目文件夹>/Result
未打开项目 软件目录 data 文件夹（可在「系统设置」中修改） 
projects/<项目名>.uc3dproj          ← 项目文件（全盘唯一一份，位于项目文件夹的上级目录）
projects/<项目名>/
├── DATA/OK、DATA/NG                ← 手动保存轮廓/点云 + 自动 OK/NG 轮廓
└── Result/                         ← 测量结果 CSV、趋势 CSV/PNG 等导出
  • CSV 采用 UTF-8 编码；连续测量跨停止 / 开始追加写入同一文件，点「重置统计」后才新建。
  • 停止采集 / 停止测量时自动排空在途帧再关文件，不会丢最后一帧。

导出与保存项一览

功能 入口 授权
保存轮廓（当前单帧） 工具栏 保存轮廓 免费
保存 3D 点云 工具栏 保存点云 免费
自动保存 OK/NG 轮廓 系统设置 → 轮廓/点云保存 免费
导出测量结果 测量工具 → 导出结果 免费
自动保存测量结果 系统设置 → 启用测量结果保存 免费
导出趋势 趋势图 → 导出CSV / 导出趋势·分布PNG 免费
导出板型报告 板型检测 → 导出 需授权
导出圆度截面 CSV 圆度测量 → 导出截面CSV 需授权
导出圆度半径图 圆度测量 → 导出半径图PNG 需授权