Files
AnyImage/docs/guide-surface.md
nan 988332548e Add tests for clipboard image functionality and mesh plane asset creation
- Implemented a comprehensive test suite for the clipboard image module, covering various functionalities including operator registration, context handling, and image processing.
- Created a new mesh plane asset with customizable parameters and integrated it into the geometry node system.
- Developed a validation script to ensure the correct behavior of the mesh plane asset, including input handling and output verification.
2026-08-22 09:49:00 +08:00

2.4 KiB
Raw Blame History

Surface

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

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

创建 Surface

  1. 选中只包含一帧的 Image Empty。
  2. 在 3D View 中右键,选择 AnyImage > Convert to Surface。
  3. 选择模型和转换选项。
  4. 确认后等待网格、材质和 Geometry Nodes 修改器创建完成。

模型与分辨率

默认的 MoGe-2 ViT-S Normal 适合多数图片。MoGe-2 使用 Resolution Level,DA3 使用 Resolution Scale。提高分辨率会增加耗时和内存占用,建议先用默认值判断整体结构。

如果某个模型名称后显示 (Missing),请在 AnyImage 扩展偏好设置中下载它。右键菜单底部的 AI Environment Settings… 可以直接打开对应设置。

转换选项

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