Files
AnyImage/docs/guide-surface.md
nan 4a69d162a0
Some checks failed
构建扩展 / build (push) Failing after 24s
Add comprehensive documentation for SnapForm features and workflows
- 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.
2026-08-19 16:02:40 +08:00

2.3 KiB
Raw Blame History

Surface

Surface 从单张图片构建带透视关系的纹理网格。它适合建筑、室内、街景和需要匹配原始观察视角的画面。

!!! warning Surface 当前只支持单张图片。视频和序列帧请使用 Depth Plane。

创建 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 实现参考。