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

1. Quick Start: Loading 3D Models

KIRI Maker 支持解析公开的 KIRI Engine、Polycam 与 Luma 分享链接，并加载其中可用的 PLY、Splat 或点云资源：

KIRI Maker resolves public KIRI Engine, Polycam, and Luma share links and loads the best available PLY, Splat, or point-cloud asset:

1. 通过分享链接加载：在首页输入框粘贴公开分享地址，然后点击 Load。模型加载后也可以使用顶部工具栏的输入框加载其他地址。
2. 随机示例模型：点击 Load 左侧的骰子图标，可从 4 个内置 KIRI Engine 示例中随机选择并立即加载一个模型。
3. 格式与权限：Luma 的压缩 PLY 会在浏览器中自动解压。分享内容必须公开，并且需要包含受支持的 PLY 或 Splat 资源；私有、已删除或仅有 Mesh 的模型无法加载。

1. Load via Share Link: Paste a public share URL into the landing-page input, then select Load. After a model loads, you can use the top toolbar input to open another URL.
2. Random Sample: Select the dice icon to the left of Load to choose and immediately load one of four built-in KIRI Engine examples.
3. Formats and Access: Compressed Luma PLY files are unpacked automatically in the browser. The capture must be public and contain a supported PLY or Splat asset; private, removed, and mesh-only captures cannot be loaded.

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

2. Basic Operations: Viewport & Adjustments

• 视角旋转：在 3D 画布区域，按住 鼠标左键 并拖拽。
• 视角平移：按住 鼠标右键 并拖拽。
• 场景缩放：滚动鼠标滚轮；触控设备可使用双指缩放和移动。
• 模型方向：桌面版左下角的 Flip Vertically 可将当前模型垂直翻转；KIRI Maker 也会根据 KIRI Engine、Polycam 和 Luma 来源应用默认方向校正。
• 自动旋转：点击 Stop Rotation 可暂停模型自动旋转，再次点击 Resume Rotation 恢复。暂停状态在预览和切换渲染模式时仍会保留。
• 切换渲染模式：
  • 3D Reality：使用高斯泼溅渲染模型的写实外观和环境内容。
  • Particle Mode：以发光粒子展示模型，并启用 Scatter / Gather 进度条和粒子特效。

• 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.
• Zoom: Scroll the mouse wheel. On touch devices, use two fingers to zoom and move the view.
• Model Orientation: On desktop, use Flip Vertically in the lower-left panel to invert the current model. KIRI Maker also applies source-aware default orientation for KIRI Engine, Polycam, and Luma captures.
• Automatic Rotation: Select Stop Rotation to pause automatic model rotation and Resume Rotation to restore it. The paused state is preserved while previewing and switching render modes.
• Switch Render Modes:
  • 3D Reality: Uses Gaussian Splatting to render the model's realistic appearance and environment.
  • Particle Mode: Displays the model as glowing particles and enables the Scatter / Gather control and particle effects.

3. 渲染设置与粒子效果

3. Rendering Settings & Particle Effects

加载模型后，点击顶部 Settings 打开渲染设置：

After loading a model, select Settings in the top toolbar to open the rendering controls:

• Filter Background (Crop)：调整主体周围保留的点云范围，范围为 0.5x–3.0x；3.0x 表示关闭裁剪。更改后会重新处理当前粒子模型。
• Particle Size / Brightness / Density：分别控制粒子大小、发光亮度与显示密度。移动端可通过 Crop、Size、Light、Density 标签切换参数。
• Scatter Effect：可从 9 种粒子分散与重组效果中选择，也可以选择 No particle effects。
• Scatter / Gather：Particle Mode 下可拖动右下方进度条手动控制分散程度，或点击播放按钮自动执行 0% → 100% → 0% 动画。

• Filter Background (Crop): Adjust the retained point-cloud area around the subject from 0.5x to 3.0x; 3.0x disables cropping. Changing this value reprocesses the current particle model.
• Particle Size / Brightness / Density: Control particle size, glow intensity, and visible density. On mobile, switch between the Crop, Size, Light, and Density parameter tabs.
• Scatter Effect: Choose from 9 particle scatter and assembly effects, or select No particle effects.
• Scatter / Gather: In Particle Mode, drag the lower-right progress slider to control the effect manually, or select Play to run a 0% → 100% → 0% animation.

4. 电影运镜、关键帧与视频导出

4. Camera Paths, Keyframes & Video Export

调整到想要的初始视角，然后点击顶部 Camera Path。当前视角会作为内置运镜的第一帧：

Set the desired starting view, then select Camera Path in the top toolbar. The current view becomes the first frame of a built-in path:

1. 内置预设：从 Flight Path Preset 选择任意预设，再选择 Scatter Effect（可选），点击 Preview 预览。
2. 自定义关键帧：选择 -- Custom Keyframes - Please Select --，依次调整视角并点击 Add Keyframe。关键帧数量不设上限，路径至少需要 2 个关键帧；点击“视角”标签可恢复保存的相机位置和观察目标，也可单独删除或使用 Clear 清空。
3. 预览控制：预览时可以切换 Particle Mode / 3D Reality、停止预览，或直接从预览控制栏开始导出；渲染切换与粒子效果会进入最终序列。
4. 导出视频：点击 Export Video 生成 1080p、目标 60 FPS 的视频。优先导出 MP4，不支持时使用浏览器可用的兼容格式；导出期间可停止录制或停止合成。

1. Built-in Presets: Choose any Flight Path Preset, optionally select a Scatter Effect, and select Preview.
2. Custom Keyframes: Choose -- Custom Keyframes - Please Select --, adjust the view, and select Add Keyframe for each view. There is no keyframe limit, and a path requires at least 2 keyframes. Select a Viewpoint label to restore its saved camera position and target; remove frames individually or use Clear to remove all.
3. Preview Controls: During preview, switch between Particle Mode and 3D Reality, stop the preview, or start exporting from the preview controls. Renderer changes and particle-effect timing are included in the final sequence.
4. Video Export: Select Export Video for 1080p output targeting 60 FPS. MP4 is preferred, with a browser-supported fallback when necessary; recording or frame composition can be stopped while export is running.

5. AI 手势控制

5. AI Gesture Controls

点击工具栏的 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:

手势	动作名称	交互效果
Gesture	Name	Interaction
	张开手掌 (Open Palm)	Open Palm	粒子散开消散：在 Particle Mode 下，模型粒子会根据手掌张开程度向四周扩散。	Particle Dispersal: In Particle Mode, particles scatter outwards based on how wide you open your palm.
	攥拳头 (Closed Fist)	Closed Fist	粒子聚拢收缩：在 Particle Mode 下，已散开的粒子会向中心收缩并恢复模型。	Particle Assembly: In Particle Mode, scattered particles gather back toward the center to restore the model.
	剪刀手 (Victory)	Victory	切换渲染模式：在摄像头前比出该手势并保持约 0.7 秒，即可在 3D Reality 与 Particle Mode 之间切换。	Toggle Render Mode: Hold the Victory sign for about 0.7 seconds to switch between 3D Reality and Particle 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.