如何快速将图像转为字节数组：image2cpp的终极使用指南

2026-02-05 05:35:57作者：何举烈Damon

image2cpp是一个实用工具，能将图片转化为字节数组或反之亦然，特别适合单色显示器如OLED等。无需Windows软件或虚拟机困扰，纯HTML+JavaScript打造在线版，方便调试和自定义数组转换。Arduino示例代码和屏幕类型兼容性良好，初始由javl开发，众多贡献者共同完善，基于GPLv3许可，自由使用和修改，欢迎支持我的开源项目。这个工具可以在线运行，无需特殊依赖或网络连接，全部功能封装在一个.html文件中。只需在浏览器中打开即可轻松使用。项目内还包含了适用于Arduino的简单代码实例，针对常见的128x64像素黑白OLED屏进行了优化设计，同样可适应多种类似显示屏。代码公开透明，遵循GPLv3协议，鼓励分享与创新，期待你的贡献和支持！

项目地址：https://gitcode.com/gh_mirrors/im/image2cpp

image2cpp是一款轻量级图像转字节工具，专为嵌入式开发设计，可将图像转换为适用于Arduino或Raspberry Pi等设备单色显示器（如OLED屏幕）的字节数组。该工具支持离线使用，操作简单高效，是硬件开发者的必备工具。

为什么选择image2cpp？

核心优势

完全免费：无需支付任何费用即可使用全部功能
离线可用：下载后即可脱离网络运行，保护开发隐私
专为硬件优化：完美适配Adafruit OLED库及主流嵌入式平台
操作简单：三步即可完成图像到代码的转换过程

快速上手：3步实现图像转字节

在线使用方法

选择图像：点击工具界面中的"选择图像"按钮上传本地图片
参数配置：调整图像尺寸、背景色和亮度阈值等关键参数
生成代码：选择输出格式（如Arduino代码）并复制结果到项目中

离线使用设置

克隆项目仓库到本地：git clone https://gitcode.com/gh_mirrors/im/image2cpp
进入项目目录，直接用浏览器打开index.html文件即可使用

实战案例：OLED屏幕图像显示

以下是使用image2cpp转换后代码在OLED屏幕上显示图像的示例：

#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>

#define OLED_WIDTH 128
#define OLED_HEIGHT 64
Adafruit_SSD1306 display(OLED_WIDTH, OLED_HEIGHT);

void setup() {
  display.begin(SSD1306_SWITCHCAPVCC, 0x3C);
  display.clearDisplay();
  
  // 由image2cpp转换得到的字节数组
  const uint8_t imageData[] = {...}; // 替换为实际转换的字节数据
  
  // 在OLED屏幕上绘制图像
  display.drawBitmap(0, 0, imageData, OLED_WIDTH, OLED_HEIGHT);
  display.display();
}

void loop() {
  // 无需循环操作
}