AnyImage/docs/features.md

功能参考

本页概览 AnyImage 的能力。安装步骤见安装与首次配置，实际操作见工作流选择与各使用指南。

工作流

工作流	适合	输入	结果
Clipboard Image	无需先另存即可使用系统剪贴板图片	剪贴板中的静态图片	Reference Image、Plane、图片节点或笔刷 Texture
Mesh Plane	不需要深度的图片卡片与背景板	单图、视频、序列帧	带图片材质和 Geometry Nodes 的普通平面
Depth Plane	快速制作可调节的立体图片	单图、视频、序列帧	带颜色、深度与 Geometry Nodes 的面片
Surface	从单张图片恢复透视空间	单图	相机空间网格、材质与可选匹配相机
Remove Background	提取透明前景	单图、视频、序列帧	透明图片或透明序列
Image Lasso	手绘提取并原位更新图片	静态 Image Empty	Pack 的透明裁切图
Balloon	沿轮廓绘制鼓起造型	静态 Image Empty	带原图 UV 的封闭网格
Debug	检查模型原始输出	模型支持的图片或帧序列	保存在 Job 目录中的原始 Prediction

Depth Plane 与 Surface 可使用 DA3 或 MoGe-2。DA3 提供相对深度和相机信息；MoGe-2 还提供 metric depth、法线与有效区域。BEN2 为去背景和可选前景处理提供 Alpha。

Blender 交互

复制图片后，在支持的编辑器中按 Ctrl+V（macOS 为 Cmd+V）即可粘贴；图片会 Pack 到当前 .blend。3D View 的 Object Mode 默认创建 Reference Image，也可在 Redo 面板切换为 Plane；Shader Editor、Compositor 与 Geometry Nodes 创建对应图片节点，Sculpt、Vertex Paint 与 Texture Paint 则设置笔刷 Texture。详见粘贴剪贴板图片。

主要功能位于 Image Empty 的 AnyImage 右键菜单。

Convert to Mesh Plane 位于 Convert to Depth Plane 上方，不需要 AI Environment。它生成基础四边形，并由 O Mesh Plane 修改器实时处理 Thickness 与 Subdivide；Thickness 为 0 时保持单面。操作会立即执行；创建后可在 Last Operation 中调整 Shadeless 与 Keep Original。

Balloon 作为不依赖 AI 的基础工具单独排列；三个 AI 功能在缺少 Environment 或默认模型时仍可点击：缺 Environment 时转入 Set Up AI Environment…，只缺默认模型时转入 Download Required Models…。全部就绪后，菜单底部显示 AI Environment Settings…，用于打开 AnyImage 扩展偏好设置。

转换任务完成后，AnyImage 在一个 Undo 步骤中创建网格、图片、材质和修改器。源 Image Empty 是否保留由转换选项决定。

Image Box 与 Image Lasso 合并为一个工具组，分别使用 Sculpt Mode 的 Box Mask 与 Lasso Mask 图标；默认显示 Box，长按按钮可切换 Lasso。绘制时使用默认鼠标光标，并以类似 Select Tool 的白色虚线显示选区。该工具组与 Balloon Lasso 相邻，并通过一个工具栏间隔与前方的 Add Cube 分开；两组工具只位于 3D Viewport 左侧工具栏，不显示在右键 AnyImage 子菜单。它们将选区外 RGBA 清为透明黑，再以最终 Alpha 大于 0 的最小 bounding box 作为输出画布；Padding 使用整数像素向四周扩展透明边距，默认 0 px。结果会 Pack 到 .blend，同一个 Empty 的原点移动到新画布中心，显示尺寸同步调整，使裁切内容在世界空间保持重合。Keep Original 默认关闭；开启后保留源 Empty 的 Active 与选择状态，并创建未选中的裁切副本。可选 Contour 使用 BEN2 的软 Alpha 进一步收紧选区，并在分析后计算最终画布范围。

Balloon 默认在 Blender 内部生成，无需 Environment 或模型。Tool Settings 提供模式、厚度、采样距离、材质复用、Contour、Depth 与 MoGe-2 Depth Model；AI 未就绪时只禁用这三个控件，并在 Tool Settings 中显示安装按钮。Depth 会把物理距离相对化并稳健拟合初始基面，保留未截断的正负起伏。Base Plane 子 Empty 的旋转定义基面朝向，沿自身局部 Z 移动定义 middle level。

O Balloon Shape 计算 修正厚度 = abs(原 X) × Thickness，并将修正深度校准为 (0.5 × 相对基面深度 + 原始 Balloon 最大半厚度) × Depth Strength。固定的原始半厚度不乘 Thickness，因此 Thickness 与 Depth Strength 分别只控制各自分支。节点以归一化原 X 距离经 Smoother Step 得到中心程度，再插值厚度与深度。Double Sided Depth 默认关闭，背面保持 Balloon 厚度。MoGe normal 会输出为原图尺寸的 tangent-space 纹理，并通过 O Balloon Layer 的 Normal Strength（默认 0.5）补偿网格无法表达的细节。

新建 Balloon 材质会用 Custom Properties 保存源 Image datablock 和可选 normal Image 的直接引用。Reuse Material 优先按这些标记匹配，不依赖材质或节点组名称；普通与 Depth 材质分别复用。Depth Balloon 的共享 normal 会逐次合并新套索的有效区域，避免复用材质时丢失其他套索的法线。

动画

Depth Plane 和 Remove Background 支持 Movie 与 Image Sequence。它们按 Image Empty 的帧范围处理素材，并生成与场景帧对应的颜色或深度序列。

Blender 无法整体 Pack 图片序列，因此动画结果会继续引用 Job 目录。保存或移动 .blend 时，应同时保留这些外部文件。详见动画与序列帧。

运行环境

AI 任务在独立 Python Environment 中通过 ONNX Runtime 执行。Blender 负责界面、任务提交和结果导入，Job Server 负责模型与文件处理。

默认 Storage Root 为 ~/.anyimage，其中保存 Environment、模型、日志和 Job 结果。连续任务会复用已加载的模型 Session；DA3 与 MoGe-2 共享一个深度模型缓存位置，BEN2 可同时保留。

安装、下载和推理都在后台运行，并通过状态栏提供进度与取消操作。详细设计见Job Server。

模型与调试

正式功能使用以下 ONNX 模型：

• MoGe-2 ViT-S、ViT-B、ViT-L Normal
• DA3 Small、DA3 Base
• BEN2 Base

首次安装会准备 MoGe-2 ViT-S Normal 与 BEN2 Base，其他模型可从 AnyImage 扩展偏好设置按需下载。

Debug 工作流保存模型 API 的直接返回，适合验证模型、设备与输入。Depth Plane 和 Surface 则在模型结果之上继续生成 Blender 可用的贴图与几何。文件字段见输出格式。