# cutout-split-boundary-shaping Specification

## Purpose
TBD - created by archiving change refine-cutout-split-boundaries. Update Purpose after archive.
## Requirements
### Requirement: Split boundary triangle cleanup

Depth Cutout SHALL 在 Split 后、投影与边界平滑前，一次删除三个顶点均在当前边界上的三角面。

#### Scenario: Remove a boundary ear
- **WHEN** Split 输出包含三个边界顶点的三角面及包含内部顶点的相邻三角面
- **THEN** 前者被删除，后者保留，清理不递归传播

### Requirement: Boundary smoothing after cleanup

Depth Cutout SHALL 在三角面清理后的几何上沿用现有 Boundary Smooth，保留其参数语义。

#### Scenario: Smooth the cleaned boundary
- **WHEN** 全边界三角面清理完成且 Boundary Smooth 大于 0
- **THEN** 现有平滑在保留几何上求值，已删除三角面不参与平滑

#### Scenario: Disable boundary smoothing
- **WHEN** Boundary Smooth 为 0
- **THEN** 深度及网格平滑步骤保持各自输入值，其他切口形状处理继续按当前参数求值

### Requirement: Rounded split thickness profile

Depth Cutout SHALL 使新切口的 Balloon 厚度轮廓在边界为零，在邻近区域连续恢复，并使 Edge Round 影响新切口的圆润过渡。

#### Scenario: Form a new meeting boundary
- **WHEN** Split 产生内部切口并执行 Balloon 厚度成形
- **THEN** 新切口前后表面在零厚度边界交汇，影响带外保留原厚度轮廓

#### Scenario: Adjust edge rounding
- **WHEN** 用户增加 Edge Round
- **THEN** 新切口的过渡带随之加宽，最终几何呈现圆润过渡的变化，原 Alpha 轮廓继续使用既有规则

#### Scenario: No new boundary
- **WHEN** 当前 Split 结果没有新增边界
- **THEN** 切口轮廓步骤保留原厚度字段

### Requirement: Thickness weighted normal smoothing

Depth Cutout SHALL 始终按归一化厚度的 smoothstep 权重混合原法向与平滑法向，再归一化；保留 Normal Smooth 对平滑迭代数的控制。

#### Scenario: Thin thickness
- **WHEN** Balloon Thickness 趋于 0，或 Uniform Thickness 与 Reference Depth 的比例趋于 0
- **THEN** 法向平滑引入的方向偏差连续趋于 0，结果保持有限

#### Scenario: Full smoothing strength
- **WHEN** 归一化厚度达到或超过 1
- **THEN** 使用完整的既有法向平滑结果

#### Scenario: Normal smoothing disabled
- **WHEN** Normal Smooth 为 0
- **THEN** 混合结果等于对应消费几何上的原法向归一化结果

### Requirement: Live cutout controls

Depth Cutout SHALL 在每次参数变更后重新求值 Split、边界平滑和厚度成形，保留现有参数接口。

#### Scenario: Edit the loaded modifier
- **WHEN** 用户加载节点资产后连续修改 Split Threshold、Boundary Smooth 和 Edge Round
- **THEN** 几何按新参数实时更新，恢复相同参数可重现相同结果，不依赖冻结的中间网格

### Requirement: Loadable node asset

本功能 SHALL 随正式节点资产交付，所有相关节点组及测试辅助图保持 Capture Attribute 为零，并保留用户属性。

#### Scenario: Independently load built asset
- **WHEN** 在独立 Blender 进程加载重建资产
- **THEN** 接口、动态形状求值和必要属性均正确，输出不含实验诊断或已结束生命周期的内部临时属性