ArkTS 元服务实战:手写一个像素画板,把 Bresenham 连线和洪水填充跑通
最近在鸿蒙开发实践中心刷到一个「像素画板」元服务案例: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))
三条底线:
- key 必须带颜色。只用 index 做 key,颜色变了不重绘,画上去没反应。
- 不要在 onTouch 里逐帧改整个数组。一次拖动几十个 move 事件,每个都触发全量 diff,中低端机直接掉帧。做法是把像素拍平成颜色索引数组,只替换受影响的元素再整体赋值一次。
- 落笔用 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 的话,这个案例难度适中,两小时能走完主流程。
- 点赞
- 收藏
- 关注作者
评论(0)