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

46
docs/guide-surface.md Normal file
View File

@@ -0,0 +1,46 @@
# Surface
Surface 从单张图片构建带透视关系的纹理网格。它适合建筑、室内、街景和需要匹配原始观察视角的画面。
!!! warning
Surface 当前只支持单张图片。视频和序列帧请使用 [Depth Plane](guide-depth-plane.md)。
## 创建 Surface
1. 选中只包含一帧的 Image Empty。
2. 在 3D View 中右键,选择 **SnapForm > Convert to Surface**。
3. 选择模型和转换选项。
4. 确认后等待网格、材质和 Geometry Nodes 修改器创建完成。
## 模型与分辨率
默认的 **MoGe-2 ViT-S Normal** 适合多数图片。MoGe-2 使用 **Resolution Level**,DA3 使用 **Resolution Scale**。提高分辨率会增加耗时和内存占用,建议先用默认值判断整体结构。
如果某个模型名称后显示 **(Missing)**,请先在 3D View 的 **SnapForm > Models** 面板下载它。
## 转换选项
- **Create Matching Camera**:创建与图片投影相匹配的透视相机。相机会成为 Surface 的子级,移动 Surface 时仍保持对应关系。
- **Remove Background**:在生成网格前删除背景三角面。转换后关闭节点中的 Mask 也不会恢复这些面。
- **Shadeless**:让贴图颜色不受场景灯光影响。
- **Keep Original**:保留源 Image Empty。
## 调整网格
生成对象的 Geometry Nodes 修改器负责剔除深度断层、合并网格、修复拓扑、平滑和重新投影 UV。常用参数包括:
- **Iterations**:控制重拓扑迭代次数。设为 `0` 可以跳过迭代,便于观察原始结构或提高速度。
- **Resolution**:控制合并后的网格密度。值越大,结果越简化。
- **Smooth**:控制表面平滑程度。
- **Depth Continuity**:剔除深度断层处的面。提高数值会更积极地清理边缘。
- **Confidence**:DA3 Surface 可用,用于过滤低置信度区域。
先调整 Culling 让主体边缘干净,再调整 Resolution 和 Smooth,通常更容易获得稳定结果。
## 匹配相机的使用方式
开启 **Create Matching Camera** 后,切换到生成的相机视图即可重新对齐原图构图。Surface 与相机存在父子关系,建议把二者作为一个整体移动或缩放。
## 进一步了解
需要查看源网格属性、重拓扑过程、相机匹配和材质法线实现时,请阅读[Surface 实现参考](surface.md)。