鸿蒙像素画板元服务拆解:Canvas、Bresenham 与双栈撤销的实现要点

举报
yd_265411139 发表于 2026/11/16 09:08:37 2026/11/16
【摘要】 基于鸿蒙开发实践中心的「像素画板」元服务案例,拆解其技术架构与实现要点:Canvas 绘制与状态分离、Bresenham 连续笔画、四邻域显式栈填充、双栈撤销的入栈规则,以及 preferences 本地存储的幂等更新。

一、这个案例在做什么

「像素画板」是鸿蒙开发实践中心里的一个元服务案例:32×32 的网格画布,画笔、橡皮、填充、吸管四种工具,15 种颜色加透明共 16 项调色板,四个几何模板(爱心、笑脸、蘑菇、宝剑),支持撤销重做,作品能用 preferences 存到本地画廊,重启后还能读回来。

它看起来是画画小工具,实际把几个常见工程问题都串起来了:触摸坐标换算、连续笔画插值、区域填充、撤销重做的历史栈、手势冲突、本地存储的幂等更新。这篇按案例给出的设计约定拆一遍实现要点。

二、架构:状态与绘制分离

案例给出的技术架构很清晰:

  • 画板页 Index 连接 CanvasViewModel,由 ViewModel 统一管理像素矩阵、当前工具、当前颜色和双栈历史;
  • PixelPreview 用原生 Canvas 负责画画面;
  • PresetTemplates 提供四个模板的像素数据;
  • ArtworkStore 通过 preferences 读写作品;
  • GalleryPage 按作品 ID 打开和更新作品,返回画廊时重新读取。

关键点是状态与界面分开:像素数据只存在 ViewModel 里,Canvas 每帧按当前矩阵重绘,模板数据是只读素材,使用前先复制再编辑。这样模板不会被污染,撤销重做也只需要记录矩阵快照或差量。

状态管理上用 @ObservedV2 / @Trace 标记可观察数据,UI 只订阅变化,不参与业务计算。

三、数据约定决定了很多实现细节

案例把数据约定写得很死,这其实是好事:

  • canvasSize = 32;
  • pixels[y][x] 以左上角为原点,x 向右、y 向下;
  • 像素值必须来自 palette,15 项是 #RRGGBB,另一项是 transparent;
  • 模板 ID 固定为 heart / smiley / mushroom / sword。

左上加 y 向下的坐标系和 Canvas 的绘制坐标天然一致,省掉了翻转。像素值收敛到调色板枚举,又让"同色判断"变成一次字符串比较,填充和"是否产生实际修改"的判定都很轻。

四、绘画手感:坐标换算 + Bresenham 连线

触摸事件拿到的坐标是连续的浮点值,先换算到 0–31 的格子索引,并做越界裁剪。真正影响手感的是连续笔画:只处理 Down 和 Up 会变成离散点,快速滑动会出现断点。

案例的做法是 Down 开始一笔,Move 时用 Bresenham 直线算法把上一格和当前格之间补齐,Up 或 Cancel 结束这一笔。Bresenham 只用整数加减和误差累积,就能得到视觉上连续的像素线段,成本很低,也不依赖浮点。

另一个容易忽略的点是手势冲突:绘画期间要禁止外层滚动容器抢走手势,Up/Cancel 时再恢复,否则斜向滑动会变成页面滚动。

五、填充:四邻域 + 显式栈

填充(油漆桶)有两种常见实现:递归泛洪和显式栈。递归写法简单,但 32×32 最大也就一千多格,嵌套深度完全可能把调用栈打穿;案例要求用显式栈做四邻域同色区域替换,安全且可控。

规则上有几个细节:

  • 只在首次按下时执行一次填充,Move 过程中不重复处理;
  • 只替换与起点同色的连通区域,天然形成边界;
  • 同色填充不产生实际修改,因此不进入历史,也不清除重做栈。

吸管同理:只取非透明像素,移动过程中不断刷取会拖慢主线程,也容易误操作。

六、撤销重做:双栈 + 入栈规则

撤销重做不是简单地压栈弹栈,难点在"什么算一次修改"。

案例的约定是:每次实际画面修改才进入双栈历史,最多保留 30 次;取色、越界触摸、重复同色笔画、同色填充都不占历史,也不清除重做;只有真正的新修改才清除重做栈。

这条规则直接决定用户感知:画一笔算一步,橡皮擦一格算一步,选模板整体替换算一步,吸管不算。如果实现里把任何触摸都当修改,撤销会变得又碎又乱。

七、存储:作品 ID 是幂等的关键

作品用 preferences 保存在端侧,字段包括稳定 ID、名称、创建时间、pixels 和缩略图。几个易错点:

  • 保存时用半屏面板输入名称,名称最多 24 字,空名落为「未命名画作」;
  • 保存按钮要防重复点击,写入成功后才关闭面板并提示「已保存到我的画廊」;
  • 画廊打开作品时带回名称和像素,继续编辑后覆盖保存必须写回同一个 ID,不能新增副本;
  • 返回画廊时重新读取存储,否则会出现"编辑完但画廊没更新"的假象;
  • 单条记录损坏要隔离处理,不能因为一条脏数据让整个画廊打不开。

「新建」和「删除」的规则也值得抄:有画面时新建先确认,确认后解除当前作品 ID 回到空画布;删除先展示作品名和不可恢复提示,取消保留。已保存作品重启后可读,临时画布和撤销历史只活在当前会话。

八、性能取舍

案例明确要求:画布用原生 Canvas 批量绘制像素和细网格,不要把每个像素做成独立按钮。32×32 是 1024 个格子,做成组件树的话,触摸和重绘都会很难受。Canvas 一次绘制整张画面,配上层叠的触摸区域,才是这个场景的正确姿势。

九、小结

这个案例的价值不在于"做一个画板",而在于它示范了一套可迁移的做法:

  1. 数据先定死(尺寸、坐标系、调色板、模板 ID),实现才有判断依据;
  2. 手感靠插值,Bresenham 是像素场景里性价比最高的选择;
  3. 填充用显式栈,别赌调用栈深度;
  4. 历史栈的入栈规则比栈本身更重要;
  5. 本地存储要围绕稳定 ID 做幂等更新。

按案例的八阶段提示词一步步做,每步都有可观察的完成标志,比一次性丢给 AI"写个画板"要稳得多。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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