鸿蒙像素画板:一笔画完,撤销为什么要只退一步

举报
yd_49100212 发表于 2026/11/16 19:41:42 2026/11/16
【摘要】 从华为云鸿蒙像素画板案例出发,用一笔绘画、同色操作和画廊编辑说明撤销历史的边界,并给出可直接操作的检查方法。

鸿蒙像素画板:一笔画完,撤销为什么要只退一步

在画板上拖出一条线,发现颜色选错了,点一次撤销,通常会期待整条线消失。如果只退掉末尾一个格子,还要再点十几次,画画的节奏就断了。这个差别来自历史记录的边界:手指移动会产生许多事件,用户完成的却是一笔。

华为云鸿蒙开发实践中心的“像素画板”案例,把画布限制在 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

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。