nan
87d7721128
- Added interaction helpers for cutout region validation and shape menu interaction. - Created main operator for converting image regions into cutout shapes, including AI artifact generation. - Introduced object creation logic for cutout shapes, handling depth and normal textures. - Defined cutout shape identifiers and node groups for various shape types. - Implemented depth texture writing and prediction artifact generation for MoGe-2. - Developed server jobs for generating cutout artifacts, depth planes, and refining image regions. - Added region refinement logic to enhance gesture masks using BEN2.
67 lines
3.9 KiB
Markdown
67 lines
3.9 KiB
Markdown
# 模型、设备与存储
|
||
|
||
AnyImage 把运行环境、模型和任务结果放在 Blender 之外，多个 Blender 版本可以共享同一套数据。
|
||
|
||
## 功能与模型设置
|
||
|
||
打开 **Edit > Preferences > Extensions > AnyImage**，可以查看和下载模型。右键菜单中的 **AI Environment Settings…** 会直接打开这里。Environment 检测后紧接 Diagnostics；其余设置分为默认展开、可折叠的 Depth & Normal、Remove Background、Upscale 和 Cutout 功能区，模型不会再集中显示在单独列表中。
|
||
|
||
- **Ready** 表示模型文件已经就绪。
|
||
- **Download** 用于按需下载模型。
|
||
- Depth & Normal 与 Upscale 的下载按钮位于当前模型选择项下方；切换选择后，可直接下载对应模型。
|
||
- Depth & Normal 只列出三档 MoGe-2；Depth Plane 与 Cutout 共用这个显式选择。
|
||
- Remove Background 使用的 BEN2 固定模型显示在对应功能区；Cutout 区只包含 Balloon Profile。
|
||
- 默认安装会准备 MoGe-2 ViT-S Normal、BEN2 Base 和 Real-ESRGAN General WDN x4v3。
|
||
- 更大的 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 输入与 Cutout 网格尺寸
|
||
|
||
Environment 区的 **Maximum AI Input Size** 默认 `2048 px`，可在 `256–8192 px` 之间调整。它是 Upscale 的可执行源图长边上限，也是 Depth、Normal Map 与 Fit to Foreground 模型分析输入的最大长边；颜色贴图仍使用原始分辨率。Cutout 区的 **Maximum Cutout Mesh Resolution** 默认 `1024`，独立限制所有 Shape 的网格采样密度，不会因为某个 Shape 是否使用 AI 而改变含义。
|
||
## 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`，主要包含：
|
||
|
||
```text
|
||
~/.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 后，确认你检查的是当前目录中的日志。
|