69 lines
3.9 KiB
Markdown
69 lines
3.9 KiB
Markdown
# 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
|
||
|