nan
08309f719d
- Added a new cutout tool for selecting regions in images, allowing users to choose mesh shapes based on selected areas. - Introduced depth generation capabilities for rasterized images, including normal data extraction. - Created jobs for generating depth planes and region data, enhancing the AI data generation workflow. - Developed a selection refinement process for cutout regions, improving accuracy in generated outputs. - Established a new region module for handling rasterized image regions and their associated AI generation tasks. - Enhanced node graph builders for asset generation, facilitating smoother integration of new features.
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×，并独立重采样 Alpha
AI 推理运行在 Blender 之外的独立 Python 3.12 Environment 中。Blender 进程只负责 UI、任务提交和结果导入，不加载 ONNX Runtime 或模型权重。
全局 Maximum AI Input Size 默认设为 2048 px。当前图片长边达到该值时 Upscale 不可用；Depth 与 Normal 的分析输入超过该值时等比缩小，但不会降低颜色贴图分辨率。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，不会重复运行模型。Cutout Normal 可选择 None、基于完整图片平面的 Tangent Space 浮雕，或直接编码到对象局部轴的 Object Space。
快速使用
选中 Image Empty 后，右键 AnyImage 菜单提供：
- Convert to Plane：同步创建普通图片网格；
- Convert to Depth Plane：使用 Preferences 中选择的深度模型处理静态图；
- Remove Background：生成透明图片或序列；
- Upscale：使用默认高清模型把当前图片编辑为 4× 结果。
3D Viewport 工具栏提供 Image Mask、Perspective 与 Cutout。Remove Background、Upscale、Image Mask 和 Perspective 都只更新当前 Empty；共享 Image 会保留原数据，并为当前 Empty 创建独立结果。工作流对比和当前输入范围见选择工作流。
源码结构
src/anyimage/
├── operators/ # Blender 交互、任务提交与结果导入
├── server/ # 无 Blender 依赖的 Job、媒体、选区、几何与模型能力
├── assets/ # Geometry Nodes 与 Shader 资产
├── runtime.py # BlendJob Runtime 配置
└── __init__.py # Blender 注册入口
程序边界、功能文件结构和调用流程见内部实现总览；开发新功能前先查看Common 公共函数，复用已经存在的 Image、ImageGeometry、Material 和对象替换入口。文档按开始使用、功能指南、参考和内部实现分层，不在 README 重复内部算法细节。
开发
仓库开发环境使用 CPython 3.11：
uv sync
uv run pytest
uv run python pack.py
节点资产脚本必须由 Blender 执行，具体命令和验证范围见节点资产。完整开发、打包与 CI 说明见开发与发布。
许可证
AnyImage Extension 代码采用 GPL-3.0-or-later。模型权重使用各自上游许可证。