Files

nan 377eee43f5 Refactor and enhance geometry node groups for depth plane and material layers

- Updated the depth plane node group to load from an asset and simplified the interface.
- Created a new build script for depth plane geometry nodes.
- Introduced material layer groups for image and depth materials with appropriate sockets.
- Added functionality to connect balloon normal scale to the image material.
- Enhanced tests to validate the new node groups and their connections.
- Ensured that production code does not create node groups directly.

2026-08-31 12:25:23 +08:00

2.8 KiB

Raw Blame History

功能参考

本页集中列出 AnyImage 当前实现的主要入口。操作建议见工作流选择，内部设计见内部实现总览。

Blender 入口

入口	位置	输入
Paste Clipboard Image	3D View / oode Editor 的 `Ctrl+V` 或 `Cmd+V`	剪贴板静态图
Convert to Plane	Image Empty 右键菜单	单图、Movie、Sequence
Convert to Depth Plane	Image Empty 右键菜单	静态图
Remove Background	Image Empty 右键菜单	单图、Movie、Sequence
Upscale	Image Empty 右键菜单	单图、Movie、Sequence
Image Box / Lasso / Line / Polyline	3D Viewport 工具栏	静态 Image Empty
Image Perspective	3D Viewport 工具栏	静态 Image Empty
Cutout	3D Viewport 工具栏	静态 Image Empty

右键菜单只在当前对象是 Image Empty 时出现。AI 功能会在 Environment 或默认模型未就绪时转入安装流程；普通 Plane、未启用 Fit to Foreground 的 Image Tools 与基础 Cutout Surface / Balloon 不依赖 Environment。

结果类型

Plane

普通 Plane 使用资产中的 O Mesh Plane Geometry Nodes，提供 Subdivide、Thickness 和 Material。Depth Plane 使用同一资产文件中的 O Image Depth Plane，增加 Depth Amount 与内部 Depth Image。

Cutout Shape

Cutout 提供四种结果：

Shape	`O Image Cutout` 内部分支	深度
Surface	`O Image Surface`	无
Balloon	`O Image Balloon`	Balloon Profile
Depth Balloon	`O Image Depth Balloon`	MoGe-2 高度
Depth Surface	`O Image Depth Surface`	MoGe-2 相机点

四种 Shape 共用 O Image Cutout 修改器、规则三角基础面、UV 和 o_balloon 属性。Shape 菜单选择内部几何分支，Cleanup 在分支前执行且使用便于调节的百倍显示值，Smooth 在分支后执行；Depth Shape 根据 Region 透明比例选择固定或自适应 Base Plane Depth，Generate Normal Map 是启用开关：Depth Surface 自动使用 Object Space，其余 Shape 自动使用 Tangent Space；Fit to Foreground 按需启用 BEN2。

图片结果

Image Mask 和 Perspective 直接更新当前 Empty 的图片并 Pack。Remove Background 输出透明颜色图或序列。Upscale 通过三档 ONNX 模型把当前 Image 输出为 4× RGBA；当前长边达到全局输入上限时不可执行。

模型

MoGe-2 ViT-S / ViT-B / ViT-L Normal
BEN2 Base
Real-ESRGAN General WDN x4v3
SAFMN Real x4
Real-ESRGAN x4plus

默认安装准备 MoGe-2 ViT-S Normal、BEN2 Base 和 Real-ESRGAN General WDN x4v3。其余模型在扩展 Preferences 中按需下载。

Debug

Server 面板提供 DA3、MoGe-2、BEN2 与 Upscale Debug Job。它们保存模型适配层的直接 Prediction，不创建正式功能对象。文件说明见 Job 产物。

2.8 KiB Raw Blame History Unescape Escape