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.
3.9 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 的扩展偏好设置按功能分组。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 与 Fit to Foreground 的 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 或重复下载已就绪内容。
确认安装完成
完成后可以用以下方式确认：
- 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、Remove Background 和 Upscale 在 AI 未就绪时仍可点击，点击后会根据状态转入 Set Up AI Environment… 或 Download Required Models…。普通 Plane、Image 编辑，以及未启用 Fit to Foreground / Generate Normal Map 的 Cutout Surface 与 Balloon 不要求安装 AI Environment。
下一步
继续阅读五分钟上手，用一张图片完成第一次转换。