nan
7d39fe8c5e
- 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.
62 lines
3.7 KiB
Markdown
62 lines
3.7 KiB
Markdown
# 安装与首次配置
|
||
|
||
AnyImage 的安装分为两步：先安装 Blender Extension，再安装独立运行环境和默认模型。第二步只需在首次使用或环境版本发生变化时执行。
|
||
|
||
## 安装 Blender Extension
|
||
|
||
1. 下载与你的系统匹配的 ZIP 文件：
|
||
- `AnyImage.v版本号.windows-x64.zip`
|
||
- `AnyImage.v版本号.macos-arm64.zip`
|
||
- `AnyImage.v版本号.linux-x64.zip`
|
||
2. 打开 Blender，进入 **Edit > Preferences > Extensions**。
|
||
3. 点击右上角菜单，选择 **Install from Disk**。
|
||
4. 选择下载的 ZIP 文件并完成安装。
|
||
|
||
!!! warning
|
||
不要解压扩展包。Blender 需要直接安装 ZIP 文件，并且安装包必须与你的操作系统匹配。
|
||
|
||
## 检查扩展偏好设置
|
||
|
||
AnyImage 的扩展偏好设置按功能分组。Environment 区包含：
|
||
|
||
- **Storage Root**：保存运行环境、模型和任务文件的位置。默认是用户目录下的 `.anyimage`，一般无需修改。
|
||
- **Device**：正式转换任务使用的计算设备。AnyImage 默认选择本机可用的最快设备；如果 GPU Provider 不可用，会使用 CPU。
|
||
|
||
Environment 检测后显示 Diagnostics。Depth & Normal、Remove Background、Upscale 与 Cutout 是默认展开的可折叠功能区，各自包含对应设置和模型状态。其中：
|
||
|
||
- **Default Upscale Model**：Upscale 使用的模型，默认是 General WDN x4v3。
|
||
- **Maximum Upscale Size**：Upscale 输出长边上限，默认 4096 px，最高 8192 px。
|
||
|
||
Depth Model 依次列出三档 MoGe-2 与两档 DA3；选择 DA3 时会提示该模型不能生成 normal。可选模型的 **Ready** 状态或 **Download** 按钮直接位于模型选择项下方；BEN2 等固定模型则显示在所属功能区。Cutout 区只保留 Balloon Profile。
|
||
|
||
如果准备把 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，并显示安装按钮。
|
||
|
||
## 下一步
|
||
|
||
继续阅读[五分钟上手](quick-start.md)，用一张图片完成第一次转换。
|