本文详解如何在 canvas 中准确生成符合嵌入式显示规范的字模数据(dec/hex),重点解决宽度 >8px 时因位序与字节填充逻辑错误导致的上下颠倒问题,确保列优先、低位在前、按行分组填充的正确性。
在为嵌入式显示屏(如 LED 点阵屏、单色 OLED)生成像素字体时,Canvas 是常用工具
——通过绘制裁剪、读取像素并打包为字节序列,最终导出 HEX 表示的字模数据。但当字体宽度超过 8 像素时,常见错误会导致输出字节顺序错乱,典型表现为“图形上下翻转”:本该在顶部的笔画出现在底部字节中。根本原因在于位组装方向与字节边界对齐逻辑未适配硬件约定。
标准嵌入式字模(如常见的 5×7、12×14、16×16 点阵)通常采用 列优先(column-major)、低位在下(LSB at top row)、每 8 行打包为 1 字节 的格式。即:
而原代码中内层循环为 for (let y = actualHeight - 1; y >= 0; y--),即从底向上读取,等效于将图像垂直翻转后再编码——这正是为何 10×14 的“A”必须“倒着画”才能匹配预期输出。
✅ 正确做法是:保持自然绘制顺序(y=0 在顶),内层循环正向遍历 y = 0 到 y = actualHeight−1,并按 bit position = y % 8 累加权重。
以下是修正后的核心逻辑(兼容任意宽高,自动按 8 行分组):
const pxlArray = [];
for (let x = 0; x < actualWidth; x++) {
let byte = 0;
let bitPos = 0; // 当前位位置(0 ~ 7),对应 y % 8
for (let y = 0; y < actualHeight; y++) {
// ✅ 从顶行(y=0)开始读取,自然顺序
const tempData = tempContext.getImageData(x, y, 1, 1).data;
const isOn = tempData[0] === 0 && tempData[1] === 0 &&
tempData[2] === 0 && tempData[3] === 255;
if (isOn) {
byte |= (1 << bitPos); // 设置第 bitPos 位(LSB = y=0)
}
bitPos++;
// ✅ 每满 8 行或到达最后一行,保存当前字节
if (bitPos === 8 || y === actualHeight - 1) {
pxlArray.push(byte);
byte = 0;
bitPos = 0;
}
}
}? 关键要点总结:
遵循此逻辑,你绘制的“A”将严格按视觉顺序被编码,无需人为翻转布局,真正实现“所见即所得”的嵌入式字体开发流程。