Files

nan 7d39fe8c5e Add cutout profile and teddy balloon height calculations

- Implemented cotangent Poisson field and Poisson balloon profile in cutout_profile.py.
- Added teddy balloon heights calculation and related functions in cutout_teddy.py.
- Introduced interaction utilities for image editing in interaction.py.
- Developed depth normalization and analysis functions in cutout_depth.py.
- Created a validation script for cutout assets in validate_cutout_asset.py.

2026-08-27 22:46:57 +08:00

3.6 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 下载。

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

Device

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

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

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

Session 缓存

连续使用同一模型和 Device 时，Server 会复用已经加载的 ONNX Session。切换到 BEN2、深度或高清等另一模型族时，旧 Session 会被释放，因此 Server 最多保留当前使用的一套模型；如果高清推理遇到 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 后，确认你检查的是当前目录中的日志。

3.6 KiB Raw Blame History Unescape Escape