5分钟上手！image2cpp快速开始指南（附Arduino实例代码）

【免费下载链接】image2cpp 项目地址: https://gitcode.com/gh_mirrors/im/image2cpp

image2cpp是一款简单实用的开源工具，能够将图片转换为字节数组，或将字节数组还原为图片，特别适用于OLED等单色显示屏项目。无论是Arduino还是树莓派开发，它都能帮助你轻松实现图像显示功能，所有处理均在本地浏览器完成，无需担心图片隐私问题。

📋 准备工作：获取工具

要开始使用image2cpp，首先需要将项目代码克隆到本地：

git clone https://gitcode.com/gh_mirrors/im/image2cpp

项目结构清晰，主要包含以下核心文件：

• index.html：工具主界面，直接在浏览器中打开即可使用
• js/script.js：核心转换逻辑实现
• oled_example/oled_example.ino：Arduino示例代码

🖥️ 快速启动工具

无需复杂配置，直接在浏览器中打开项目根目录下的index.html文件即可启动工具。界面直观分为四个主要步骤：

1. 选择图片或输入字节数组

• 图片输入：点击"Select image"区域上传本地图片
• 字节数组输入：在右侧文本框粘贴字节数组，设置宽高后选择"Read as horizontal"或"Read as vertical"

2. 配置图像参数

根据你的显示屏特性调整参数：

• 画布大小：设置目标显示尺寸（如128x64像素）
• 背景颜色：选择白色、黑色或透明背景
• 颜色反转：勾选"Invert image colors"可翻转黑白像素
• 抖动算法：提供Binary、Bayer、Floyd-Steinberg等多种算法选择
• 缩放选项：支持保持比例缩放或拉伸填充

3. 预览转换效果

在预览区域可以实时查看转换后的图像效果，确认无误后进入下一步。

4. 生成输出代码

选择适合你项目的输出格式：

• Arduino code：生成可直接用于Arduino的代码
• Plain bytes：仅输出原始字节数组
• Adafruit GFXbitmapFont：适用于Adafruit GFX库的字体格式

点击"Generate code"按钮生成代码，然后通过"Copy Output"复制到剪贴板。

🚀 Arduino实例：显示图像到OLED

项目提供了完整的Arduino示例代码oled_example/oled_example.ino，以下是关键步骤：

1. 硬件准备

• Arduino开发板
• SSD1306驱动的128x64 OLED显示屏
• 杜邦线若干

2. 安装库文件

在Arduino IDE中安装必要的库：

• Adafruit GFX Library
• Adafruit SSD1306 Library

3. 核心代码解析

示例代码中定义了一个字节数组来存储图像数据：

const unsigned char myBitmap [] PROGMEM = {
  // 图像字节数据...
};

在setup()函数中初始化显示屏并绘制图像：

void setup() {
  display.begin(SSD1306_SWITCHCAPVCC, 0x3D);  // 初始化显示屏
  display.clearDisplay();                     // 清屏
  display.drawBitmap(0, 0, myBitmap, 64, 64, WHITE);  // 绘制图像
  display.display();                          // 更新显示
}

只需将从image2cpp生成的字节数组替换myBitmap的内容，即可显示自定义图像。

💡 使用技巧

• 显示模式选择：如果图像显示异常，尝试切换"Draw mode"中的水平/垂直扫描模式
• 位交换选项：使用u8g2库时，勾选"Swap bits in byte"可解决显示错乱问题
• 批量处理：支持同时上传多张图片，自动生成带序号的字节数组

📄 许可证信息

image2cpp基于GPL v3许可证开源，你可以自由使用、修改和分发，但需保留原作者信息并分享修改后的代码。详细条款参见项目根目录下的LICENSE.md。

通过以上步骤，你已经掌握了image2cpp的基本使用方法。这个工具不仅简化了图像到代码的转换过程，还为嵌入式项目提供了灵活的图像显示解决方案。无论是制作小型电子装置还是复杂的交互界面，它都能成为你的得力助手！

【免费下载链接】image2cpp 项目地址: https://gitcode.com/gh_mirrors/im/image2cpp