nan
1994d38ccd
- Introduced tests for color image handling, ensuring source preservation and premultiplied alpha usage. - Implemented tests for brush stroke operations, validating segment boundaries and brush anti-aliasing. - Added tests for frame anti-aliasing, confirming correct rendering behavior with various alpha values and depth settings. - Created tests for frame projection, ensuring accurate overlap calculations and half-plane clipping. - Developed tests for image premultiplied retention, verifying behavior during loading and packing processes. - Added undo functionality tests for mask operations, ensuring single transaction behavior during edits.
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：正式转换任务使用的计算设备。Apple Silicon Mac 默认使用 CPU，Windows 默认使用 DirectML；也可手动选择其他可用设备。
macOS arm64 提供 CPU 与 CoreML。CoreML 由系统在 Apple CPU、GPU 与 Neural Engine 之间调度，不是 PyTorch MPS backend，也不表示只使用 GPU；它的实际速度取决于模型。
Environment 检测后显示 Diagnostics。Depth & Normal、Remove Background、Upscale 与 Cutout 是默认展开的可折叠功能区，各自包含对应设置和模型状态。其中：
- Default Upscale Model：Upscale 使用的模型，默认是 General WDN x4v3。
- Maximum AI Input Size：Upscale、Depth 与 Normal Map 的 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 中执行。
下一步
继续阅读五分钟上手，用一张图片完成第一次转换。