nan
32bcd45d7b
- 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.
AnyImage
AnyImage 是一款 Blender Extension，用于把图片带入可编辑的 2.5D 工作流：粘贴和清理图片、创建普通 Plane 或 Depth Plane、从套索生成 Cutout Shape，并通过独立 AI Environment 去除背景或进行 4× 高清放大。
完整说明从文档首页开始；首次使用请阅读安装与首次配置和五分钟上手。
主要功能
- 在 3D View、Node Editor 与绘画模式中用
Ctrl+V（macOS 为Cmd+V）粘贴并 Pack 剪贴板图片 - 将 Image Empty 转换为带
O Mesh PlaneGeometry Nodes 的普通 Plane - 使用 MoGe-2 或 DA3 将静态图转换为可调 Depth Plane
- 用 Cutout 套索在图片可见 Alpha 内生成 Surface、Balloon、Depth Balloon 或 Depth Surface，并通过统一的
O Image Cutout修改器切换 Shape、按创建分辨率清理碎岛和调整表面 - 用 Image Box、Lasso、Line、Polyline 和 Perspective 清理或矫正静态图片
- 用 BEN2 为单图、视频或序列帧去除背景
- 用三档 ONNX 模型将单图、视频或序列帧放大 4×
AI 推理运行在 Blender 之外的独立 Python 3.12 Environment 中。Blender 进程只负责 UI、任务提交和结果导入，不加载 ONNX Runtime 或模型权重。
全局 Maximum AI Input Size 默认限制 Upscale、Depth 与 Normal 分析的长边为 2048 px；超过时等比缩放分析输入，但不会降低颜色贴图分辨率。Cutout 在套索裁切后应用该限制，并以同一分析尺度计算网格密度。
安装
- 下载与系统匹配的扩展包：
AnyImage.v<version>.windows-x64.zipAnyImage.v<version>.macos-arm64.zipAnyImage.v<version>.linux-x64.zip
- 在 Blender 打开 Edit > Preferences > Extensions，选择 Install from Disk 并直接安装 ZIP。
- 选中 Image Empty，在右键 AnyImage 菜单中点击 Set Up AI Environment…。
- 安装完成后，在扩展 Preferences 中确认默认 MoGe-2、BEN2 与 Real-ESRGAN WDN 模型显示 Ready。
普通 Plane、基础 Image 编辑，以及不带 Refine / Normal 的 Cutout Surface 与 Balloon 无需 AI Environment。Cutout 的 Depth 与 Normal 统一使用 MoGe-2；两者同时启用时共享同一次 Prediction，不会重复运行模型。
快速使用
选中 Image Empty 后，右键 AnyImage 菜单提供：
- Convert to Plane：同步创建普通图片网格；
- Convert to Depth Plane：使用 Preferences 中选择的深度模型处理静态图；
- Remove Background：生成透明图片或序列；
- Upscale：使用默认高清模型生成 4× 结果。
3D Viewport 工具栏提供 Image Mask、Perspective 与 Cutout。工作流对比和当前输入范围见选择工作流。
源码结构
src/anyimage/
├── operators/ # Blender 交互、任务提交与结果导入
├── server/ # 无 Blender 依赖的 Job、媒体、选区、几何与模型能力
├── assets/ # Geometry Nodes 与 Shader 资产
├── runtime.py # BlendJob Runtime 配置
└── __init__.py # Blender 注册入口
程序边界、功能文件结构和调用流程见内部实现总览。文档按开始使用、功能指南、参考和内部实现分层，不在 README 重复内部算法细节。
开发
仓库开发环境使用 CPython 3.11：
uv sync
uv run pytest
uv run python pack.py
节点资产脚本必须由 Blender 执行，具体命令和验证范围见节点资产。完整开发、打包与 CI 说明见开发与发布。
许可证
AnyImage Extension 代码采用 GPL-3.0-or-later。模型权重使用各自上游许可证。