鸿蒙实践案例学习笔记:像素画板——32×32 画布上的 ArkUI 像素画元服务
今天在鸿蒙开发实践中心阅读了「像素画板」案例,并给它的 GitCode 代码仓点了 Star,顺手把学习笔记记下来。
案例是什么
像素画板是一款像素画元服务(元服务卡片形态),作者是华为云码道 CodeArts,版本 v1.1.0(2026-10-02),MIT 许可,案例发布于 2026-11-05。代码仓:https://gitcode.com/harmony-practice-center/HarmonyOS-AtomSer-pixel-paint
它用 ArkTS + ArkUI 实现,端侧单机运行,不需要云服务;支持 API 24。按案例介绍,可以学习 Canvas 像素绘制、应用内数据流转和 preferences 持久化。
画布与工具
- 画布是 32×32 的网格,共 1024 个像素点,支持点击/拖动绘制、缩放、点按上色。
- 四个核心工具:画笔、橡皮、油漆桶、拾色器。
- 四个内置模板:爱心、太阳、房子、汽车,可以一键加载到画布再二次创作。
- 画布数据保存在内存 CanvasState 中;画好的作品保存到图库,图库用 preferences 做本地持久化,应用重启后作品还在。
两个值得记的算法点
- 画笔连线用 Bresenham 直线算法插值:拖动时在起点和终点之间补点,线条不断点。
- 油漆桶用洪水填充算法:从点击位置出发,把同色连通区域一次性替换成新颜色。
这两个算法都与界面解耦,UI 只负责把结果渲染出来——和之前数独案例里“逻辑纯函数、与 UI 分离”的做法是同一个思路。
工程结构
项目分三层:app(应用入口)+ feature/PaintFeature(业务功能)+ pages(页面)。
- 入口:pages/Index,首页负责模式选择(新建/继续/画廊)与权限申请。
- 画布页:pages/PaintBoard,PaintBoard.ets 是画布渲染,PixelPaintState.ets 管画布状态,Palette.ets 管颜色面板。
- 图库页:pages/Gallery,Gallery.ets 负责展示、重命名、删除、重绘。
- 工具:constants/ToolConstants.ets 集中管理工具定义。
状态管理用 @State/@Prop/@Watch,UI 用声明式语法;画布用 Canvas 组件承载绘制。
今天顺手做的两件事
- 在 GitCode 给 HarmonyOS-AtomSer-pixel-paint 点了 Star(之前已 Star 的数独仓不动)。
- 进了 AI DevSpace 免费体验版看了一圈,没有创建任何收费资源。
小结
像素画板这个案例不大,但把“状态驱动 UI、算法与界面解耦、本地持久化”三件事讲得很清楚,适合当作 ArkUI 入门后的练手案例:先读 PixelPaintState 和两处算法,再对照 PaintBoard.ets 看渲染,最后自己改一个模板或加一个工具试试。
(本文内容来自今天在鸿蒙开发实践中心阅读的像素画板案例页与公开代码仓 README,未实际构建运行该工程。)
- 点赞
- 收藏
- 关注作者
评论(0)