nan
2dfa9b2add
- Unified reference depth calculation to use a single implementation in common/depth.py. - Removed server-side reference depth computation and adjusted depth.json to only include image_size and intrinsics. - Updated depth texture handling to ignore transparent, invalid, and non-positive pixels when calculating reference depth. - Changed reference depth calculation to use the 95th percentile of valid depth values. - Adjusted depth direction fitting to return a flat direction when no samples are available. - Removed cleanup threshold parameters from Cutout and related nodes, simplifying the interface. - Updated tests to verify new reference depth logic and ensure compatibility with existing functionality.
2.5 KiB
2.5 KiB
Why
参考深度现在有两条互不相干的算法：服务端按「源图 Alpha 阈值」取中位数写进 depth.json，Cutout 又按「选区透明比例」决定用 95 分位还是固定值 8.0。同一个深度场在不同目标下得到不同基准，历史补偿（Depth Offset = 1、固定兜底）也在互相抵消。深度纹理的 Alpha 已经同时携带源图 Alpha 与模型有效性，足以单独作为有效性判据。
What Changes
- BREAKING：服务端不再计算参考深度，
depth.json只保留image_size与intrinsics。 - 在
common/depth.py提供唯一的参考深度计算：以depth.exr的 Alpha 大于0.95、深度有限且为正为有效域，取相机 Z 的 95 百分位。 - 统计前丢弃距离超过
REFERENCE_DEPTH_LIMIT（8米）的样本，避免远景把参考深度与整个重建尺度拖到远处；选择后没有样本时参考深度取该上限，不报错也不提示。 - 深度方向拟合没有可用样本时返回无倾斜方向，Relief Plane 与 Depth Symmetry 的
Direction一律回退为(0, 0, 1)，不再报错，也不在调用点各自兜底。 - Depth Plane、Relief Plane、Depth Solid、Depth Symmetry 共用同一实现与同一统计量，不再区分「服务端基准」与「标定基准」；Cutout 把选区作为可选参考域传入，Plane 转换使用整幅深度图。
- BREAKING：参考深度从内容中位数改为上分位，基准平面移动到场景后端，Depth Plane 与 Relief Plane 的几何结果随之变化。
- 删除 Cutout 的透明比例闸门与固定基准兜底，并停止向服务端透传 Alpha Threshold；Alpha Threshold 只保留控制轮廓的既有职责。
- 把 Relief Plane 的
Depth Offset默认值从1改为0，让基准由参考深度本身决定。
Capabilities
New Capabilities
reference-depth-calibration: 定义参考深度的唯一来源、有效性判据、统计量，以及它作为深度几何与Uniform Scale归一化基准的职责。
Modified Capabilities
无。
Impact
影响 src/anyimage/server/geometry/depth_texture.py、geometry/prediction_artifacts.py、jobs/cutout.py、src/anyimage/common/depth.py、Plane 转换与 Cutout 的对象创建逻辑、tools/nodes/groups/image_relief_plane.py、相关测试与 src/anyimage/assets/O_AnyImage.blend。不新增依赖、不改变 AI 推理与节点组接口；已有场景中保存的 Modifier 数值不变，但重新生成深度几何的结果会变化。