3.3 KiB
3.3 KiB
depth-alpha-semantics Specification
Purpose
TBD - created by archiving change separate-depth-alpha-and-model-input. Update Purpose after archive.
Requirements
Requirement: Model input preserves source RGB
系统 SHALL 使用输入图 RGB 准备 MoGe2 输入，缩放 SHALL 基于 RGB 执行，alpha MUST 保持为独立信号。
Scenario: Same RGB with different alpha
- WHEN 两张尺寸、RGB 相同的图仅 alpha 不同，并使用相同输入尺寸上限
- THEN 它们生成的模型 RGB 输入相同，包括触发缩放的情况
Scenario: Transparent sky retains color context
- WHEN Remove BG 输出保留天空 RGB 并将其 alpha 设为零
- THEN MoGe2 输入保留天空 RGB，输出深度产物对应像素的 Alpha 为零
Requirement: Alpha silhouette determines depth extension
系统 SHALL 根据原图 alpha 确定可见分量和轮廓修补范围，使用同一分量的可靠深度延伸轮廓。模型有效性 MUST 用于排除不可靠来源，修补范围 SHALL 独立于模型 mask 孔洞。延伸 SHALL 保持原始 alpha、模型有效性与未修补区域的深度。
Scenario: Repair the alpha edge
- WHEN alpha 轮廓内侧保护带及轮廓外采样带存在不稳定深度，且分量内部存在可靠来源
- THEN 系统使用该分量可靠深度修补边界，并保持目标像素的相机投影射线
Scenario: Internal mask hole
- WHEN 一个低 mask 区域完全位于 alpha 轮廓保护带以外的内部
- THEN 该区域不会仅因 mask 偏低而成为延伸目标，其模型有效性保持原值
Scenario: Fully opaque input
- WHEN 输入 alpha 全为 1
- THEN 系统保留原始深度场，包括低 mask 区域
Scenario: Component lacks reliable depth
- WHEN 某个 alpha 分量没有可靠深度来源
- THEN 该分量保留原始深度，不从其他分量借用深度
Requirement: Depth artifact alpha combines coverage and model validity
depth.exr SHALL 在 RGB 保存相机空间 XYZ，在 Alpha 保存对齐预测尺寸的原图 alpha 与原始模型有效性的逐像素乘积。两个信号 MUST 保留连续值，补边 MUST 保持乘积所用的原始信号。
Scenario: Continuous values
- WHEN 某像素原图 alpha 为 0.8，模型有效性为 0.75
- THEN 导出的 Alpha 为 0.6，XYZ 保留该像素的深度处理结果
Scenario: Invisible or model-invalid pixel
- WHEN 原图 alpha 或模型有效性任一为零
- THEN EXR Alpha 为零，XYZ 仍保存可供采样的数值场
Requirement: Geometry consumers use depth channels by purpose
Depth Plane SHALL 通过现有 Valid Only 和 Validity Threshold 按 EXR Alpha 剔除。Cutout SHALL 根据自身轮廓生成曲面并读取 XYZ，EXR Alpha 不得引入额外曲面剔除。
Scenario: Depth plane culling
- WHEN Valid Only 开启且原图 alpha 或模型有效性使乘积低于当前阈值
- THEN 该采样位置按现有节点的面域规则参与剔除
Scenario: Culling disabled
- WHEN 用户关闭 Valid Only
- THEN 完整细分网格继续进入深度投影与厚度处理
Scenario: Cutout keeps its contour
- WHEN Cutout 轮廓内含低 EXR Alpha 区域
- THEN 曲面拓扑保持由 Cutout 轮廓决定，深度采样使用导出的 XYZ