ooolabdev/ooosplat

OOOSplat – 一键式桌面 3D Gaussian Splatting 工具

功能说明

• 将常规的 360° 视频或一系列照片文件夹转换为 3D Gaussian Splatting 模型（一种可从任何视角渲染的点云表示法）。
• 整个流程皆在本地执行 – 无需云端上传，无需远程 API。它整合了必要的工具（FFmpeg、COLMAP、Brush）并透过 React + Tauri 构建的图形界面进行管理。

为何重要

• Gaussian splatting 是一种新兴的神经图形技术，能从图像中产生高质量、可实时渲染的 3D 场景。目前正广泛应用于 VR/AR、游戏资产及视觉特效。
• OOOSplat 让非程序员也能轻松使用此技术：只需选择视频/文件夹，挑选质量预设（快速 / 平衡 / 精细），应用程序便会处理繁重的工作 – 帧提取、相机位姿重建、模型训练及 PLY 导出。

主要功能

功能	说明
一键生成	支持 MP4、MOV、JPG/PNG 序列。应用程序会自动提取帧、执行 COLMAP 进行运动结构恢复 (SfM)、使用 Brush 训练 Gaussian splat 模型，并自动写入 final.ply。
三种质量预设	快速（低分辨率，约 8k 次迭代）、平衡（中分辨率，约 15k 次迭代）、精细（高分辨率，最高 30k 次迭代）。应用程序会根据您的 GPU 内存自动调整帧率、分辨率和训练设置。
透明材质支持	处理 Alpha 通道的 MOV/PNG，为 COLMAP 生成黑白遮罩，确保透明对象得以保留。
多任务管理器	同时执行多个项目、查看实时进度、日志、硬件使用率，并支持暂停/取消及从检查点恢复。
本地 MCP (Model Control Protocol)	可选的本地 AI 代理接口（Codex 风格），可通过回环 HTTP 端点创建、启动、查询及取消任务。
编辑与预览	查看生成的 PLY，进行旋转/缩放/平移、选取并删除个别 Gaussian、撤销/重做，并导出编辑后的模型。
导出选项	导出垂直或水平 MP4 视频、单一文件离线 HTML 查看器 (WebGPU/WebGL2) 或原始 PLY 文件。
跨平台	提供 Windows 11 (x64)、Apple-Silicon macOS 15+ (Alpha) 及 Ubuntu 24.04 LTS (x86_64 Alpha) 的预编译二进制文件。
隐私优先	所有原始媒体、中间数据及模型皆保留在您的电脑上；仅发送可选的匿名遥测数据（不含媒体或路径）。

运作流程

1. 输入处理 – 使用 FFprobe 探测视频；FFmpeg 根据选择的 FPS 和分辨率提取帧。图像文件夹会自动排序。
2. COLMAP 重建 – 特征提取与匹配（若有 NVIDIA 显卡则使用 GPU 加速 CUDA，否则使用 CPU）。增量式 SfM 建立相机位姿与稀疏点云。
3. Brush 训练 – OOOBrush CLI 读取 COLMAP 输出，并在 GPU 上训练 Gaussian splat 模型（Windows/Linux 使用 Vulkan，Apple Silicon 使用 Metal）。
4. 验证与导出 – 验证产生的 final.ply 并写入项目文件夹。UI 随后可预览或进一步编辑模型。

系统需求

• Windows: Windows 11 x64, WebView2 runtime, 具备 CUDA 13.2+ 的 NVIDIA GPU（或 CPU 回退）。
• macOS: 仅限 Apple-Silicon (M1/M2…); 使用内置 Metal 后端，无 CUDA。
• Linux: Ubuntu 24.04 LTS x86_64; 需要 Vulkan 驱动程序进行 GPU 训练，否则仅限 CPU。
• 建议使用至少 8 GB VRAM 的 GPU 以进行精细预设；若内存不足，应用程序会自动降级。

典型工作流程

选择视频 / 图像文件夹 → 选择项目文件夹 → 选择质量预设 → 开始 →
   [FFmpeg 提取帧] → [COLMAP 建立相机位姿] → [Brush 训练 Gaussian splats] →
   final.ply 出现 → 预览 / 编辑 → 导出 (MP4, HTML, 或 PLY)

开发者笔记

• UI 为 React 19 前端，在 Tauri 2 窗口中渲染；后端为 Rust (Tokio async)。
• 引擎（FFmpeg, COLMAP, Brush）已打包并透过 npm run setup:engines 验证；自定义 COLMAP 分支与 Brush 的源代码位于同一个组织 (ooolabdev)。
• 提供诊断 CLI (splatstudio) 用于健康检查、帧规划以及从命令行执行完整流程。
• 构建脚本处理 Windows NSIS 安装程序、macOS 未签名 DMG 及 Debian 软件包。

适用对象

• 希望从手持 360° 视频产生 3D 资产，但不想学习命令行 SfM 工具的创作者。
• 需要可重现、GUI 驱动工作流程的 Gaussian-splatting 流程原型研究人员。
• 重视隐私（所有数据保留在本地）且对 VR/AR 内容创作感兴趣的爱好者。

---

总结: OOOSplat 是一款精致的跨平台桌面应用程序，将整个 Gaussian-splatting 工作流程（帧提取、相机重建、神经训练及导出）整合为一键操作，让任何拥有现代 PC 的人都能轻松使用尖端的神经渲染技术。