Files

nan 32bcd45d7b Add new node asset scripts for geometry and shader operations

- Implemented `build_mesh_plane.py` to create a geometry node group for mesh planes with customizable parameters.
- Created `build_shadeless.py` for a shader node group that displays color without scene lighting while preserving shadows and reflections.
- Added `validate.py` to validate the integrity of the newly created node groups and their inputs.
- Introduced `validate_cutout.py` to ensure the functionality of cutout node groups and their dependencies.
- Developed `validate_mesh_plane.py` to test the mesh plane creation and its modifier settings.

2026-08-30 00:17:29 +08:00

2.6 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 在分支后执行；Point Spacing 控制网格密度，Normal 与 Refine Selection 按需启用 MoGe-2 和 BEN2。

图片结果

Image Mask 和 Perspective 直接更新当前 Empty 的图片并 Pack。Remove Background 输出透明颜色图或序列。Upscale 通过三档 ONNX 模型输出 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.6 KiB Raw Blame History Unescape Escape