User Guide — 3DGS & Particle Viewer

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

1. Quick Start: Loading 3D Models

系统支持从网络分享链接直接提取并展示 3DGS（三维高斯泼溅）与常规三维点云模型：

The system supports directly fetching and rendering 3DGS (Gaussian Splatting) and regular 3D point cloud models from online share URLs:

通过分享链接加载：在首页中央的输入框（或者在模型加载后的顶部菜单栏）粘贴 Kiri Engine、Polycam 或 Luma 分享地址，然后点击 Load 按钮。系统会自动解析、下载 PLY 并加载模型。

Load via Share Link: Paste a Kiri Engine, Polycam, or Luma share URL in the centered input (or in the top toolbar after loading), then click Load. The app resolves the link, downloads its PLY, and loads the model automatically.

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

2. Basic Operations: Viewport & Adjustments

视角旋转：在 3D 画布区域，按住 鼠标左键 并拖拽。
视角平移：按住 鼠标右键 并拖拽。
场景缩放：滚动 鼠标中键滚轮。系统支持极小距离缩放，可将视角拉得极近来观测模型微小细节。
初始视角自动缩放对齐：当模型加载时，无论背景切割设置多大，默认视角都会精准缩放对齐到主体的 1x radius 距离，让人物面部或物体核心细节直接贴近屏幕中央。
渲染引擎切换与背景裁剪规则：
- 3D 实景模式：照片级写实的高保真三维高斯着色。在此模式下，系统将自动保留 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 Reality Mode: Photorealistic high-fidelity 3D Gaussian Splatting rendering. Under this mode, the system automatically 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.

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

3DGS & Particle Point Cloud Viewer