- 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.
2.5 KiB
常见问题
找不到 SnapForm 右键菜单
SnapForm 菜单只会在选中 Image Empty 时出现。确认对象类型是 Empty,并且显示方式为 Image。普通 Mesh、图片编辑器中的图片或未选中的 Image Empty 都不会显示入口。
转换入口是灰色的
通常有以下原因:
- Environment 尚未安装。
- 默认必需模型尚未就绪。
- 另一个 SnapForm 任务正在运行。
- Surface 的输入不是单张图片。
如果子菜单显示 Install Environment 或 Download Required Models,先完成对应操作。
Environment 安装失败
- 海外源访问不稳定时尝试 Install Environment (Mirror)。
- 检查 Blender 的 Online Access 是否开启。
- 确认 Storage Root 有足够空间且可写。
- 查看 Storage Root 下的
install.log。
安装模型失败不会删除已经成功创建的 Environment。可以稍后使用 Download Required Models 或 Models 面板重试。
模型下载很慢或失败
模型会尝试 Hugging Face 和 OmooLab 备用来源。检查网络、代理和磁盘空间后重新点击 Download。模型直链连接或长时间无数据时会自动尝试下一来源。
第一次转换较慢
第一次任务需要启动 Job Server 并把模型载入内存。Server 运行且模型仍在缓存中时,后续同类任务通常会更快。
Depth Plane 太平或深度方向反了
在 Geometry Nodes 修改器中调整 Depth Scale。增大绝对值会加强深度,使用负值可以反转前后关系。
Surface 边缘破碎或细节太多
先调整 Depth Continuity 清理断层,再提高 Resolution 简化网格,并用 Smooth 稳定表面。必要时尝试另一个模型或降低输入分辨率。
动画面片不播放
检查源 Image Empty 的 Image Frames 是否大于 1,并确认场景时间正在变化。生成后的动画还需要对应 Job 文件夹存在;文件被移动或删除时应重新定位序列。
可以删除 jobs 文件夹吗
静态图的部分结果会 Pack 到 .blend,但视频与序列帧会直接引用 Job 文件。只有确认没有工程继续引用对应目录时才应删除。
如何完全撤销一次转换
转换完成后直接按 Ctrl+Z。SnapForm 会把网格、材质、图片和修改器的创建合并为一次 Blender Undo 操作。
从旧版本升级后功能不可用
如果 Environment 声明或依赖发生变化,请重新执行一次 Install Environment。从 0.12.0–0.12.5 升级到 0.12.6 或更高版本时需要重建 Environment。