nan
1994d38ccd
- Introduced tests for color image handling, ensuring source preservation and premultiplied alpha usage. - Implemented tests for brush stroke operations, validating segment boundaries and brush anti-aliasing. - Added tests for frame anti-aliasing, confirming correct rendering behavior with various alpha values and depth settings. - Created tests for frame projection, ensuring accurate overlap calculations and half-plane clipping. - Developed tests for image premultiplied retention, verifying behavior during loading and packing processes. - Added undo functionality tests for mask operations, ensuring single transaction behavior during edits.
3.0 KiB
3.0 KiB
Purpose
保证 Brush 的笔画范围准确跟随屏幕轨迹，预览与最终覆盖使用一致的几何并集，使长笔画持续响应，并提供清晰的完成、取消和单步撤销行为。
ADDED Requirements
Requirement: Stroke simplification bounds the whole segment error
Brush 与共享自由手绘手势 SHALL 将每个保留原始采样点到简化线段的偏差限制在 0.75 个 Viewport 像素以内。Polyline 的已提交顶点 SHALL 按用户输入保留。
Scenario: Dense curved stroke is simplified
- WHEN 用户以高密度采样绘制弯曲轨迹
- THEN 整段简化误差不超过 0.75 px，连续尾点替换不会累计放大偏差
- AND 预览与提交使用同一有效路径
Requirement: Brush antialiases the complete geometric union
Brush SHALL 对全部圆形印记和连接条的完整几何并集应用一次抗锯齿。几何并集相同的图元分段方式 SHALL 产生相同覆盖值。
Scenario: Stroke turns through a right angle
- WHEN 半径为 2、5 或 25 px 的 Brush 形成直角连接或自交
- THEN 内部连接处不会因图元各自的抗锯齿边界减少覆盖
- AND 提交覆盖符合完整并集的抗锯齿参考结果
Scenario: Equivalent geometry has different segmentation
- WHEN 同一个直线 footprint 由不同数量的共线连接条描述
- THEN 输出 Alpha 覆盖在浮点误差内一致
Requirement: Long stroke preview remains responsive
Brush SHALL 在每次有效路径变化后显示整条待提交笔画的合并填充和外轮廓。局部新增笔画的预览计算 SHALL 限定于变化范围，静止重绘 SHALL 复用已有预览结果。
Scenario: A short segment is appended to a long stroke
- WHEN 已有 800、1600 或 3200 个屏幕点，用户追加只影响局部范围的短线段
- THEN 预览更新覆盖新范围并保留其他区域，计算范围不扩展为完整历史笔画
- AND 预览与相同路径的完整几何参考一致
Scenario: Tail changes or crosses previous geometry
- WHEN 活动尾段变化或与已有笔画相交
- THEN 预览清除失效尾段的覆盖及内部轮廓，呈现当前完整 footprint
Requirement: Mask provides one transactional gesture edit
Mask SHALL 在启动时冻结 Scene 的 Gesture、Mode 和 Radius；完成时一次提交 Packed Image 并支持单步 Undo。Mask SHALL NOT 暴露无法执行的操作后参数重做面板。
Scenario: Stroke is completed and undone
- WHEN 用户完成一个 Brush、Lasso 或 Polyline Mask 后执行 Undo
- THEN 源图片与对象状态恢复，整次手势只产生一个编辑步骤
Scenario: Stroke is cancelled or tool changes
- WHEN 用户按 Esc、RMB，或切换工具取消未提交手势
- THEN 原 Image 不变，所有操作内路径与预览资源释放
Scenario: User edits tool settings
- WHEN 用户修改 Scene 中的 Mask 工具设置
- THEN 新手势采用新设置，进行中的手势保持启动时设置