Skip to content

OOOSplat v0.4.1

Pre-release
Pre-release

Choose a tag to compare

@ooolabdev ooolabdev released this 13 Sep 17:39
· 3 commits to main since this release

OOOSplat 0.4.1 是一次稳定性与体验更新,重点改进任务失败后的处理指引、预览资源恢复、流水线状态展示以及 Gaussian 裁切操作。

主要更新

更易理解的失败指引

  • COLMAP 无法完成空间重建时,会使用通俗语言说明可能原因,包括移动过快、画面模糊、相邻画面重叠不足或运动物体过多。
  • Brush 训练失败时,会区分显卡驱动、显卡资源不足和项目图片读取不完整等情况。
  • 失败弹窗支持:
    • 从断点重新尝试。
    • 直接打开任务日志。
    • 展开查看原始错误信息。
  • 用户主动取消任务时不会显示失败弹窗。

预览与文件操作稳定性

  • 修复应用长时间运行并退出预览后,“预览”“删除”和“在文件管理器中显示”偶尔失效的问题。
  • 预览退出采用独立会话管理和超时恢复机制。
  • 即使资源清理出现异常,界面也会在 8 秒后自动恢复,不再需要重启应用。
  • 迟到的旧预览回调不会影响新打开的预览。
  • 项目目录和日志目录改由后端校验后打开,操作失败时会给出明确提示。

任务进度与日志修复

  • 任务失败或取消时,进度不再错误跳到 100%。
  • 时间线会准确标记发生失败或取消的阶段。
  • 修复日志达到 500 条后停止自动滚动的问题。
  • 查看旧日志时会暂停自动跟随,滚动到底部后自动恢复。
  • 新日志不再带动整个任务页面滚动到底部。
  • 选择新的输入素材后,会清空上一任务的实时进程和日志;新素材的分析提示、透明通道提示和错误信息仍会正常显示。

结果与断点可靠性

  • 生成完成后增加结果卡,显示 Gaussian 数量、PLY 大小、注册图像数量、三维点数量和总耗时。
  • 注册率低于 80% 时,会在结果卡和历史任务中持续显示质量提醒。
  • 失败或取消不会清除已经完成的阶段检查点。
  • 修复完成记录与 final.ply 不一致时的状态判断。
  • 加强中断发布后的结果恢复,并使用原子替换降低文件损坏风险。

Gaussian 裁切体验

  • 球形半径和盒形尺寸不再错误受 1000 上限限制。
  • 当裁切范围大于 1000 时,拖动数值会从当前真实值平滑变化,不再突然降至 1000 以下。
  • 支持最大 1e12 的合法裁切尺寸。
  • 非法输入会恢复为上一次有效值并显示提示。
  • 极大或极小的数值会使用紧凑的科学计数法显示。
  • 模型 Transform 缩放仍保持原有的 0.001–1000 安全范围。

其他稳定性改进

  • 改进大型 PLY 文件头解析,支持合法短读、LF/CRLF 和不同属性间距。
  • 改进 Windows 外部进程终止流程,降低取消任务后残留子进程的可能性。
  • 视频信息读取现在可以随任务正常取消。
  • 优化稀疏重建结果检查,避免阻塞界面运行线程。
  • 保留更完整的 COLMAP 与 Brush 错误末尾信息,方便定位问题。

兼容性

现有项目、final.ply、断点数据和 Gaussian 编辑状态可继续使用,无需迁移。

  • Windows:Windows 11 x64
  • macOS:macOS 15 及以上,Apple Silicon
  • Linux:Ubuntu 24.04 LTS x86_64

安装包

请根据系统下载对应文件:

  • Windows:OOOSplat-0.4.1-x64-windows.exe
  • macOS Apple Silicon:OOOSplat-0.4.1-arm64-macos.dmg
  • Ubuntu 24.04:OOOSplat-0.4.1-x64-linux.deb

建议现有用户升级到 0.4.1,以获得更可靠的任务恢复、预览关闭和失败处理体验。

完整变更: 0.4.0...0.4.1

OOOSplat 0.4.1 is a stability and usability update focused on clearer failure guidance, reliable preview cleanup, accurate pipeline status, and smoother Gaussian crop editing.

Highlights

Clearer failure guidance

  • Added user-friendly guidance when COLMAP cannot reconstruct the captured space.
  • Common causes such as fast camera movement, blurry images, insufficient overlap, and moving objects are now explained in plain language.
  • Brush failures now distinguish graphics-card issues from incomplete or damaged project files.
  • Failure dialogs provide:
    • Retry from the latest valid checkpoint.
    • Open the task log folder.
    • Expandable original error details.
  • Manually cancelled tasks do not trigger failure dialogs.

More reliable preview and file operations

  • Fixed an issue where Preview, Delete, and Show in File Manager could occasionally stop responding after the application had been running for a long time.
  • Added explicit preview-session management and an 8-second recovery watchdog.
  • The interface now unlocks automatically if preview cleanup takes too long.
  • Late callbacks from old preview sessions no longer affect newly opened previews.
  • Project and log folders are validated by the backend before being opened, with visible feedback when an operation fails.

Pipeline progress and log fixes

  • Failed or cancelled tasks no longer incorrectly jump to 100%.
  • The timeline now identifies the actual failed or cancelled stage.
  • Fixed automatic log scrolling after the 500-entry limit is reached.
  • Auto-follow pauses while the user reads older logs and resumes after returning to the bottom.
  • New log entries no longer scroll the entire task panel.
  • Selecting new input media clears the previous task’s live progress and logs, while new analysis notices and errors remain visible.

Results and checkpoint reliability

  • Added a completion card showing:
    • Gaussian count.
    • PLY file size.
    • Registered image count.
    • 3D point count.
    • Total processing time.
  • Projects with a registration rate below 80% retain a visible quality warning in both the result card and task history.
  • Failed and cancelled runs preserve completed stage checkpoints.
  • Improved handling when completion metadata and final.ply do not match.
  • Interrupted result publishing can recover valid output candidates.
  • Final PLY publishing now uses safer atomic replacement.

Improved Gaussian crop editing

  • Sphere radius and box dimensions are no longer incorrectly limited to 1000.
  • Values above 1000 now change smoothly from their actual value instead of snapping below the old limit.
  • Crop dimensions support valid values up to 1e12.
  • Invalid input restores the last valid value and displays a field-level warning.
  • Very large or very small values use compact scientific notation.
  • Model Transform scale keeps its existing safe range of 0.001–1000.

Additional stability improvements

  • Improved PLY header parsing for valid short reads, LF/CRLF line endings, and flexible property spacing.
  • Improved Windows child-process cleanup when cancelling a task.
  • Video probing can now be cancelled with the active pipeline.
  • Sparse-reconstruction validation no longer blocks the asynchronous runtime.
  • COLMAP and Brush errors retain a bounded tail of their original output for easier troubleshooting.

Compatibility

Existing projects, final.ply files, checkpoints, and Gaussian edit states remain compatible. No migration is required.

  • Windows: Windows 11 x64
  • macOS: macOS 15 or later on Apple Silicon
  • Linux: Ubuntu 24.04 LTS x86_64

Downloads

Choose the package for your operating system:

  • Windows: OOOSplat-0.4.1-x64-windows.exe
  • macOS Apple Silicon: OOOSplat-0.4.1-arm64-macos.dmg
  • Ubuntu 24.04: OOOSplat-0.4.1-x64-linux.deb

Existing users are encouraged to upgrade to 0.4.1 for more reliable task recovery, preview cleanup, and failure handling.

Full changelog: 0.4.0...0.4.1