LCD Image Converter 快速上手:嵌入式图像转换与字体生成的 4 个实用能力
【免费下载链接】lcd-image-converterTool to create bitmaps and fonts for embedded applications, v.2项目地址: https://gitcode.com/gh_mirrors/lc/lcd-image-converter
LCD Image Converter 是一款嵌入式图像转换工具:把 PNG 转成能直接编译进固件的 C 数组,完成图像转数组与位图字体生成。内置 RLE压缩、预设模板与命令行批处理,适合给 MCU、TFT、OLED 屏幕做显示资源、不想手写位图的新手与硬件工程师。
它替你解决了什么 🎯
你大概遇到过:设计师发来一张 128x64 的 PNG,你要把它变成 uint8_t logo[] = {...} 这样的 C 数组,还得让字节顺序和驱动对得上。手抄费时易错,网上找的转换脚本一换屏就得改——大端小端、逐行逐列,每种控制器都不一样。
LCD Image Converter 干的就是这一步:按预设重新排布像素,输出可直接编译的 C 源码,支持 1–32 位像素深度,单色、灰度、彩色都覆盖。字体也不用手画点阵:给它字符和字号,它生成位图字体表。
5分钟跑通第一次转换 ⚡
先编译出可执行文件:git clone https://gitcode.com/gh_mirrors/lc/lcd-image-converter 获取源码,装好 Qt 后依次执行 qmake 和 make。首次打开图形界面,先确认内置预设名,比如 16 位 RGB 屏常用的 lcdR4G5B4。
最短路径只有一条命令:
lcd-image-converter --mode=convert-image --input=logo.png --output=logo.c --doc-name=logo --preset-name=lcdR4G5B4跑完打开 logo.c,里面是排好顺序的像素数组,直接加进工程。上屏后若图像颠倒或左右反,回预设调整字节方向与扫描方向,再转一次。
四个值得知道的能力 ✨
RLE压缩:把大色块图像的体积砍掉四成
图标背景是大片纯色时打开它:连续相同的数据块被折叠成「值 + 次数」,这类图像压缩后体积通常减少 40%–65%,显示前先解码一轮。实现见 classes/compression/。
预设模板:一套参数适配一块屏
预设固定像素深度、字节顺序与数据块大小,模板文件再决定生成代码的样子。新加一块屏,复制预设改参数就行,不用重写转换逻辑。位置在 classes/settings/presets/。
字体按需生成:只编译用到的字符
用 --chars-list 列字符,或用 --chars-range 给范围(如 32-126),字体就只含这些字。界面只要数字和几个符号时,ROM 占用能降一大截。
命令行批处理:把转换写进构建脚本
convert-image、convert-font、hex2bin 三种模式都可用 --help 查参数,套 for 循环批量处理资源目录,再把命令加进 Makefile。
场景实战:参数怎么选 🔧
电池供电的物联网设备先想存储:像素深度压到最低(单色 1 位或灰度 4 位)、数据块选 8 位,再开 RLE 压缩——这类界面多是大色块加文字,正是 RLE 的主场。字号先试 12x12,字符集只留实际用到的。取舍在于低深度扛不住彩色渐变素材,屏幕支持 16 位且 ROM 不紧张时,直接用 RGB565 预设更省心。
工业面板更在意显示一致:像素深度与控制器对齐(RGB565 取 16 位),字节顺序跟 DMA 读取方向保持一致,字体关掉抗锯齿,单色屏上灰边只显糊。把预设存进配置文件并用 --config-presets 指向它,团队结果就一致,不会「我机器正常、烧进去花屏」。取舍是 16 位体积翻倍,换来颜色稳定。
适合谁,什么时候别选它
- 你在给 MCU 做位图资源、不想再手写数组:把它当图像转数组和字体生成工具用即可。
- 团队对接多种屏幕、要统一输出:预设系统就是干这个的。
- 转换要接进构建流程、批量可重复:命令行模式够用。
- 目标是桌面或手机 App,直接用 PNG/JPEG:不必引入。
- 避坑提醒:没确认预设的字节顺序与扫描方向就批量转,上屏会是旋转或镜像;先拿一张小图验证再全量跑。
从一张 PNG 到一段可编译的 C 数组,LCD Image Converter 把最容易出错的环节收进了预设和模板里。把转换命令加进构建脚本,显示资源从此和代码一样可版本管理。
【免费下载链接】lcd-image-converterTool to create bitmaps and fonts for embedded applications, v.2项目地址: https://gitcode.com/gh_mirrors/lc/lcd-image-converter
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考