Initial public release

openspec/specs/selection-rasterization/spec.md

@@ -0,0 +1,68 @@
+# selection-rasterization Specification
+
+## Purpose
+TBD - created by archiving change simplify-selection-rasterization. Update Purpose after archive.
+## Requirements
+### Requirement: Selection uses one overlap-preserving fill
+系统 SHALL 使用 non-zero winding 栅格化所有 Selection Path，使同方向自交或重复绕行的重叠区域保持选中，并且不得暴露可切换的填充规则。
+
+#### Scenario: Lasso overlaps itself
+- **WHEN** Image Tool 或 Cutout 的 Selection 路径以同一方向重复包围一个区域
+- **THEN** 该重叠区域在 Viewport 预览和最终 Selection Mask 中均保持选中
+
+#### Scenario: Simple path is selected
+- **WHEN** Selection 路径是普通矩形、半平面、凹多边形或不自交 Lasso
+- **THEN** 系统产生与既有 non-zero 填充相同的选中区域
+
+### Requirement: Selection Path contains its inversion state
+系统 SHALL 使用只包含普通二维点数组和 Invert 的不可变 Selection Path 值在用户手势与实际 Image 或 Cutout 操作之间传递 Selection；该类型 SHALL 保留完整值的 JSON 编解码，但不得包含填充规则。
+
+#### Scenario: Image Tool submits a Selection
+- **WHEN** 用户完成 Image Tool 手势
+- **THEN** 同一 Operator 把包含 Points 与 Invert 的 Selection Path 直接交给实际图片编辑
+
+#### Scenario: Cutout menu creates Shape operations
+- **WHEN** Cutout Pie Menu 为当前点数组创建 Shape 按钮
+- **THEN** 菜单将包含 Points 与 Invert 的完整 Path 编码一次，并为每个 Shape Operator 复用同一字符串
+
+#### Scenario: Cutout Shape operation restores the Selection
+- **WHEN** 用户点击任一 Cutout Shape 按钮
+- **THEN** Shape Operator 从单一 Path JSON 恢复 Points 与 Invert 后再进行栅格化
+
+### Requirement: Selection rasterization uses scanline events
+系统 SHALL 通过路径边与扫描行的交点事件构建 non-zero winding Mask，每条路径边不得重复创建扫描行块乘以 Selection 宽度的二维像素比较数组。
+
+#### Scenario: High-resolution Lasso is rasterized
+- **WHEN** 系统处理高分辨率图片上的多点 Lasso
+- **THEN** 每条边只为实际跨越的扫描行产生端点事件，所有端点完成后每行执行一次水平累计
+
+#### Scenario: Path point count increases
+- **WHEN** Selection 画布不变而路径点数增加
+- **THEN** 栅格器增加交点事件处理，不按每个新增点重新扫描完整二维 Selection 像素区域
+
+### Requirement: Non-inverted Selection processing stays local
+系统 SHALL 对非 Invert Selection 只在裁切后的路径范围内执行填充、抗锯齿、源 Alpha 合并和可见 bounds 计算；抗锯齿范围 MUST 包含固定卷积核所需的边缘 padding。
+
+#### Scenario: Local Selection is rasterized
+- **WHEN** 非 Invert Selection 只覆盖源图的一部分
+- **THEN** 中间 Mask 和 Alpha 运算范围限制在路径 bounds 及必要的抗锯齿 padding
+
+#### Scenario: Inverted Selection is rasterized
+- **WHEN** Selection 启用 Invert
+- **THEN** 系统使用完整图片范围表达路径外区域，但仍只累计一次 scanline 事件
+
+### Requirement: Optimized rasterization preserves Mask semantics
+系统 MUST 保持现有像素中心判定、Invert、抗锯齿核、Alpha 阈值、空 Selection 警告和最终局部 Selection Mask bounds 语义。
+
+#### Scenario: Selection has source Alpha
+- **WHEN** Selection Path 与源图 Alpha 一起栅格化
+- **THEN** 系统只保留 Alpha 高于阈值且 non-zero winding Mask 有效的像素，并返回其紧致 bounds
+
+#### Scenario: Selection has no visible pixels
+- **WHEN** Selection 与图片范围或可见源 Alpha 没有交集
+- **THEN** 系统报告空 Selection，且不向后续 Image、Cutout 或 AI 操作提交结果
+
+#### Scenario: Equivalent Selection is processed
+- **WHEN** 相同 Selection Path、源 Alpha、阈值和抗锯齿设置由参考实现与优化实现处理
+- **THEN** 两者产生逐值一致的 Mask values 和相同 bounds
+