3DGS & 粒子点云可视化系统

3DGS & Particle Point Cloud Viewer

用户操作与使用指南手册

User Operations & Guidelines Manual

📂 1. 快速入门：加载 3D 模型

📂 1. Quick Start: Loading 3D Models

系统支持从网络分享链接或本地 PLY、Splat、SplatV 文件加载 3DGS/4DGS 高斯泼溅与常规三维点云模型：

The system supports directly fetching and rendering 3DGS/4DGS Gaussian Splatting and regular 3D point cloud models from online share URLs or local PLY, Splat, and SplatV files:

通过分享链接加载：在首页中央的 AI 对话输入框（或者在模型加载后的顶部菜单栏）粘贴 Remy3D 或 Kiri Engine 分享地址（如 https://remy3d.com/share/...），然后点击 Load 按钮。系统会启动内置代理自动解析并加载模型。
加载本地文件：点击顶部的上传模型，选择 .ply、.splat 或 4DGS .splatv 文件。

Load via Share Link: Paste a Remy3D or Kiri Engine share URL (e.g., https://remy3d.com/share/...) in the centered AI input box (or in the top toolbar after loading), then click the Load button. The system automatically fetches, parses, and loads the model.
Load a Local File: Click Upload Model in the toolbar and choose a .ply, .splat, or 4DGS .splatv file.

🖱️ 2. 基础操作：场景视角与常规调节

🖱️ 2. Basic Operations: Viewport & Adjustments

视角旋转：在 3D 画布区域，按住 鼠标左键 并拖拽。
视角平移：按住 鼠标右键 并拖拽。
场景缩放：滚动 鼠标中键滚轮。系统支持极小距离缩放，可将视角拉得极近来观测模型微小细节。
初始视角自动缩放对齐：当模型加载时，无论背景切割设置多大，默认视角都会精准缩放对齐到主体的 1x radius 距离，让人物面部或物体核心细节直接贴近屏幕中央。
渲染引擎切换与背景裁剪规则：
- ✨ 3D/4D 实景模式：使用 HoloEngineRuntime 渲染高保真 3DGS，并播放 4DGS .splatv 动画。在此模式下，系统将保留 100% 完整的原始背景和环境内容（无裁剪），并自动拉伸相机的远截面（Far Clip），保证宏大背景不会被截断。
- ☁️ Point Cloud 模式：展现充满未来科技感的荧光圆点粒子状态。在此模式下，系统默认将背景点云控制在干净的 2.5x 模型半径内，完美剔除环境噪点。

Rotate View: Press and hold the Left Mouse Button and drag on the 3D canvas area.
Pan View: Press and hold the Right Mouse Button and drag.
Zooming: Scroll the Middle Mouse Wheel. The system supports micro-distance zooming, allowing you to get extremely close to observe fine details of the model.
Initial Auto-Fit Zoom: When a model loads, regardless of the background filter radius, the default camera will accurately align and fit to a 1x radius distance of the model's centroid, placing the subject directly in the center at close range.
Toggle Render Mode & Clipping Rules:
- ✨ 3D/4D Reality Mode: HoloEngineRuntime renders high-fidelity 3DGS and animated 4DGS .splatv. This mode keeps 100% of the raw background environment (no cropping) and extends the camera's far clip plane to prevent distant scenes from being cut off.
- ☁️ Point Cloud Mode: Renders glowing holographic-style floating point cloud particles. Under this mode, the background is automatically filtered to a clean 2.5x model radius to exclude messy environmental noise points.

🎥 3. 电影级运镜录制与 15 套内置闭环运镜预设

🎥 3. Cinematic Flight Path Recording & 15 Built-in Presets

点击顶部 🎥 Camera Path 开启运镜控制台，录制属于您的电影航拍视频：

Click the 🎥 Camera Path button at the top to open the flight path console and record your own aerial tracking videos:

🚀 新增：15 套 GSAP 复合型闭环运镜

我们内置了 15 套高级运镜预设（包含 Dolly Zoom 希区柯克滑动变焦、8字形无限循环、螺旋上升收缩、钟摆等）。这些预设轨迹完全基于您当前的缩放大小（Zoom）与仰角（Pitch）动态计算，且运行期间支持鼠标右键拖拽实时平移运镜轴心。

🚀 New: 15 Built-in GSAP Closed Loop Flight Paths

We have integrated 15 advanced camera flight presets (e.g., Hitchcock Dolly Zoom, Figure-8 loop, spiral ascending, pendulum). These trajectories are dynamically calculated based on your current Zoom level and Pitch angle, and support real-time panning of the tracking center with the right mouse button.

使用内置运镜预设：在 Flight Path Preset 下拉菜单中选择一套内置运镜（如 Hitchcock Dolly Zoom），点击 ▶️ Preview 即可开始预览。在预览运行期间，网页会自动锁定页面缩放防误触。
自定义记录关键帧：选择 None (Custom Keyframes) 模式下，调整视角后点击 ➕ Add Keyframe 增加第一视角（支持 2 ~ 8 个关键帧），并点击 ▶️ Preview 沿轨迹平滑飞行。
60帧导出视频：无论选择预设还是自定义路径，点击 📹 Export 1080p MP4 都会自动启用离屏 1080p 渲染并生成匀速 60fps MP4 视频，录制完将自动触发浏览器下载。

Built-in Presets: Select a flight path preset from the Flight Path Preset dropdown (e.g., Hitchcock Dolly Zoom), then click ▶️ Preview to begin. During the preview, page zoom controls are locked to avoid misclicks.
Custom Keyframes: Under the None (Custom Keyframes) mode, adjust your viewpoint, click ➕ Add Keyframe (supports 2 to 5 frames), and click ▶️ Preview to fly smoothly along your custom path.
60FPS Video Export: Click 📹 Export 1080p MP4 under any mode. The system triggers offscreen 1080p WebGL rendering with a decoupled virtual timestamp step. Regardless of GPU lag, the exported MP4/WebM video is guaranteed to have a constant 60 FPS playback rate and will download automatically.

🤚 4. 核心体验：智能 AI 手势追踪

🤚 4. Core Experience: Intelligent AI Gesture Tracking

点击工具栏的 🤚 Gesture 按钮授权摄像头。开启后，在摄像头前展示特定手势即可控制场景：

Click the 🤚 Gesture button in the toolbar to grant camera access. Once enabled, display specific gestures in front of the camera to control the scene:

💡 识别小贴士

请保持手部光线充足并距摄像头 0.5 ~ 1.5 米。系统内置 8 帧防抖动缓冲和低通指数平滑滤波，动作表现非常柔和线性，不用担心手发抖导致画面乱颤。

💡 Detection Tips

Please ensure adequate lighting and maintain a distance of 0.5 to 1.5 meters from the camera. The system features an 8-frame anti-shake buffer and low-pass exponential smoothing filters for smooth, linear motion feedback.

手势	动作名称	交互效果
Gesture	Name	Interaction
🖐️	张开手掌 (Open Palm)	Open Palm	粒子散开消散：在点云模式下，模型粒子将根据您的手指张开幅度向四周扩散消散。	Particle Dispersal: In Point Cloud mode, particles will scatter outwards based on how wide you open your palm.
✊	攥拳头 (Closed Fist)	Closed Fist	粒子聚拢收缩：在点云模式下，已散开的粒子会向中心收缩，拼回原本的密集人形。	Particle Assembly: In Point Cloud mode, scattered particles will gather back towards the center to restore the dense model.
✌️	剪刀手 (Victory)	Victory	切换渲染模式：在摄像头前比出该手势并保持超过0.7秒可触发切换。会在 3DGS 实景模式与粒子点云模式之间进行切换。	Toggle Render Mode: Strike the Victory sign and hold it for over 0.7 seconds to toggle rendering between 3DGS mode and Point Cloud mode.
✊ ✊	双手攥拳 (Two Fists)	Two Fists	双手距离缩放：同时展示两只手的攥拳状态。当两拳距离靠近或拉远时，可以无极调整 3D 模型的物理尺寸大小。	Two-Hand Distance Zoom: Present two closed fists. Bring your fists closer or further apart to dynamically scale the 3D model size.
☝️	食指指向 (Pointing Up)	Pointing Up	遥控相机视角：比出单指指向上方后，在空中移手，相机会精确跟踪您的食指指尖轨迹进行平滑视角旋转。	Remote Camera Rotation: Show a pointing finger and move your hand. The camera will smoothly follow the trajectory of your index finger tip.

关闭本页，返回浏览器 Close Page, Back to Viewer