nan
0cf04a13c6
- Added upscale operator to handle image upscaling by 4x using AI models. - Introduced new jobs for upscale processing in the server, including debug and standard upscale jobs. - Created a new ONNX model handler for upscale operations, supporting tiled inference and resource management. - Updated tests to cover new upscale functionality, including input validation and output verification. - Added documentation for the upscale feature, detailing usage and model options.
3.2 KiB
安装与首次配置
AnyImage 的安装分为两步：先安装 Blender Extension，再安装独立运行环境和默认模型。第二步只需在首次使用或环境版本发生变化时执行。
安装 Blender Extension
- 下载与你的系统匹配的 ZIP 文件：
AnyImage.v版本号.windows-x64.zipAnyImage.v版本号.macos-arm64.zipAnyImage.v版本号.linux-x64.zip
- 打开 Blender，进入 Edit > Preferences > Extensions。
- 点击右上角菜单，选择 Install from Disk。
- 选择下载的 ZIP 文件并完成安装。
!!! warning 不要解压扩展包。Blender 需要直接安装 ZIP 文件，并且安装包必须与你的操作系统匹配。
检查扩展偏好设置
在 AnyImage 的扩展偏好设置中可以看到两个选项：
- Storage Root：保存运行环境、模型和任务文件的位置。默认是用户目录下的
.anyimage，一般无需修改。 - Device：正式转换任务使用的计算设备。AnyImage 默认选择本机可用的最快设备；如果 GPU Provider 不可用，会使用 CPU。
- Default Upscale Model：Upscale 使用的模型，默认是 General WDN x4v3。
- Maximum Upscale Size：Upscale 输出长边上限，默认 4096 px，最高 8192 px。
如果准备把 Storage Root 放到其他磁盘，建议在首次安装 Environment 之前修改。更换目录后，旧目录中的环境和模型不会自动移动。
配置 AI Environment
选中 Image Empty，在右键 AnyImage 子菜单中点击 Set Up AI Environment…；也可以在 AnyImage 扩展偏好设置中点击同名按钮。
确认安装前，对话框会说明以下内容：
- 安装独立 Python、ONNX Runtime 与支持包，并下载 MoGe-2 ViT-S Normal、BEN2 Base 和 Real-ESRGAN General WDN x4v3。
- 默认模型合计约 360 MB；连同 Environment 预计需要约 600 MB 下载量和约 1 GB 磁盘空间。
- 根据网络速度，首次安装通常需要 5–20 分钟。
- Use Mirror 只让 uv、Python 和 Python 包使用国内镜像；模型下载源保持不变。
安装过程中请保持 Blender 打开。状态栏会显示当前阶段、进度和下载速度。
如果 Environment 已安装但任一默认模型缺失，入口会改为 Download Required Models…；对话框列出缺失模型和下载体积，确认后只下载缺失模型，不会重装 Environment 或重复下载已就绪内容。
确认安装完成
完成后可以用以下方式确认：
- Job Server 不再显示 “Environment is not installed”。
- AnyImage 扩展偏好设置中的 MoGe-2 ViT-S Normal、BEN2 Base 和 Real-ESRGAN General WDN x4v3 显示 Ready。
- 选中 Image Empty 后，右键菜单底部显示 AI Environment Settings…。
Convert to Depth Plane…、Convert to Surface… 和 Remove Background 在 AI 未就绪时仍可点击，点击后会根据状态转入 Set Up AI Environment… 或 Download Required Models…。Balloon 的本地套索与几何生成功能不要求安装 AI Environment；未就绪时，Tool Settings 只会禁用 Contour、Depth 与 Depth Model，并显示安装按钮。
下一步
继续阅读五分钟上手，用一张图片完成第一次转换。