nan
b5a2f9690c
- Added depth.py for MoGe-2 depth sampling and balloon deformation functionality. - Introduced validate_balloon_asset.py to validate balloon shape modifiers and material properties in Blender. - Enhanced test_server.py with new unit tests for balloon depth analysis and job progress tracking. - Updated existing tests to improve code clarity and maintainability.
2.0 KiB
2.0 KiB
输出格式
本页记录 Job 产物的稳定用途与主要字段。日常使用只需了解 Job 文件夹。
文件概览
| Job | 主要文件 | 内容 |
|---|---|---|
generate-depth |
results.npz、深度与颜色序列 |
Depth Plane 所需深度、相机和贴图 |
generate-surface |
mesh.npz、normal.png、颜色层 |
Surface 网格、相机与材质输入 |
remove-background |
color.0001.png 起 |
带 Alpha 的颜色层 |
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 返回 |
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 导入所需的派生数据。
图片序列
正式颜色层统一使用 color.0001.* 起始的文件名。深度动画使用 EXR 序列以保存浮点值。源 Empty 为 Movie 或 Sequence 时，Blender 按序列载入这些文件，即使任务只输出一帧。
MoGe-2 Surface 的法线单独保存为 normal.png。材质在 Blender 端创建，不属于 Job 文件格式。