二进制图片

tool/IMAGE_CONVERTER_README.md

@@ -0,0 +1,167 @@
+# 图片转换工具使用指南
+
+这个工具可以将多种格式的图片转换为适用于ESP32墨水屏显示的二进制点阵数据。
+
+## 功能特点
+
+- 支持多种图片格式：JPG、PNG、BMP、GIF、TIFF等
+- 自动调整图片大小并居中显示
+- 支持黑色背景白色文本或白色背景黑色文本
+- 支持旋转90度显示
+- 支持Floyd-Steinberg抖动算法提高图像质量
+- 支持创建文本图像
+- 支持批量转换
+
+## 安装依赖
+
+```bash
+pip install Pillow
+```
+
+## 使用方法
+
+### 1. 转换单个图片
+
+```bash
+python3 image_converter.py image <输入图片路径> <输出文件路径> [选项]
+```
+
+```bash
+cd "/Users/jeremygan/Desktop/
+TangledupAI/esp32_GDEY042T81-24Pin-_dirver-" && python3 tool/image_con
+verter.py image tool/test_iamge_white_bg2.png images/test_image2.py --
+width 400 --height 300
+```
+选项参数：
+- `--width`: 目标宽度（默认400）
+- `--height`: 目标高度（默认300）
+- `--invert`: 反转颜色（白色背景黑色文本）
+- `--rotate`: 旋转90度
+- `--no-dither`: 不使用抖动算法
+
+示例：
+```bash
+# 转换为黑色背景白色文本（默认）
+python3 image_converter.py image photo.jpg photo_dark.py
+
+# 转换为白色背景黑色文本
+python3 image_converter.py image photo.jpg photo_light.py --invert
+
+# 转换并旋转90度
+python3 image_converter.py image photo.jpg photo_rotated.py --rotate
+
+# 转换为128x296尺寸并旋转
+python3 image_converter.py image photo.jpg photo_small.py --width 128 --height 296 --rotate
+```
+
+### 2. 创建文本图像
+
+```bash
+python3 image_converter.py text "<文本内容>" <输出文件路径> [选项]
+```
+
+
+选项参数：
+- `--width`: 目标宽度（默认400）
+- `--height`: 目标高度（默认300）
+- `--font-size`: 字体大小（默认24）
+- `--invert`: 反转颜色（白色背景黑色文本）
+- `--rotate`: 旋转90度
+
+示例：
+```bash
+# 创建文本图像
+python3 image_converter.py text "Hello ESP32!" hello.py
+
+# 创建大字体文本图像
+python3 image_converter.py text "Hello ESP32!" hello_big.py --font-size 32
+
+# 创建旋转文本图像
+python3 image_converter.py text "Rotated Text" rotated.py --rotate
+```
+
+### 3. 批量转换
+
+```bash
+python3 image_converter.py batch <输入目录> <输出目录> [选项]
+```
+
+示例：
+```bash
+# 批量转换目录中的所有图片
+python3 image_converter.py batch images/ converted/
+
+# 批量转换为白色背景黑色文本
+python3 image_converter.py batch images/ converted/ --invert
+```
+
+## 输出格式
+
+转换后的文件包含一个bytearray变量，变量名与文件名相同：
+
+```python
+# Converted from photo.jpg
+# Size: 400x300
+# Inverted: False, Rotated: False
+photo = bytearray(b'\x00\x00\x00\x0...')
+```
+
+## 在ESP32项目中使用
+
+1. 将转换后的.py文件复制到ESP32项目目录
+2. 在boot.py中设置`RUN_MODE=3`
+3. 修改image.py导入转换后的图片数据：
+
+```python
+# 在image.py中导入转换后的图片
+from photo import photo
+
+def run(img_data=None):
+    if img_data is None:
+        # 使用默认图片
+        img_data = photo
+    
+    # ... 其余代码保持不变
+```
+
+4. 上传代码到ESP32并运行
+
+## 示例
+
+运行示例脚本：
+
+```bash
+python3 convert_examples.py
+```
+
+这将创建示例图片目录并展示各种转换用法。
+
+## 注意事项
+
+1. 图片会自动调整大小并居中显示，保持原始宽高比
+2. 使用抖动算法可以提高图像质量，但会增加文件大小
+3. 旋转90度后，宽度和高度会互换
+4. 确保输出目录有写入权限
+5. 转换大图片可能需要一些时间
+
+## 故障排除
+
+1. **ImportError: No module named 'PIL'**
+   - 解决方案：运行 `pip install Pillow`
+
+2. **无法识别的图片格式**
+   - 解决方案：确保图片格式受支持（JPG、PNG、BMP、GIF、TIFF）
+
+3. **转换后的图片显示不正确**
+   - 解决方案：尝试使用`--invert`参数反转颜色
+   - 尝试使用`--rotate`参数旋转图片
+
+4. **内存不足**
+   - 解决方案：减小目标尺寸或使用更小的源图片
+
+## 技术细节
+
+- 图片使用Floyd-Steinberg抖动算法转换为1位黑白图像
+- 每个字节表示8个像素，最高位在前
+- 像素值0表示黑色，1表示白色
+- 字节数组按行组织，每行需要的字节数为(宽度+7)//8