Add comprehensive documentation for SnapForm features and workflows
Some checks failed
构建扩展 / build (push) Failing after 24s

- Introduced new guides for Depth Plane, Surface, and animation workflows.
- Added installation instructions and FAQs to assist users in setup and troubleshooting.
- Created a quick-start guide for first-time users to convert images to Depth Planes.
- Documented the process for removing backgrounds from images.
- Established a models and storage section to clarify data management.
- Included a stylesheets file for improved documentation styling.
- Updated mkdocs configuration for better navigation and theme settings.
This commit is contained in:
2026-08-19 16:02:40 +08:00
parent 70072b852a
commit 4a69d162a0
21 changed files with 1210 additions and 12 deletions

48
docs/quick-start.md Normal file
View File

@@ -0,0 +1,48 @@
# 五分钟上手
这个流程会把一张图片转换为可继续编辑的 Depth Plane。
## 1. 导入图片
在 3D View 中选择 **Add > Image > Reference**,导入一张图片。Blender 会创建一个显示方式为 Image 的 Empty。
建议第一次尝试使用主体清晰、前后景关系明确的图片。人物、产品、建筑立面和插画通常都比较适合。
## 2. 打开 SnapForm 菜单
保持 Image Empty 处于选中状态,在 3D View 中点击右键,选择 **SnapForm > Convert to Depth Plane**。
如果菜单不存在,请确认当前对象是 Image Empty;如果转换入口是灰色,请先完成[安装与首次配置](installation.md)。
## 3. 使用默认设置转换
第一次使用建议保留默认设置:
- **Depth From**:MoGe-2 ViT-S Normal
- **Resolution Level**:5
- **Remove Background**:关闭
- **Shadeless**:关闭
- **Keep Original**:关闭
点击确认后,状态栏会显示模型加载和处理进度。首次推理需要加载模型,之后连续处理通常会更快。
## 4. 查看和调整结果
转换完成后,原 Image Empty 会被新的网格对象替代。打开 Geometry Nodes 修改器,可以调整:
- **Displacement**:选择直接改变几何,或改用材质置换。
- **Subdivision**:控制面片细分程度。
- **Background Depth**:控制透明区域或背景区域的深度。
- **Depth Scale**:放大、减小或反转深度变化。
如果希望保留原 Image Empty,转换前开启 **Keep Original**。
## 5. 让画面不受灯光影响
希望颜色尽量贴近原图时,在转换对话框中开启 **Shadeless**。需要让结果参与场景光照、阴影和材质表现时,则保持关闭。
## 接下来可以尝试
- 主体需要透明背景:[转换时去除背景](remove-background.md)
- 想要更强的透视结构:[转换为 Surface](guide-surface.md)
- 输入是视频或序列帧:[制作动画 Depth Plane](animation.md)