Files
AnyImage/docs/models-and-storage.md
nan 1613bd3194 Add image perspective editing and related tools
- Implemented the Image Perspective tool for editing image corners in Blender.
- Created a new operator `EditImagePerspective` to handle the perspective transformation.
- Added a preview feature for the perspective adjustment.
- Introduced the `ImagePolylineTool` for editing image masks with polylines.
- Developed backend support for Real-ESRGAN model inference, including ONNX integration.
- Added functionality for image masking and background removal.
- Created unit tests for the Real-ESRGAN ONNX model to ensure correct preprocessing and inference.
2026-08-22 22:17:10 +08:00

2.1 KiB
Raw Blame History

模型、设备与存储

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

Models 设置

打开 Edit > Preferences > Extensions > AnyImage,可以查看和下载模型。右键菜单中的 AI Environment Settings… 会直接打开这里。

  • Ready 表示模型文件已经就绪。
  • Download 用于按需下载模型。
  • 默认安装会准备 MoGe-2 ViT-S Normal 和 BEN2 Base。
  • DA3、更大的 MoGe-2,以及只供 Debug 使用的 Real-ESRGAN General x4v3 需要时再下载即可。

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

Device

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

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

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

Storage Root

默认 Storage Root 是 ~/.anyimage,主要包含:

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

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

Job 文件夹

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

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

日志

遇到安装或 Server 问题时:

  • 在扩展偏好设置中点击 Open Server Log 查看运行日志。
  • Environment 安装问题查看 Storage Root 下的 install.log。
  • 修改 Storage Root 后,确认你检查的是当前目录中的日志。