nan
7f6e47432e
- Introduced a new design for selection rasterization that decouples the selection geometry from the image content, ensuring that the SelectionMask is independent of the source image's alpha and color. - Updated the `rasterize_selection_path` function to only accept selection paths and image dimensions, removing parameters related to source alpha and alpha thresholds. - Implemented a new approach for handling selection paths using non-zero winding fill, ensuring overlapping areas are preserved. - Enhanced performance by utilizing a scanline algorithm for rasterization, significantly reducing processing time for high-resolution images. - Updated internal documentation and added comprehensive tests to validate the new behavior and performance improvements. - Ensured backward compatibility by maintaining existing interfaces where necessary while introducing breaking changes in the selection processing logic.
3.8 KiB
3.8 KiB
ADDED 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