nan
377eee43f5
- 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.
56 lines
2.8 KiB
Markdown
56 lines
2.8 KiB
Markdown
# 功能参考
|
||
|
||
本页集中列出 AnyImage 当前实现的主要入口。操作建议见[工作流选择](../guides/workflows.md)，内部设计见[内部实现总览](../internals/index.md)。
|
||
|
||
## 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 产物](../internals/outputs.md)。
|