Visionary

Visionary 是一个基于 WebGPU 和 ONNX Runtime 构建的开放、原生 Web 平台，支持在浏览器中实时渲染多种 Gaussian Splatting 变体（3DGS、MLP-based 3DGS、4DGS、Neural Avatars 以及任何未来的算法），并可直接渲染传统 3D Mesh；同时支持使用前馈网络进行后处理。

特性

• 原生 WebGPU 驱动：利用 WebGPU 实现百万级高斯粒子的高性能并行排序与渲染。
• 混合渲染架构：自动处理高斯点云与标准 Mesh 的深度混合（Depth Compositing），完美解决遮挡问题，支持复杂的场景组合。
• 统一资源加载 (Universal Loader)：单一接口智能识别并加载多种格式：
  • 静态高斯: PLY, SPLAT, KSplat, SPZ, SOG
  • 标准模型: GLB, GLTF, FBX, OBJ
  • 4DGS/Avatar/scaffold-GS: ONNX
  • 自定义算法: 导出您自己的算法至 ONNX 格式

---

文档导航

入门指南

• 快速开始 (Quick Start)
  了解如何安装依赖、启动演示项目以及自定义模型配置。

开发指导

1. 核心基础 (Core Foundations)

构建应用基础。本章涵盖：

• 环境初始化：配置 ONNX Runtime (ORT) 与 WebGPU 上下文。
• 统一加载器：详解 loadUnifiedModel 接口与智能文件格式检测机制。
• 资源管理：Gaussian 渲染器的复用策略与内存管理。

2. 场景对象与交互 (Object & Interaction)

掌握模型控制。本章涵盖：

• 高斯对象 (GaussianModel)：属性控制（缩放、透明度、裁剪）。
• 4D 动画：时间轴控制、播放/暂停与动态推理更新。

3. 渲染管线 (Rendering Pipeline)

深入引擎底层。本章涵盖：

• 混合渲染循环：理解 Scene Pass -> Depth Capture -> Splatting 的执行顺序。
• GaussianThreeJSRenderer：核心渲染协调器的 API 详解。
• 深度与遮挡：自动深度模式 (Auto Depth Mode) 的工作原理。

模块参考

深入查阅特定功能模块的实现细节。文档分为两类：

• API 参考：详细的接口定义、参数说明与类型声明。
• 架构文档：系统设计原理、数据流向与核心逻辑图解。

查看完整模块参考了解所有可用模块。