跳到主要内容
Numio

图片转 C 数组

将本地图片转换为 Adafruit GFX 位图、SSD1306 显存或 RGB565 C 数组，实时预览像素并下载头文件。

PNG、JPEG 或 WebP · 最大 10 MB、1600 万像素。图片仅在浏览器内处理。

像素预览

选择图片或载入示例，即可预览实际输出像素。

预览中的黑色像素为 1。每行从新字节开始，右侧不足一字节的空位补 0。用于 Adafruit GFX drawBitmap。

C 头文件

使用方法

  1. 选择本地 PNG、JPEG 或 WebP 图片，也可以载入示例。
  2. 设置输出尺寸，选择保持比例或拉伸；单色模式下可调整阈值和反相。
  3. 按显示库要求选择数据排列方式，核对像素预览，再复制代码或下载 .h 文件。

示例

128 × 64 单色图片占用 1,024 字节。
GFX 逐行格式：x=0 位于首字节的第 7 位。
SSD1306 分页格式：y=0 位于首字节的第 0 位。
RGB565：红 = 0xF800，绿 = 0x07E0，蓝 = 0x001F。

功能与限制

图片处理全部在本地完成。输入上限为 10 MB、1600 万像素，输出宽高范围均为 1–256 像素；工具不会连接或烧录设备。

工具冻结首个解码帧，并将长边缩至最多 256 像素。透明像素与白色合成，保持比例模式使用白色补边。

单色模式下，亮度低于阈值的像素编码为 1（预览为黑色）；等于阈值时编码为 0。反相只作用于图像像素，不会改变图像边界外的补零位。OLED 通常会点亮值为 1 的像素。

GFX 每行补齐整字节；SSD1306 最后一页补齐 8 像素，非整页尺寸需要驱动配合。RGB565 输出为 16 位数值数组，不指定传输字节序。

头文件使用 static const 数组，在 AVR 平台采用 PROGMEM 存储。GFX 可读取对应位图格式；AVR 上复制原始显存数据应使用适当的程序存储器读取或复制函数。不生成 LVGL 图像描述符、调色板或透明通道。

FAQ

图片会上传吗？

不会，解码、缩放和转换都在浏览器内完成。

OLED 显示错乱怎么办？

核对尺寸和排列格式。Adafruit GFX drawBitmap 使用横向逐行、最左像素在第 7 位；SSD1306 原始显存按纵向 8 像素分页、顶部像素在第 0 位。

RGB565 可以选择大小端吗？

本工具导出 uint16_t 数值，实际字节序交由编译器和显示驱动处理，并非原始字节流。

格式参考资料

工具页面更新日期：