OOOSplat v0.4.1
Pre-release
Pre-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.plydo 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