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

4.0 KiB

Raw Blame History

模型、设备与存储

AnyImage 把运行环境、模型和任务结果放在 Blender 之外，多个 Blender 版本可以共享同一套数据。

功能与模型设置

打开 Edit > Preferences > Extensions > AnyImage，可以查看和下载模型。右键菜单中的 AI Environment Settings… 会直接打开这里。Environment 检测后紧接 Diagnostics；其余设置分为默认展开、可折叠的 Depth & Normal、Remove Background、Upscale 和 Cutout 功能区，模型不会再集中显示在单独列表中。

Ready 表示模型文件已经就绪。
Download 用于按需下载模型。
Depth & Normal 与 Upscale 的下载按钮位于当前模型选择项下方；切换选择后，可直接下载对应模型。
Depth Model 先列出三档 MoGe-2，再列出两档 DA3；DA3 不输出 normal，选择后会在设置下方提示。
Remove Background 使用的 BEN2 固定模型显示在对应功能区；Cutout 区只包含 Balloon Profile。
默认安装会准备 MoGe-2 ViT-S Normal、BEN2 Base 和 Real-ESRGAN General WDN x4v3。
DA3、更大的 MoGe-2，以及可选的 SAFMN Real x4、Real-ESRGAN x4plus 需要时再下载即可。
可公开取得的 ONNX 制品使用经过大小与 SHA-256 校验的原址，并以 OmooLab R2 为镜像；不会把源码仓库名称推测成 Hugging Face 下载地址。
Real-ESRGAN General WDN x4v3 与 SAFMN Real x4 的上游只发布 PyTorch 权重，当前 ONNX 均从官方权重导出并仅从 R2 下载。

较大的模型不一定适合所有图片。建议先用默认模型完成构图，再针对细节与性能需求比较其他模型。

全局 AI 输入尺寸

Environment 区的 Maximum AI Input Size 默认 2048 px，可在 256–8192 px 之间调整。它既是允许执行 Upscale 的当前图片长边上限，也是 Depth 与 Normal 分析输入的最大长边；Upscale 在达到上限时置灰，Depth 与 Normal 则保持宽高比缩小分析输入。颜色贴图仍使用当前图片的原始分辨率。Cutout 在完成套索裁切后再应用上限，因此整张图片很大但选区较小时不会被无谓缩小。

Device

扩展偏好设置中的 Device 控制 Depth Plane、Cutout 的 AI 增强、Remove Background 和 Upscale 等正式任务。

Windows 通常优先使用 DirectML。
Apple Silicon macOS 通常优先使用 CoreML。
Provider 不可用时会回退到 CPU。

Debug 面板中的 Debug Device 只影响 Debug 任务，不会覆盖正式任务的 Device。

Session 缓存

连续使用同一模型和 Device 时，Server 会复用已经加载的 ONNX Session。缓存分为 BEN2、几何模型和 Upscale 三个族，每个族只保留最近使用的一套；同族切换模型或 Device 时释放旧 Session。如果高清推理遇到 provider 资源错误，也会立即卸载该 Session。

Storage Root

默认 Storage Root 是 ~/.anyimage，主要包含：

~/.anyimage/
├── .venv/           # 独立 Python Environment
├── models/          # 模型文件
├── jobs/            # 每次任务的结果与 job.log
├── install.log      # Environment 安装日志
└── server.log       # 带 Job ID 的任务主线与 Job Server 日志

更改 Storage Root 相当于切换到另一套环境、模型和任务数据。AnyImage 不会自动移动旧目录。

Job 文件夹

每个任务会在 jobs/ 下创建一个独立目录。单张图生成的关键贴图通常会 Pack 到 .blend；视频和序列帧则继续引用 Job 目录中的文件。

可以清理已经确认不再使用的任务目录，但清理前应检查是否有 .blend 仍引用其中的序列帧。

日志

遇到安装或 Server 问题时：

在扩展偏好设置中点击 Open Server Log 查看带时间、Job ID 与 Job Type 的运行主线。
具体 Job 的 Handler 细节和完整 traceback 查看 jobs/<job-id>/job.log。
Environment 安装问题查看 Storage Root 下的 install.log。
修改 Storage Root 后，确认你检查的是当前目录中的日志。

4.0 KiB Raw Blame History Unescape Escape