nan
c97b4a3e41
- Implemented viewport.py for handling 3D view projections, gestures, and overlay drawing. - Created refine_image_selection.py to manage the refinement of gesture masks and output image bounds. - Added selection module with refine_selection.py to process and crop images based on alpha channel visibility. - Introduced __init__.py for selection module to expose refine_selection function.
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 AI Input Size**：Upscale、Depth、Normal Map 与 Refine Selection 的 AI 输入长边上限，默认 2048 px；颜色贴图保留原始分辨率。
|
||
- **Maximum Cutout Mesh Resolution**：所有 Cutout Shape 的网格采样长边上限，默认 1024，独立于 AI 输入尺寸。
|
||
|
||
Depth & Normal 提供三档 MoGe-2，Depth Plane 与 Cutout Depth / Normal Map 共用当前选择。可选模型的 **Ready** 状态或 **Download** 按钮位于选择项下方；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 或重复下载已就绪内容。
|
||
|
||
## 确认安装完成
|
||
|
||
完成后可以用以下方式确认：
|
||
|
||
- AnyImage 扩展偏好设置中的 MoGe-2 ViT-S Normal、BEN2 Base 和 Real-ESRGAN General WDN x4v3 显示 **Ready**。
|
||
- 选中 Image Empty 后，右键菜单底部显示 **AI Environment Settings…**。
|
||
|
||
点击 **Convert to Depth Plane**、**Remove Background** 或 **Upscale** 时，AnyImage 会根据状态进入 **Set Up AI Environment…** 或 **Download Required Models…**。普通 Plane、Image 编辑和基础 Cutout Surface / Balloon 直接在 Blender 中执行。
|
||
|
||
## 下一步
|
||
|
||
继续阅读[五分钟上手](quick-start.md)，用一张图片完成第一次转换。
|