OOOSplat v0.4.1

[ooolabdev]

OOOSplat 0.4.1

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

---

This discussion was created from the release OOOSplat v0.4.1.