Files
AnyImage/docs/outputs.md
nan 1613bd3194 Add image perspective editing and related tools
- Implemented the Image Perspective tool for editing image corners in Blender.
- Created a new operator `EditImagePerspective` to handle the perspective transformation.
- Added a preview feature for the perspective adjustment.
- Introduced the `ImagePolylineTool` for editing image masks with polylines.
- Developed backend support for Real-ESRGAN model inference, including ONNX integration.
- Added functionality for image masking and background removal.
- Created unit tests for the Real-ESRGAN ONNX model to ensure correct preprocessing and inference.
2026-08-22 22:17:10 +08:00

2.3 KiB
Raw Blame History

输出格式

本页记录 Job 产物的稳定用途与主要字段。日常使用只需了解 Job 文件夹。

文件概览

Job 主要文件 内容
generate-depth results.npz、深度与颜色序列 Depth Plane 所需深度、相机和贴图
generate-surface mesh.npz、normal.png、颜色层 Surface 网格、相机与材质输入
remove-background color.0001.png 起 带 Alpha 的颜色层
refine-image-mask selection-input.png、image.png、bounds.json BEN2 细化后的局部内容 mask 与原图坐标 bounds
analyze-balloon lasso-input.png,按选项输出 foreground.png、contour.json、depth.npz、normal.png 套索约束输入、BEN2 轮廓与 MoGe-2 深度、法线
debug-da3 prediction.npz DA3 API 返回
debug-moge2 prediction*.npz MoGe-2 API 返回
debug-ben2 foreground*.png BEN2 API 返回
debug-realesrgan-general-x4v3 prediction*.png Real-ESRGAN General x4v3 的 4× RGB API 返回

NPZ 字段

DA3 Depth 结果包含 depth、conf、extrinsics 与 intrinsics。MoGe-2 Depth 结果包含 depth、normal、mask 与 intrinsics。

Balloon Depth 的 depth.npz 包含相对 depth_signal、归一化拟合平面 baseline_vector、valid、reference_depth、裁切原点与输入尺寸。Geometry Nodes 将归一化原 X 距离经 Smoother Step 后作为 Thickness 与 Depth 的混合系数。normal.png 是铺回原图尺寸的 tangent-space 法线;套索和有效区域外为中性法线。

Surface 的 mesh.npz 包含 vertices、faces、uv、intrinsics、image_size 与 reference_depth,以及 Geometry Nodes 使用的网格属性。

Debug 文件保持模型 API 的数据形态,用于比较推理结果;正式 Job 则提供 Blender 导入所需的派生数据。General x4v3 的浮点 RGB 返回只做 [0, 1] 限制和 8-bit PNG 序列化,不做额外画质处理。

图片序列

正式颜色层统一使用 color.0001.* 起始的文件名。深度动画使用 EXR 序列以保存浮点值。源 Empty 为 Movie 或 Sequence 时,Blender 按序列载入这些文件,即使任务只输出一帧。

MoGe-2 Surface 的法线单独保存为 normal.png。材质在 Blender 端创建,不属于 Job 文件格式。