Initial public release

openspec/specs/frame-transparent-rgb/spec.md

@@ -0,0 +1,95 @@
+# frame-transparent-rgb Specification
+
+## Purpose
+TBD - created by archiving change preserve-frame-bottom-layer-rgb. Update Purpose after archive.
+## Requirements
+### Requirement: Frame selects the bottom valid source for hidden RGB
+
+Frame SHALL 在每个输出像素复用当前有效投影和从远到近的稳定深度顺序，以第一个几何有效样本作为底层 RGB 来源。底层判定 SHALL 独立于 Alpha，并 SHALL 沿用相同深度时 active 位于最上层、其他对象按名称稳定排序的规则。
+
+#### Scenario: Transparent foreground overlaps a transparent background
+- **WHEN** 蓝色底层和红色前景覆盖同一像素，且两者 Alpha 都为零
+- **THEN** 输出 RGB SHALL 为底层蓝色
+- **AND** 输出 Alpha SHALL 为零
+
+#### Scenario: The farthest image does not cover a pixel
+- **WHEN** 最远图片在某像素没有有效投影，而其他图片具有有效投影
+- **THEN** 该像素的底层来源 SHALL 为实际覆盖它的最远有效图片
+
+#### Scenario: Transparent images share the same depth
+- **WHEN** active 与另一透明图片在相同深度覆盖同一像素
+- **THEN** 底层 RGB SHALL 来自非 active 图片
+- **AND** 多个非 active 同深度图片 SHALL 沿用现有名称排序确定底层
+
+#### Scenario: Source planes cross
+- **WHEN** 两张透明图片的平面相交，并在不同像素交换前后关系
+- **THEN** 各像素的隐藏 RGB SHALL 分别来自该像素处最底层的有效图片
+
+#### Scenario: Projection validity depends on the view mode
+- **WHEN** 一个候选底层在透视视图中位于观察方向后方，或无法取得有限且位于源边界内的交点
+- **THEN** 该样本 SHALL 不作为底层来源
+- **AND** 正交视图中有限且位于源边界内的非正深度交点 SHALL 继续具有底层资格
+
+### Requirement: Frame preserves bottom RGB in transparent output
+
+Frame SHALL 在最终 straight RGBA 转换后 Alpha 为零且具有有效源覆盖的像素中，保存底层源未乘 Alpha 的 RGB 双线性采样结果。采样 SHALL 使用现有 Frame 投影坐标和边界约定；系统 SHALL 保持当前 Alpha 可见性数值判定与最终 Alpha 结果。
+
+#### Scenario: A masked single image is framed without resampling displacement
+- **WHEN** 单张图片经 Mask 剔除 Alpha 后，以原尺寸和像素中心对齐的映射执行 Frame
+- **THEN** 透明区域的 RGB SHALL 与源图片对应像素一致
+- **AND** Alpha SHALL 保持剔除后的结果
+
+#### Scenario: Transparent source colors require interpolation
+- **WHEN** Frame 缩放或透视映射在底层完全透明区域取得非整数像素采样位置
+- **THEN** RGB SHALL 为底层原始 RGB 的双线性插值结果
+- **AND** Alpha SHALL 保持零
+
+#### Scenario: Mask Add follows a packed Frame result
+- **WHEN** 用户对 Mask 剔除后经 Frame 生成的单图 Packed Image 执行 Mask Add
+- **THEN** 提升 Alpha 的区域 SHALL 显示 Frame 保留的底层颜色
+- **AND** 该颜色 SHALL 在 Packed Image 像素中实际存在
+
+### Requirement: Frame blends foreground RGB over bottom color with independent alpha
+
+Frame SHALL 以最底层有效源的原始 RGB 双线性样本初始化颜色，随后从远到近对每个前景计算 C = P_front + C × (1 - A_front)，其中 P_front 为预乘后插值的 RGB。Alpha SHALL 从零开始对包括底层在内的全部有效层独立执行 source-over，并沿用现有数值判定。最终 RGB SHALL 不除以合成 Alpha。
+
+#### Scenario: Both layers are partially transparent
+- **WHEN** 蓝色底层 Alpha 为 0.5，红色前景 Alpha 为 0.25
+- **THEN** 输出 Alpha SHALL 为 0.625
+- **AND** straight RGB SHALL 为红色 0.25、绿色 0、蓝色 0.75
+
+#### Scenario: A visible foreground overlaps a transparent bottom layer
+- **WHEN** 蓝色底层 Alpha 为零，红色前景 Alpha 为 0.25
+- **THEN** 输出 SHALL 为 RGB (0.25, 0, 0.75) 和 Alpha 0.25
+- **AND** 恢复 Alpha 后 SHALL 保留相同 RGB
+
+#### Scenario: Hidden neighbor colors meet a visible sampling edge
+- **WHEN** 前景插值邻域同时含有可见红色像素和完全透明绿色像素
+- **THEN** 前景采样 SHALL 沿用预乘插值结果并按采样 Alpha 混入底色
+- **AND** 隐藏绿色 SHALL 不污染可见红色
+
+#### Scenario: Restoring alpha reveals a continuous transition into white
+
+- **WHEN** 前景原图的黑色背景被 Alpha 隐藏，前景边缘 Alpha 逐渐下降，且底层原始 RGB 为白色、Alpha 为零
+- **THEN** RGB SHALL 随前景 Alpha 连续过渡到白色
+- **AND** Packed Image 经 Mask Add 恢复 Alpha 后 SHALL 保留该过渡
+
+### Requirement: Source coverage takes priority over edge color extension
+
+Frame SHALL 保持完整 Canvas 和源外透明边缘扩色。存在有效源覆盖且最终透明的像素 SHALL 使用底层 RGB；没有有效源覆盖的像素 SHALL 保持 Alpha 零，并沿用紧邻可见内容的一圈 RGB 扩色，其余区域保持透明黑色。
+
+#### Scenario: Transparent source pixels border visible content
+- **WHEN** 源内部透明像素紧邻可见像素，且隐藏 RGB 与相邻可见颜色不同
+- **THEN** 源内部透明像素 SHALL 保留底层原始 RGB
+- **AND** 该 RGB SHALL 不被边缘扩色覆盖
+
+#### Scenario: The frame extends beyond all source images
+- **WHEN** Frame 包含所有源投影之外的区域
+- **THEN** 外部像素 Alpha SHALL 为零
+- **AND** 一圈扩色之外的无覆盖像素 SHALL 为透明黑色
+- **AND** Canvas 尺寸 SHALL 保持原有 Frame 规则
+
+#### Scenario: A visible edge crosses a processing chunk boundary
+- **WHEN** 可见边缘跨越 Frame 行块边界
+- **THEN** 透明边缘颜色 SHALL 与使用同一规则处理完整画布的结果一致
+