鸿蒙像素画板:一笔画完,撤销为什么要只退一步
鸿蒙像素画板:一笔画完,撤销为什么要只退一步
在画板上拖出一条线,发现颜色选错了,点一次撤销,通常会期待整条线消失。如果只退掉末尾一个格子,还要再点十几次,画画的节奏就断了。这个差别来自历史记录的边界:手指移动会产生许多事件,用户完成的却是一笔。
华为云鸿蒙开发实践中心的“像素画板”案例,把画布限制在 32×32,提供画笔、橡皮、填充和吸管,并约定最多撤销 30 次画面修改。小画布很适合把这件事看清楚。下面按案例给出的交互规则,讨论一笔绘画怎样进入历史,以及几种容易漏掉的操作。
从按下到抬起,保存一笔的起点
可以在手指按下时保留当前像素矩阵,移动时更新画布,到抬起时再决定要不要记入撤销栈。这样,一笔经过多少格都不会改变撤销次数。用于历史的矩阵需要逐行复制;如果只复制外层数组,内部的行仍被共享,后续上色就可能同时改掉“旧画面”。
按下时先留一个临时快照,不必立即把它算作正式历史。假设画布已经有一块红色,用户又用红笔划过同一片区域,画面没有变化,这次操作就不该占掉一步撤销。更容易漏掉的是重做:用户刚撤销一笔,随后重复涂了同色,原来那一步仍应可以重做。只有实际产生新修改,才清空重做栈。
例如先画红线,再画蓝线,然后撤销蓝线。此时用红色沿已有红线描一遍,重新点击“重做”,蓝线应回来。如果它回不来,可以检查代码是不是在每次 Down 事件里就清空了重做栈。把清空动作移到确认像素发生变化的位置,通常更符合这套交互规则。
案例还把 Up 和 Cancel 都作为一笔结束的信号。处理 Cancel 时需要明确保留还是回退已经画出的部分,并一并结束手势状态。若画布外面套着可滚动页面,还要恢复页面滚动,否则被打断的一笔可能让整个页面一直停在“正在绘画”的状态。
线要补齐,填充只做一次
手指从一个格子滑到另一个格子,中间未必每格都有 Move 事件。只把事件落点上色,快速斜线会留下空洞。案例使用 Bresenham 连线,在相邻两个落点之间补出经过的格子。补点和历史记录各有自己的边界:一笔中可以补很多格,结束时仍然只记一次修改。
坐标换算也值得单独检查。若画布实际宽度为 W,横向格子编号可以按 floor(x / W × 32) 计算,再判断结果是否落在 0 到 31。触摸到了右侧边缘,结果可能等于 32。把越界输入直接排除,可以避免把画布外的拖动误记成边缘绘画。页面缩放后应使用实际画布尺寸,不能沿用设计稿上的固定宽度。
填充工具则在首次按下时处理一次相连区域。案例采用四邻域,只有上下左右相邻且颜色相同的格子会连在一起,对角接触不算。移动手指时若再次触发填充,就可能把原本只想改的一块区域扩展到旁边。填充色和原色相同时可以直接结束,也不会增加历史。
吸管只读取颜色。按案例约定,点到透明像素不更新当前颜色;点到有色像素则改变选中色。两种情况都没有修改画面,因此都不应该消耗撤销次数。把工具事件统一塞进历史栈之前,需要先判断它到底改了什么。
保存作品以后,历史从哪里开始
撤销栈保存的是当前编辑过程,画廊保存的是作品。用户打开一幅已有作品时,可以把读出的像素作为新的历史起点,再记录本次编辑。如果把加载过程也当作一次绘画,第一次撤销可能退回打开作品前的空白画布,看起来就像作品被清掉了。
“清空”和“新建”也需要分别处理。这个案例里,清空保留当前作品 ID,并允许撤销;新建确认后解除旧作品的关联,之后保存为另一幅作品。编辑旧图再保存,应覆盖同一个 ID。否则每改一次颜色,画廊里就多出一份副本。
验证时可以先保存一幅蘑菇图,重新打开,把伞帽改成蓝色并保存,再返回画廊。作品数量应该不变,预览应该更新。接着重新打开作品并尝试撤销,检查是否会错误地回到空白。最后关闭并重新启动应用,确认已保存像素仍在;当前会话的撤销历史则按案例约定重新开始。
这些检查只需要一条线、一次填充和一幅保存过的图,就能把触摸事件、画面修改和作品存储之间的关系走一遍。后续增加自定义颜色或更大的画布时,也可以保留这组操作作为回归检查。
参考:华为云鸿蒙开发实践中心“像素画板”案例及其公开仓库 HarmonyOS-AtomSer-pixel-paint,阅读日期 2026 年 11 月 16 日。
案例地址:https://harmonybp.developer.huaweicloud.com/cases/b5ac967624594fb1bf1b8ec0ce00dbd5
- 点赞
- 收藏
- 关注作者
评论(0)