Files

nan 32bcd45d7b Add new node asset scripts for geometry and shader operations

- Implemented `build_mesh_plane.py` to create a geometry node group for mesh planes with customizable parameters.
- Created `build_shadeless.py` for a shader node group that displays color without scene lighting while preserving shadows and reflections.
- Added `validate.py` to validate the integrity of the newly created node groups and their inputs.
- Introduced `validate_cutout.py` to ensure the functionality of cutout node groups and their dependencies.
- Developed `validate_mesh_plane.py` to test the mesh plane creation and its modifier settings.

2026-08-30 00:17:29 +08:00

3.8 KiB

Raw Blame History

安装与首次配置

AnyImage 的安装分为两步：先安装 Blender Extension，再安装独立运行环境和默认模型。第二步只需在首次使用或环境版本发生变化时执行。

安装 Blender Extension

下载与你的系统匹配的 ZIP 文件：
- AnyImage.v版本号.windows-x64.zip
- AnyImage.v版本号.macos-arm64.zip
- AnyImage.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 分析输入的长边上限，默认 2048 px；只缩放分析输入，不降低颜色贴图分辨率。

Depth Plane 的 Depth Model 依次列出三档 MoGe-2 与两档 DA3；选择 DA3 时会提示该模型不能生成 normal。Cutout 固定使用 MoGe-2：全局选择 MoGe-2 时沿用对应档位，选择 DA3 时回退默认 MoGe-2。可选模型的 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、Remove Background 和 Upscale 在 AI 未就绪时仍可点击，点击后会根据状态转入 Set Up AI Environment… 或 Download Required Models…。普通 Plane、Image 编辑，以及未启用 Refine / Normal 的 Cutout Surface 与 Balloon 不要求安装 AI Environment。

下一步

继续阅读五分钟上手，用一张图片完成第一次转换。

3.8 KiB Raw Blame History Unescape Escape