AnyImage/openspec/specs/cutout-depth-extension/spec.md

cutout-depth-extension Specification

Purpose

TBD - created by archiving change restore-cutout-depth-extension. Update Purpose after archive.

Requirements

Requirement: Reliable depth sources retain the tested alpha rule

系统 SHALL 按剪裁 Alpha 定义可见域和8连通分量；供体候选 SHALL 位于同一可见分量内，并满足固定 Alpha ≥ 0.95、Validity > 0.5、有限正深度。系统 SHALL 保留内侧2像素保护及旧版回退规则。

Scenario: Low clipping threshold retains translucent edges

• WHEN 剪裁 Alpha 为0.1，边缘 Alpha 为0.1且同分量存在可靠核心
• THEN 边缘属于可见域但不能充当供体，其深度使用同分量可靠来源补齐

Scenario: Narrow component lacks a core

• WHEN 分量内缩2像素后没有可靠供体
• THEN 使用本分量未内缩的可靠候选；候选也为空时保留该分量原预测

Requirement: Extension preserves reliable interior and projection

系统 SHALL 沿用旧算法补齐轮廓边缘及可见域外4个深度图像素，使用sigma=0.8、半径3像素的分量内局部平滑。系统 SHALL 保留内部受保护区域及未修补像素，按目标像素射线重建变化像素的XYZ。

Scenario: Filtered sampling crosses an outline

• WHEN 采样邻域跨越主体轮廓
• THEN 邻近透明侧4像素范围提供延伸深度，各分量采用自身供体和平滑输入，其他可见分量保持各自处理结果

Scenario: Corrected points retain their pixel location

• WHEN 像素继承供体Z
• THEN XYZ仍投影至目标像素，归一化投影误差小于1e-6；原Alpha和validity保持不变

Scenario: Opaque input and interior validity holes

• WHEN 输入完全不透明，或透明图内部存在模型validity孔洞
• THEN 完全不透明输入原样返回；内部孔洞只限制供体资格，不扩大轮廓修补区域

Requirement: Only cutout depth artifacts use corrected frames

系统 SHALL 仅由Cutout深度请求开启延伸，使用同一修复Frame写入深度和Metadata。共享入口默认 SHALL 关闭修复，Normal SHALL 使用原始Frame，EXR A SHALL 保持原Alpha乘原validity。

Scenario: Cutout requests depth and normals

• WHEN 同一Cutout请求同时生成深度和Normal
• THEN 只执行一次模型预测，深度及Metadata来自修复Frame，Normal来自原始Frame

Scenario: Other artifact requests

• WHEN 普通Depth Plane、全景深度或仅Normal请求运行
• THEN 沿用各自原始预测产物行为

Requirement: Real image verification uses a fixed prediction

验收 SHALL 在工作区外使用用户蜘蛛和头骨原图、固定同一Alpha与预测，在现有几何节点及相同参数下仅替换原始/延伸深度产物，记录截图、耗时与残余问题。

Scenario: Full modifier evaluation

• WHEN 两张图完成深度产物对照
• THEN 全部结果非空、坐标有限、无节点警告，报告一次补边与节点求值的独立耗时，并检查Normal着色