Initial public release

openspec/specs/depth-alpha-semantics/spec.md

@@ -0,0 +1,65 @@
+# 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
+