Files

nan 08309f719d feat: Implement cutout tool and depth generation features

- Added a new cutout tool for selecting regions in images, allowing users to choose mesh shapes based on selected areas.
- Introduced depth generation capabilities for rasterized images, including normal data extraction.
- Created jobs for generating depth planes and region data, enhancing the AI data generation workflow.
- Developed a selection refinement process for cutout regions, improving accuracy in generated outputs.
- Established a new region module for handling rasterized image regions and their associated AI generation tasks.
- Enhanced node graph builders for asset generation, facilitating smoother integration of new features.

2026-08-30 23:09:13 +08:00

2.8 KiB

Raw Blame History

功能参考

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

Blender 入口

入口	位置	输入
Paste Clipboard Image	3D View / Node 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、非 Refine 的 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，Normal 可选 None、Tangent 或 Object，Refine Selection 按需启用 BEN2。

图片结果

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

模型

MoGe-2 ViT-S / ViT-B / ViT-L Normal
DA3 Small / Base
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