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

36
docs/animation.md Normal file
View File

@@ -0,0 +1,36 @@
# 视频与序列帧
SnapForm 可以逐帧处理视频和序列帧,并生成随场景时间播放的 Depth Plane 或透明 Image Empty。
## 支持的工作流
- **Convert to Depth Plane**:支持视频和序列帧。
- **Remove Background**:支持视频和序列帧。
- **Convert to Surface**:当前只支持单张图片。
## 设置处理范围
处理范围来自 Image Empty 自身的图片设置:
- **Image Frames** 决定处理的帧数。
- **Offset** 决定从源素材的哪个位置开始。
- **Start** 决定结果从场景的哪一帧开始播放。
- **Cyclic** 会保留到生成的颜色与深度序列中。
显式把 Image Frames 设为 `1` 时,SnapForm 只处理一帧。范围超过视频长度时,SnapForm 会把窗口收回有效范围内。
## 性能建议
- 先用较少帧数和较低分辨率测试效果。
- DA3 和 MoGe-2 的 Depth Plane 会逐帧推理并复用模型 Session,显存峰值主要由单帧分辨率决定。
- 视频越长,处理时间和任务目录占用越大。
- 任务运行期间可以从 Blender 状态栏查看进度并取消。
## 保存和移动工程
Blender 无法把整组动画图片序列完整打包进 `.blend`。SnapForm 因此让动画结果直接引用 Storage Root 的 Job 文件夹。
!!! danger
删除、移动或清理仍被工程引用的 Job 文件夹,会导致动画颜色或深度序列丢失。
需要把工程移动到另一台机器时,请连同对应 Job 文件夹一起复制,并在 Blender 中重新定位缺失文件。也可以先把需要长期保留的序列复制到项目自己的素材目录,再用 Blender 的外部数据工具重新映射路径。