ArkTS 元服务实战:手写一个像素画板,把 Bresenham 连线和洪水填充跑通

举报
yd_235338516 发表于 2026/11/15 10:24:27 2026/11/15
【摘要】 最近在鸿蒙开发实践中心刷到一个「像素画板」元服务案例:32×32 画布、四种绘图工具、双栈撤销重做、本地画廊。看着不大,真自己动手写,坑全在算法和状态管理上。这篇记录一下实现思路和踩过的坑。 一、为什么用元服务而不是 App画板这种轻交互工具天然适合元服务:免安装、卡片即可拉起、用完就走。像素画板的画布是 32×32,单张位图最多 1024 个像素,正好落在元服务的内存与首屏预算里。 二、网...

最近在鸿蒙开发实践中心刷到一个「像素画板」元服务案例:32×32 画布、四种绘图工具、双栈撤销重做、本地画廊。看着不大,真自己动手写,坑全在算法和状态管理上。这篇记录一下实现思路和踩过的坑。

一、为什么用元服务而不是 App

画板这种轻交互工具天然适合元服务:免安装、卡片即可拉起、用完就走。像素画板的画布是 32×32,单张位图最多 1024 个像素,正好落在元服务的内存与首屏预算里。

二、网格渲染:Grid + ForEach 的三条底线

画布用 Grid 排 32 列,每个格子一个 GridItem:

Grid() {
  ForEach(this.pixels, (px: Pixel, idx: number) => {
    GridItem() {
      Row()
        .width('100%').height('100%')
        .backgroundColor(px.color)
        .borderRadius(1)
    }
  }, (px: Pixel, idx: number) => `${idx}-${px.color}`)
}
.columnsTemplate('1fr '.repeat(32))
.onTouch((e: TouchEvent) => this.handleDraw(e))

三条底线:

  1. key 必须带颜色。只用 index 做 key,颜色变了不重绘,画上去没反应。
  2. 不要在 onTouch 里逐帧改整个数组。一次拖动几十个 move 事件,每个都触发全量 diff,中低端机直接掉帧。做法是把像素拍平成颜色索引数组,只替换受影响的元素再整体赋值一次。
  3. 落笔用 onTouch 而不是 onClick。onClick 拿不到移动轨迹,连线会断成点。

三、四种工具,两种算法

  • 铅笔 / 橡皮:单点写入,橡皮就是写背景色。
  • 直线:Bresenham。整数运算,无浮点误差,32 格的小网格上比 DDA 更稳:
bresenham(x0: number, y0: number, x1: number, y1: number): number[][] {
  const pts: number[][] = [];
  let dx = Math.abs(x1 - x0), dy = Math.abs(y1 - y0);
  let sx = x0 < x1 ? 1 : -1, sy = y0 < y1 ? 1 : -1;
  let err = dx - dy;
  while (true) {
    pts.push([x0, y0]);
    if (x0 === x1 && y0 === y1) break;
    const e2 = 2 * err;
    if (e2 > -dy) { err -= dy; x0 += sx; }
    if (e2 < dx) { err += dx; y0 += sy; }
  }
  return pts;
}
  • 油漆桶:洪水填充。32×32 用递归 DFS 会爆栈(最坏 1024 层),改成显式栈更保险:
fill(sx: number, sy: number, newColor: number) {
  const target = this.get(sx, sy);
  if (target === newColor) return; // 必须提前返回,否则死循环
  const stack: number[][] = [[sx, sy]];
  while (stack.length) {
    const [x, y] = stack.pop()!;
    if (x < 0 || y < 0 || x >= 32 || y >= 32) continue;
    if (this.get(x, y) !== target) continue;
    this.set(x, y, newColor);
    stack.push([x + 1, y], [x - 1, y], [x, y + 1], [x, y - 1]);
  }
}

洪水填充最容易被忽略的是「填充色等于目标色」这个分支,不提前返回就会无限入栈。

四、撤销重做:双栈 + 只存差量

最直觉的做法是每步存整张画布快照,32×32 内存不大,但 50 步撤销就是 5 万个整数。更省的是记录「这一步改动了哪些格子」:

interface Step { indices: number[]; before: number[]; after: number[]; }

undoStack / redoStack 两个数组,新操作入 undoStack 时清空 redoStack。撤销就是把 before 写回,重做写 after。双栈的边界条件是很多人写错的地方:undo 到空、redo 到空都要及时用 disabled 属性把按钮禁掉,否则会读到 undefined。

五、本地画廊:Preferences 存缩略图

每个作品存成一段 JSON:像素数组 + 创建时间 + 缩略图色块,用 Preferences 键值存储,key 取时间戳。要注意 Preferences 单值有大小上限,1024 个像素直接写十六进制颜色会超,改成颜色索引(0-15 调色板)后体积能压到 2KB 以内,读回来再映射成颜色。

六、踩坑小结

现象 原因 解法
画上去没反应 ForEach key 只用了 index key 带上颜色值
拖动画线断成点 用 onClick 取轨迹 改用 onTouch
油漆桶卡死 填充色等于目标色 提前 return
撤销后重做错位 redoStack 没清空 新操作时 clear
画廊读不出来 Preferences 超上限 存颜色索引

七、感受

这个案例最值钱的不是 UI,而是它把「元服务的资源边界」摆到你面前:没有 GPU 加速的大画布,没有海量存储,只有 1024 个格子和几 KB 的键值空间。约束遢着你去做算法层面的优化:Bresenham、洪水填充、差量快照这些东西,在 App 里可以靠第三方库糊过去,在元服务里必须自己想清楚。

云端实践环境可以直接跑通,租约内改代码、装到模拟器上看效果,比自己搭环境快很多。想练手 ArkTS 的话,这个案例难度适中,两小时能走完主流程。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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