鸿蒙像素画板元服务拆解:Canvas、Bresenham 与双栈撤销的实现要点
一、这个案例在做什么
「像素画板」是鸿蒙开发实践中心里的一个元服务案例: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 一次绘制整张画面,配上层叠的触摸区域,才是这个场景的正确姿势。
九、小结
这个案例的价值不在于"做一个画板",而在于它示范了一套可迁移的做法:
- 数据先定死(尺寸、坐标系、调色板、模板 ID),实现才有判断依据;
- 手感靠插值,Bresenham 是像素场景里性价比最高的选择;
- 填充用显式栈,别赌调用栈深度;
- 历史栈的入栈规则比栈本身更重要;
- 本地存储要围绕稳定 ID 做幂等更新。
按案例的八阶段提示词一步步做,每步都有可观察的完成标志,比一次性丢给 AI"写个画板"要稳得多。
- 点赞
- 收藏
- 关注作者
评论(0)